From 7bd86a025d87b6d1e22a1ca81d5afbb4f7988fb3 Mon Sep 17 00:00:00 2001 From: Mark Pilgrim Date: Thu, 30 Jul 2009 01:31:49 -0400 Subject: [PATCH] asterisms for everyone! --- packaging.html | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/packaging.html b/packaging.html index 07c382f..6cf17d6 100644 --- a/packaging.html +++ b/packaging.html @@ -95,6 +95,8 @@ This version requires Python 3 or later; a Python 2 version is available separat
  • Write a “read me” file. 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. +

    ⁂ +

    Directory Structure

    To start packaging your Python software, you need to get your files and directories in order. The httplib2 directory looks like this: @@ -144,6 +146,8 @@ chardet/ +--... +

    ⁂ +

    Writing Your Setup Script

    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/

    ☞Setup script metadata is defined in PEP 314. +

    ⁂ +

    Classifying Your Package

    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

    Checking Your Setup Script for Errors

    +

    ⁂ +

    Creating Source Distributions

    +

    ⁂ +

    Creating Binary Distributions

    @@ -263,6 +273,8 @@ Topic :: Software Development :: Libraries :: Python Modules

    Building a Linux RPM Package

    +

    ⁂ +

    Adding Your Package to The Python Package Index

    Registering Yourself

    @@ -280,6 +292,8 @@ Topic :: Software Development :: Libraries :: Python Modules * Oh, I almost forgot - cover the Per-User Site packages stuff, PEP 370 --> +

    ⁂ +

    The Many Possible Futures of Python Packaging

    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

  • py2exe +

    ⁂ +

    Further Reading

    On Distutils: