GNU Info

(python2.1-dist.info)Creating a Source Distribution

---

Next: Creating Built Distributions Prev: Writing the Setup Configuration File Up: Top

---

Enter node , (file) or (file)node

Creating a Source Distribution
******************************

As shown in section~Note: A simple example, you use the `sdist'
command to create a source distribution.  In the simplest case,

     python setup.py sdist

(assuming you haven't specified any `sdist' options in the setup script
or config file), `sdist' creates the archive of the default format for
the current platform.  The default format is gzip'ed tar file
(`.tar.gz') on UNIX, and ZIP file on Windows.  *no MacOS support here*

You can specify as many formats as you like using the `--formats'
option, for example:

     python setup.py sdist --formats=gztar,zip

to create a gzipped tarball and a zip file.  The available formats are:
Format                   Description              Notes
------                   -----                    -----
zip                      zip file (`.zip')        (1),(3)
gztar                    gzip'ed tar file         (2),(4)
                         (`.tar.gz')              
bztar                    bzip2'ed tar file        (4)
                         (`.tar.gz')              
ztar                     compressed tar file      (4)
                         (`.tar.Z')               
tar                      tar file (`.tar')        (4)

Notes:
`(1)'
     default on Windows

`(2)'
     default on UNIX

`(3)'
     requires either external `zip' utility or `zipfile' module (not
     part of the standard Python library)

`(4)'
     requires external utilities: `tar' and possibly one of `gzip',
     `bzip2', or `compress'

Specifying the files to distribute

Manifest-related options