doc: dev instructions for README.md

This commit is contained in:
Mathew Guest 2024-08-02 05:00:58 -06:00
parent 9a1999b8ab
commit cb083cd38e

@ -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!