打包包含隐藏文件夹的python项目

基础概念

打包包含隐藏文件夹的Python项目通常指的是将一个Python项目及其所有依赖项（包括隐藏文件夹中的文件）打包成一个可分发的格式，如压缩包或安装包。隐藏文件夹通常是指以.开头的文件夹，在Unix-like系统中这些文件夹默认是隐藏的。

类型

源码包：包含项目的所有源代码文件。
二进制包：包含编译后的可执行文件，适用于不需要源码的场景。
虚拟环境包：包含一个独立的Python虚拟环境，以及项目所需的所有依赖项。

应用场景

当你需要将你的Python项目分享给他人时。
当你需要在不同的计算机或服务器上部署你的项目时。
当你希望确保项目的依赖项和环境配置不会因环境差异而出现问题时。

遇到的问题及解决方法

问题：打包过程中隐藏文件夹未被包含

原因：打包工具可能默认不包含隐藏文件夹，或者在指定打包路径时未正确包含这些文件夹。

解决方法：

使用tar命令打包时，可以通过--exclude参数排除不需要打包的文件，但要注意不要误排除了隐藏文件夹。如果需要包含隐藏文件夹，可以直接在命令中指定：

tar -czvf project.tar.gz . --exclude-vcs

这里的.表示当前目录，--exclude-vcs是一个常用的排除版本控制系统（如git）文件的选项。

使用Python的setuptools打包时，可以在setup.py文件中使用package_data参数来包含隐藏文件夹中的数据文件：

from setuptools import setup, find_packages

setup(
    name='your_project_name',
    version='0.1',
    packages=find_packages(),
    package_data={
        '': ['.*'],  # 包含所有隐藏文件
    },
)

然后运行以下命令进行打包：

python setup.py sdist bdist_wheel

示例代码

假设你的项目结构如下：

my_project/
├── .hidden_folder/
│   └── secret.txt
├── src/
│   └── main.py
└── setup.py

在setup.py中添加以下内容：

from setuptools import setup, find_packages

setup(
    name='my_project',
    version='0.1',
    packages=find_packages(where='src'),
    package_dir={'': 'src'},
    package_data={
        '': ['.*'],  # 包含所有隐藏文件
    },
)

然后执行打包命令：