from distutils.core import setup
setup(
    name = "chardet",
    packages = ["chardet"],
    version = "1.0.2",
    description = "Universal encoding detector",
    author = "Mark Pilgrim",
    author_email = "mark@diveintomark.org",
    url = "http://chardet.feedparser.org/",
    download_url = "http://chardet.feedparser.org/download/python3-chardet-1.0.1.tgz",
    keywords = ["encoding", "i18n", "xml"],
    classifiers = [
        "Programming Language :: Python",
        "Programming Language :: Python :: 3",
        "Development Status :: 4 - Beta",
        "Environment :: Other Environment",
        "Intended Audience :: Developers",
        "License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)",
        "Operating System :: OS Independent",
        "Topic :: Software Development :: Libraries :: Python Modules",
        "Topic :: Text Processing :: Linguistic",
        ],
    long_description = """\
Universal character encoding detector
-------------------------------------

Detects
 - ASCII, UTF-8, UTF-16 (2 variants), UTF-32 (4 variants)
 - Big5, GB2312, EUC-TW, HZ-GB-2312, ISO-2022-CN (Traditional and Simplified Chinese)
 - EUC-JP, SHIFT_JIS, ISO-2022-JP (Japanese)
 - EUC-KR, ISO-2022-KR (Korean)
 - KOI8-R, MacCyrillic, IBM855, IBM866, ISO-8859-5, windows-1251 (Cyrillic)
 - ISO-8859-2, windows-1250 (Hungarian)
 - ISO-8859-5, windows-1251 (Bulgarian)
 - windows-1252 (English)
 - ISO-8859-7, windows-1253 (Greek)
 - ISO-8859-8, windows-1255 (Visual and Logical Hebrew)
 - TIS-620 (Thai)

This version requires Python 3 or later; a Python 2 version is available separately.
"""
)

chardet と httplib2 はオープンソースだが、 Pythonライブラリを何か特定のライセンスでリリースしなければならないという制約は存在しない。この章で説明する手順は、ライセンスに関係なく、どんなPythonのソフトウェアにも使える。

Distutilsがやってくれないこと¶

初めてのPythonパッケージをリリースする作業は手ごわいもの。 Distutils はできる限りの自動化を試みてくれるが、自分自身でやらなければいけないこともいくつか存在する。

ライセンスの選択

これは、政治と危険に満ちた複雑な話題だ。自分のソフトウェアをオープンソースとしてリリースしたいのであれば、私はつつましく5つのアドバイスをしておく：

1. 独自のライセンスを書いてはならない。
2. 独自のライセンスを書いてはならない。
3. 独自のライセンスを書いてはならない。
4. ライセンスがgplである必要はないが、gpl互換である必要がある。
5. 独自のライセンスを書いてはならない。

ソフトウェアの分類

この分類にはPyPIの分類システムを使うが、その詳細についてはこの章のもう少し後で説明する。

“read me”ファイルの作成

これをいい加減に済ませてはならない。最低でも、ソフトウェアが何をするのかについての概要と、インストールの方法ぐらいは書くようにしよう。

ディレクトリ構造¶

Pythonソフトウェアのパッケージ化を始めるには、ファイルとディレクトリを整理する必要がある。 httplib2ディレクトリは以下のようになる：

httplib2/                 1
|
+--README.txt             2
|
+--setup.py               3
|
+--httplib2/              4
   |
   +--__init__.py
   |
   +--iri2uri.py

すべてのディレクトリとファイルを入れるルートディレクトリを作ろう。

これにはPythonモジュールと同じ名前を付けておく。

Windowsユーザのために、“read me” ファイルには.txtという拡張子を付け、さらにWindowsスタイルの改行文字を使っておこう。自分はコマンドラインから起動する独自のマクロ言語を備えたクールなテキストエディタを使っているからといって、ユーザーの人生を難しくする必要はない（ユーザは「メモ帳」を使っている。悲しいけれどこれは事実）。

あなたがLinuxやMac OS Xを使っているとしても、そのクールなテキストエディタには、まず間違いなくファイルをWindowsスタイルの改行文字で保存するオプションがある。

