Default page

Edit File: index.html

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Debian Python Policy</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><meta name="description" content="This document describes the packaging of Python within the Debian GNU/Linux distribution and the policy requirements for packaged Python programs and modules." /><link rel="home" href="index.html" title="Debian Python Policy" /><link rel="next" href="python3.html" title="Chapter 1. Completing the move to Python 3" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Debian Python Policy</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="python3.html">Next</a></td></tr></table><hr /></div><div xml:lang="en" class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="idm1"></a>Debian Python Policy</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Neil</span> <span class="surname">Schemenauer</span></h3><code class="email"><<a class="email" href="mailto:nas@debian.org">nas@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Matthias</span> <span class="surname">Klose</span></h3><code class="email"><<a class="email" href="mailto:doko@debian.org">doko@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Gregor</span> <span class="surname">Hoffleit</span></h3><code class="email"><<a class="email" href="mailto:flight@debian.org">flight@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Josselin</span> <span class="surname">Mouette</span></h3><code class="email"><<a class="email" href="mailto:joss@debian.org">joss@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Joe</span> <span class="surname">Wreschnig</span></h3><code class="email"><<a class="email" href="mailto:piman@debian.org">piman@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Loïc</span> <span class="surname">Minier</span></h3><code class="email"><<a class="email" href="mailto:lool@debian.org">lool@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Scott</span> <span class="surname">Kitterman</span></h3><code class="email"><<a class="email" href="mailto:scott@kitterman.com">scott@kitterman.com</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Barry</span> <span class="surname">Warsaw</span></h3><code class="email"><<a class="email" href="mailto:barry@debian.org">barry@debian.org</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Ben</span> <span class="surname">Finney</span></h3><code class="email"><<a class="email" href="mailto:ben+debian@benfinney.id.au">ben+debian@benfinney.id.au</a>></code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Neil</span> <span class="surname">Williams</span></h3><code class="email"><<a class="email" href="mailto:codehelp@debian.org">codehelp@debian.org</a>></code></div></div><div><p class="copyright">Copyright © 1999, 2019 Software in the Public Interest</p></div><div><div class="legalnotice"><a id="idm61"></a><p>
	  This manual is free software; you can redistribute it and/or
	  modify it under the terms of the GNU General Public License
	  as published by the Free Software Foundation; either version
	  2 of the License, or (at your option) any later version.
	</p><p>
	  This is distributed in the hope that it will be useful, but
	  WITHOUT ANY WARRANTY; without even the implied warranty of
	  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
	  the GNU General Public License for more details.
	</p><p>
	  A copy of the GNU General Public License version 2 is available as
	  <code class="filename">/usr/share/common-licences/GPL-2</code> in the Debian
	  GNU/Linux system, or on the World Wide Web at
	  <a class="ulink" href="https://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_blank">GNU General Public License, version 2</a>.
	</p><p>
	  You can also obtain it by writing to the
	  Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
	  Boston, MA 02110-1301, USA.
	</p></div></div><div><div class="abstract"><p class="title"><strong>Abstract</strong></p><p>
	This document describes the packaging of Python within the
	Debian GNU/Linux distribution and the policy requirements for
	packaged Python programs and modules.
      </p></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="python3.html">1. Completing the move to Python 3</a></span></dt><dt><span class="chapter"><a href="python.html">2. Python Packaging</a></span></dt><dd><dl><dt><span class="section"><a href="python.html#versions">2.1. Versions</a></span></dt><dt><span class="section"><a href="python.html#base">2.2. Main packages</a></span></dt><dt><span class="section"><a href="python.html#minimal">2.3. Minimal packages</a></span></dt><dt><span class="section"><a href="python.html#interpreter">2.4. Python Interpreter</a></span></dt><dd><dl><dt><span class="section"><a href="python.html#interpreter_name">2.4.1. Interpreter Name</a></span></dt><dt><span class="section"><a href="python.html#interpreter_loc">2.4.2. Interpreter Location</a></span></dt></dl></dd><dt><span class="section"><a href="python.html#paths">2.5. Module Path</a></span></dt><dt><span class="section"><a href="python.html#runtimes_hooks">2.6. Hooks for updates to installed runtimes</a></span></dt><dt><span class="section"><a href="python.html#docs">2.7. Documentation</a></span></dt></dl></dd><dt><span class="chapter"><a href="module_packages.html">3. Packaged Modules</a></span></dt><dd><dl><dt><span class="section"><a href="module_packages.html#idm319">3.1. Types of Python Modules</a></span></dt><dt><span class="section"><a href="module_packages.html#wheels">3.2. Wheels</a></span></dt><dt><span class="section"><a href="module_packages.html#package_names">3.3. Module Package Names</a></span></dt><dt><span class="section"><a href="module_packages.html#specifying_versions">3.4. Specifying Supported Versions</a></span></dt><dt><span class="section"><a href="module_packages.html#dependencies">3.5. Dependencies</a></span></dt><dt><span class="section"><a href="module_packages.html#provides">3.6. Provides</a></span></dt><dt><span class="section"><a href="module_packages.html#byte_compilation">3.7. Modules Byte-Compilation</a></span></dt></dl></dd><dt><span class="chapter"><a href="programs.html">4. Python Programs</a></span></dt><dd><dl><dt><span class="section"><a href="programs.html#interpreter-directive">4.1. Interpreter directive (“Shebang”)</a></span></dt><dt><span class="section"><a href="programs.html#version_indep_progs">4.2. Programs using the default Python</a></span></dt><dd><dl><dt><span class="section"><a href="programs.html#current_version_progs">4.2.1. Programs Shipping Private Modules</a></span></dt></dl></dd><dt><span class="section"><a href="programs.html#version_dep_progs">4.3. Programs Using a Particular Python Version</a></span></dt></dl></dd><dt><span class="chapter"><a href="embed.html">5. Programs Embedding Python</a></span></dt><dd><dl><dt><span class="section"><a href="embed.html#build_embedded">5.1. Building Embedded Programs</a></span></dt><dt><span class="section"><a href="embed.html#embedded_deps">5.2. Embedded Python Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a href="other.html">6. Interaction with Locally Installed Python Versions</a></span></dt><dt><span class="appendix"><a href="build_dependencies.html">A. Build Dependencies</a></span></dt><dt><span class="appendix"><a href="packaging_tools.html">B. Packaging Tools</a></span></dt><dd><dl><dt><span class="section"><a href="packaging_tools.html#distutils">B.1. distutils</a></span></dt><dt><span class="section"><a href="packaging_tools.html#setuptools">B.2. setuptools</a></span></dt><dt><span class="section"><a href="packaging_tools.html#dh-python">B.3. <code class="literal">dh-python</code></a></span></dt><dt><span class="section"><a href="packaging_tools.html#pybuild">B.4. pybuild</a></span></dt><dt><span class="section"><a href="packaging_tools.html#cdbs">B.5. CDBS</a></span></dt><dt><span class="section"><a href="packaging_tools.html#pysupport">B.6. <code class="literal">python-support</code> (removed)</a></span></dt><dt><span class="section"><a href="packaging_tools.html#pycentral">B.7. <code class="literal">python-central</code> (removed)</a></span></dt></dl></dd><dt><span class="appendix"><a href="upgrade.html">C. Upgrade Procedure</a></span></dt></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="python3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Completing the move to Python 3</td></tr></table></div></body></html>