编程 on ICE345のBLOG

python使用pip之setup.py编写

Tue, 04 Feb 2025 13:34:10 +0000

1. 基础结构
#

setup.py 是 Python 打包的核心配置文件，需使用 setuptools 库定义包的元数据和构建规则。

基本模板
#

from setuptools import setup, find_packages

setup(
 name="your-package-name", # 包名（PyPI唯一标识）
 version="0.1.0", # 版本号
 author="Your Name",
 author_email="your@email.com",
 description="Short description",
 long_description=open("README.md").read(), # 长描述（README内容）
 long_description_content_type="text/markdown", # README格式
 url="https://github.com/yourusername/your-package", # 项目地址
 packages=find_packages(), # 自动发现包目录
 install_requires=[], # 依赖库列表
 entry_points={}, # 命令行工具入口
 classifiers=[], # PyPI分类标签
 python_requires=">=3.6", # Python版本要求
)

2. 关键参数详解
#

(1) `name`
#

作用：包在 PyPI 上的唯一标识符。
规则：
- 必须全小写，可用连字符（-），如 my-package。
- 需在 PyPI 上未被占用（上传前检查）。

(2) `version`
#

作用：包的版本号，每次更新必须递增。
格式：推荐语义化版本（如 1.0.0, 0.2.5）。

(3) `packages`
#

自动发现：

packages=find_packages(), # 自动搜索所有含 __init__.py 的目录

手动指定：

packages=["my_package", "my_package.submodule"],

(4) `install_requires`
#

作用：定义包的依赖库及版本约束。

示例：

install_requires=[
 "requests>=2.25.1", # 最低版本
 "numpy<1.22,>=1.20", # 版本范围
 "pandas", # 不限制版本
]

(5) `entry_points`
#

作用：定义命令行工具入口，生成可执行命令。

示例：

entry_points={
 "console_scripts": [
 "my-command=my_package.module:main", # 格式：命令名=包.模块:函数
 ],
}

用户安装后可直接运行 my-command。

(6) `package_data`
#

作用：包含包内的非代码文件（如数据、配置文件）。

示例：

package_data={
 "my_package": ["data/*.csv", "templates/*.html"],
},

(7) `include_package_data`
#

作用：自动包含 MANIFEST.in 中指定的文件。

用法：

include_package_data=True, # 需配合 MANIFEST.in 文件

(8) `classifiers`
#

作用：为 PyPI 提供包的分类标签（便于搜索）。

常用选项：

classifiers=[
 "Programming Language :: Python :: 3",
 "License :: OSI Approved :: MIT License",
 "Operating System :: OS Independent",
 "Topic :: Software Development :: Libraries",
]

完整列表见：PyPI Classifiers

3. 完整示例
#

假设项目结构如下：

Java中有关包的相关配置以及介绍

Sat, 21 Sep 2024 16:15:08 +0000

下面是一个详细的教程，涵盖如何将多个 Java 文件组织成包、引入包以及如何打包成 JAR 文件的过程。

1. 创建 Java 包
#

1.1 目录结构
#

假设我们要创建一个名为 com.example.myapp 的包，目录结构如下：

javadoc生成注释文件

Fri, 20 Sep 2024 16:47:41 +0000

什么是 Javadoc？
#

Javadoc 是 Java 编程语言中用于生成 API 文档的工具。它通过解析源代码中的特殊注释，生成带有结构化文档的 HTML 文件，从而为类、方法、字段等生成说明文档。Javadoc 是 Java 编程中极为重要的文档生成工具，有助于开发者理解和使用代码。

java_command

Sat, 14 Sep 2024 16:34:47 +0000

在Java中，编译和运行程序涉及几个主要命令，包括 javac（编译器）、java（运行器）以及其他辅助命令。以下是最常用的Java编译和运行命令：

java_lib常见error

Sat, 14 Sep 2024 16:33:54 +0000

笔记

在 javac 编译和使用 java 运行时自动添加库，使用–module-path 添加库路径，使用–module-add 添加库

java_set

Sat, 14 Sep 2024 16:31:40 +0000

在Windows上配置Java环境以便能够编译和运行Java源程序涉及三个主要步骤：安装JDK、配置环境变量（包括JAVA_HOME、PATH和CLASSPATH），以及设置CLASSPATH以便程序能够找到所需的库文件。以下是详细步骤：

二村映射

Sat, 07 Sep 2024 11:25:58 +0000

Futamura 投影（Futamura Projection）是编程语言和编译技术中的一个重要概念，由日本计算机科学家 Futamura Yoshihiko 在 1971 年提出。Futamura 投影解释了如何通过对解释器进行部分求值（Partial Evaluation），将解释器转换为编译器，以及进一步的可能转变。

gcc介绍

Sat, 07 Sep 2024 11:21:43 +0000

编译系统（过程）
#

编译过程是将源代码转换成可执行文件的几个步骤的集合。每一步生成不同类型的文件，这些文件在最终的可执行程序中扮演不同的角色。以下是详细的步骤以及每个阶段产生的文件的作用：

编程 on ICE345のBLOG

python使用pip之setup.py编写

1. 基础结构 #

基本模板 #

2. 关键参数详解 #

(1) name #

(2) version #

(3) packages #

(4) install_requires #

(5) entry_points #

(6) package_data #

(7) include_package_data #

(8) classifiers #

3. 完整示例 #

Java中有关包的相关配置以及介绍

1. 创建 Java 包 #

1.1 目录结构 #

javadoc生成注释文件

什么是 Javadoc？ #

java_command

java_lib常见error

java_set

二村映射

gcc介绍

编译系统（过程） #

1. 基础结构
#

基本模板
#

2. 关键参数详解
#

(1) `name`
#

(2) `version`
#

(3) `packages`
#

(4) `install_requires`
#

(5) `entry_points`
#

(6) `package_data`
#

(7) `include_package_data`
#

(8) `classifiers`
#

3. 完整示例
#

1. 创建 Java 包
#

1.1 目录结构
#

什么是 Javadoc？
#

编译系统（过程）
#