Kaydet (Commit) 5da37be7 authored tarafından Éric Araujo's avatar Éric Araujo

Kill trailing whitespace

üst 3a9f58f6
...@@ -11,8 +11,8 @@ Pysetup supports two configuration files: :file:`.pypirc` and :file:`packaging.c ...@@ -11,8 +11,8 @@ Pysetup supports two configuration files: :file:`.pypirc` and :file:`packaging.c
Configuring indexes Configuring indexes
------------------- -------------------
You can configure additional indexes in :file:`.pypirc` to be used for index-related You can configure additional indexes in :file:`.pypirc` to be used for index-related
operations. By default, all configured index-servers and package-servers will be used operations. By default, all configured index-servers and package-servers will be used
in an additive fashion. To limit operations to specific indexes, use the :option:`--index` in an additive fashion. To limit operations to specific indexes, use the :option:`--index`
and :option:`--package-server options`:: and :option:`--package-server options`::
......
...@@ -8,7 +8,7 @@ Pysetup supports installing Python packages from *Package Servers* in addition ...@@ -8,7 +8,7 @@ Pysetup supports installing Python packages from *Package Servers* in addition
to PyPI indexes and mirrors. to PyPI indexes and mirrors.
Package Servers are simple directory listings of Python distributions. Directories Package Servers are simple directory listings of Python distributions. Directories
can be served via HTTP or a local file system. This is useful when you want to can be served via HTTP or a local file system. This is useful when you want to
dump source distributions in a directory and not worry about the full index structure. dump source distributions in a directory and not worry about the full index structure.
Serving distributions from Apache Serving distributions from Apache
......
...@@ -33,13 +33,13 @@ code, of course!) are: ...@@ -33,13 +33,13 @@ code, of course!) are:
All of these tasks are covered in this document. All of these tasks are covered in this document.
Not all module developers have access to multiple platforms, so one cannot Not all module developers have access to multiple platforms, so one cannot
expect them to create buildt distributions for every platform. To remedy expect them to create buildt distributions for every platform. To remedy
this, it is hoped that intermediaries called *packagers* will arise to address this, it is hoped that intermediaries called *packagers* will arise to address
this need. Packagers take source distributions released by module developers, this need. Packagers take source distributions released by module developers,
build them on one or more platforms and release the resulting built build them on one or more platforms and release the resulting built
distributions. Thus, users on a greater range of platforms will be able to distributions. Thus, users on a greater range of platforms will be able to
install the most popular Python modules in the most natural way for their install the most popular Python modules in the most natural way for their
platform without having to run a setup script or compile a single line of code. platform without having to run a setup script or compile a single line of code.
...@@ -69,14 +69,14 @@ Some observations: ...@@ -69,14 +69,14 @@ Some observations:
arguments to the :func:`setup` function arguments to the :func:`setup` function
* those keyword arguments fall into two categories: package metadata (name, * those keyword arguments fall into two categories: package metadata (name,
version number, etc.) and information about what's in the package (a list version number, etc.) and information about what's in the package (a list
of pure Python modules in this case) of pure Python modules in this case)
* modules are specified by module name, not filename (the same will hold true * modules are specified by module name, not filename (the same will hold true
for packages and extensions) for packages and extensions)
* it's recommended that you supply a little more metadata than we have in the * it's recommended that you supply a little more metadata than we have in the
example. In particular your name, email address and a URL for the example. In particular your name, email address and a URL for the
project if appropriate (see section :ref:`packaging-setup-script` for an example) project if appropriate (see section :ref:`packaging-setup-script` for an example)
To create a source distribution for this module you would create a setup To create a source distribution for this module you would create a setup
...@@ -102,10 +102,10 @@ This simple example demonstrates some fundamental concepts of Distutils. ...@@ -102,10 +102,10 @@ This simple example demonstrates some fundamental concepts of Distutils.
First, both developers and installers have the same basic user interface, i.e. First, both developers and installers have the same basic user interface, i.e.
the setup script. The difference is which Distutils *commands* they use: the the setup script. The difference is which Distutils *commands* they use: the
:command:`sdist` command is almost exclusively for module developers, while :command:`sdist` command is almost exclusively for module developers, while
:command:`install` is more often used by installers (although some developers :command:`install` is more often used by installers (although some developers
will want to install their own code occasionally). will want to install their own code occasionally).
If you want to make things really easy for your users, you can create more If you want to make things really easy for your users, you can create more
than one built distributions for them. For instance, if you are running on a than one built distributions for them. For instance, if you are running on a
Windows machine and want to make things easy for other Windows users, you can Windows machine and want to make things easy for other Windows users, you can
create an executable installer (the most appropriate type of built distribution create an executable installer (the most appropriate type of built distribution
...@@ -125,18 +125,18 @@ by running :: ...@@ -125,18 +125,18 @@ by running ::
General Python terminology General Python terminology
========================== ==========================
If you're reading this document, you probably have a good idea of what Python If you're reading this document, you probably have a good idea of what Python
modules, extensions and so forth are. Nevertheless, just to be sure that modules, extensions and so forth are. Nevertheless, just to be sure that
everyone is on the same page, here's a quick overview of Python terms: everyone is on the same page, here's a quick overview of Python terms:
module module
The basic unit of code reusability in Python: a block of code imported by The basic unit of code reusability in Python: a block of code imported by
some other code. Three types of modules are important to us here: pure some other code. Three types of modules are important to us here: pure
Python modules, extension modules and packages. Python modules, extension modules and packages.
pure Python module pure Python module
A module written in Python and contained in a single :file:`.py` file (and A module written in Python and contained in a single :file:`.py` file (and
possibly associated :file:`.pyc` and/or :file:`.pyo` files). Sometimes possibly associated :file:`.pyc` and/or :file:`.pyo` files). Sometimes
referred to as a "pure module." referred to as a "pure module."
extension module extension module
...@@ -148,18 +148,18 @@ extension module ...@@ -148,18 +148,18 @@ extension module
currently Distutils only handles C/C++ extensions for Python. currently Distutils only handles C/C++ extensions for Python.
package package
A module that contains other modules, typically contained in a directory of A module that contains other modules, typically contained in a directory of
the filesystem and distinguished from other directories by the presence of a the filesystem and distinguished from other directories by the presence of a
file :file:`__init__.py`. file :file:`__init__.py`.
root package root package
The root of the hierarchy of packages. (This isn't really a package, The root of the hierarchy of packages. (This isn't really a package,
since it doesn't have an :file:`__init__.py` file. But... we have to since it doesn't have an :file:`__init__.py` file. But... we have to
call it something, right?) The vast majority of the standard library is call it something, right?) The vast majority of the standard library is
in the root package, as are many small standalone third-party modules that in the root package, as are many small standalone third-party modules that
don't belong to a larger module collection. Unlike regular packages, don't belong to a larger module collection. Unlike regular packages,
modules in the root package can be found in many directories: in fact, modules in the root package can be found in many directories: in fact,
every directory listed in ``sys.path`` contributes modules to the root every directory listed in ``sys.path`` contributes modules to the root
package. package.
...@@ -175,8 +175,8 @@ module distribution ...@@ -175,8 +175,8 @@ module distribution
A collection of Python modules distributed together as a single downloadable A collection of Python modules distributed together as a single downloadable
resource and meant to be installed all as one. Examples of some well-known resource and meant to be installed all as one. Examples of some well-known
module distributions are NumPy, SciPy, PIL (the Python Imaging module distributions are NumPy, SciPy, PIL (the Python Imaging
Library) or mxBase. (Module distributions would be called a *package*, Library) or mxBase. (Module distributions would be called a *package*,
except that term is already taken in the Python context: a single module except that term is already taken in the Python context: a single module
distribution may contain zero, one, or many Python packages.) distribution may contain zero, one, or many Python packages.)
pure module distribution pure module distribution
...@@ -189,5 +189,5 @@ non-pure module distribution ...@@ -189,5 +189,5 @@ non-pure module distribution
distribution root distribution root
The top-level directory of your source tree (or source distribution). The The top-level directory of your source tree (or source distribution). The
directory where :file:`setup.py` exists. Generally :file:`setup.py` will directory where :file:`setup.py` exists. Generally :file:`setup.py` will
be run from this directory. be run from this directory.
...@@ -9,7 +9,7 @@ installing modules using Distutils. The main purpose of the setup script is ...@@ -9,7 +9,7 @@ installing modules using Distutils. The main purpose of the setup script is
to describe your module distribution to Distutils, so that the various to describe your module distribution to Distutils, so that the various
commands that operate on your modules do the right thing. As we saw in section commands that operate on your modules do the right thing. As we saw in section
:ref:`packaging-simple-example`, the setup script consists mainly of a :ref:`packaging-simple-example`, the setup script consists mainly of a
call to :func:`setup` where the most information is supplied as call to :func:`setup` where the most information is supplied as
keyword arguments to :func:`setup`. keyword arguments to :func:`setup`.
Here's a slightly more involved example, which we'll follow for the next couple Here's a slightly more involved example, which we'll follow for the next couple
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment