HTTP/2 302 server: nginx date: Fri, 16 Jan 2026 01:56:40 GMT content-type: text/plain; charset=utf-8 content-length: 0 x-archive-redirect-reason: found capture at 20070811220312 location: https://web.archive.org/web/20070811220312/https://docs.python.org/dist/dist.html server-timing: captures_list;dur=0.491936, exclusion.robots;dur=0.032730, exclusion.robots.policy;dur=0.023291, esindex;dur=0.009504, cdx.remote;dur=14.484438, LoadShardBlock;dur=319.266994, PetaboxLoader3.resolve;dur=81.507448, PetaboxLoader3.datanode;dur=91.395640 x-app-server: wwwb-app225-dc8 x-ts: 302 x-tr: 359 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 set-cookie: wb-p-SERVER=wwwb-app225; path=/ x-location: All x-as: 14061 x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() HTTP/2 200 server: nginx date: Fri, 16 Jan 2026 01:56:41 GMT content-type: text/html x-archive-orig-date: Sat, 11 Aug 2007 22:03:12 GMT x-archive-orig-server: Apache/2.2.3 (Debian) DAV/2 SVN/1.4.2 mod_ssl/2.2.3 OpenSSL/0.9.8c x-archive-orig-last-modified: Tue, 19 Sep 2006 05:58:08 GMT x-archive-orig-etag: "656f1-3c71-2cbb9c00" x-archive-orig-accept-ranges: bytes x-archive-orig-content-length: 15473 x-archive-orig-expires: Sun, 12 Aug 2007 22:03:12 GMT x-archive-orig-connection: close x-archive-guessed-content-type: text/html x-archive-guessed-charset: utf-8 memento-datetime: Sat, 11 Aug 2007 22:03:12 GMT link: ; rel="original", ; rel="timemap"; type="application/link-format", ; rel="timegate" content-security-policy: default-src 'self' 'unsafe-eval' 'unsafe-inline' data: blob: archive.org web.archive.org web-static.archive.org wayback-api.archive.org athena.archive.org analytics.archive.org pragma.archivelab.org wwwb-events.archive.org x-archive-src: 44_0_20070811212738_crawl108-c/44_0_20070811220130_crawl107.arc.gz server-timing: captures_list;dur=0.540528, exclusion.robots;dur=0.018055, exclusion.robots.policy;dur=0.008158, esindex;dur=0.009224, cdx.remote;dur=6.006399, LoadShardBlock;dur=178.978896, PetaboxLoader3.datanode;dur=261.197104, PetaboxLoader3.resolve;dur=87.437632, load_resource;dur=210.199569 x-app-server: wwwb-app225-dc8 x-ts: 200 x-tr: 440 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 x-location: All x-as: 14061 x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() content-encoding: gzip

Distributing Python Modules

Up: Python Documentation Index Next: 1. An Introduction to

---

Distributing Python Modules

Greg Ward

Python Software Foundation
Email: distutils-sig@python.org

Anthony Baxter

Release 2.5
19th September, 2006

Copyright © 2001-2006 Python Software Foundation. All rights reserved.

Copyright © 2000 BeOpen.com. All rights reserved.

Copyright © 1995-2000 Corporation for National Research Initiatives. All rights reserved.

Copyright © 1991-1995 Stichting Mathematisch Centrum. All rights reserved.

See the end of this document for complete license and permissions information.

Abstract:

This document describes the Python Distribution Utilities (``Distutils'') from the module developer's point of view, describing how to use the Distutils to make Python modules and extensions easily available to a wider audience with very little overhead for build/release/install mechanics.

---

• 1. An Introduction to Distutils
  • 1.1 Concepts & Terminology
  • 1.2 A Simple Example
  • 1.3 General Python terminology
  • 1.4 Distutils-specific terminology
• 2. Writing the Setup Script
  • 2.1 Listing whole packages
  • 2.2 Listing individual modules
  • 2.3 Describing extension modules
    • 2.3.1 Extension names and packages
    • 2.3.2 Extension source files
    • 2.3.3 Preprocessor options
    • 2.3.4 Library options
    • 2.3.5 Other options
  • 2.4 Relationships between Distributions and Packages
  • 2.5 Installing Scripts
  • 2.6 Installing Package Data
  • 2.7 Installing Additional Files
  • 2.8 Additional meta-data
  • 2.9 Debugging the setup script