何かもっともな理由がない限り、Distutilsのセットアップスクリプトには

setup.pyという名前を付けておくべき。

Pythonソフトウェアが単一の.pyファイルで構成されているのであれば、

そのファイルは“read me”ファイルやセットアップスクリプトと一緒にルートディレクトリに置いておけばいい。しかし、httplib2は単一の.pyファイルではない。httplib2はマルチファイルモジュールなのだ。しかしそれでも問題はない！ルートディレクトリの中にhttplib2ディレクトリを置こう。つまり、httplib2/というルートディレクトリの中にあるhttplib2/ディレクトリの中に __init__.pyファイルがあることになる。これで問題ない。実は、これによってパッケージ化の処理が単純化される。

chardetディレクトリの方はこれとは微妙に異なっている。 httplib2と同じくchardetはマルチファイルモジュールなので、 chardet/というルートディレクトリの中にchardet/ディレクトリが存在する。しかし、chardetの場合は、 README.txtファイルに加えてhtml形式のドキュメントがdocs/ディレクトリの中に用意されているのだ。このdocs/ディレクトリには、.htmlファイルや.cssファイルがいくつか入っており、さらにimages/というサブディレクトリの中には複数の.pngファイルや.gifファイルも入っている（これは後で重要になる）。

また、(l)gplでライセンスされたソフトウェアの慣例として、lgplの全文を収めたCOPYING.txtというファイルも入っている。

chardet/
|
+--COPYING.txt
|
+--setup.py
|
+--README.txt
|
+--docs/
|  |
|  +--index.html
|  |
|  +--usage.html
|  |
|  +--images/ ...
|
+--chardet/
   |
   +--__init__.py
   |
   +--big5freq.py
   |
   +--...

セットアップスクリプトを書く¶

DistutilsのセットアップスクリプトはPythonスクリプトになる。このスクリプトは理論的にはPythonができることなら何でもできる。しかし実際には、このスクリプトでは最小限の処理を可能な限り標準的な方法で行うべき。

インストール処理をエキゾチックなものにすれば、エキゾチックなバグレポートが返ってくることになる。

どんなDistutilsセットアップスクリプトだろうと、1行目は常に同じものになる：

from distutils.core import setup

これは setup()関数をインポートしている。この関数がDistutilsのメインのエントリポイント。すべてのDistutilsセットアップスクリプトのうちの95%はsetup()の呼び出しだけで構成されており、他には何も含んでいない（この統計は単なるでっち上げだが、Distutilsのセットアップスクリプトが、Distutilsのsetup()関数を呼び出す以上のことをするのであれば、何かそれ相応の理由を持っているべき.

setup()関数は何十ものパラメータを受け取ることができる。これに関わるすべての人を正気に保つために、すべてのパラメータには名前付き引数を使わなければならない。これは単なる慣例ではなく、コード上要求されている条件だ。従って、名前付き引数を使わずにsetup()関数を呼び出そうとすると、セットアップスクリプトはクラッシュする。

次の名前付き引数は必須：

name: パッケージ名
version: パッケージのバージョン番号
author: フルネーム
author_email: 電子メールアドレス
url: プロジェクトのホームページ。

プロジェクト用のウェブサイトを別個に持っていないのであれば、自分のPyPIパッケージのページでもいい。

必須ではないが、以下もセットアップスクリプトに含めておくことを推奨：

description: プロジェクトの一行要約
long_description: reStructuredText形式で書かれた複数行の文字列。PyPIはこれをhtmlに変換し、あなたのパッケージのページに表示する。
classifiers: 次節で説明する特別な形式の文字列のリスト

セットアップスクリプトのメタデータは pep 314 で定義されている。

では、chardetのセットアップスクリプトを見てみよう。ここでは先ほど説明した必須/推奨のパラメーター全部に加えて、さらにもう一つ、packagesというパラメータを使っている。

from distutils.core import setup
setup(
    name = 'chardet',
    packages = ['chardet'],
    version = '1.0.2',
    description = 'Universal encoding detector',
    author='Mark Pilgrim',
    ...
)

