Skip to content

Commit d13a4cc

Browse files
committed
enhancement #30: update README
1 parent 7cc5a47 commit d13a4cc

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

README.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,20 @@ List of steps to follow to adapt the template to your project.
1313
2. Clone the new repo
1414
3. [Recommended] Make a virtual environment
1515
4. [Optional] Set up [git lfs](#git) and *.gitattributes*
16-
4. Activate pre-commit hook
16+
5. Activate [pre-commit hook](#git)
1717
```console
18-
mv scripts/git_hooks/pre-commit .git/hooks/
18+
./scripts/setup_git_hooks.sh
1919
```
20-
5. Install dev tools
20+
6. [Configure](#ide---linting) visual studio
21+
```console
22+
./scripts/setup_vscode_extensions.sh
23+
./scripts/setup_vscode_config.sh
24+
```
25+
7. Install dev tools
2126
```console
2227
pip install -e .[dev]
2328
```
24-
6. [Configure](#ide---linting) Visual Code with the linters
25-
7. [Adapt](#unit-tests-and-test-coverage) workflow and bagdes links to this repo
29+
8. [Adapt](#unit-tests-and-test-coverage) workflow and bagdes links to this repo
2630

2731

2832
## Configuration
@@ -59,11 +63,13 @@ A *.gitignore* file ensures that the Python temporary files are not committed. I
5963

6064
[git LFS](https://git-lfs.com/) can be configured to manage all non-script files (3D models, deep learning models, images, etc.). The list of files is defined in *gitattributes_example*. If you wish to utilize LFS, rename this file to *.gitattributes* and then run ```git lfs install```. It's also a good practice to maintain another repository as a submodule containing all the data.
6165

62-
A git hook can be set up to automatically check for PEP8 compliance before committing. Refer to *scripts/git_hooks*. Installing this is recommended as the GitHub workflows will perform the same checks.
66+
A git hook can be set up to automatically check for PEP8 compliance before committing. Refer to *scripts/git_hooks*. Installing this is recommended as the GitHub workflows will perform the same checks. The script *./scripts/setup_git_hooks.sh* will do this for you.
6367

6468

6569
### IDE - Linting
6670

71+
TL;DR Use *./scripts/setup_vscode_extensions.sh* and *./scripts/setup_vscode_config.sh*
72+
6773
Visual Studio Code is the recommended IDE. Ensure you have the Python extension installed and [configure](https://dev.to/adamlombard/how-to-use-the-black-python-code-formatter-in-vscode-3lo0) VS Code to auto-format your code using [black](https://black.readthedocs.io).
6874

6975
[isort](https://pycqa.github.io/isort/) verifies the order of Python imports. [Set up](https://github.com/microsoft/vscode-isort#import-sorting-on-save) VS Code to handle this automatically.
@@ -72,7 +78,7 @@ Visual Studio Code is the recommended IDE. Ensure you have the Python extension
7278

7379
Lastly, [mypy](https://mypy.readthedocs.io/en/stable/index.html) will perform static type checking. In this guide, it's set to run in **strict** mode. Feel free to [adjust the constraints](https://mypy.readthedocs.io/en/stable/getting_started.html?highlight=strict#strict-mode-and-configuration) if they don't align with your project's needs.
7480

75-
These tools are configured in the **setup.cfg** file. Their versions are predefined to prevent discrepancies between local and remote checks. It's advisable to keep them updated.
81+
These tools are configured in the **setup.cfg** and **pyproject.toml** files. Their versions are predefined to prevent discrepancies between local and remote checks. It's advisable to keep them updated.
7682

7783

7884
**A code not compliant with PEP8 guidelines will not be merged.**

0 commit comments

Comments
 (0)