manim 0.18.0.post0__tar.gz → 0.19.0__tar.gz

{manim-0.18.0.post0 → manim-0.19.0}/LICENSE.community

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021, the Manim Community Developers
+Copyright (c) 2024, the Manim Community Developers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{manim-0.18.0.post0 → manim-0.19.0}/PKG-INFO

@@ -1,63 +1,62 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: manim
-Version: 0.18.0.post0
+Version: 0.19.0
 Summary: Animation engine for explanatory math videos.
-Home-page: https://www.manim.community/
 License: MIT
 Author: The Manim Community Developers
 Author-email: contact@manim.community
-Requires-Python: >=3.8,<3.13
+Requires-Python: >=3.9
 Classifier: Development Status :: 4 - Beta
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Graphics
 Classifier: Topic :: Multimedia :: Video
 Classifier: Topic :: Scientific/Engineering
 Provides-Extra: gui
 Provides-Extra: jupyterlab
-Requires-Dist: Pillow (>=9.1,<10.0)
-Requires-Dist: Pygments (>=2.10.0,<3.0.0)
-Requires-Dist: backports.cached-property (>=1.0.1,<2.0.0) ; python_version < "3.8"
-Requires-Dist: click (>=7.2,<=9.0)
-Requires-Dist: click-default-group (>=1.2.2,<2.0.0)
-Requires-Dist: cloup (>=0.13,<2.2)
-Requires-Dist: dearpygui (>=1.3.1,<2.0.0) ; extra == "gui"
-Requires-Dist: decorator (>=5.0.7,<6.0.0)
-Requires-Dist: importlib-metadata (>=4.10.0,<5.0.0) ; python_version < "3.8"
-Requires-Dist: isosurfaces (==0.1.0)
-Requires-Dist: jupyterlab (>=3.0,<4.0) ; extra == "jupyterlab"
+Requires-Dist: Pillow (>=9.1)
+Requires-Dist: Pygments (>=2.0.0)
+Requires-Dist: audioop-lts (>=0.2.0) ; python_version >= "3.13"
+Requires-Dist: av (>=9.0.0,<14.0.0)
+Requires-Dist: beautifulsoup4 (>=4.12)
+Requires-Dist: click (>=8.0)
+Requires-Dist: cloup (>=2.0.0)
+Requires-Dist: dearpygui (>=1.0.0) ; extra == "gui"
+Requires-Dist: decorator (>=4.3.2)
+Requires-Dist: importlib-metadata (>=3.6) ; python_full_version <= "3.9.0"
+Requires-Dist: isosurfaces (>=0.1.0)
+Requires-Dist: jupyterlab (>=3.0.0) ; extra == "jupyterlab"
 Requires-Dist: manimpango (>=0.5.0,<1.0.0)