packagesパラメータは、配布プロセスにおける用語の不幸な重複を浮き彫りにする。私たちは、いま構築しているものを「パッケージ」と呼んできた（そして、これがPythonの「パッケージ」インデックスに登録される）。

しかし、このpackagesパラメータが指しているものはそれとは違う。これは、chardetモジュールがマルチファイルモジュール（これは時に……「パッケージ」と呼ばれる）であるという事実を指している。このpackagesパラメータは、 chardet/ディレクトリ、__init__.pyファイル、そしてchardetモジュールを構成するすべての.pyファイルをビルドに加えるように Distutils に伝える。これは重要。もし実際のソースコードを入れ忘れてしまったら、ドキュメントやメタデータの話はすべて無意味なものになってしまう。

パッケージを分類する¶

Python Package Index (“PyPI”) には何千ものPythonライブラリが存在している。適切な分類用メタデータを用意しておけば、他の人々があなたのライブラリを簡単に見つけられるようになる。

PyPIは、分類タグをもとにパッケージを探せるようになっていて、分類タグをいくつか選んで絞り込みをかけることもできる。分類タグは無視できるような見えないメタデータではない。

ソフトウェアを分類するには、 classifiersパラメータを Distutils の setup()関数に渡せばよい。

classifiers は、文字列のリストだが、この文字列は自由形式ではない。すべての分類タグはPyPIのこのリストにあるものを使う必要がある。

分類タグはオプションなので、Distutilsのセットアップスクリプトを書く時には全て省略することもできる。しかしそれをやってはいけない。少なくとも次の分類タグは必ず入れておくべき。

Programming Language（プログラミング言語）:

具体的には、 - "Programming Language :: Python"と - "Programming Language :: Python :: 3"

の両方を入れておくべき。この2つのタグを抜かすと、パッケージはpypi.python.orgの全ページのサイドバーからリンクされているこの Python 3 互換ライブラリのリストに表示されなくなってしまう。

License（ライセンス）:

これは、サードパーティのライブラリを評価するときにに探される。複数のライセンスの下で配布しているライブラリだとはっきり示しているのでなければ、複数のライセンスタグを入れてはいけない（そして、強制されている場合でなければ、ソフトウェアを複数のライセンスで公開しないべき。また、他の人に複数ライセンスを強制するのもやめるべき。）

Operating System（オペレーティングシステム）:

もしソフトウェアがWindows（あるいはMac OS XやLinux）上でのみ動くものなら、後になってそれを知るよりも早めに知っておきたい。ソフトウェアがプラットフォーム依存のコードを使わずにどこでも動作するのであれば、"Operating System :: OS Independent"という分類タグを使う。複数のOparating System分類タグを書かなければならないのは、ソフトウェアが個々のプラットフォームについて特別なサポートを必要とするときだけ（これは一般的ではない）。

以下の分類タグも含めておくことを奨める：

Development Status（開発状況）: ソフトウェアはベータ版の品質だろうか？それともアルファ版の品質？プリアルファ？一つだけ選ぼう。それも正直に。
Intended Audience（対象とする利用者）: どんな人がソフトウェアをダウンロードするだろうか？最も一般的な選択肢としては
- Developers、
- End Users/Desktop、
- Science/Research、
- System Administrators

がある。

Framework（フレームワーク）: もしソフトウェアが、DjangoやZopeなどのもっと大きなフレームワークのためのプラグインである場合は、適当なFrameworkタグを付けておこう。そうでないのならこれは省略する。
Topic（トピック）: たくさんの選択肢が存在する。該当するものをすべて選択しよう。

良いパッケージ分類タグの例¶

例を挙げるために、ここに Django の分類タグを示す。

Django は、製品レベルの品質を持ち、クラスプラットフォームで、Webサーバ上で動作する、bsdライセンスのウェブアプリケーションフレームワークだ（DjangoはまだPython 3に対応していないので、Programming Language :: Python :: 3というタグは含まれていない）。

Programming Language :: Python
License :: OSI Approved :: BSD License
Operating System :: OS Independent
Development Status :: 5 - Production/Stable
Environment :: Web Environment
Framework :: Django
Intended Audience :: Developers
Topic :: Internet :: WWW/HTTP
Topic :: Internet :: WWW/HTTP :: Dynamic Content
Topic :: Internet :: WWW/HTTP :: WSGI
Topic :: Software Development :: Libraries :: Python Modules

