Search.setIndex({"alltitles": {"Abstract": [[3, null]], "Appendix": [[3, null]], "Build Dependencies": [[0, null]], "Building Embedded Programs": [[2, "building-embedded-programs"]], "CDBS": [[7, "cdbs"]], "Completing the move to Python 3": [[9, null]], "Contents": [[3, "contents"]], "Copyright": [[1, null]], "Dependencies": [[6, "dependencies"]], "Documentation": [[4, "documentation"]], "Embedded Python Dependencies": [[2, "embedded-python-dependencies"]], "Hooks for updates to installed runtimes": [[4, "hooks-for-updates-to-installed-runtimes"]], "Indices and tables": [[3, "indices-and-tables"]], "Interaction with Locally Installed Python Versions": [[5, null]], "Interpreter Location": [[4, "interpreter-location"]], "Interpreter Name": [[4, "interpreter-name"]], "Interpreter directive (\u201cShebang\u201d)": [[8, "interpreter-directive-shebang"]], "Main packages": [[4, "main-packages"]], "Minimal packages": [[4, "minimal-packages"]], "Module Package Names": [[6, "module-package-names"]], "Module Path": [[4, "module-path"]], "Modules Byte-Compilation": [[6, "modules-byte-compilation"]], "Packaged Modules": [[6, null]], "Packaging Tools": [[7, null]], "Programs Embedding Python": [[2, null]], "Programs Shipping Private Modules": [[8, "programs-shipping-private-modules"]], "Programs Using a Particular Python Version": [[8, "programs-using-a-particular-python-version"]], "Programs using the default Python": [[8, "programs-using-the-default-python"]], "Provides": [[6, "provides"]], "Python Interpreter": [[4, "python-interpreter"]], "Python Packaging": [[4, null]], "Python Programs": [[8, null]], "Removal of the unversioned packages": [[9, "removal-of-the-unversioned-packages"]], "Specifying Supported Versions": [[6, "specifying-supported-versions"]], "This document": [[10, null]], "Types of Python Modules": [[6, "types-of-python-modules"]], "Unversioned python commands": [[9, "unversioned-python-commands"]], "Upgrade Procedure": [[11, null]], "Versions": [[4, "versions"]], "Virtual packages for Python-version specific dependencies": [[4, "virtual-packages-for-python-version-specific-dependencies"]], "Wheels": [[6, "wheels"]], "dh-python": [[7, "dh-python"]], "distutils": [[7, "distutils"]], "pybuild": [[7, "pybuild"]], "python-central (removed)": [[7, "python-central-removed"]], "python-support (removed)": [[7, "python-support-removed"]], "setuptools": [[7, "setuptools"]]}, "docnames": ["build-dependencies", "copyright", "embedded-python", "index", "interpreter", "locally-installed-python", "packaged-modules", "packaging-tools", "python-programs", "python3", "this-document", "upgrade-procedure"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["build-dependencies.rst", "copyright.rst", "embedded-python.rst", "index.rst", "interpreter.rst", "locally-installed-python.rst", "packaged-modules.rst", "packaging-tools.rst", "python-programs.rst", "python3.rst", "this-document.rst", "upgrade-procedure.rst"], "indexentries": {"environment variable": [[4, "index-1", false]], "pep 394": [[4, "index-0", false]], "pep 404": [[9, "index-0", false]], "pep 427": [[6, "index-0", false]], "pep 466": [[9, "index-1", false]], "python enhancement proposals": [[4, "index-0", false], [6, "index-0", false], [9, "index-0", false], [9, "index-1", false]], "pythonpath": [[4, "index-1", false]]}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [4, 5, 6, 8], "0": 4, "02110": 1, "1": [0, 4], "10": 9, "11": 9, "12": 9, "1301": 1, "1999": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "2": [0, 1, 4, 6, 7, 8, 9], "2021": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "3": [0, 3, 4, 6, 8, 11], "394": 4, "4": [4, 6], "404": 9, "427": 6, "466": 9, "5": [0, 4, 6, 8], "51": 1, "6": [0, 4, 7, 8], "7": [0, 4, 9], "9": 0, "A": [0, 1, 4, 6, 8], "As": [4, 5, 6, 8], "At": 4, "By": 4, "FOR": 1, "For": [4, 6, 9, 11], "If": [4, 5, 6, 7, 8, 9], "In": 4, "It": [2, 4, 6, 7], "No": 9, "Such": 6, "The": [0, 2, 4, 6, 7, 8, 9, 11], "Their": 7, "There": [4, 6], "These": [4, 6, 8, 9], "To": 0, "abl": 0, "abov": 7, "absent": 4, "access": 6, "accomplish": 6, "achiev": 6, "across": 6, "act": 4, "ad": [6, 11], "add": 7, "addit": [4, 11], "adequ": 6, "administr": 4, "advantag": 6, "advis": 4, "affect": [4, 5], "after": [9, 11], "afterward": 4, "again": [6, 11], "against": [2, 6], "all": [0, 4, 5, 6, 9, 11], "allow": [4, 6], "along": 7, "alreadi": 4, "also": [1, 4, 6, 8], "altern": 4, "although": [7, 9], "alwai": 4, "an": [7, 8, 9], "ani": [0, 1, 2, 4, 6, 8, 9, 11], "announc": 11, "anoth": 7, "apart": 4, "api": 7, "appear": 4, "append": 4, "appendix": 7, "appli": [6, 8], "applic": [0, 4, 9, 11], "approach": 6, "appropri": [6, 8], "ar": [4, 6, 7, 8, 9, 11], "architectur": [4, 8, 11], "archiv": [6, 9], "argument": 4, "assist": 11, "associ": 11, "au": 1, "author": 1, "autom": 6, "automat": [2, 6, 7], "avail": [1, 4, 6, 9], "avoid": [0, 4], "awai": 7, "b": 6, "back": 6, "bar": 6, "barri": 1, "base": [6, 7], "becom": 4, "been": [4, 6, 7], "befor": [4, 9], "being": 4, "belong": 6, "below": 6, "ben": 1, "benfinnei": 1, "best": 6, "beta": 4, "between": 6, "bin": [4, 6, 8, 9], "binari": [4, 6, 8, 9], "binnmu": 11, "block": 9, "bookworm": 9, "bootstrap": 4, "boston": 1, "both": [6, 11], "bound": 6, "break": 9, "build": [3, 4, 6, 7, 9, 11], "built": [0, 2, 4, 6], "bullsey": [4, 9], "buster": 9, "bypass": 4, "byte": [3, 4, 7, 8], "bytecod": 6, "c": 6, "calcul": 7, "call": [4, 6], "can": [1, 4, 6, 8, 9, 11], "candid": 11, "cannot": [4, 6], "capit": 6, "care": [5, 11], "case": [4, 6], "caus": 11, "cdb": 3, "central": 3, "chang": [4, 6, 7, 10, 11], "check": 4, "choos": 6, "class": 7, "clear": 6, "clearer": 6, "code": 6, "codehelp": 1, "com": 1, "come": 4, "comma": 6, "command": [3, 7], "common": [1, 4], "compat": 6, "compil": [3, 4, 7, 8], "complet": [3, 4], "compliant": 6, "compon": 6, "config": 9, "configpars": 4, "configur": 6, "confus": 6, "consensu": 11, "consist": 6, "constraint": 6, "contain": 6, "continu": [6, 9], "control": 6, "conveni": [4, 6], "coordin": 11, "copi": 1, "copyright": 3, "core": 11, "correct": 6, "correctli": 2, "correspond": 6, "cours": 6, "creat": 2, "current": [2, 4, 6, 8], "d": 4, "dbg": [4, 9], "deb": 7, "debhelp": 7, "debian": [1, 3, 4, 5, 6, 7, 9, 10, 11], "debian_config": 6, "debian_default": 4, "debug": 6, "declar": [0, 2, 4, 6, 8], "dedic": 4, "default": [2, 3, 4, 6, 7, 9, 10, 11], "defin": [4, 6], "depend": [3, 7, 8, 9, 11], "deploy": [4, 6], "deprec": [6, 8], "describ": [3, 6, 7, 11], "design": [4, 7], "desir": 6, "detail": [1, 4, 6, 7], "dev": [0, 2, 4, 9, 11], "develop": [4, 7, 9], "dh": [3, 4], "dh_python3": 7, "differ": [4, 5], "difficult": 6, "direct": 3, "directli": 6, "directori": [4, 6, 7, 8], "dirtbik": 6, "discuss": [9, 11], "dist": [4, 6, 7], "distinguish": 4, "distribut": [1, 3, 4, 6], "distro": 6, "distro_info": 6, "distutil": [3, 4], "django": 6, "django_": 6, "do": 4, "doc": [4, 6, 9, 11], "document": [3, 6, 7, 9], "doe": [0, 2, 4, 6, 9], "doko": 1, "don": 5, "done": [6, 11], "dot": 6, "dpkg": 2, "drop": [9, 11], "dure": 6, "e": [4, 6, 8], "each": 4, "earlier": 4, "easier": 7, "easili": 6, "egg": 6, "either": [1, 4, 6, 8], "emb": 2, "embed": 3, "enabl": [4, 6], "encod": 6, "encourag": [6, 7], "enough": 6, "enshrin": 4, "ensur": 4, "ensurepip": 4, "entangl": 11, "entir": 4, "entri": 4, "env": [4, 8], "environ": [0, 4, 6], "equal": 4, "establish": 6, "etc": [6, 7], "even": [1, 4], "everi": [0, 4, 6], "examin": 6, "exampl": [4, 6], "except": [4, 6], "exclud": 4, "execut": [4, 8], "exist": [4, 9], "experiment": 11, "explain": [4, 8], "explicitli": [4, 6], "extend": 9, "extens": [0, 6, 7, 8], "fail": 4, "far": 4, "field": 6, "fifth": 1, "file": [4, 6, 7], "finnei": 1, "first": [4, 8], "fit": 1, "flag": 7, "flight": 1, "floor": 1, "focu": 7, "follow": [4, 6], "foo": [4, 6, 8], "forcefulli": 6, "form": [4, 6, 8, 11], "format": [4, 6], "found": 4, "foundat": 1, "fourth": 4, "franklin": 1, "free": 1, "from": [4, 6, 7, 9, 11], "full": [4, 7], "fulli": [4, 7], "function": 4, "futur": [4, 6, 7], "g": [4, 6, 8], "gdbm": 4, "gener": [1, 6, 8, 11], "get": 11, "git": 10, "given": 4, "glossari": 6, "gnu": [1, 3], "goal": [4, 6, 9], "got": 5, "gpl": [1, 4], "greater": 4, "gregor": 1, "grep": 6, "guarante": 6, "ha": [4, 6, 7, 9], "handl": [4, 6, 8], "have": [4, 5, 6, 8, 11], "heat": 11, "help": [6, 7], "helper": 4, "higher": 6, "histor": 4, "hoffleit": 1, "hook": 3, "hope": 1, "how": 6, "howev": 6, "hyphen": 6, "i": [0, 1, 2, 4, 6, 7, 8, 9, 10, 11], "id": [1, 6], "ignor": 6, "immedi": 4, "implement": [4, 6], "impli": 1, "import": 6, "improv": 7, "inc": 1, "includ": [4, 6], "incomplet": 4, "inde": 4, "independ": [4, 6], "index": 3, "individu": 6, "info": 6, "inform": [4, 6], "initi": 9, "insid": 6, "instal": [2, 3, 6, 7, 8, 9], "instanc": 4, "instead": 6, "integr": 4, "intend": 6, "interact": 3, "interdepend": 4, "interest": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "interfac": 4, "interfer": 4, "intern": 6, "interpret": [2, 3, 6, 9], "interpreter_loc": 8, "interpreter_nam": 8, "introduc": 9, "invok": [4, 7], "its": [6, 8], "itself": [6, 8], "jessi": 7, "joe": 1, "joss": 1, "josselin": 1, "just": 7, "keep": 11, "keyword": 6, "kind": 6, "kitterman": 1, "klose": 1, "larg": [6, 7], "last": [4, 9], "later": [1, 4, 6, 7], "latest": [4, 9], "layout": 7, "least": 0, "legaci": 4, "less": 6, "letter": 6, "lib": [4, 6, 7, 8], "lib2to3": 4, "libpython": [2, 6], "librari": [2, 4, 6, 9], "licenc": 1, "licens": [1, 4], "like": 9, "limit": 6, "line": [6, 7, 8], "link": [2, 6], "linux": [1, 3], "list": [4, 6, 9, 10], "local": [3, 4, 7, 9], "locat": [3, 6, 8], "long": [4, 5, 11], "longer": 6, "lool": 1, "loos": 6, "lower": [4, 6], "lo\u00efc": 1, "ma": 1, "mai": [0, 4, 6, 7, 8, 9, 11], "mail": [9, 10], "main": 3, "maintain": [4, 6, 7, 11], "major": [4, 6, 9], "make": [4, 6, 7, 11], "man": 7, "manag": [4, 6, 7], "mandatori": 7, "mani": [6, 11], "manual": [1, 11], "matthia": 1, "max": 4, "maximum": 6, "mechan": 4, "merchant": 1, "messag": 4, "met": 4, "meta": 11, "metadata": 6, "micro": [4, 5], "might": 4, "min": 4, "mind": 7, "minier": 1, "minim": [3, 9], "minor": [4, 8, 9], "minu": 6, "mk": 7, "modifi": [1, 4, 7], "modul": [0, 3, 5, 7, 11], "more": [1, 6, 9, 11], "mouett": 1, "move": [3, 4], "multi": 11, "multipl": [4, 6, 7, 8, 11], "must": [0, 2, 4, 6, 8, 9], "na": 1, "name": [3, 8], "namespac": 6, "narrow": 6, "necessari": [6, 8, 11], "necessarili": 6, "need": [4, 5, 6, 8, 9, 11], "neil": 1, "never": 6, "new": [4, 5, 7, 9, 11], "newer": 4, "nmu": 6, "none": 7, "normal": 6, "note": [4, 8, 9], "now": 11, "number": [4, 6], "obsolet": 6, "obtain": 1, "occur": 4, "off": 4, "offer": 7, "offici": 4, "old": [4, 11], "older": 11, "onc": 11, "one": [6, 9, 11], "onli": [0, 4, 6, 7, 8, 9, 11], "oper": 6, "optim": 6, "option": [1, 4, 6], "order": [6, 7, 11], "org": 1, "other": [4, 5, 6, 9, 11], "out": 4, "outsid": 4, "overrid": [4, 7], "overview": 7, "own": [6, 8], "packag": [0, 2, 3, 8, 11], "page": 3, "paragraph": 6, "part": 9, "parti": 4, "particular": [1, 3, 4, 6], "path": [3, 5, 6], "pep": [4, 6, 9], "phase": 11, "piman": 1, "pip": [4, 6], "pkg": 6, "place": 6, "plan": 9, "pleas": 9, "point": [4, 7, 9], "polici": [3, 4, 6, 7, 10, 11], "port": 9, "possibl": [6, 11], "post": [4, 6, 8], "pre": [4, 6, 8, 11], "prefer": [4, 6], "prefix": 6, "prepar": 11, "prerm": 6, "preserv": 6, "previous": 9, "print": 4, "privat": [3, 4, 6], "problem": 4, "procedur": 3, "profil": 4, "program": [3, 6, 7], "propos": 10, "provid": [2, 3, 4, 7, 9], "provis": 6, "public": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "publish": 1, "pure": [0, 6], "purpos": [1, 4, 6], "put": 6, "py": [4, 6, 7], "py3vers": 4, "pybuild": 3, "pyc": 6, "pydoc": 9, "pyo": 6, "pyshar": 4, "python": [0, 3, 10, 11], "python2": [0, 4, 6, 8, 9], "python3": [0, 4, 6, 8, 9, 10, 11], "pythonpath": 4, "pyvenv": 6, "pyvers": 4, "pyxdg": 6, "re": 6, "read": 7, "readi": 11, "reason": [4, 6], "rebuild": [6, 11], "rebuilt": 11, "recommend": [4, 6, 7, 9], "recompil": [6, 11], "redistribut": 1, "reduc": [6, 9], "redund": 6, "refer": 4, "relat": [7, 11], "releas": [4, 6, 7, 9, 11], "remain": [4, 6], "remov": [3, 4, 6, 8, 11], "replac": [6, 7], "repositori": 10, "repres": [4, 6], "request": 7, "requir": [0, 3, 4, 6, 8, 11], "reserv": 4, "resolv": 6, "respect": 6, "revers": 9, "review": 10, "rewheel": 6, "rivera": 1, "root": 6, "rtinstal": 4, "rtremov": 4, "rtupdat": [4, 6], "rule": 8, "run": [6, 8], "runtim": [0, 3, 6], "same": [4, 6, 7, 8], "schedul": 11, "schemenau": 1, "scope": 4, "scott": 1, "script": [4, 6, 7, 8, 9], "search": [3, 4], "second": 4, "section": [4, 7, 11], "see": [1, 4, 6, 7, 8, 9], "seem": 4, "seen": 7, "select": [9, 11], "sens": 6, "separ": [4, 6], "set": [4, 6], "setup": 7, "setuptool": [3, 6], "sever": [6, 11], "shall": [4, 6], "share": [1, 2, 4, 6, 8], "shebang": 3, "shift": 7, "ship": [3, 6], "shlibdep": 2, "shortli": 6, "should": [0, 2, 4, 6, 7, 8, 9], "similar": 7, "similarli": 6, "sinc": [4, 6], "singl": [6, 8], "site": [4, 7], "smooth": 11, "so": [2, 6, 9, 11], "softwar": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "some": [0, 4, 6, 7, 9, 11], "sourc": [6, 10, 11], "special": 4, "specif": [0, 3, 6, 7, 8], "specifi": [3, 4, 8], "split": [4, 6], "st": 1, "stabl": 4, "stack": [4, 6, 9], "standard": [4, 7], "start": 9, "state": 9, "statement": 6, "stefano": 1, "stefanor": 1, "still": [4, 9], "stop": 4, "stretch": [4, 7], "strictli": 6, "strongli": 7, "structur": 6, "subject": 6, "subpackag": 6, "substitut": 6, "suffici": [4, 6], "suffix": 6, "suggest": 9, "suit": 6, "superset": 4, "support": [3, 4, 8, 9, 11], "sure": 6, "sy": [4, 6], "symbol": 6, "symlink": 4, "synonym": 4, "system": [1, 4, 6, 7], "t": 5, "take": 6, "team": 11, "term": [1, 6], "test": 11, "than": [4, 6], "thei": [4, 6, 7, 8, 11], "them": [0, 4, 6, 7], "themselv": [4, 8], "thereaft": 6, "thi": [1, 2, 3, 4, 6, 7, 8, 9, 11], "third": 4, "those": [8, 9], "three": [4, 11], "through": [4, 6], "tight": 8, "time": [4, 6], "tk": 4, "todo": 4, "too": 5, "tool": [3, 4, 6], "trace": 6, "track": 4, "tracker": 11, "transient": 11, "transit": [6, 11], "treat": 4, "true": 11, "turn": 6, "two": [6, 9], "type": [3, 4], "typic": 11, "unavoid": 11, "under": 1, "underscor": 6, "uninstal": 11, "univers": 6, "unless": [2, 6], "unrel": 6, "unstabl": 11, "unsupport": 4, "until": 9, "unvers": [3, 4], "updat": [3, 6, 11], "upgrad": [3, 4, 6, 9], "upload": [9, 11], "upon": 4, "upstream": [4, 6, 7, 9], "us": [0, 1, 3, 4, 5, 6, 7, 9], "usa": 1, "user": [6, 9], "usr": [1, 4, 6, 7, 8, 9], "valu": 6, "variabl": [4, 6], "varieti": 6, "variou": 7, "venv": 4, "veri": 6, "versa": 7, "version": [0, 1, 2, 3, 7, 9, 11], "via": 6, "vice": 7, "virtual": [3, 6], "virtualenv": 6, "vulner": 4, "wa": 4, "wai": [6, 7], "want": 6, "warranti": 1, "warsaw": 1, "we": 6, "web": 1, "well": [4, 9], "were": 6, "wheel": [3, 4], "wheezi": [4, 6], "when": [0, 4, 6, 7, 9, 11], "whenev": 6, "where": [2, 4, 11], "which": [2, 4, 6, 7, 8], "whl": 6, "wide": 1, "william": 1, "within": [3, 4], "without": 1, "won": 5, "work": [2, 4, 6, 11], "world": 1, "would": 4, "wreschnig": 1, "write": 1, "written": 8, "x": [0, 2, 4, 6, 7, 8], "xb": 6, "xdg": 6, "xlib": 6, "xorg": 4, "y": [0, 2, 4, 6, 7, 8, 11], "yet": [6, 9], "you": [1, 5, 7], "your": [1, 5], "z": [2, 4], "zip": [4, 6]}, "titles": ["<span class=\"section-number\">1. </span>Build Dependencies", "<span class=\"section-number\">1. </span>Copyright", "<span class=\"section-number\">6. </span>Programs Embedding Python", "Abstract", "<span class=\"section-number\">3. </span>Python Packaging", "<span class=\"section-number\">7. </span>Interaction with Locally Installed Python Versions", "<span class=\"section-number\">4. </span>Packaged Modules", "<span class=\"section-number\">2. </span>Packaging Tools", "<span class=\"section-number\">5. </span>Python Programs", "<span class=\"section-number\">2. </span>Completing the move to Python 3", "<span class=\"section-number\">4. </span>This document", "<span class=\"section-number\">3. </span>Upgrade Procedure"], "titleterms": {"3": 9, "abstract": 3, "appendix": 3, "build": [0, 2], "byte": 6, "cdb": 7, "central": 7, "command": 9, "compil": 6, "complet": 9, "content": 3, "copyright": 1, "default": 8, "depend": [0, 2, 4, 6], "dh": 7, "direct": 8, "distutil": 7, "document": [4, 10], "embed": 2, "hook": 4, "indic": 3, "instal": [4, 5], "interact": 5, "interpret": [4, 8], "local": 5, "locat": 4, "main": 4, "minim": 4, "modul": [4, 6, 8], "move": 9, "name": [4, 6], "packag": [4, 6, 7, 9], "particular": 8, "path": 4, "privat": 8, "procedur": 11, "program": [2, 8], "provid": 6, "pybuild": 7, "python": [2, 4, 5, 6, 7, 8, 9], "remov": [7, 9], "runtim": 4, "setuptool": 7, "shebang": 8, "ship": 8, "specif": 4, "specifi": 6, "support": [6, 7], "tabl": 3, "thi": 10, "tool": 7, "type": 6, "unvers": 9, "updat": 4, "upgrad": 11, "us": 8, "version": [4, 5, 6, 8], "virtual": 4, "wheel": 6}})