-Requires-Dist: mapbox-earcut (>=1.0.0,<2.0.0)
-Requires-Dist: moderngl (>=5.6.3,<6.0.0)
-Requires-Dist: moderngl-window (>=2.3.0,<3.0.0)
-Requires-Dist: networkx (>=2.5,<3.3)
-Requires-Dist: notebook (>=6.4,<7.0) ; extra == "jupyterlab"
-Requires-Dist: numpy (>=1.22,<2.0) ; python_version < "3.12"
-Requires-Dist: numpy (>=1.26,<2.0) ; python_version >= "3.12"
-Requires-Dist: pycairo (>=1.21,<2.0)
-Requires-Dist: pydub (>=0.25.1,<0.26.0)
-Requires-Dist: requests (>=2.26.0,<3.0.0)
-Requires-Dist: rich (>=6.0,!=12.0.0)
-Requires-Dist: scipy (>=1.11,<2.0) ; python_version >= "3.12"
-Requires-Dist: scipy (>=1.7.3,<2.0.0) ; python_version < "3.12"
-Requires-Dist: screeninfo (>=0.8,<0.9)
-Requires-Dist: skia-pathops (>=0.7.0,<0.8.0) ; python_version < "3.12"
-Requires-Dist: skia-pathops (>=0.8.0.post1,<0.9.0) ; python_version >= "3.12"
-Requires-Dist: srt (>=3.5.0,<4.0.0)
-Requires-Dist: svgelements (>=1.8.0,<2.0.0)
-Requires-Dist: tqdm (>=4.62.3,<5.0.0)
-Requires-Dist: typing-extensions (>=4.7.1,<5.0.0)
-Requires-Dist: watchdog (>=2.1,<=3.0.0)
+Requires-Dist: mapbox-earcut (>=1.0.0)
+Requires-Dist: moderngl (>=5.0.0,<6.0.0)
+Requires-Dist: moderngl-window (>=2.0.0)
+Requires-Dist: networkx (>=2.6)
+Requires-Dist: notebook (>=6.0.0) ; extra == "jupyterlab"
+Requires-Dist: numpy (>=2.0) ; python_version < "3.10"
+Requires-Dist: numpy (>=2.1) ; python_version >= "3.10"
+Requires-Dist: pycairo (>=1.13,<2.0.0)
+Requires-Dist: pydub (>=0.20.0)
+Requires-Dist: rich (>=12.0.0)
+Requires-Dist: scipy (>=1.13.0) ; python_version < "3.13"
+Requires-Dist: scipy (>=1.14.0) ; python_version >= "3.13"
+Requires-Dist: screeninfo (>=0.7)
+Requires-Dist: skia-pathops (>=0.7.0)
+Requires-Dist: srt (>=3.0.0)
+Requires-Dist: svgelements (>=1.8.0)
+Requires-Dist: tqdm (>=4.0.0)
+Requires-Dist: typing-extensions (>=4.0.0)
+Requires-Dist: watchdog (>=2.0.0)
 Project-URL: Bug Tracker, https://github.com/ManimCommunity/manim/issues
 Project-URL: Changelog, https://docs.manim.community/en/stable/changelog.html
 Project-URL: Documentation, https://docs.manim.community/
 Project-URL: Discord, https://www.manim.community/discord/
+Project-URL: Homepage, https://www.manim.community/
 Project-URL: Repository, https://github.com/manimcommunity/manim
 Project-URL: Twitter, https://twitter.com/manim_community
 Description-Content-Type: text/markdown
@@ -85,7 +84,8 @@ Description-Content-Type: text/markdown
 
 Manim is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as demonstrated in the videos of [3Blue1Brown](https://www.3blue1brown.com/).
 
-> NOTE: This repository is maintained by the Manim Community and is not associated with Grant Sanderson or 3Blue1Brown in any way (although we are definitely indebted to him for providing his work to the world). If you would like to study how Grant makes his videos, head over to his repository ([3b1b/manim](https://github.com/3b1b/manim)). This fork is updated more frequently than his, and it's recommended to use this fork if you'd like to use Manim for your own projects.
+> [!NOTE]
+> The community edition of Manim has been forked from 3b1b/manim, a tool originally created and open-sourced by Grant Sanderson, also creator of the 3Blue1Brown educational math videos. While Grant Sanderson’s repository continues to be maintained separately by him, he is not among the maintainers of the community edition. We recommend this version for its continued development, improved features, enhanced documentation, and more active community-driven maintenance. If you would like to study how Grant makes his videos, head over to his repository ([3b1b/manim](https://github.com/3b1b/manim)).
 
 ## Table of Contents:
 
@@ -99,7 +99,8 @@ Manim is an animation engine for explanatory math videos. It's used to create pr
 
 ## Installation
 
-> **WARNING:** These instructions are for the community version _only_. Trying to use these instructions to install [3b1b/manim](https://github.com/3b1b/manim) or instructions there to install this version will cause problems. Read [this](https://docs.manim.community/en/stable/faq/installation.html#why-are-there-different-versions-of-manim) and decide which version you wish to install, then only follow the instructions for your desired version.
+> [!CAUTION]
+> These instructions are for the community version _only_. Trying to use these instructions to install [3b1b/manim](https://github.com/3b1b/manim) or instructions there to install this version will cause problems. Read [this](https://docs.manim.community/en/stable/faq/installation.html#why-are-there-different-versions-of-manim) and decide which version you wish to install, then only follow the instructions for your desired version.
 
 Manim requires a few dependencies that must be installed prior to using it. If you
 want to try it out first before installing it locally, you can do so

{manim-0.18.0.post0 → manim-0.19.0}/README.md

@@ -21,7 +21,8 @@
 
 Manim is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as demonstrated in the videos of [3Blue1Brown](https://www.3blue1brown.com/).
 
-> NOTE: This repository is maintained by the Manim Community and is not associated with Grant Sanderson or 3Blue1Brown in any way (although we are definitely indebted to him for providing his work to the world). If you would like to study how Grant makes his videos, head over to his repository ([3b1b/manim](https://github.com/3b1b/manim)). This fork is updated more frequently than his, and it's recommended to use this fork if you'd like to use Manim for your own projects.
+> [!NOTE]
+> The community edition of Manim has been forked from 3b1b/manim, a tool originally created and open-sourced by Grant Sanderson, also creator of the 3Blue1Brown educational math videos. While Grant Sanderson’s repository continues to be maintained separately by him, he is not among the maintainers of the community edition. We recommend this version for its continued development, improved features, enhanced documentation, and more active community-driven maintenance. If you would like to study how Grant makes his videos, head over to his repository ([3b1b/manim](https://github.com/3b1b/manim)).
 
 ## Table of Contents:
 
@@ -35,7 +36,8 @@ Manim is an animation engine for explanatory math videos. It's used to create pr
 
 ## Installation
 
-> **WARNING:** These instructions are for the community version _only_. Trying to use these instructions to install [3b1b/manim](https://github.com/3b1b/manim) or instructions there to install this version will cause problems. Read [this](https://docs.manim.community/en/stable/faq/installation.html#why-are-there-different-versions-of-manim) and decide which version you wish to install, then only follow the instructions for your desired version.
+> [!CAUTION]
+> These instructions are for the community version _only_. Trying to use these instructions to install [3b1b/manim](https://github.com/3b1b/manim) or instructions there to install this version will cause problems. Read [this](https://docs.manim.community/en/stable/faq/installation.html#why-are-there-different-versions-of-manim) and decide which version you wish to install, then only follow the instructions for your desired version.
 
 Manim requires a few dependencies that must be installed prior to using it. If you
 want to try it out first before installing it locally, you can do so

{manim-0.18.0.post0 → manim-0.19.0}/manim/__init__.py

@@ -1,14 +1,10 @@
 #!/usr/bin/env python
-
-
 from __future__ import annotations
 
-import pkg_resources
-
-__version__: str = pkg_resources.get_distribution(__name__).version
+from importlib.metadata import version
 
+__version__ = version(__name__)
 
-import sys
 
 # isort: off
 
@@ -20,6 +16,7 @@ from ._config import *
 from .utils.commands import *
 
 # isort: on
+import numpy as np
 
 from .animation.animation import *
 from .animation.changing import *

manim-0.19.0/manim/__main__.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+import click
+import cloup
+
+from manim import __version__
+from manim._config import cli_ctx_settings, console
+from manim.cli.cfg.group import cfg
+from manim.cli.checkhealth.commands import checkhealth
+from manim.cli.default_group import DefaultGroup
+from manim.cli.init.commands import init
+from manim.cli.plugins.commands import plugins
+from manim.cli.render.commands import render
+from manim.constants import EPILOG
+
+
+def show_splash(ctx: click.Context, param: click.Option, value: str | None) -> None:
+    """When giving a value by console, show an initial message with the Manim
+    version before executing any other command: ``Manim Community vA.B.C``.
+
+    Parameters
+    ----------
+    ctx
+        The Click context.
+    param
+        A Click option.
+    value
+        A string value given by console, or None.
+    """
+    if value:
+        console.print(f"Manim Community [green]v{__version__}[/green]\n")
+
+
+def print_version_and_exit(
+    ctx: click.Context, param: click.Option, value: str | None
+) -> None:
+    """Same as :func:`show_splash`, but also exit when giving a value by
+    console.
+
+    Parameters
+    ----------
+    ctx
+        The Click context.
+    param
+        A Click option.
+    value
+        A string value given by console, or None.
+    """
+    show_splash(ctx, param, value)
+    if value:
+        ctx.exit()
+
+
+@cloup.group(
+    context_settings=cli_ctx_settings,
+    cls=DefaultGroup,
+    default="render",
+    no_args_is_help=True,
+    help="Animation engine for explanatory math videos.",
+    epilog="See 'manim <command>' to read about a specific subcommand.\n\n"
+    "Note: the subcommand 'manim render' is called if no other subcommand "
+    "is specified. Run 'manim render --help' if you would like to know what the "
+    f"'-ql' or '-p' flags do, for example.\n\n{EPILOG}",
+)
+@cloup.option(
+    "--version",
+    is_flag=True,
+    help="Show version and exit.",
+    callback=print_version_and_exit,
+    is_eager=True,
+    expose_value=False,
+)
+@click.option(
+    "--show-splash/--hide-splash",
+    is_flag=True,
+    default=True,
+    help="Print splash message with version information.",
+    callback=show_splash,
+    is_eager=True,
+    expose_value=False,
+)
+@cloup.pass_context
+def main(ctx: click.Context) -> None:
+    """The entry point for Manim.
+
+    Parameters
+    ----------
+    ctx
+        The Click context.
+    """
+    pass
+
+
+main.add_command(checkhealth)
+main.add_command(cfg)
+main.add_command(plugins)
+main.add_command(init)
+main.add_command(render)
+
+if __name__ == "__main__":
+    main()

{manim-0.18.0.post0 → manim-0.19.0}/manim/_config/__init__.py

@@ -3,7 +3,9 @@
 from __future__ import annotations
 
 import logging
-from contextlib import _GeneratorContextManager, contextmanager
+from collections.abc import Generator
+from contextlib import contextmanager
+from typing import Any
 
 from .cli_colors import parse_cli_ctx
 from .logger_utils import make_logger
@@ -35,12 +37,14 @@ logging.getLogger("PIL").setLevel(logging.INFO)
 logging.getLogger("matplotlib").setLevel(logging.INFO)
 
 config = ManimConfig().digest_parser(parser)
+# TODO: to be used in the future - see PR #620
+# https://github.com/ManimCommunity/manim/pull/620
 frame = ManimFrame(config)
 
 
 # This has to go here because it needs access to this module's config
 @contextmanager
-def tempconfig(temp: ManimConfig | dict) -> _GeneratorContextManager:
+def tempconfig(temp: ManimConfig | dict[str, Any]) -> Generator[None, None, None]:
     """Context manager that temporarily modifies the global ``config`` object.
 
     Inside the ``with`` statement, the modified config will be used.  After
@@ -64,7 +68,6 @@ def tempconfig(temp: ManimConfig | dict) -> _GeneratorContextManager:
        8.0
        >>> with tempconfig({"frame_height": 100.0}):
        ...     print(config["frame_height"])
-       ...
        100.0
        >>> config["frame_height"]
        8.0

{manim-0.18.0.post0 → manim-0.19.0}/manim/_config/cli_colors.py

@@ -1,10 +1,15 @@
+from __future__ import annotations
+
 import configparser
+from typing import Any
 
 from cloup import Context, HelpFormatter, HelpTheme, Style
 
+__all__ = ["parse_cli_ctx"]
+
 
-def parse_cli_ctx(parser: configparser.ConfigParser) -> Context:
-    formatter_settings = {
+def parse_cli_ctx(parser: configparser.SectionProxy) -> dict[str, Any]:
+    formatter_settings: dict[str, str | int] = {
         "indent_increment": int(parser["indent_increment"]),
         "width": int(parser["width"]),
         "col1_max_width": int(parser["col1_max_width"]),
@@ -30,16 +35,19 @@ def parse_cli_ctx(parser: configparser.ConfigParser) -> Context:
     formatter = {}
     theme = parser["theme"] if parser["theme"] else None
     if theme is None:
-        formatter = HelpFormatter().settings(
-            theme=HelpTheme(**theme_settings), **formatter_settings
+        formatter = HelpFormatter.settings(
+            theme=HelpTheme(**theme_settings),
+            **formatter_settings,  # type: ignore[arg-type]
         )
     elif theme.lower() == "dark":
-        formatter = HelpFormatter().settings(
-            theme=HelpTheme.dark().with_(**theme_settings), **formatter_settings
+        formatter = HelpFormatter.settings(
+            theme=HelpTheme.dark().with_(**theme_settings),
+            **formatter_settings,  # type: ignore[arg-type]
         )
     elif theme.lower() == "light":
-        formatter = HelpFormatter().settings(
-            theme=HelpTheme.light().with_(**theme_settings), **formatter_settings
+        formatter = HelpFormatter.settings(
+            theme=HelpTheme.light().with_(**theme_settings),
+            **formatter_settings,  # type: ignore[arg-type]
         )
 
     return Context.settings(

{manim-0.18.0.post0 → manim-0.19.0}/manim/_config/default.cfg

@@ -221,9 +221,7 @@ repr_number = green
 # Uncomment the following line to manually set the loglevel for ffmpeg. See
 # ffmpeg manpage for accepted values
 loglevel = ERROR
-# defaults to the one present in path
-ffmpeg_executable = ffmpeg
 
 [jupyter]
-media_embed =
+media_embed = False
 media_width = 60%%

{manim-0.18.0.post0 → manim-0.19.0}/manim/_config/logger_utils.py

@@ -9,13 +9,13 @@ Both ``logger`` and ``console`` use the ``rich`` library to produce rich text
 format.
 
 """
+
 from __future__ import annotations
 
 import configparser
 import copy
 import json
 import logging
-import sys
 from typing import TYPE_CHECKING
 
 from rich import color, errors
@@ -27,6 +27,8 @@ from rich.theme import Theme
 if TYPE_CHECKING:
     from pathlib import Path
 
+__all__ = ["make_logger", "parse_theme", "set_file_logger", "JSONFormatter"]
+
 HIGHLIGHTED_KEYWORDS = [  # these keywords are highlighted specially
     "Played",
     "animations",
@@ -50,9 +52,9 @@ Loading the default color configuration.[/logging.level.error]
 
 
 def make_logger(
-    parser: configparser.ConfigParser,
+    parser: configparser.SectionProxy,
     verbosity: str,
-) -> tuple[logging.Logger, Console]:
+) -> tuple[logging.Logger, Console, Console]:
     """Make the manim logger and console.
 
     Parameters
@@ -84,25 +86,29 @@ def make_logger(
     theme = parse_theme(parser)
     console = Console(theme=theme)
 
-    # With rich 9.5.0+ we could pass stderr=True instead
-    error_console = Console(theme=theme, file=sys.stderr)
+    error_console = Console(theme=theme, stderr=True)
 
     # set the rich handler
-    RichHandler.KEYWORDS = HIGHLIGHTED_KEYWORDS
     rich_handler = RichHandler(
         console=console,
         show_time=parser.getboolean("log_timestamps"),
+        keywords=HIGHLIGHTED_KEYWORDS,
     )
 
     # finally, the logger
     logger = logging.getLogger("manim")
     logger.addHandler(rich_handler)
     logger.setLevel(verbosity)
+    logger.propagate = False
+
+    if not (libav_logger := logging.getLogger()).hasHandlers():
+        libav_logger.addHandler(rich_handler)
+        libav_logger.setLevel(verbosity)
 
     return logger, console, error_console
 
 
-def parse_theme(parser: configparser.ConfigParser) -> Theme:
+def parse_theme(parser: configparser.SectionProxy) -> Theme:
     """Configure the rich style of logger and console output.
 
     Parameters
@@ -178,7 +184,7 @@ class JSONFormatter(logging.Formatter):
 
     """
 
-    def format(self, record: dict) -> str:
+    def format(self, record: logging.LogRecord) -> str:
         """Format the record in a custom JSON format."""
         record_c = copy.deepcopy(record)
         if record_c.args: