dovolopor
Project description
Python Package Template
📦 一个快速上传到 PyPI 的 Python Package 模版。
上传到 PyPI 后可以使用
pip install
安装。
1 使用方法
-
点击本项目右上角的绿色按钮
Use this template
(使用此模板),输入名称和说明,完成创建; -
将项目克隆到本地,这里以本项目为例,实际操作时这里需要替换你自己的项目;
git clone https://github.com/Ailln/python-package-template.git --depth 1
-
修改配置,文件中有提示;
cd python-package-template # 1. 将下文中的 your_package_name 改成你的实际项目名称 mv package_name your_package_name # 2. 接下来修改 `setup.py MANIFEST.in /package_name/shell/usage.py scripts/local_install.sh` 中的参数,里面有提示。 # 3. 最后 `README.md` 修改为你的项目介绍,也就是你当前在读的这个文本。
-
编写你的 Package 代码,并进行测试。
# 本地充分测试 bash scripts/local_test.sh
-
上传到 PyPi(需要注册),参考如何发布自己的包到 pypi;
bash scripts/upload_pypi.sh
-
更新到 Github。
git push
2 项目结构
.
├── README.md # 项目文档
├── package_name # 你需要手动修改为你的项目名称
│ ├── shell # 在命令行中执行的代码
│ │ ├── __init__.py
│ │ └── usage.py
│ ├── src # 静态资源
│ │ └── temp.txt
│ └── version.py # 版本号
├── scripts
│ ├── local_install.sh # 需要替换里面的 package_name
│ ├── local_test.sh
│ └── upload_pypi.sh
├── requirements.txt # 包依赖
├── .gitignore # git 忽略项
├── MANIFEST.in # 要包含在 sdist 命令构建的分发中的文件列表。
├── LICENSE # 这里面的内容为本项目的 License,你需要手动替换它。
└── setup.py # 安装配置
3 TODO
- 增加自动修改
package name
的脚本。 - 增加 test 相关代码。
4 许可
5 参考
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
dov-0.0.1.tar.gz
(4.2 kB
view hashes)
Built Distribution
dov-0.0.1-py3-none-any.whl
(4.7 kB
view hashes)