d5d1513d94
* test: re-add opencv-python * chore(dev): move to Rye instead of PDM * try fix * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * fix: build backend * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * fix: string quotes? * small fixes * upgrade typing * fix(ci): rye install on Windows * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * fix(ci): typos * fix * fix(ci): actually use right python version * fix(deps): manimgl * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * fix docs * another fix * cleanup * make sure to use trusted publisher * chore(docs): remove PDM --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2.5 KiB
Workflow
This document is there to help you recreate a working environment for Manim Slides.
Dependencies
:start-after: <!-- start deps -->
:end-before: <!-- end deps -->
Forking the repository and cloning it locally
We use GitHub to host Manim Slides' repository, and we encourage contributors to use git.
Useful links:
Once you feel comfortable with git and GitHub, fork the repository, and clone it locally.
As for every Python project, using virtual environment is recommended to avoid conflicts between modules. For this project, we use Rye to easily manage project and development dependencies. If not already, please install this tool.
Installing Python modules
With Rye, installation becomes straightforward:
rye sync --all-features
Running commands
Because modules are installed in a new Python environment,
you cannot use them directly in the shell.
Instead, you either need to prepend rye run to any command, e.g.:
rye run manim-slides wizard
Testing your code
Most of the tests are done with GitHub actions, thus not on your computer. The only command you should run locally is:
rye run pre-commit run --all-files
This runs a few linter and formatter to make sure the code quality and style stay constant across time. If a warning or an error is displayed, please fix it before going to next step.
For testing your code, simply run:
rye run pytest
Building the documentation
The documentation is generated using Sphinx, based on the content
in docs/source and in the manim_slides Python package.
To generate the documentation, run the following:
cd docs
rye run make html
Then, the output index file is located at docs/build/html/index.html and
can be opened with any modern browser.
:::{warning} Building the documentation can take quite some time, especially the first time as it needs to render all the animations.
Further builds should run faster. :::
Proposing changes
Once you feel ready and think your contribution is ready to be reviewed, create a pull request and wait for a reviewer to check your work!
Many thanks to you!