mirror of
https://github.com/kennethreitz/dive-into-python3.git
synced 2026-06-05 23:10:17 +00:00
asterisms for everyone!
This commit is contained in:
@@ -95,6 +95,8 @@ This version requires Python 3 or later; a Python 2 version is available separat
|
||||
<li><b>Write a “read me” file</b>. Don’t skimp on this. At a minimum, it should give your users an overview of what your software does and how to install it.
|
||||
</ul>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=structure>Directory Structure</h2>
|
||||
|
||||
<p>To start packaging your Python software, you need to get your files and directories in order. The <code>httplib2</code> directory looks like this:
|
||||
@@ -144,6 +146,8 @@ chardet/
|
||||
+--...
|
||||
</code></pre>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=setuppy>Writing Your Setup Script</h2>
|
||||
|
||||
<p>The Distutils setup script is a Python script. In theory, it can do anything Python can do. In practice, it should do as little as possible, in as standard a way as possible. Setup scripts should be boring. The more exotic your installation process is, the more exotic your bug reports will be.
|
||||
@@ -178,6 +182,8 @@ chardet/
|
||||
<p><span class=u>☞</span>Setup script metadata is defined in <a href=http://www.python.org/dev/peps/pep-0314/><abbr>PEP</abbr> 314</a>.
|
||||
</blockquote>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=trove>Classifying Your Package</h2>
|
||||
|
||||
<p>The Python Package Index (“PyPI”) contains thousands of Python libraries. Proper classification metadata will allow people to find yours more easily.
|
||||
@@ -247,11 +253,15 @@ Topic :: Software Development :: Libraries :: Python Modules</code></pre>
|
||||
|
||||
<h3 id=check>Checking Your Setup Script for Errors</h3>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=sdist>Creating Source Distributions</h2>
|
||||
|
||||
<!-- archive formats -->
|
||||
<!-- manifest -->
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=bdist>Creating Binary Distributions</h2>
|
||||
|
||||
<!-- python3 setup.py bdist --help-formats -->
|
||||
@@ -263,6 +273,8 @@ Topic :: Software Development :: Libraries :: Python Modules</code></pre>
|
||||
|
||||
<h3 id=rpm>Building a Linux RPM Package</h3>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=pypi>Adding Your Package to The Python Package Index</h2>
|
||||
|
||||
<h3 id=register-user>Registering Yourself</h3>
|
||||
@@ -280,6 +292,8 @@ Topic :: Software Development :: Libraries :: Python Modules</code></pre>
|
||||
* Oh, I almost forgot - cover the Per-User Site packages stuff, PEP 370
|
||||
-->
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=future>The Many Possible Futures of Python Packaging</h2>
|
||||
|
||||
<p>Distutils is not the be-all and end-all of Python packaging, but as of this writing (August 2009), it’s the only packaging framework that works in Python 3. There are a number of other frameworks for Python 2; some focus on installation, others on testing and deployment. Some or all of these may end up being ported to Python 3 in the future.
|
||||
@@ -302,6 +316,8 @@ Topic :: Software Development :: Libraries :: Python Modules</code></pre>
|
||||
<li><a href=http://www.py2exe.org/><code>py2exe</code></a>
|
||||
</ul>
|
||||
|
||||
<p class=a>⁂
|
||||
|
||||
<h2 id=furtherreading>Further Reading</h2>
|
||||
|
||||
<p>On Distutils:
|
||||
|
||||
Reference in New Issue
Block a user