次はchardetの分類タグ。

chardetは、文字コード自動判定用のライブラリだ。これは

ベータ版の品質
クラスプラットフォームで、
Python 3互換で、
lgplでライセンスされていて、
開発者が自身の製品に組み込んで使うこと

を想定している。

Programming Language :: Python
Programming Language :: Python :: 3
License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Operating System :: OS Independent
Development Status :: 4 - Beta
Environment :: Other Environment
Intended Audience :: Developers
Topic :: Text Processing :: Linguistic
Topic :: Software Development :: Libraries :: Python Modules

次は httplib2 の分類タグ。これは、httpウェブサービスで詳しく見たライブラリだ。

httplib2 は

ベータ版の品質で、
クロスプラットフォームで、
mitライセンスで、Python開発者を対象

としている。

Programming Language :: Python
Programming Language :: Python :: 3
License :: OSI Approved :: MIT License
Operating System :: OS Independent
Development Status :: 4 - Beta
Environment :: Web Environment
Intended Audience :: Developers
Topic :: Internet :: WWW/HTTP
Topic :: Software Development :: Libraries :: Python Modules

マニフェストを使って追加ファイルを指定する¶

デフォルトでは、Distutils は次のファイルをリリースパッケージに入れる：

README.txt
setup.py
packagesパラメータにリストされたマルチファイルモジュールが必要とする.pyファイル。
py_modulesパラメータにリストされた個々の.pyファイル。

これでhttplib2プロジェクトのファイルは網羅できている。

しかし chardetプロジェクトでは、これに加えて COPYING.txtライセンスファイルと、画像やhtmlファイルを収めたdocs/ディレクトリもパッケージに入れておくつもりだった。このファイルやディレクトリをchardetのリリースパッケージに追加してもらうには、 マニフェストファイル が必要となる。

マニフェストファイルは MANIFEST.in という名のテキストファイル。このファイルをREADME.txtやsetup.pyファイルと一緒にルートディレクトリに置く。

マニフェストファイルは、Pythonスクリプトではなく、 Distutils が定義する一連の「コマンド」を並べたテキストファイル。マニフェストコマンドを使うことで、特定のファイルやディレクトリをパッケージに含めたり除外したりできる。

chardetプロジェクト用のマニフェストファイル全体：

include COPYING.txt                                1
recursive-include docs *.html *.css *.png *.gif    2

recursive-include はディレクトリ名と1つ以上のファイル名を受け取る。このファイル名の部分ではファイルを個別に指定するだけではなく、ワイルドカードを使って指定することもできる。

この行は「ルートディレクトリの中にdocs/ディレクトリがあるだろう？その中から .html・.css・.png・.gifファイルを（再帰的に）探してほしい。それらをすべてリリースパッケージに入れたい」という意味になる。

すべてのマニフェストコマンドは、プロジェクトディレクトリのディレクトリ構造をそのまま維持する。

recursive-includeコマンドが、.html と .pngファイルをリリースパッケージのルートディレクトリに置くことはない。このコマンドはdocs/ディレクトリの構造を保ちつつ、このディレクトリの中にあるファイルのうちワイルドカードにマッチしたものだけをパッケージに含める（今まで言っていなかったが、chardetのドキュメントは、実際にはxmlで書かれており、別のスクリプトによってhtmlに変換されている。私はこのxmlファイルをリリースパッケージに含めずに、htmlと画像だけを含めておきたい）。

マニフェストファイルが必要になるのは、Distutils がデフォルトでは無視するファイルをパッケージに入れる場合だけ。マニフェストファイルが本当に必要なら、Distutils がデフォルトで見つけないファイルやディレクトリだけを書くようにする。

セットアップスクリプトにエラーがないかを確認する¶

把握しておかなければいけないことはたくさんある。

Distutils には、必須なメタデータがセットアップスクリプト中にすべて存在しているかどうかをチェックするための組み込みの検証コマンドが付属している。

