<think>我们正在讨论如何在Python中声明和使用
私有库。参考引用[1]讨论了使用devpi搭建
私有pypi仓库，引用[2]讨论了Python中
私有变量的命名约定。然而，用户的问题是关于声明和使用
私有库（即
私有Python包），而不是变量。
在Python中，
私有库通常指的是不在公共PyPI上发布的库，而是放在
私有仓库（如devpi）中的库。因此，声明
一个私有库意味着将代码打包为可分发的格式（如wheel或sdist）并上传到
私有仓库，然后在其他项目中使用这个
私有库时，配置pip以从
私有仓库安装。
步骤概述：
1.
创建私有库项目：编写代码，并
创建setup.py（或setup.cfg，pyproject.toml）来定义包。
2. 打包项目：生成分发文件。
3. 上传
私有库到
私有仓库（如devpi）。
4. 在另
一个项目中使用：配置pip使用
私有仓库，然后使用pip安装
私有库。
详细步骤：
### 1.
创建私有库项目
假设我们有
一个名为`my_privatelib`的库，其目录结构如下：
```
my_privatelib/
├── setup.py
├── my_privatelib
│ ├── __init__.py
│ └── utils.py
```
在`setup.py`中定义包的基本信息：
```python
from setupt
ools import setup, find_packages
setup(
name='my_privatelib',
version='0.1.0',
packages=find_packages(),
# 其他元数据，如作者、描述等
)
```
### 2. 打包项目
生成分发文件（wheel和sdist）：
```bash
cd my_privatelib
python setup.py sdist bdist_wheel
```
这会在`dist/`目录下生成两个文件：`.tar.gz`和`.whl`。
### 3. 上传到
私有仓库
首先，确保你有
一个运行的
私有仓库（如devpi）。假设我们有
一个devpi服务器运行在`http://devpi.example.com`。
安装并配置devpi客户端：
```bash
pip install devpi-client
```
登录到devpi服务器（如果需要的话）：
```bash
devpi use http://devpi.example.com
devpi login <username> # 如果需要
```
上传包：
```bash
devpi upload
```
或者使用twine（另一种上传工具）：
```bash
pip install twine
twine upload --repository http://devpi.example.com dist/* --username <username> --password <password>
```
### 4. 在另
一个私有库中使用
假设我们有另
一个项目需要使用`my_privatelib`。
首先，配置pip使用
私有仓库。可以临时指定索引：
```bash
pip install --index-url http://devpi.example.com my_privatelib
```
或者在项目中
创建`requirements.txt`文件，指定索引和包：
```
--index-url http://devpi.example.com
my_privatelib==0.1.0
```
然后使用pip安装：
```bash
pip install -r requirements.txt
```
### 注意事项
-
私有仓库的访问可能需要身份验证，确保在URL中包含用户名和密码（如`http://username:password@devpi.example.com`）或使用安全的方式（如环境变量）传递凭证。
- 对于团队协作，确保所有成员都能访问
私有仓库。
### 关于
私有变量
引用[2]中提到，Python中通过命名约定（如单下划线`_var`）表示受保护的变量，双下划线`__var`表示
私有变量（会被名称改写）。但请注意，这仅适用于模块内部的变量和
类的成员变量，而不是整个库的可见性。整个库的
私有性是通过不在公共仓库发布并控制访问权限来实现的。
§§相关问题§§
1. 如何搭建
一个私有的PyPI仓库（如devpi）？
2. 除了devpi，还有哪些
私有PyPI仓库方案？
3. 如何将Python包打包并上传到PyPI（公共仓库）？
4. 在Python中，如何利用模块和包组织代码以实现代码复用？
</think>### 在Python中声明和使用
私有库的
方法
在Python中
创建私有库并在其他
私有库中使用，主要通过**
私有包管理工具**和**访问控制机制**实现，核心流程如下：
---
### 一、声明
私有库（
创建私有包）
#### 1. 项目结构
创建标准的Python包结构，使用下划线前缀表示内部
私有模块：
```
my_private_lib/
├── __init__.py
├── _internal_utils.py #
私有模块（单下划线约定）
└── public_api.py
```
#### 2. 访问控制
- **单下划线前缀** `_var`：约定为内部使用（非强制
私有）[^2]
- **双下划线前缀** `__var`：名称修饰（Name Mangling）实现强
私有
```python
# _internal_utils.py
__all__ = ['public_func'] # 限制导入范围
def public_func():
return _private_helper()
def _private_helper(): # 保护
方法（子
类可访问）
return __core_logic() # 强
私有方法
def __core_logic(): # 名称修饰为 _ClassName__core_logic
return "
私有核心逻辑"
```
#### 3. 打包配置（setup.py）
```python
from setupt
ools import setup
setup(
name="my_private_lib",
version="0.1",
packages=["my_private_lib"],
install_requires=["requests"],
# 关键配置：限制发布范围
classifiers=["Private :: Do Not Upload"]
)
```
---
### 二、在
私有仓库中部署
使用
私有PyPI仓库（如devpi）托管
私有库：
1. **构建包**：`python setup.py sdist bdist_wheel`
2. **上传到
私有仓库**：
```bash
devpi upload # 使用devpi客户端
# 或
twine upload --repository-url http://your-devpi-server dist/*
```
---
### 三、在其他
私有库中使用
#### 1. 配置
私有源
在项目中
创建`.pip/pip.conf`：
```ini
[global]
index-url = http://your-devpi-server/r
oot/public
extra-index-url = https://pypi.org/simple # 公共源后备
```
#### 2. 安装
私有库
```bash
pip install my_private_lib --extra-index-url http://your-devpi-server
```
#### 3. 导入使用
```python
from my_private_lib import public_func
from my_private_lib._internal_utils import _private_helper # 不推荐（破坏封装）
print(public_func()) # 正确访问公开API
```
---
### 关键注意事项
1. **访问控制优先级**：
- 单下划线 `_mod`：开发者自觉遵守约定
- 双下划线 `__var`：解释器强制名称修饰
- `__all__` 列表：控制`from module import *`的范围
2. **
私有仓库优势**（对比公共PyPI）：
- 内网安装速度提升 **50倍+**（100MB/s vs 2MB/s）[^1]
- 敏感代码不外泄
- 依赖版本可控
3. **安全加固**：
-
私有仓库启用HTTPS和Token认证
- 敏感模块添加运行时校验：
```python
if not __package__.startswith("internal_"):
raise RuntimeError("禁止外部使用")
```
---
扫一扫
16万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
