manim-plugintemplate 0.1.3

Installing Poetry

Poetry can be installed on any OS that can has curl. Please visit the official poetry website for installation instructions.

Setting Up Your Plugin Directory Structure

To create a Python project suitable for poetry you may want to see the official documentation for a list of all available commands. In short, if you haven’t extended manim’s functionality yet, run:

poetry new --src manim-YourPluginName

Note: --src is both optional and recomended in order to create a src directory where all of your plugin code should live.

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.

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

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, "manim.plugins", is REQUIRED and can be specified as follows:

[tool.poetry.plugins."manim.plugins"]
"manim_yourpluginname" = "manim_yourpluginname"

This allows Manim to discover your plugin via manim plugin -u

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:1.19.2, etc…). Equally important to the dependencies specified here is that they do not conflict with manim’s.

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