pydoc > apt_pkg

man perldoc info pydoc3 ri search

📛 NAME

apt_pkg - Classes and functions wrapping the apt-pkg library.

🚀 Quick Reference

Use Case	Command	Description
🗂️ Open package cache	cache = apt_pkg.Cache(progress)	Load APT cache, optionally with progress reporting
🔍 Access a package	pkg = cache['apt']	Get a Package object by name (or tuple name, arch)
📦 List all packages	for pkg in cache.packages:	Iterate over every package in the cache
⚙️ Mark for install	depcache.mark_install(pkg)	Mark a package for installation (with auto_inst, from_user)
🗑️ Mark for removal	depcache.mark_delete(pkg, purge=True)	Mark package for deletion (or purging)
✅ Commit changes	depcache.commit(acquire_progress, install_progress)	Fetch and install marked packages
🔧 Read configuration	val = apt_pkg.config.find('APT::Get::Assume-Yes')	Retrieve a configuration value with optional default
📋 Parse dependencies	deps = apt_pkg.parse_depends('apt (>= 1.0)')	Return parsed dependency lists
🔒 System lock	with apt_pkg.SystemLock():	Context manager for global dpkg/apt lock
📥 Fetch files	acquire = apt_pkg.Acquire(progress)	Coordinate network/copy file retrieval

📖 DESCRIPTION

The apt_pkg module provides several classes and functions for accessing the functionality provided by the apt-pkg library. Typical uses might include reading APT index files and configuration files and installing or removing packages.

📦 CLASSES

_PackageManager(builtins.object) → PackageManager
builtins.SystemError(builtins.Exception) → Error
builtins.ValueError(builtins.Exception) → CacheMismatchError
builtins.object
   Acquire
   AcquireItem → AcquireFile
   AcquireItemDesc
   AcquireWorker
   ActionGroup
   Cache
   Cdrom
   Configuration
   DepCache
   Dependency
   DependencyList
   Description
   FileLock
   Group
   GroupList
   HashString
   HashStringList
   Hashes
   IndexFile
   MetaIndex
   OrderList
   Package
   PackageFile
   PackageList
   PackageRecords
   Policy
   ProblemResolver
   SourceList
   SourceRecordFiles
   SourceRecords
   SystemLock
   Tag → TagRemove, TagRename, TagRewrite
   TagFile
   TagSection
   Version

🏗️ Acquire

Acquire([progress: apt.progress.base.AcquireProgress])

📥 Coordinate file retrieval via network or local (copy:/). Optional progress object reports progress.

• get_lock(log: str) – 🔒 Acquire a lock for the given directory.
• run() -> int – ▶️ Run the fetcher; returns RESULT_CANCELLED, RESULT_CONTINUE, or RESULT_FAILED.
• shutdown() – 🛑 Shut down the fetcher, removing all items.

📊 Data descriptors:

• fetch_needed – 📦 Total bytes to fetch.
• items – 📋 List of AcquireItem objects.
• partial_present – ⏳ Bytes already available.
• total_needed – 📊 Total bytes needed (fetched + to fetch).
• workers – 👷 Active AcquireWorker objects.

🏷️ Constants:

• RESULT_CANCELLED = 2
• RESULT_CONTINUE = 0
• RESULT_FAILED = 1

📄 AcquireFile

AcquireFile(owner, uri[, hash, size, descr, short_descr, destdir, destfile])

📥 Represent a file to be fetched. Owner is an Acquire object. Optional parameters for hashes, size, descriptions, and destination.

Inherits from AcquireItem. See that class for common descriptors.

📦 AcquireItem

❗ Cannot be instantiated directly; use AcquireFile.

📊 Data descriptors:

• active_subprocess – 🏃 Active subprocess name (e.g., 'gzip', 'rred', 'gpgv').
• complete – ✅ Whether the item was fetched completely.
• desc_uri – 🌐 URI description.
• destfile – 📁 Destination file path.
• error_text – ❌ Error string if any.
• filesize – 📏 File size in bytes.
• id – 🔢 Integer ID.
• is_trusted – 🔐 True if from a trusted repository.
• local – 🏠 True if fetching a local item (copy:/).
• mode – ⏪ Old name for active_subprocess.
• partialsize – 📊 Bytes fetched so far.
• status – 🚦 Status; compare with STAT_* constants.

🏷️ Constants:

• STAT_AUTH_ERROR = 4
• STAT_DONE = 2
• STAT_ERROR = 3
• STAT_FETCHING = 1
• STAT_IDLE = 0
• STAT_TRANSIENT_NETWORK_ERROR = 5

📝 AcquireItemDesc

📋 Provide description and URI of an item. Used by progress classes.

📊 Data descriptors:

• description – 📄 Long description.
• owner – 👤 The owning AcquireItem.
• shortdesc – 📛 Short description (e.g., package name).
• uri – 🌐 The URI to download from.

👷 AcquireWorker

👷 Represent a sub-process fetching files using methods from Dir::Bin::Methods.

📊 Data descriptors:

• current_item – 📦 Currently fetched AcquireItemDesc.
• current_size – 📏 Fetched bytes for current item.
• resumepoint – ⏳ Bytes already available when download started.
• status – 🚦 Worker status string.
• total_size – 📊 Total size of current item.

⚡ ActionGroup

ActionGroup(depcache)

⚡ Disable cleanup actions for faster batch modifications. Use as context manager or call release(). Example:

with apt_pkg.ActionGroup(depcache):
    depcache.markInstall(pkg)

• release() – 🏁 End the action group; triggers deferred cleanup if last group.

🗂️ Cache

Cache([progress]) -> Cache() object.

📇 In‑core representation of the APT cache. Provides access to available packages, mapping names to Package objects. Optional progress for loading.

• update(progress, sources: SourceList, pulse_interval: int) -> bool – 🔄 Fetch updated index files; does not affect current cache.
• __contains__, __getitem__, __len__ – 🔍 Dictionary-like access.

📊 Data descriptors:

• depends_count – 🔗 Number of dependency objects.
• file_list – 📁 List of PackageFile objects.
• group_count – 📦 Number of Group objects.
• groups – 📋 List of Group objects.
• is_multi_arch – 🌐 Whether multi-arch is supported.
• package_count – 📊 Number of packages.
• package_file_count – 📑 Number of package files.
• packages – 📦 List of Package objects.
• policy – 🎯 The Policy for this cache.
• provides_count – 🔗 Number of Provides relations.
• ver_file_count – 🔗 (Version, PackageFile) relations.
• version_count – 🏷️ Number of Version objects.

🚫 CacheMismatchError

❌ Raised when an object from a different cache is passed to DepCache methods. Inherits from ValueError.

💿 Cdrom

Cdrom()

💿 Identify and add Debian installation media to /etc/apt/sources.list.

• add(progress: apt_pkg.CdromProgress) -> bool – ➕ Add CD-ROM to sources.
• ident(progress: apt_pkg.CdromProgress) -> str – 🔍 Return hexadecimal CD-ROM ID (or None).

⚙️ Configuration

Configuration()

🔧 Map option keys to values, reading from config files. The global apt_pkg.config is the most important instance.

• clear(key: str) – 🧹 Remove option and all sub-options.
• dump() -> str – 📄 Return a string dump of the configuration.
• exists(key: str) -> bool – ❓ Check if key exists.
• find(key: str[, default: str = '']) -> str – 🔍 Return value or default.
• find_b(key: str[, default: bool = False]) -> bool – ✅ Boolean variant.
• find_dir(key: str[, default: str = '']) -> str – 📁 Like find_file but adds trailing slash.
• find_file(key: str[, default: str = '']) -> str – 📂 Resolve filename with directory prefixes.
• find_i(key: str[, default: int = 0]) -> int – 🔢 Integer variant.
• get(key[, default]) -> str – 🔍 Same as find.
• keys([root: str]) -> list – 📋 All keys below root.
• list([root: str]) -> list – 📋 All items at root, full names.
• my_tag() -> str – 🏷️ Tag of the root (empty for global).
• set(key: str, value: str) – ✏️ Set key to value.
• subtree(key: str) -> apt_pkg.Configuration – 🌳 Return a sub-configuration rooted at key.
• value_list([root: str]) -> list – 📋 Values instead of keys.