例えば、versionパラメータを入れ忘れたとしたら、Distutils がそれをエラーとして表示してくれる。

例：

c:\python31\python.exe setup.py check
running check
warning: check: missing required meta-data: version

versionパラメータ（とその他の必要なメタデータ全て）を入れると、checkコマンドはこのようになる：

c:\Users\pilgrim\chardet> c:\python31\python.exe setup.py check
running check

ソースディストリビューションを作る¶

Distutilsは、複数の種類のリリースパッケージを構築できる。

最低でも、ソースコードと、 Disturils のセットアップスクリプトと、 “read me”ファイルと、その他任意の追加ファイルを入れた「ソースディストリビューション」を構築すべき。ソースディストリビューションを構築するには、Distutils のセットアップスクリプトに sdistコマンドを渡せばよい。

c:\Users\pilgrim\chardet> c:\python31\python.exe setup.py sdist
running sdist
running check
reading manifest template 'MANIFEST.in'
writing manifest file 'MANIFEST'
creating chardet-1.0.2
creating chardet-1.0.2\chardet
creating chardet-1.0.2\docs
creating chardet-1.0.2\docs\images
copying files to chardet-1.0.2...
copying COPYING -> chardet-1.0.2
copying README.txt -> chardet-1.0.2
copying setup.py -> chardet-1.0.2
copying chardet\__init__.py -> chardet-1.0.2\chardet
copying chardet\big5freq.py -> chardet-1.0.2\chardet
...
copying chardet\universaldetector.py -> chardet-1.0.2\chardet
copying chardet\utf8prober.py -> chardet-1.0.2\chardet
copying docs\faq.html -> chardet-1.0.2\docs
copying docs\history.html -> chardet-1.0.2\docs
copying docs\how-it-works.html -> chardet-1.0.2\docs
copying docs\index.html -> chardet-1.0.2\docs
copying docs\license.html -> chardet-1.0.2\docs
copying docs\supported-encodings.html -> chardet-1.0.2\docs
copying docs\usage.html -> chardet-1.0.2\docs
copying docs\images\caution.png -> chardet-1.0.2\docs\images
copying docs\images\important.png -> chardet-1.0.2\docs\images
copying docs\images\note.png -> chardet-1.0.2\docs\images
copying docs\images\permalink.gif -> chardet-1.0.2\docs\images
copying docs\images\tip.png -> chardet-1.0.2\docs\images
copying docs\images\warning.png -> chardet-1.0.2\docs\images
creating dist
creating 'dist\chardet-1.0.2.zip' and adding 'chardet-1.0.2' to it
adding 'chardet-1.0.2\COPYING'
adding 'chardet-1.0.2\PKG-INFO'
adding 'chardet-1.0.2\README.txt'
adding 'chardet-1.0.2\setup.py'
adding 'chardet-1.0.2\chardet\big5freq.py'
adding 'chardet-1.0.2\chardet\big5prober.py'
...
adding 'chardet-1.0.2\chardet\universaldetector.py'
adding 'chardet-1.0.2\chardet\utf8prober.py'
adding 'chardet-1.0.2\chardet\__init__.py'
adding 'chardet-1.0.2\docs\faq.html'
adding 'chardet-1.0.2\docs\history.html'
adding 'chardet-1.0.2\docs\how-it-works.html'
adding 'chardet-1.0.2\docs\index.html'
adding 'chardet-1.0.2\docs\license.html'
adding 'chardet-1.0.2\docs\supported-encodings.html'
adding 'chardet-1.0.2\docs\usage.html'
adding 'chardet-1.0.2\docs\images\caution.png'
adding 'chardet-1.0.2\docs\images\important.png'
adding 'chardet-1.0.2\docs\images\note.png'
adding 'chardet-1.0.2\docs\images\permalink.gif'
adding 'chardet-1.0.2\docs\images\tip.png'
adding 'chardet-1.0.2\docs\images\warning.png'
removing 'chardet-1.0.2' (and everything under it)

指摘しておきたいことがいくつかある：

