console_scripts执行时的ModuleNotFoundError

时间:2017-03-20 18:33:18

标签: python-3.x setuptools

发生了什么

我有一个用Python 3(Python 3.6.0解释器)编写的简单CLI项目,我可以直接从命令行使用包和模块名运行,但在安装setuptools时失败:

# success
❯ python -m myProject.cli --version
0.0.1.dev0
# failure
❯ mycli --version
Traceback (most recent call last):
  File "/path/myProject/venv/bin/mycli", line 11, in <module>
    load_entry_point('myProject==0.0.1.dev0', 'console_scripts', 'mycli')()
  File "/path/myProject/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 560, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)
  File "/path/myProject/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2648, in load_entry_point
    return ep.load()
  File "/path/myProject/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2302, in load
    return self.resolve()
  File "/path/myProject/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2308, in resolve
    module = __import__(self.module_name, fromlist=['__name__'], level=0)
ModuleNotFoundError: No module named 'myProject'

项目设置

该项目具有以下结构:

.
├── myProject
│   └── cli.py
└── setup.py

我希望稍后可以将脚本安装为mycli,因此我的setup.py看起来像这样:

from setuptools import setup, find_packages

from myProject.cli import __version__

setup(

    # Package info
    name = 'myProject',
    version = __version__,
    packages = find_packages(),

    # Dependencies
    install_requires = [
        'docopt>=0.6.2'
    ],

    # Script info
    entry_points = {
        'console_scripts': [
            'mycli = myProject.cli:main'
        ]
    }
)

安装

安装完成且没有错误:

❯ python setup.py install
running install
running bdist_egg
running egg_info
writing myProject.egg-info/PKG-INFO
writing dependency_links to myProject.egg-info/dependency_links.txt
writing entry points to myProject.egg-info/entry_points.txt
writing requirements to myProject.egg-info/requires.txt
writing top-level names to myProject.egg-info/top_level.txt
reading manifest file 'myProject.egg-info/SOURCES.txt'
writing manifest file 'myProject.egg-info/SOURCES.txt'
installing library code to build/bdist.macosx-10.12-x86_64/egg
running install_lib
warning: install_lib: 'build/lib' does not exist -- no Python modules to install

creating build/bdist.macosx-10.12-x86_64/egg
creating build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/PKG-INFO -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/SOURCES.txt -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/dependency_links.txt -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/entry_points.txt -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/requires.txt -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
copying myProject.egg-info/top_level.txt -> build/bdist.macosx-10.12-x86_64/egg/EGG-INFO
zip_safe flag not set; analyzing archive contents...
creating 'dist/myProject-0.0.1.dev0-py3.6.egg' and adding 'build/bdist.macosx-10.12-x86_64/egg' to it
removing 'build/bdist.macosx-10.12-x86_64/egg' (and everything under it)
Processing myProject-0.0.1.dev0-py3.6.egg
Removing /path/myProject/venv/lib/python3.6/site-packages/myProject-0.0.1.dev0-py3.6.egg
Copying myProject-0.0.1.dev0-py3.6.egg to /path/myProject/venv/lib/python3.6/site-packages
myProject 0.0.1.dev0 is already the active version in easy-install.pth
Installing mycli script to /path/myProject/venv/bin

Installed /path/myProject/venv/lib/python3.6/site-packages/myProject-0.0.1.dev0-py3.6.egg
Processing dependencies for myProject==0.0.1.dev0
Searching for docopt==0.6.2
Best match: docopt 0.6.2
Adding docopt 0.6.2 to easy-install.pth file

Using /path/myProject/venv/lib/python3.6/site-packages
Finished processing dependencies for myProject==0.0.1.dev0

pip show也向我展示了预期结果:

❯ pip show myProject
Name: myProject
Version: 0.0.1.dev0
Location: /path/myProject/venv/lib/python3.6/site-packages/myProject-0.0.1.dev0-py3.6.egg
Requires: docopt

然而,当我执行ModuleNotFoundError: No module named 'myProject'时,总会弹出mycli错误。

我非常感谢任何指针。

1 个答案:

答案 0 :(得分:2)

我找到了解决问题的方法,我认为这是对PEP 420 -- Implicit Namespace Packages的误解。

此页面说明了,因为Python 3.3:

  

在寻找名为&#34; foo&#34; 的模块或包时,对于父路径中的每个目录:

     
      
  • 如果找到&lt; directory&gt; / foo / __ init __。py ,则会导入并返回常规包。
  •   
  • 如果没有,但找到&lt; directory&gt; / foo 并且是一个目录,则会记录该目录并继续扫描父路径中的下一个目录。
  •   
     

如果扫描完成而未返回模块或包,并且至少记录了一个目录,则创建命名空间包。新的命名空间包:

     
      
  • 将__path__属性设置为扫描期间找到并记录的路径字符串的可迭代内容。
  •   
  • 没有__file__属性。
  •   

pkg_resources documentation

中所定义
  

命名空间包是一个只包含其他包和模块的包,没有自己的直接内容。

正如我所描述的那样,我的包裹属于那个类别,而这个类别并非如此。

__init.py__目录下添加空myProject/后,我在install步骤中看到了这种情况:

❯ python setup.py build    
running build
running build_py
creating build/lib
creating build/lib/myProject
copying myProject/__init__.py -> build/lib/myProject
copying myProject/cli.py -> build/lib/myProject

在:

>>> myProject.__path__
_NamespacePath(['/path/myProject'])
>>> myProject.__file__
AttributeError: module 'myProject' has no attribute '__file__'

后:

>>> myProject.__path__
['/path/myProject']
>>> myProject.__file__
'/path/myProject/__init__.py'