📦 DepCache

DepCache(cache: apt_pkg.Cache)

📦 Holds extra state on packages: marks, broken status, etc. Required for package manipulation.

• commit(acquire_progress, install_progress) – ✅ Fetch and install marked changes.
• fix_broken() -> bool – 🔧 Attempt to fix broken packages.
• get_candidate_ver(pkg: apt_pkg.Package) -> apt_pkg.Version – 🎯 Get the candidate version.
• init(progress: apt.progress.base.OpProgress) – 🔄 (Re)initialize the depcache.
• is_auto_installed(pkg) -> bool – 🤖 Check if automatically installed.
• is_garbage(pkg) -> bool – 🗑️ Check if auto‑installed and no longer needed.
• is_inst_broken(pkg) -> bool – ❌ Broken ignoring marked changes.
• is_now_broken(pkg) -> bool – ❌ Broken including marked changes.
• is_upgradable(pkg) -> bool – ⬆️ Upgradable?
• mark_auto(pkg, auto: bool) – 🏷️ Mark as automatically installed or not.
• mark_delete(pkg[, purge: bool = False]) – 🗑️ Mark for deletion/purging.
• mark_install(pkg[, auto_inst=True, from_user=True]) – ⬇️ Mark for installation.
• mark_keep(pkg) – 🔒 Mark to keep current version.
• marked_delete(pkg) -> bool – ❓ Marked for removal?
• marked_downgrade(pkg) -> bool – ⬇️ Marked for downgrade?
• marked_install(pkg) -> bool – ⬇️ Marked for install?
• marked_keep(pkg) -> bool – 🔒 Should be kept?
• marked_reinstall(pkg) -> bool – 🔁 Marked for reinstall?
• marked_upgrade(pkg) -> bool – ⬆️ Marked for upgrade?
• minimize_upgrade() -> bool – 📉 Keep each package marked for upgrade if possible.
• read_pinfile([file: str]) – 📌 Read pin policy.
• set_candidate_release(pkg, ver, rel: string) -> bool – 🎯 Set candidate version and align dependencies to a release.
• set_candidate_ver(pkg, ver) -> bool – 🎯 Set candidate version.
• set_reinstall(pkg, reinstall: bool) – 🔁 Mark for reinstall.
• upgrade([dist_upgrade: bool = True]) -> bool – ⬆️ Mark packages for upgrade (dist-upgrade if true).

📊 Data descriptors:

• broken_count – ❌ Number of broken packages.
• deb_size – 📦 Total download size for changes.
• del_count – 🗑️ Packages marked for removal.
• inst_count – ⬇️ Packages marked for install.
• keep_count – 🔒 Packages marked for keep.
• policy – 🎯 The Policy object.
• usr_size – 💾 Disk space change (Installed-Size delta).

🔗 Dependency

🔗 Represent a dependency from one package version to a package, optionally with a version relation.

• all_targets() -> list – 🎯 All Version objects satisfying this dependency.

📊 Data descriptors:

• comp_type – 🔢 Comparison operator in mathematical notation: <, <=, =, !=, >=, >, ''.
• comp_type_deb – 🔢 Debian notation: <<, <=, =, !=, >=, >>, ''.
• dep_type – 🏷️ Translated dependency type string.
• dep_type_enum – 🔢 Numeric type; compare with TYPE_* constants.
• dep_type_untranslated – 🏷️ Untranslated type string.
• id – 🔢 Numeric ID.
• parent_pkg – 👤 Dependent package.
• parent_ver – 👤 Dependent version.
• target_pkg – 🎯 Package depended upon.
• target_ver – 🎯 Version string of target.

