How can you help?#
Here is what you can do to help the project:
Use vsketch and let people know about it.
Give any type of feedback (what works well, missing features, possible API improvement, bugs, etc.) by opening an issue or contacting the author.
Contribute to the improvement of this documentation.
Contribute code via pull requests.
In case of doubt, let’s get the discussion started on the Drawingbots Discord server.
If you intend to modify vsketch (either for your own purpose or contribute improvements), you will need to properly setup a development environment. Vsketch uses Poetry for project management (see installation instructions). Then, run the following commands:
git clone https://github.com/abey79/vsketch
poetry install --with docs # installs everything needed including vsketch in editable mode
Poetry will automatically create a virtual environment. You can spawn a shell with the virtual environment activated with the following command:
You can run tests with the following command:
$ poetry run pytest
vsketch provides a
justfile for common operations. Just must be installed to use it.
The following command list the available recipes:
For example, you may build the documentation using this command:
Available recipes include:
just docs-build: build the documentation
just docs-clean: clean the documentations build file
just docs-live: run a live server for the documentation
just install: install a complete dev environment
just test: run all tests
just test-failed: run previously failed tests
just update-deps: update Poetry’s lockfile