[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ A ] [ B ] [ C ] [ next ]

# Debian Python Policy

## Abstract

This document describes the packaging of Python within the Debian GNU/Linux distribution and the policy requirements for packaged Python programs and modules.

## Copyright Notice

Copyright © 1999—2014 Software in the Public Interest

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.

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.

A copy of the GNU General Public License is available as `/usr/share/common-licences/GPL` in the Debian GNU/Linux distribution or on the World Wide Web at `The GNU General Public License`.

You can also obtain it by writing to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

## Contents

- 1 On the move to Python 3
- 2 Python Packaging
  - 2.1 Versions
  - 2.2 Main packages
  - 2.3 Minimal packages
  - 2.4 Python Interpreter
    - 2.4.1 Interpreter Name
    - 2.4.2 Interpreter Location
  - 2.5 Module Path
  - 2.6 Hooks for updates to installed runtimes
  - 2.7 Documentation
- 3 Packaged Modules
  - 3.1 Types of Python Modules
  - 3.2 Wheels
  - 3.3 Module Package Names
  - 3.4 Specifying Supported Versions
  - 3.5 Dependencies
  - 3.6 Provides
  - 3.7 Modules Byte-Compilation
- 4 Python Programs
  - 4.1 Programs using the default python
    - 4.1.1 Programs Shipping Private Modules
  - 4.2 Programs Using a Particular Python Version
- 5 Programs Embedding Python
  - 5.1 Building Embedded Programs
  - 5.2 Embedded Python Dependencies
- 6 Interaction with Locally Installed Python Versions
- A Build Dependencies
- B Packaging Tools
  - B.1 distutils
  - B.2 python-support (deprecated)
  - B.3 python-central (removed)
  - B.4 CDBS
  - B.5 dh_python2 and dh_python3
- C Upgrade Procedure

[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ A ] [ B ] [ C ] [ next ]

Debian Python Policy