🏷️ Constants:

• TYPE_CONFLICTS = 5
• TYPE_DEPENDS = 1
• TYPE_DPKG_BREAKS = 8
• TYPE_ENHANCES = 9
• TYPE_OBSOLETES = 7
• TYPE_PREDEPENDS = 2
• TYPE_RECOMMENDS = 4
• TYPE_REPLACES = 6
• TYPE_SUGGESTS = 3

📋 DependencyList

📋 Efficient list-like type for Dependency objects. Supports __getitem__ and __len__.

📄 Description

📄 Represent a package description and attributes (e.g., for translations).

📊 Data descriptors:

• file_list – 📁 List of PackageFile objects.
• language_code – 🌐 Language code (empty for untranslated).
• md5 – 🔐 MD5 hash of the description.

❌ Error

❌ Exception class for most python-apt exceptions. Inherits from SystemError (catch this first). Introduced in 1.1.

🔒 FileLock

SystemLock(filename: str)

🔒 Context manager for file-based locking. Usage:

with apt_pkg.FileLock(filename):
    ...

• __enter__ – 🔒 Lock the file.
• __exit__ – 🔓 Release the lock.

📦 Group

Group(cache, name)

📦 Group of packages sharing the same name. Supports iteration and find_package(architecture), find_preferred_package(prefer_non_virtual=True).

📋 GroupList

📋 Efficient internal representation for the groups attribute of Cache. Supports __getitem__ and __len__.

🔐 HashString

HashString(type, hash) or HashString('type:hash')

🔐 Store a hash and its type (MD5Sum, SHA1, SHA256). Supports comparison operators and verify_file(filename).

📊 Data descriptors:

• hashtype – 🏷️ Hash type string.
• hashvalue – 🔢 Hexadecimal hash string.
• usable – ✅ Whether the hash is trusted.

📋 HashStringList

HashStringList()

📋 Manage a list of HashString objects. Knows the best hash and provides verify_file(filename).

• append(object: HashString) – ➕ Append a hash.
• find(type: str = "") -> HashString – 🔍 Find a hash of the given type, or the best one.
• verify_file(filename: str) -> bool – ✅ Verify all hashes in the list.

📊 Data descriptors:

• file_size – 📏 File size if part of the list, else 0.
• usable – ✅ Whether at least one trusted hash is present.

🔐 Hashes

Hashes([object: (bytes, file)])

🔐 Calculate all supported hashes for a given object (bytes, file descriptor, or file-like with fileno()).

📊 Data descriptors:

• hashes – 📋 A HashStringList of all computed hashes.

📑 IndexFile

📑 Represent an index file (package indexes, translation indexes, source indexes).

• archive_uri(path: str) -> str – 🌐 Return the URI for a given path in the archive.

📊 Data descriptors:

• describe – 📄 Description string.
• exists – ✅ Whether the file exists.
• has_packages – 📦 Whether it contains packages.
• is_trusted – 🔐 Whether it can be trusted (GPG signed Release).
• label – 🏷️ Label.
• size – 📏 Size in bytes.

🌐 MetaIndex

🌐 Provide information about meta-indexes (Release files): trusted status, URI, distribution, and list of IndexFile objects.

📊 Data descriptors:

• dist – 📦 Distribution string.
• index_files – 📋 List of IndexFile objects.
• is_trusted – 🔐 Trusted?
• uri – 🌐 URI of the meta index.

📋 OrderList

OrderList(depcache: DepCache)

📋 Sequence type for packages with ordering methods for configuration and unpacking.

• append(pkg: Package) – ➕ Append a package.
• flag(pkg: Package, flag: int[, unset_flags: int]) – 🏁 Set/clear flags.
• is_flag(pkg: Package, flag: int) – ❓ Check flag(s).
• is_missing(pkg: Package) – ❓ Check if package is marked for install.
• is_now(pkg: Package) – ❓ Check if package is flagged for any state but removal.
• order_configure() – 🔧 Order for configuration (Policy).
• order_critical() – ⚡ Order by PreDepends only (critical unpack).
• order_unpack() – 📦 Order for unpacking.
• score(pkg: Package) -> int – 📊 Return the score.
• wipe_flags(flags: int) – 🧹 Remove flags from all packages.

🏷️ Flags:

• FLAG_ADDED = 1
• FLAG_ADD_PENDIG = 2
• FLAG_AFTER = 256
• FLAG_CONFIGURED = 32
• FLAG_IMMEDIATE = 4
• FLAG_IN_LIST = 128
• FLAG_LOOP = 8
• FLAG_REMOVED = 64
• FLAG_STATES_MASK = 112
• FLAG_UNPACKED = 16

📦 Package

📦 Represent a package. Access versions via version_list, and manipulate with DepCache.

• get_fullname([pretty: bool = False]) -> str – 📛 Full name including architecture; omit arch for native if pretty=True.

📊 Data descriptors:

• architecture – 🏗️ Architecture.
• current_state – 🚦 Current state (compare with CURSTATE_*).
• current_ver – 🏷️ Currently installed version, or None.
• essential – ⭐ Essential flag.
• has_provides – 🔗 Whether provided by another package.
• has_versions – 📦 Whether any version exists in the cache.
• id – 🔢 Numeric ID.
• important – ❗ Old 'Important' flag.
• inst_state – 🚦 Install state (compare with INSTSTATE_*).
• name – 📛 Package name.
• provides_list – 📋 List of (providesname, providesver, version) tuples.
• rev_depends_list – 🔗 Reverse dependencies (DependencyList).
• selected_state – 🚦 Selection state (compare with SELSTATE_*).
• version_list – 📋 List of Version objects.

📑 PackageFile

📑 An index file stored in the cache with extra metadata.

📊 Data descriptors:

• architecture – 🏗️ Architecture (unused, empty).
• archive – 📦 Archive (Suite) from Release.
• codename – 🏷️ Codename (e.g., squeeze-updates).
• component – 🧩 Component (e.g., 'main').
• filename – 📁 Path to the file.
• id – 🔢 Numeric ID.
• index_type – 🏷️ Type string (e.g., 'Debian Package Index').
• label – 🏷️ Label from Release.
• not_automatic – 🚫 NotAutomatic flag.
• not_source – 🚫 Lacks an active source (packages cannot be downloaded).
• origin – 🌐 Origin from Release.
• site – 🌐 Hostname of the source.
• size – 📏 Size in bytes.
• version – 🏷️ Version from Release (e.g., '5.0.X').

📋 PackageList

📋 Efficient internal representation for the packages attribute of Cache. Supports __getitem__ and __len__.

📦 PackageManager

PackageManager(depcache: apt_pkg.DepCache)

📦 Fetch and install packages marked in the depcache. Override methods to implement custom behavior.

• configure(pkg: Package) -> bool – ⚙️ Add a configure action.
• go(status_fd: int) -> bool – ▶️ Start dpkg.
• install(pkg: Package, filename: str) -> bool – ⬇️ Add an install action.
• remove(pkg: Package, purge: bool) -> bool – 🗑️ Add a removal action.
• reset() – 🔄 Reset for a new round.
• do_install(status_fd: int) -> int – 🏁 Install packages; returns RESULT_COMPLETED, RESULT_FAILED, RESULT_INCOMPLETE.
• fix_missing() -> bool – 🔧 Fix missing packages.
• get_archives(fetcher: Acquire, list: SourceList, recs: PackageRecords) -> bool – 📥 Queue downloads.

🏷️ Constants:

• RESULT_COMPLETED = 0
• RESULT_FAILED = 1
• RESULT_INCOMPLETE = 2

📄 PackageRecords

PackageRecords(cache: apt_pkg.Cache)

📄 Retrieve package metadata like maintainer, filename, hashes, and raw record.

• lookup((packagefile: apt_pkg.PackageFile, index: int)) -> bool – 🔍 Change to a new package.

📊 Data descriptors:

• filename – 📁 Filename field.
• hashes – 🔐 HashStringList.
• homepage – 🌐 Homepage field.
• long_desc – 📄 Long description.
• maintainer – 👤 Maintainer field.
• md5_hash – 🔐 MD5 hash.
• name – 📛 Package name.
• record – 📋 Raw record (for TagSection).
• sha1_hash – 🔐 SHA1 hash.
• sha256_hash – 🔐 SHA256 hash.
• short_desc – 📛 Short description.
• source_pkg – 📦 Source package name (if different).
• source_ver – 🏷️ Source package version.

🎯 Policy

Policy(cache)

🎯 Representation of the cache policy; creates pins, reads pin files, and overrides priorities.

• create_pin(type: str, pkg: str, data: str, priority: int) – 📌 Create a pin (type: 'Version', 'Release', 'Origin').
• get_candidate_ver(package: apt_pkg.Package) -> Optional[apt_pkg.Version] – 🎯 Get the best version.
• get_priority(package: Union[apt_pkg.Package, apt_pkg.Version, apt_pkg.PackageFile]) -> int – 🔢 Return priority.
• init_defaults() – 🔄 Initialize defaults after create_pin() with empty pkg.
• read_pindir(dirname: str) -> bool – 📂 Read pin files from directory.
• read_pinfile(filename: str) -> bool – 📄 Read a single pin file.
• set_priority(which, priority: int) – 🎯 Override priority for a version/file.

🔧 ProblemResolver

ProblemResolver(depcache: apt_pkg.DepCache)

🔧 Resolve dependency problems by marking packages for installation/removal.