• 3. Writing the Setup Configuration File
• 4. Creating a Source Distribution
  • 4.1 Specifying the files to distribute
  • 4.2 Manifest-related options
• 5. Creating Built Distributions
  • 5.1 Creating dumb built distributions
  • 5.2 Creating RPM packages
  • 5.3 Creating Windows Installers
    • 5.3.1 The Postinstallation script
• 6. Registering with the Package Index
  • 6.1 The .pypirc file
• 7. Uploading Packages to the Package Index
• 8. Examples
  • 8.1 Pure Python distribution (by module)
  • 8.2 Pure Python distribution (by package)
  • 8.3 Single extension module
• 9. Extending Distutils
  • 9.1 Integrating new commands
  • 9.2 Adding new distribution types
• 10. Command Reference
  • 10.1 Installing modules: the install command family
    • 10.1.1 install_data
    • 10.1.2 install_scripts
  • 10.2 Creating a source distribution: the sdist command
• 11. API Reference
  • 11.1 distutils.core -- Core Distutils functionality
  • 11.2 distutils.ccompiler -- CCompiler base class
  • 11.3 distutils.unixccompiler -- Unix C Compiler
  • 11.4 distutils.msvccompiler -- Microsoft Compiler
  • 11.5 distutils.bcppcompiler -- Borland Compiler
  • 11.6 distutils.cygwincompiler -- Cygwin Compiler
  • 11.7 distutils.emxccompiler -- OS/2 EMX Compiler
  • 11.8 distutils.mwerkscompiler -- Metrowerks CodeWarrior support
  • 11.9 distutils.archive_util -- Archiving utilities
  • 11.10 distutils.dep_util -- Dependency checking
  • 11.11 distutils.dir_util -- Directory tree operations
  • 11.12 distutils.file_util -- Single file operations
  • 11.13 distutils.util -- Miscellaneous other utility functions
  • 11.14 distutils.dist -- The Distribution class
  • 11.15 distutils.extension -- The Extension class
  • 11.16 distutils.debug -- Distutils debug mode
  • 11.17 distutils.errors -- Distutils exceptions
  • 11.18 distutils.fancy_getopt -- Wrapper around the standard getopt module
  • 11.19 distutils.filelist -- The FileList class
  • 11.20 distutils.log -- Simple PEP 282-style logging
  • 11.21 distutils.spawn -- Spawn a sub-process
  • 11.22 distutils.sysconfig -- System configuration information
  • 11.23 distutils.text_file -- The TextFile class
  • 11.24 distutils.version -- Version number classes
  • 11.25 distutils.cmd -- Abstract base class for Distutils commands
  • 11.26 distutils.command -- Individual Distutils commands
  • 11.27 distutils.command.bdist -- Build a binary installer
  • 11.28 distutils.command.bdist_packager -- Abstract base class for packagers
  • 11.29 distutils.command.bdist_dumb -- Build a ``dumb'' installer
  • 11.30 distutils.command.bdist_rpm -- Build a binary distribution as a Redhat RPM and SRPM
  • 11.31 distutils.command.bdist_wininst -- Build a Windows installer
  • 11.32 distutils.command.sdist -- Build a source distribution
  • 11.33 distutils.command.build -- Build all files of a package
  • 11.34 distutils.command.build_clib -- Build any C libraries in a package
  • 11.35 distutils.command.build_ext -- Build any extensions in a package
  • 11.36 distutils.command.build_py -- Build the .py/.pyc files of a package
  • 11.37 distutils.command.build_scripts -- Build the scripts of a package
  • 11.38 distutils.command.clean -- Clean a package build area
  • 11.39 distutils.command.config -- Perform package configuration
  • 11.40 distutils.command.install -- Install a package
  • 11.41 distutils.command.install_data -- Install data files from a package
  • 11.42 distutils.command.install_headers -- Install C/C++ header files from a package
  • 11.43 distutils.command.install_lib -- Install library files from a package
  • 11.44 distutils.command.install_scripts -- Install script files from a package
  • 11.45 distutils.command.register -- Register a module with the Python Package Index
  • 11.46 Creating a new Distutils command
• Module Index
• Index
• About this document ...

---

Distributing Python Modules

Up: Python Documentation Index Next: 1. An Introduction to

---

Release 2.5, documentation updated on 19th September, 2006.

See About this document... for information on suggesting changes.