|
| 1 | +This project uses [pre-commit](https://pre-commit.com/) to perform some |
| 2 | +formatting and linting that hasn't made its way into CI/CD. If you're |
| 3 | +contributing to this project, make sure you set it up before you make the commit. |
| 4 | +You can also see |
| 5 | +[.pre-commit-config.yaml](https://github.com/Davidyz/VectorCode/blob/main/.pre-commit-config.yaml) |
| 6 | +for a list of hooks enabled for the repo. |
| 7 | + |
| 8 | +# Python CLI |
| 9 | + |
| 10 | +The development and publication of this tool is managed by |
| 11 | +[pdm](https://pdm-project.org/en/latest/). |
| 12 | + |
| 13 | +Once you've cloned and `cd`ed into the repo, run `make deps`. This will call |
| 14 | +some `pdm` commands to install development dependencies. Some of them are |
| 15 | +actually optional, but for convenience I decided to leave them here. This will |
| 16 | +include [pytest](https://docs.pytest.org/en/stable/), the testing framework, |
| 17 | +and [coverage.py](https://coverage.readthedocs.io/en/7.7.1/), the coverage |
| 18 | +report tool. If you're not familiar with pytest or coverage.py, you can run `make test` to |
| 19 | +run tests, and `make coverage` to generate a coverage report. The testing and |
| 20 | +coverage report are also in the CI configuration, but it might still help to run |
| 21 | +them locally before you open the PR. |
| 22 | + |
| 23 | +# Neovim Plugin |
| 24 | + |
| 25 | +At the moment, there isn't much to cover on here. As long as the code is |
| 26 | +formatted (stylua) and appropriately type-annotated, you're good. I do have |
| 27 | +plans to write some tests, but before that happens, formatting and type |
| 28 | +annotations are the only things that you need to take special care of. |
0 commit comments