mirror of
https://git.zavage.net/Zavage-Software/app_skellington.git
synced 2024-12-21 14:19:21 -07:00
doc: dev instructions for README.md
This commit is contained in:
parent
9a1999b8ab
commit
cb083cd38e
33
README.md
33
README.md
@ -20,7 +20,7 @@ in the src directory which is a validation file; it contains the accepted
|
|||||||
parameter names, types, and limits for configurable options in the
|
parameter names, types, and limits for configurable options in the
|
||||||
application which is built on app_skellington. The format is multi-level .ini syntax.
|
application which is built on app_skellington. The format is multi-level .ini syntax.
|
||||||
|
|
||||||
Reference the ConfigObj documentation for config.ini and config.spec
|
Reference the ConfigObj documentation for config.ini and config.spec
|
||||||
format. See:
|
format. See:
|
||||||
|
|
||||||
- https://configobj.readthedocs.io/en/latest/configobj.html#the-config-file-format
|
- https://configobj.readthedocs.io/en/latest/configobj.html#the-config-file-format
|
||||||
@ -31,15 +31,15 @@ file always contains the full specification of parameters; i.e. even default
|
|||||||
parameters are added into the config file.
|
parameters are added into the config file.
|
||||||
|
|
||||||
Linux:
|
Linux:
|
||||||
|
|
||||||
/home/\<user\>/.config/\<app_name\>/config.ini
|
/home/\<user\>/.config/\<app_name\>/config.ini
|
||||||
|
|
||||||
/home/\<user\>/.cache/\<app_name\>/log/\<app_name\>.log
|
/home/\<user\>/.cache/\<app_name\>/log/\<app_name\>.log
|
||||||
|
|
||||||
Windows:
|
Windows:
|
||||||
|
|
||||||
C:\\Users\\\<user>\\\<app_name\>\\Local\\\<app_name\>\\config.ini
|
C:\\Users\\\<user>\\\<app_name\>\\Local\\\<app_name\>\\config.ini
|
||||||
|
|
||||||
C:\\Users\\\<user>\\\<app_name\>\\Local\\\<app_name\>\\Logs\\\<app_name\>.log
|
C:\\Users\\\<user>\\\<app_name\>\\Local\\\<app_name\>\\Logs\\\<app_name\>.log
|
||||||
|
|
||||||
Application configuration can be overridden ad-hoc through the --config <filename>
|
Application configuration can be overridden ad-hoc through the --config <filename>
|
||||||
@ -61,6 +61,28 @@ Tests
|
|||||||
-----
|
-----
|
||||||
Tests are a WIP. Recommendation is to run 'pytest' in the 'tests' directory.
|
Tests are a WIP. Recommendation is to run 'pytest' in the 'tests' directory.
|
||||||
|
|
||||||
|
Development
|
||||||
|
-----------
|
||||||
|
Clone the repo:
|
||||||
|
```commandline
|
||||||
|
git clone https://git-mirror.zavage.net/zavage-software/app_skellington.git
|
||||||
|
```
|
||||||
|
|
||||||
|
Verify your desired python environment.
|
||||||
|
|
||||||
|
Poetry install to install dependencies and the program in your desired python environment
|
||||||
|
```commandline
|
||||||
|
poetry install
|
||||||
|
# verify no errors
|
||||||
|
```
|
||||||
|
|
||||||
|
Install pre-commit hooks:
|
||||||
|
```commandline
|
||||||
|
pre-commit install
|
||||||
|
```
|
||||||
|
|
||||||
|
Begin development.
|
||||||
|
|
||||||
License
|
License
|
||||||
-------
|
-------
|
||||||
I'm releasing this software under one of the most permissive
|
I'm releasing this software under one of the most permissive
|
||||||
@ -72,4 +94,3 @@ Notes
|
|||||||
-----
|
-----
|
||||||
See official website: https://zavage-software.com
|
See official website: https://zavage-software.com
|
||||||
Please report bugs, improvements, or feedback!
|
Please report bugs, improvements, or feedback!
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user