asterisms for everyone!

This commit is contained in:
Mark Pilgrim
2009-07-30 01:31:49 -04:00
parent 90e17cf660
commit 7bd86a025d
+16
View File
@@ -95,6 +95,8 @@ This version requires Python 3 or later; a Python 2 version is available separat
<li><b>Write a &#8220;read me&#8221; file</b>. Don&#8217;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>&#x2042;
<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>&#x2042;
<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>&#x261E;</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>&#x2042;
<h2 id=trove>Classifying Your Package</h2>
<p>The Python Package Index (&#8220;PyPI&#8221;) 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>&#x2042;
<h2 id=sdist>Creating Source Distributions</h2>
<!-- archive formats -->
<!-- manifest -->
<p class=a>&#x2042;
<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>&#x2042;
<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>&#x2042;
<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&#8217;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>&#x2042;
<h2 id=furtherreading>Further Reading</h2>
<p>On Distutils: