mirror of
https://github.com/python/cpython.git
synced 2025-10-31 21:51:50 +00:00
6ef038e78c
This started out as an easy task, just add a section describing this alternate scheme, but I found a lot of cleanup to do along the way: - fixed inverted reST targets - fixed entries for modules (hi abiflags!) or data files - avoided duplicating the same options listing five or six times - added missing entries for C headers locations - added documentation for --install-lib - fixed a few misuses of the option role (see #9312), but not all (not worth the time, but will do it in packaging docs) - fixed some markup The paths fixes were done with an eye on the source code in the install command, so they really describe what’s actually done. The situation on Mac OS X is rather messy: the fix for #8084 touched site and sysconfig, but distutils doesn’t use these files. I suspect we have a mismatched stdlib at the moment, and the fix is not even clear (see the bug report for further discussion).
56 lines
1.9 KiB
ReStructuredText
56 lines
1.9 KiB
ReStructuredText
.. _packaging-install-index:
|
|
|
|
******************************
|
|
Installing Python Projects
|
|
******************************
|
|
|
|
:Author: The Fellowship of the Packaging
|
|
:Release: |version|
|
|
:Date: |today|
|
|
|
|
.. TODO: Fill in XXX comments
|
|
|
|
.. The audience for this document includes people who don't know anything
|
|
about Python and aren't about to learn the language just in order to
|
|
install and maintain it for their users, i.e. system administrators.
|
|
Thus, I have to be sure to explain the basics at some point:
|
|
sys.path and PYTHONPATH at least. Should probably give pointers to
|
|
other docs on "import site", PYTHONSTARTUP, PYTHONHOME, etc.
|
|
|
|
Finally, it might be useful to include all the material from my "Care
|
|
and Feeding of a Python Installation" talk in here somewhere. Yow!
|
|
|
|
.. topic:: Abstract
|
|
|
|
This document describes Packaging from the end-user's point of view: it
|
|
explains how to extend the functionality of a standard Python installation by
|
|
building and installing third-party Python modules and applications.
|
|
|
|
|
|
This guide is split into a simple overview followed by a longer presentation of
|
|
the :program:`pysetup` script, the Python package management tool used to
|
|
build, distribute, search for, install, remove and list Python distributions.
|
|
|
|
.. TODO integrate install and pysetup instead of duplicating
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:numbered:
|
|
|
|
install
|
|
pysetup
|
|
pysetup-config
|
|
pysetup-servers
|
|
|
|
|
|
.. seealso::
|
|
|
|
:ref:`packaging-index`
|
|
The manual for developers of Python projects who want to package and
|
|
distribute them. This describes how to use :mod:`packaging` to make
|
|
projects easily found and added to an existing Python installation.
|
|
|
|
:mod:`packaging`
|
|
A library reference for developers of packaging tools wanting to use
|
|
standalone building blocks like :mod:`~packaging.version` or
|
|
:mod:`~packaging.metadata`, or extend Packaging itself.
|