• clear(pkg: apt_pkg.Package) – 🔄 Revert protect/remove actions.
• protect(pkg: apt_pkg.Package) – 🛡️ Mark as protected (state won't change).
• remove(pkg: apt_pkg.Package) – 🗑️ Mark for removal.
• resolve([fix_broken: bool = True]) -> bool – 🔧 Intelligently resolve problems.
• resolve_by_keep() -> bool – 🔒 Try to resolve only by keeping packages.

📋 SourceList

SourceList()

📋 Represent the list of sources from /etc/apt/sources.list and similar files.

• find_index(pkgfile: apt_pkg.PackageFile) -> apt_pkg.IndexFile – 🔍 Find the index file for a given package file.
• get_indexes(acquire: apt_pkg.Acquire[, all: bool=False]) -> bool – 📥 Add indexes (Release, Packages) to an Acquire object.
• read_main_list() -> bool – 📖 Read/refresh the source list.

📊 Data descriptors:

• list – 📋 List of MetaIndex objects.

📄 SourceRecordFiles

SourceRecordFile()

📄 Look up source package file records. Supports __getitem__ and __len__.

📊 Data descriptors:

• hashes – 🔐 HashStringList of the source file.
• path – 🌐 Remote path.
• size – 📏 Size.
• type – 🏷️ Type of the source file.

📄 SourceRecords

SourceRecords()

📄 Look up source package records. Iterate with lookup() or step().

• lookup(name: str) -> bool – 🔍 Look up a source package by name.
• restart() – 🔄 Restart the parser.
• step() -> bool – ⏭️ Move to the next source package.

📊 Data descriptors:

• binaries – 📋 List of binary package names.
• build_depends – 🔧 Build dependencies (dict, same format as depends_list_str).
• files – 📋 List of SourceRecordFiles objects.
• index – 📑 List of IndexFile objects.
• maintainer – 👤 Maintainer.
• package – 📛 Source package name.
• record – 📋 Raw record.
• section – 🏷️ Section.
• version – 🏷️ Version.

🔒 SystemLock

SystemLock()

🔒 Context manager for the global dpkg/apt lock. Usage:

with apt_pkg.SystemLock():
    ...

• __enter__ – 🔒 Lock the system.
• __exit__ – 🔓 Release the lock.

🏷️ Tag

🏷️ Abstract base for actions on a tag section. Subclasses: TagRemove, TagRename, TagRewrite.

📊 Data descriptors:

• action – 🎬 Action to perform (0=REMOVE, 1=RENAME, 2=REWRITE).
• data – 📋 Data for rewrite or new name for rename.
• name – 📛 Tag name to act on.

🏷️ Constants:

• REMOVE = 0
• RENAME = 1
• REWRITE = 2

🏷️ TagRemove

TagRemove(name: str) – 🗑️ Remove the tag name from the section.

🏷️ TagRename

TagRename(old_name: str, new_name: str) – 🔄 Rename old_name to new_name.

🏷️ TagRewrite

TagRewrite(name: str, data: str) – ✏️ Change the tag value to data.

📄 TagFile

TagFile(file, [bytes: bool = False])

📄 Access debian control files (multiple RFC822 sections). Iterate to get TagSection objects, or use step() / jump().

• close() – 🚪 Close the file.
• jump(offset: int) -> bool – ⏩ Jump to an offset.
• offset() -> int – 📍 Current offset.
• step() -> bool – ⏭️ Step forward.

📊 Data descriptors:

• section – 📄 The current TagSection object.

📄 TagSection

TagSection(text: str, [bytes: bool = False])

📄 Access a single RFC822-style section. Read‑only dictionary with additional methods.

• bytes() -> int – 📏 Byte size of the section.
• find(name: str[, default=None]) -> str – 🔍 Return value for key.
• find_flag(name: str) -> int – ✅ Return 1 if value is yes/true, 0 otherwise.
• find_raw(name: str[, default=None]) -> str – 📋 Return the complete 'key: value' line.
• keys() -> list – 📋 List of all keys.
• write(file: int, order: List[str], rewrite: List[Tag]) -> None – ✏️ Rewrite the section to a file descriptor.

🏷️ Version

🏷️ Represent a package version. Supports comparison operators.

📊 Data descriptors:

• arch – 🏗️ Architecture of this version.
• depends_list – 🔗 Dict mapping dependency types to lists of lists of Dependency objects (or‑groups).
• depends_list_str – 🔗 Same but with (name, version, operator) tuples.
• downloadable – ✅ Whether the version can be downloaded.
• file_list – 📋 List of (packagefile, index) tuples.
• hash – 🔢 Internal numeric hash.
• id – 🔢 Numeric ID.
• installed_size – 💾 Installed size.
• multi_arch – 🌐 Multi‑arch state (compare with MULTI_ARCH_*).
• parent_pkg – 👤 Parent Package.
• priority – 🔢 Priority integer (compare with PRI_*).
• priority_str – 🏷️ Priority as string.
• provides_list – 📋 List of (providesname, providesver, version) tuples.
• section – 🏷️ Section.
• size – 📏 Package file size.
• translated_description – 📄 Description object (translated or untranslated).
• ver_str – 🔢 Version string.

🏷️ Multi‑arch constants:

• MULTI_ARCH_ALL = 1
• MULTI_ARCH_ALLOWED = 8
• MULTI_ARCH_ALL_ALLOWED = 9
• MULTI_ARCH_ALL_FOREIGN = 3
• MULTI_ARCH_FOREIGN = 2
• MULTI_ARCH_NO = 0
• MULTI_ARCH_NONE = 0
• MULTI_ARCH_SAME = 4

🔧 FUNCTIONS

🔐 base64_encode

base64_encode(value: bytes) -> str

🔐 Encode a bytestring to Base64. Input must not contain a null byte.

🔗 check_dep

check_dep(pkg_ver: str, dep_op: str, dep_ver: str) -> bool

🔗 Check that version pkg_ver matches dep_ver under operator dep_op (<,<=,=,>=,>). Example:

apt_pkg.check_dep('1', '