Estou trabalhando com um conjunto de projetos Manim e minha árvore de diretórios de projetos se parece com isso:
- (dir)
ManimProjects
(diretório raiz)- (dir)
public
(contém bibliotecas compartilhadas por todos os projetos)- (arquivo)
public_mobjects.py
- (arquivo)
- (diretor)
Project1
- (arquivo)
scene.py
- (arquivo)
- (diretor)
Project2
- (arquivo)
scene.py
- (arquivo)
- (dir)
Então, por exemplo, em Project1
's scene.py
, eu gostaria de importar o public_mobjects
modelo, o que devo fazer?
Tentei usar from ..public.public_mobjects import ...
, que é a sintaxe padrão de importação relativa em Python, mas isso resulta em um erro:
Manim Community v0.19.0
Traceback (most recent call last):
File "<frozen runpy>", line 198, in _run_module_as_main
File "<frozen runpy>", line 88, in _run_code
File "<user-dir>\AppData\Local\Programs\Python\Python313\Scripts\manim.exe\__main__.py", line 7, in <module>
sys.exit(main())
~~~~^^
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\click\core.py", line 1161, in __call__
return self.main(*args, **kwargs)
~~~~~~~~~^^^^^^^^^^^^^^^^^
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\click\core.py", line 1082, in main
rv = self.invoke(ctx)
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\click\core.py", line 1697, in invoke
return _process_result(sub_ctx.command.invoke(sub_ctx))
~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\click\core.py", line 1443, in invoke
return ctx.invoke(self.callback, **ctx.params)
~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\click\core.py", line 788, in invoke
return __callback(*args, **kwargs)
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\manim\cli\render\commands.py", line 121, in render
for SceneClass in scene_classes_from_file(file):
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\manim\utils\module_ops.py", line 167, in scene_classes_from_file
module = get_module(file_path)
File "<user-dir>\AppData\Local\Programs\Python\Python313\Lib\site-packages\manim\utils\module_ops.py", line 67, in get_module
spec.loader.exec_module(module)
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^
File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "<outer-dir-of-manim-projects>\ManimProjects\CircleOfFifth\scene.manim.py", line 40, in <module>
from ..public.text_config import *
ModuleNotFoundError: No module named 'd:\\'
Eu sei que ao executar diretamente um arquivo de código python, quando a importação relativa é usada, eu preciso py -m ...
resolver importações relativas, mas o manim não executa um arquivo python diretamente. Então, qual é o método correto de fazer isso no Manim?
Atualmente programo com Manim no VSCode com o plugin "Manim Sideview". Minha versão Python é 3.13.1
e Manim version 0.19.0
.
Se você não quiser reestruturar seu projeto, ou editar
$PYTHONPATH
, ou editarsys.path
manualmente, ou editar__package__
, ou tentar adicionar,__init__.py
você pode tentar resolver o problema usando uma ferramenta destinada a resolver importações relativas.Aqui está uma dessas ferramentas
$ pip install importmonkey
e você pode fazer isso:Por que o problema ocorre
O problema acontece porque as importações relativas em Python dependem do
__package__
atributo, que normalmente é definido ao executar um módulo dentro de um pacote usandopython -m package.module
No entanto, o Manim executa scripts de forma diferente: ele os carrega dinamicamente via importlib, fazendo com que as importações relativas (de ..public import public_mobjects) falhem.Além disso, sys.path (que o Python usa para procurar módulos) não inclui automaticamente diretórios irmãos, o que significa que Project1/scene.py não pode importar naturalmente public/public_mobjects.py.
Como a solução funciona
A solução proposta evita modificar o sistema de importação padrão do Python (ou seja, nenhuma alteração no PYTHONPATH ou na estrutura do pacote). Em vez disso, ele adiciona diretórios dinamicamente ao caminho de importação do Python
Divulgação: sou o autor do importmonkey.