Lines Matching +full:install +full:- +full:module

1 .. _distutils-intro:
12 :ref:`install-index` chapter.
15 .. _distutils-concepts:
20 Using the Distutils is quite simple, both for module developers and for
21 users/administrators installing third-party modules.  As a developer, your
22 responsibilities (apart from writing solid, well-documented and well-tested
35 Not all module developers have access to a multitude of platforms, so it's not
38 address this need.  Packagers will take source distributions released by module
41 install most popular Python module distributions in the most natural way for
46 .. _distutils-simple-example:
54 Unlike, say, Autoconf-style configure scripts, the setup script may be run
55 multiple times in the course of building and installing your module
58 If all you want to do is distribute a module called :mod:`foo`, contained in a
76 * modules are specified by module name, not filename (the same will hold true
80   name, email address and a URL for the project (see section :ref:`setup-script`
83 To create a source distribution for this module, you would create a setup
89 For Windows, open a command prompt window (:menuselection:`Start -->
95 containing your setup script :file:`setup.py`, and your module :file:`foo.py`.
96 The archive file will be named :file:`foo-1.0.tar.gz` (or :file:`.zip`), and
97 will unpack into a directory :file:`foo-1.0`.
99 If an end-user wishes to install your :mod:`foo` module, all they have to do is
100 download :file:`foo-1.0.tar.gz` (or :file:`.zip`), unpack it, and---from the
101 :file:`foo-1.0` directory---run ::
103    python setup.py install
106 third-party modules in their Python installation.
111 :command:`sdist` command is almost exclusively for module developers, while
112 :command:`install` is more often for installers (although most developers will
113 want to install their own code occasionally).
117 (:command:`bdist_pkgtool`), and HP-UX :program:`swinstall`
119 file called :file:`foo-1.0.noarch.rpm`::
124 this has to be run on an RPM-based system such as Red Hat Linux, SuSE Linux, or
130    python setup.py bdist --help-formats
133 .. _python-terms:
143 module
148 pure Python module
149    a module written in Python and contained in a single :file:`.py` file (and
151    "pure module."
153 extension module
154    a module written in the low-level language of the Python implementation: C/C++
156    loadable pre-compiled file, e.g. a shared object (:file:`.so`) file for Python
162    a module that contains other modules; typically contained in a directory in the
170    small, standalone third-party modules that don't belong to a larger module
176 .. _distutils-term:
178 Distutils-specific terminology
184 module distribution
186    resource and meant to be installed *en masse*.  Examples of some well-known
187    module distributions are NumPy, SciPy, Pillow,
189    already taken in the Python context: a single module distribution may contain
192 pure module distribution
193    a module distribution that contains only pure Python modules and packages.
196 non-pure module distribution
197    a module distribution that contains at least one extension module.  Sometimes
198    referred to as a "non-pure distribution."
201    the top-level directory of your source tree (or  source distribution); the