Improve Readme

This commit is contained in:
Quentin Rouland 2019-03-23 21:01:51 +01:00
parent c044cefc26
commit 5ab87a395d

View File

@ -2,13 +2,15 @@
A Ubuntu Touch password management app aiming to be compatible with [ZX2C4s pass command line application](https://www.passwordstore.org/) the standard unix password manager. A Ubuntu Touch password management app aiming to be compatible with [ZX2C4s pass command line application](https://www.passwordstore.org/) the standard unix password manager.
# Build & Tests
# Building # Building
* Install [clickable](https://github.com/bhdouglass/clickable). * Install [clickable](https://github.com/bhdouglass/clickable).
* Clone this repo : ```git clone --recursive https://github.com/qrouland/UTPass``` * Clone this repo : ```git clone --recursive https://github.com/qrouland/UTPass```
* Move to app directory: ```cd UTPass``` * Move to app directory: ```cd UTPass```
* Build third parties : ```clickable third_build``` * Build third parties : ```clickable third_build```
* Build the app : ```clickable``` * Build & Run the app : ```clickable```
For more options/details see the [clickable documentation](http://clickable.bhdouglass.com/en/latest/index.html) For more options/details see the [clickable documentation](http://clickable.bhdouglass.com/en/latest/index.html)
@ -16,21 +18,19 @@ For more options/details see the [clickable documentation](http://clickable.bhdo
* ```clickable third_build ``` : build third dependencies for arm architecture * ```clickable third_build ``` : build third dependencies for arm architecture
* ```clickable third_build_d ``` : build third dependencies for amd64 architecture * ```clickable third_build_d ``` : build third dependencies for amd64 architecture
* ```clickable third_clean ``` : clean third parties * ```clickable third_clean ``` : clean third parties
* ```clickable style ``` : reformat the code (Required [astyle](astyle.sourceforge.ne) & [qmlfmt](https://github.com/jesperhh/qmlfmt) installed) * ```clickable style ``` : reformat the code (Required [astyle](https://astyle.sourceforge.net) & [qmlfmt](https://github.com/jesperhh/qmlfmt) to be installed)
## Testing ## Testing
To switch to the tests build you need to add the following arguments to the build command : -DTEST_RUNNER=ON. To switch to the tests build you need to add the following arguments to the build command : -DTEST_RUNNER=ON.
To do so with clickable you need to use the following commands: To do so with clickable you need to use the following commands:
```
export CLICKABLE_BUILD_ARGS='-DTEST_RUNNER=ON' * Set CLICKABLE_BUILD_ARGS environnment variable : ```export CLICKABLE_BUILD_ARGS='-DTEST_RUNNER=ON'```
clickable * Build & Run the tests ```clickable ```
```
To comeback to the app build unset the environnment variable : To comeback to the standart app build :
``` * Unset CLICKABLE_BUILD_ARGS environnment variable ```unset CLICKABLE_BUILD_ARGS```
unset CLICKABLE_BUILD_ARGS
```
# Contributing # Contributing
@ -40,7 +40,7 @@ Please respect the code style format by running ```clickable style``` before com
# Features # Features
The goal is to be closest possible of the features offer by [ZX2C4s pass command line application](https://www.passwordstore.org/). The goal is to be closest possible of the features offer by [ZX2C4s pass command line application](https://www.passwordstore.org/).
See to the FEATURES.MD file for detailed comparison. See to the FEATURES.MD file for details.
# License # License