Distutilsはマニフェストファイル (MANIFEST.in) に気づいている。
Distutilsは、マニフェストファイルのパースに成功し、指定した追加ファイル（COPYING.txtとdocs/ディレクトリにあるHTMLファイルと画像）を追加している。
プロジェクトディレクトリの中を覗くと、Distutils が dist/というディレクトリを作成したことが分かる。dist/ディレクトリの中には配布可能な .zipファイルがある。

c:\Users\pilgrim\chardet> dir dist
 Volume in drive C has no label.
 Volume Serial Number is DED5-B4F8

 Directory of c:\Users\pilgrim\chardet\dist

07/30/2009  06:29 PM    <DIR>          .
07/30/2009  06:29 PM    <DIR>          ..
07/30/2009  06:29 PM           206,440 chardet-1.0.2.zip
               1 File(s)        206,440 bytes
               2 Dir(s)  61,424,635,904 bytes free

グラフィカルインストーラを作る¶

どんなPythonライブラリにもWindowsユーザのためのグラフィカルインストーラを付ける価値がある。このインストーラは（Windowsを使ってない人でも）簡単に作ることができるし、 Windowsユーザはこれをありがたく思う。

Distutilsを使えば、グラフィカルなWindowsインストーラを作成できる。この機能を使うにはbdist_wininst コマンドを Distutils のセットアップスクリプトに渡せばよい。

c:\Users\pilgrim\chardet> c:\python31\python.exe setup.py bdist_wininst
running bdist_wininst
running build
running build_py
creating build
creating build\lib
creating build\lib\chardet
copying chardet\big5freq.py -> build\lib\chardet
copying chardet\big5prober.py -> build\lib\chardet
...
copying chardet\universaldetector.py -> build\lib\chardet
copying chardet\utf8prober.py -> build\lib\chardet
copying chardet\__init__.py -> build\lib\chardet
installing to build\bdist.win32\wininst
running install_lib
creating build\bdist.win32
creating build\bdist.win32\wininst
creating build\bdist.win32\wininst\PURELIB
creating build\bdist.win32\wininst\PURELIB\chardet
copying build\lib\chardet\big5freq.py -> build\bdist.win32\wininst\PURELIB\chardet
copying build\lib\chardet\big5prober.py -> build\bdist.win32\wininst\PURELIB\chardet
...
copying build\lib\chardet\universaldetector.py -> build\bdist.win32\wininst\PURELIB\chardet
copying build\lib\chardet\utf8prober.py -> build\bdist.win32\wininst\PURELIB\chardet
copying build\lib\chardet\__init__.py -> build\bdist.win32\wininst\PURELIB\chardet
running install_egg_info
Writing build\bdist.win32\wininst\PURELIB\chardet-1.0.2-py3.1.egg-info
creating 'c:\users\pilgrim\appdata\local\temp\tmp2f4h7e.zip' and adding '.' to it
adding 'PURELIB\chardet-1.0.2-py3.1.egg-info'
adding 'PURELIB\chardet\big5freq.py'
adding 'PURELIB\chardet\big5prober.py'
...
adding 'PURELIB\chardet\universaldetector.py'
adding 'PURELIB\chardet\utf8prober.py'
adding 'PURELIB\chardet\__init__.py'
removing 'build\bdist.win32\wininst' (and everything under it)
c:\Users\pilgrim\chardet> dir dist
c:\Users\pilgrim\chardet>dir dist
 Volume in drive C has no label.
 Volume Serial Number is AADE-E29F

Directory of c:\Users\pilgrim\chardet\dist

07/30/2009  10:14 PM    <DIR>          .
07/30/2009  10:14 PM    <DIR>          ..
07/30/2009  10:14 PM           371,236 chardet-1.0.2.win32.exe
07/30/2009  06:29 PM           206,440 chardet-1.0.2.zip
               2 File(s)        577,676 bytes
               2 Dir(s)  61,424,070,656 bytes free

他のオペレーティングシステムのためのパッケージを構築する¶

Distutils は、Linuxユーザ向けのインストールパッケージを構築する手助けをしてくれる。 Linuxでソフトウェアを配布してもらいたいなら、主要なLinuxディストリビューションでソフトウェアのパッケージ化を専門としているコミュニティメンバと協力したほうがいい。

