mirror of https://github.com/on4kjm/FLEcli.git
parent
8afb81eed3
commit
6134577dd0
@ -0,0 +1,41 @@
|
|||||||
|
# Installation
|
||||||
|
|
||||||
|
## Downloading
|
||||||
|
|
||||||
|
The application can be downloaded from the latest release page, found at https://github.com/on4kjm/FLEcli/releases.
|
||||||
|
|
||||||
|
The application is available in the following packaging:
|
||||||
|
* `FLEcli_v..._macOS_64-bit.tar.gz` is the MacOS version.
|
||||||
|
* `FLEcli_v..._windows_32-bit.zip` is the Windows version. Only the 32 bit is proposed as it should work also on older Windows version.
|
||||||
|
* `FLEcli_v..._Linux_64-bit.tar.gz` is the 64 bits distribution for Linux.
|
||||||
|
* `FLEcli_v..._Linux_32-bit.tar.gz` is the 32 bits distribution for Linux
|
||||||
|
* `FLEcli_v..._Linux_arm.tar.gz` is the 32 bits ARM (instruction set 6) distribution (for RaspberryPi older models for example)
|
||||||
|
* `FLEcli_v..._Linux_arm64.tar.gz` is the 64 bits ARM (instruction set 6) distribution
|
||||||
|
|
||||||
|
After downloading the appropriate archive, you can validate its sha256 and compare it with the value in the `checksum.txt` file.
|
||||||
|
|
||||||
|
## Compiling
|
||||||
|
The application can also be compiled from sources if Golang is available. How to proceed is out of the scope of this notice.
|
||||||
|
|
||||||
|
## Installing
|
||||||
|
|
||||||
|
Unpack it in a convenient location. Depending on your Operating System, you can make it available from any location:
|
||||||
|
* Adding the directory to the path for Windows
|
||||||
|
* Creating a (permanent) alias on Linux or MacOS
|
||||||
|
* Moving the executable to a directory that is in the path, such as `/usr/local/bin` for Linux or MacOs.
|
||||||
|
|
||||||
|
### HomeBrew
|
||||||
|
Currently there is no Homebrew installation available.
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
The application is also available as a docker container.
|
||||||
|
It can be started with: `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli <FLEcli command>`. If no command is specified, help is displayed.
|
||||||
|
To avoid typing the whole command, an alias is recomended as described in the [docker specific instructions](../docker/README.md).
|
||||||
|
|
||||||
|
**Important note:** when specifying the path of a file (input or output), it must be relative to the directory the container was started in.
|
||||||
|
|
||||||
|
### MacOS
|
||||||
|
|
||||||
|
**WARNING:** at this stage, the MacOS binary is not signed. It will fail to load on the recent OS version unless a very permissive security setting is enable (which is not advised).
|
||||||
|
|
||||||
|
Please find [here a detailed procedure](install_mac.md) to use FLEcli on a Mac despite the missing signature.
|
@ -0,0 +1,26 @@
|
|||||||
|
# Installation on MacOS
|
||||||
|
|
||||||
|
At this stage, the MacOS FLEcli binary is not signed. It will fail to load on recent MacOS version.
|
||||||
|
|
||||||
|
This procedure will guide you for adding FLEcli to the exception list.
|
||||||
|
|
||||||
|
When the executable has been unpacked in a directory and that you try to execute it in the console (`./FLEcli`), you will get the following error:
|
||||||
|
|
||||||
|
![](pictures/Error_1.png?raw=true)
|
||||||
|
|
||||||
|
Make sure that you choose "cancel" to close the dialog.
|
||||||
|
Having triggered that error will allow you to enable the exception.
|
||||||
|
|
||||||
|
Enter the "system preference" and choose the "Security Settings".
|
||||||
|
|
||||||
|
![](pictures/System_preference.png?raw=true)
|
||||||
|
|
||||||
|
On the "general" tab, you will see the problem that just occurred ( _"FLEcli" was blocked from use because it is not from an identified developer_ ). Click on the "Allow Anyway" button.
|
||||||
|
|
||||||
|
![](pictures/security_setting.png?raw=true)
|
||||||
|
|
||||||
|
When trying again to execute the application, the error message will be slightly different:
|
||||||
|
|
||||||
|
![](pictures/Error_2.png?raw=true)
|
||||||
|
|
||||||
|
But this time, choose "open". The exception is now registered.
|
After Width: | Height: | Size: 76 KiB |
After Width: | Height: | Size: 112 KiB |
After Width: | Height: | Size: 506 KiB |
After Width: | Height: | Size: 240 KiB |
@ -0,0 +1,96 @@
|
|||||||
|
# Usage
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
```
|
||||||
|
Usage:
|
||||||
|
FLEcli [command]
|
||||||
|
|
||||||
|
Available Commands:
|
||||||
|
adif Generates an ADIF file based on a FLE type shorthand logfile.
|
||||||
|
csv Generates a SOTA .csv file based on a FLE type shorthand logfile.
|
||||||
|
help Help about any command
|
||||||
|
load Loads and validates a FLE type shorthand logfile
|
||||||
|
version "version" will output the current build information
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
--config string config file (default is $HOME/.FLEcli.yaml)
|
||||||
|
-h, --help help for FLEcli
|
||||||
|
|
||||||
|
Use "FLEcli [command] --help" for more information about a command.
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## "LOAD" command
|
||||||
|
```
|
||||||
|
FLEcli load --help
|
||||||
|
Loads and validates a FLE type shorthand logfile
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
FLEcli load [flags]
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
-h, --help help for load
|
||||||
|
-i, --input string FLE formatted input file (mandatory)
|
||||||
|
--interpolate Interpolates the missing time entries.
|
||||||
|
|
||||||
|
Global Flags:
|
||||||
|
--config string config file (default is $HOME/.FLEcli.yaml)
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## "ADIF" command
|
||||||
|
```
|
||||||
|
FLEcli adif --help
|
||||||
|
Generates an ADIF file based on a FLE type shorthand logfile.
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
FLEcli adif [flags]
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
-h, --help help for adif
|
||||||
|
-i, --input string FLE formatted input file (mandatory)
|
||||||
|
--interpolate Interpolates the missing time entries.
|
||||||
|
-o, --output string Output filename
|
||||||
|
--overwrite Overwrites the output file if it exisits
|
||||||
|
-s, --sota Generates a SOTA ready ADIF file.
|
||||||
|
-w, --wwff Generates a WWFF ready ADIF file.
|
||||||
|
|
||||||
|
Global Flags:
|
||||||
|
--config string config file (default is $HOME/.FLEcli.yaml)
|
||||||
|
```
|
||||||
|
|
||||||
|
## "CSV" command
|
||||||
|
```
|
||||||
|
FLEcli csv --help
|
||||||
|
Generates a SOTA .csv file based on a FLE type shorthand logfile.
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
FLEcli csv [flags]
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
-h, --help help for csv
|
||||||
|
-i, --input string FLE formatted input file (mandatory)
|
||||||
|
--interpolate Interpolates the missing time entries.
|
||||||
|
-o, --output string Output filename
|
||||||
|
--overwrite Overwrites the output file if it exisits
|
||||||
|
|
||||||
|
Global Flags:
|
||||||
|
--config string config file (default is $HOME/.FLEcli.yaml)
|
||||||
|
```
|
||||||
|
|
||||||
|
## "VERSION" command
|
||||||
|
```
|
||||||
|
FLEcli version --help
|
||||||
|
"version" will output the current build information
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
FLEcli version [flags]
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
-d, --detailed Prints the detailed version information
|
||||||
|
-h, --help help for version
|
||||||
|
|
||||||
|
Global Flags:
|
||||||
|
--config string config file (default is $HOME/.FLEcli.yaml)
|
||||||
|
```
|
||||||
|
The normal output looks like `FLEcli version: v0.0.1`. The detailled output gives additionaly the Git commit hash. the date and time of build and who built the release.
|
@ -1,21 +1,24 @@
|
|||||||
## Building docker image by hand
|
|
||||||
|
|
||||||
* `docker build -t fle_cli .`
|
|
||||||
|
|
||||||
## goReleaser built Docker images
|
## goReleaser built Docker images
|
||||||
|
|
||||||
* `goreleaser --snapshot --skip-publish --rm-dist`
|
* `goreleaser --snapshot --skip-publish --rm-dist`
|
||||||
* docker image is named "jmmeessen/flecli". It creates two labels automatically ("latest" and the last release)
|
* docker image is named "on4kjm/flecli". It creates two labels automatically ("latest" and the last release)
|
||||||
|
|
||||||
|
## Building the image by hand
|
||||||
|
(this assumes that the Linux executable is available in `dist/`, thus as built by GoReleaser)
|
||||||
|
|
||||||
|
* `docker build -f docker/Dockerfile -t test/test dist/FLEcli_linux_amd64` will create a image called `test/test:latest`.
|
||||||
|
|
||||||
## Running the container
|
## Running the container
|
||||||
|
|
||||||
* `docker run --rm -i fle_cli version -d`
|
To start and execute the `<FLEcli command>` use : `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli <FLEcli command>`. If no command is specified, help is displayed.
|
||||||
* `docker run --rm -i -v "$(pwd)":/FLEcli_data fle_cli version -d`
|
|
||||||
* `docker run --rm -i jmmeessen/flecli version -d`
|
|
||||||
|
|
||||||
* `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data jmmeessen/flecli`.
|
This little command will create an alias that avoids typing the whole command: `alias FLEcli="docker run --rm --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli"`. To use it, type `FLEcli version` for example.
|
||||||
* `alias FLEcli="docker run --rm --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data jmmeessen/flecli"`
|
|
||||||
|
Important note: when specifying the path of a file (input or output), it must be relative to the directory the container was started in.
|
||||||
|
|
||||||
## Running bash in the container
|
## Running bash in the container
|
||||||
|
|
||||||
* `docker run --rm -i -v "$(pwd)":/FLEcli_data --entrypoint /bin/sh fle_cli`
|
Note, this doesn't work with the SCRATCH image. You need to use the Alpine base image. Anyway, if you want to enter the container, you know what I am talking about.
|
||||||
|
|
||||||
|
* `docker run --rm -i -v "$(pwd)":/FLEcli_data --entrypoint /bin/sh on4kjm/flecli`
|
Loading…
Reference in new issue