PIP是Python用于管理第三方库的管理工具。 类似于Ruby的Gem和Lua的Luarcoks管理工具。日常工作中,会写一些Python语言的公共的模块,这些模块可以复用,被第三方软件人员使用。为了便于这些库代码的传播,我们可以将Python写的库上传到pipy.org网站上。然后,第三方的软件人员,可以通过Pip软件检索到这些库文件,并进行下载安装。以移值的Pygraylog库的结构为例。上传主要文件,要遵循一定的的目录规范和操作,流程,我们拉下来介绍规上传的目录结构,操作流程中设置到的命令执行动作。

1.目录结构

用Tree命令,展开上传的库文件的目录。 dist文件夹:.tar.gz文件,既是第通过Pipg下载的主要安装文件包。 requreiments.txt:是这个当前的Python第三方库,需要依赖的别的Python库。 setup.py:安装库使用的安装脚本。


└─$ tree
.
├── dist
│   └── py3graylog-0.1.0.tar.gz
├── __init__.py
├── LICENSE
├── MANIFEST
├── py3graylog
│   ├── endpoints.py
│   ├── graylogapi.py
│   └── __init__.py
├── README.md
├── requirements.txt
├── setup.py
└── test

2.配置文件

配置文件是告知一些上传时,要使用的一些基本的信息:上传服务器、用户、密码。

└─$ cat ~/.pypirc
[distutils]
index-servers =
    pypi

[pypi]
username:
password:

3.Setup.py安装文件

setup.py文件中设置的信息有,是围绕上传库的版本、作者、联系方式、下载地址等相关信息的介绍,这些信息最后都会在Pypi的第三方包的介绍中出现。

#!/usr/bin/env python
# coding:<encoding name> : # coding: utf-8

from distutils.core import setup

setup(name='py3graylog',
      version='0.1.0',
      description='基于Zack Allen老师的pygraylog,升级成为支持Python3的执行调用。',
      author='T',
      author_email='1@1.com',
      url='https://www.github.com/py3graylog',
      download_url='https://github.com/py3graylog/tarball/0.1.0',
      packages=['py3graylog'],
      keywords=['graylog', 'graylog-api', 'api graylog'],
      install_requires=[
          'requests'
      ],
     )

4.操作执行命令

当准备完了各种配置文件、脚本之后,是需要在pypi.org上进行账号注册的,只有注册了账号,可以上传库项目到网站上。主体要进行三步操作:

4.1 生成安装包。

 python setup.py sdist

4.2 进行库的注册。

 python setup.py register

4.3 上传库工程。

 python setup.py sdist upload

5.安装模块验证

如果库被成功的传到了pypi.org上之后,正常的情况,就可以用pip search和pip install进行安装了。

sudo pip search py3graylog
sudo pip install py3graylog
Edit me