例として、chardetライブラリはDebian GNU/Linux リポジトリの中にある（従って、これはUbuntu リポジトリの中にもある）。このパッケージはある日突然姿を現した。 DebianコミュニティはPythonライブラリをパッケージングする独自のポリシーを持っており、Debianのpython-chardetライブラリはこれらの慣習に従うように作られている。このパッケージはDebianのリポジトリの中に存続しているので、コンピュータの管理のために選択したシステムの設定にもよるがDebianのユーザはセキュリティアップデートや新しいバージョンを受け取ることになる。

ソフトウェアをPython Package Indexに追加する¶

ソフトウェアをPython Package Index にアップデートするプロセスには3つのステップがある。

アカウントを作成する
ソフトウェアを登録する
setup.py sdist と setup.py bdist_*で作成したパッケージをアップロードする。

アカウントを作成するためにPyPI ユーザ登録ページへ行く。希望のユーザ名、パスワード、有効な電子メールアドレスを入力し、 Registerボタンをクリックしよう（pgpキーやgpgキーを提供することもできる。これらを持っていなかったり、これらの意味が分からなくても、心配は要らない）。 PyPIから数分以内に、メールアドレスを検証するためのリンクが書かれている電子メールが届くはずなのでそれを確認。登録処理を完了させるためにそのリンクをクリック。

今度は、ソフトウェアをPyPIに登録し、それをアップロードする必要がある。これは1つのステップですべて実行できる。

c:\Users\pilgrim\chardet> c:\python31\python.exe setup.py register sdist bdist_wininst upload                                                                          1
running register
We need to know who you are, so please choose either:
 1. use your existing login,
 2. register as a new user,
 3. have the server generate a new password for you (and email it to you), or
 4. quit
Your selection [default 1]:  1                                                  2
Username: MarkPilgrim                                                           3
Password:
Registering chardet to http://pypi.python.org/pypi                              4
Server response (200): OK
running sdist                                                                   5
... output trimmed for brevity ...
running bdist_wininst                                                           6
... output trimmed for brevity ...
running upload                                                                  7
Submitting dist\chardet-1.0.2.zip to http://pypi.python.org/pypi
Server response (200): OK
Submitting dist\chardet-1.0.2.win32.exe to http://pypi.python.org/pypi
Server response (200): OK
I can store your PyPI login so future submissions will be faster.
(the login will be stored in c:\home\.pypirc)
Save your login (y/N)?n                                                        8

プロジェクトを初めてリリースするときは、DistutilsがソフトウェアをPython Package Indexに追加し、それに専用のurlを与える。それ以降の場合は、プロジェクトのメタデータを、変更されたsetup.pyのパラメータへと更新するだけだ。次に、ソースディストリビューションの構築 (sdist) と、Windowsインストーラの構築 (bdist_wininst) を行って、それらをPyPIにアップロードする (upload)。
“use your existing login.” を選択するために、1と入力してENTERキーを押そう。
PyPIユーザ登録ページで入力したユーザ名とパスワードを入力しよう。Distuilsは入力したパスワードをエコーしないし、文字の代わりにアスタリスクをエコーすることもない。パスワードを入力してENTERを押そう。
DistutilsはパッケージをPython Package Indexに登録し……
……ソースディストリビューションを構築し……
……Windows用インストーラを構築し……
……そして、これら両方をPython Package Indexにアップロードする。
もし新しいバージョンのリリース処理を自動化したいのであれば、PyPIの証明書をローカルファイルに保存しておく必要がある。これはまったくセキュアではないので、まったく任意だ。

これで、Python Package Indexにパッケージのページを手に入れた. アドレスは http://pypi.python.org/pypi/NAME になる。（NAMEにはsetup.pyファイルのnameパラメータに渡した文字列が入る）。

新しいバージョンをリリースしたいときは、 setup.py を単に新しいバージョン番号で更新して、同じアップロードコマンドを再び実行する：

c:\Users\pilgrim\chardet> c:\python31\python.exe setup.py register sdist bdist_wininst upload

Table of Contents¶

16章 Pythonライブラリをパッケージ化する¶

飛び込む¶