manim-plugintemplate 0.1.4

Installing Poetry

Poetry can be installed on Windows, MacOS and Linux. Please visit the official poetry website for installation instructions. You may want to see the official documentation for a list of all available commands.

Setting Up Your Plugin Directory Structure

To create a Python project suitable for poetry, run:

poetry new --src manim-YourPluginName

This will create the following project structure:

manim-YourPluginName
├── pyproject.toml
├── README.rst
├── src
│   └── manim_yourpluginname
│       └── __init__.py
└── tests
    ├── __init__.py
    └── test_manim_yourpluginname.py

If you have already extended manim’s functionality, you can instead run:

cd path/to/plugin
poetry init

This will prompt you for basic information regarding your plugin and help create and populate a pyproject.toml similar to the one in this template; however, you may wish to update your project directory structure similarly.

See the official documentation for more information on the init command.

From now on, when working on your plugin, ensure you are using the virtual environment by running the following at the root of your project:

poetry shell

Updating Pyproject.toml

The pyproject.toml file is used by Poetry and other build systems to manage and configure your project. Manim uses the package’s entry point metadata to discover available plugins. The entry point group, "manim.plugins", is REQUIRED and can be specified as follows:

[tool.poetry.plugins."manim.plugins"]
"manim_yourpluginname" = "module:object.attr"

Testing Your Plugin Locally

poetry install

This command will read the pyproject.toml, install the dependencies of your plugin, and create a poetry.lock file to ensure everyone using your plugin gets the same version of dependencies. It is important that your dependencies are properly annotated with a version constraint (e.g. manim:^0.1.1, numpy:*, etc…). Equally important to the dependencies specified here is that they do not directly conflict with Manim’s. If you want to update the dependencies specified in pyproject.toml, use:

poetry update

See the official documentation for more information on versioning or the install command.

Poetry allows for dependencies that are strictly for project developers. These are not installed by users. To add them to your project, update the pyproject.toml file with the section followed by the dependencies:

The pytest package is a functional testing framework which you can use to run the test within the manim-YourPluginName/tests directory. You should create files which test the behavior and functionality of your plugin here. Test first development is a good practice to ensure your code behaves as intended before packaging and shipping your code publicly. Additionally, you can create Manimations that depend on your plugin which is another great way to ensure functionality.