
``apt.debfile`` --- Classes related to debian package files
***********************************************************

The ``apt.debfile`` provides classes to work with locally available
debian packages, or source packages.


Binary packages
===============

class apt.debfile.DebPackage(filename=None, cache=None)

   A Debian Package (.deb file).

   The ``DebPackage`` class is a class for working with '.deb' files,
   also known as Debian packages.

   It provides methods and attributes to get a list of the files in
   the package, to install the package and much more.

   If you specify *cache* it has to point to an ``apt.cache.Cache()``
   object.

   Changed in version 0.7.9: Introduce all new methods (everything
   except for ``open()`` and ``filelist``)

   check()

      Check if the package is installable.

   check_conflicts()

      Check if there are conflicts with existing or selected packages.

      Check if the package conflicts with a existing or to be
      installed package. Return True if the pkg is OK.

   compare_to_version_in_cache(use_installed=True)

      Compare the package to the version available in the cache.

      Checks if the package is already installed or availabe in the
      cache and if so in what version, returns one of (VERSION_NONE,
      VERSION_OUTDATED, VERSION_SAME, VERSION_NEWER).

   conflicts

   depends

   filelist

   install(install_progress=None)

      Install the package.

   missing_deps

   open(filename)

      open given debfile

   provides

   replaces

   replaces_real_pkg(pkgname, oper, ver)

      Return True if a given non-virtual package is replaced.

      Return True if the deb packages replaces a real (not virtual)
      packages named (pkgname, oper, ver).

   required_changes

   satisfy_depends_str(dependsstr)

      Satisfy the dependencies in the given string.


Source packages
===============

class apt.debfile.DscSrcPackage(filename=None, cache=None)

   A locally available source package.

   Provide functionality to work with locally available source
   packages, especially with their '.dsc' file.

   New in version 0.7.9.

   check()

      Check if the package is installable..

   check_conflicts()

      Check if there are conflicts with existing or selected packages.

      Check if the package conflicts with a existing or to be
      installed package. Return True if the pkg is OK.

   compare_to_version_in_cache(use_installed=True)

      Compare the package to the version available in the cache.

      Checks if the package is already installed or availabe in the
      cache and if so in what version, returns one of (VERSION_NONE,
      VERSION_OUTDATED, VERSION_SAME, VERSION_NEWER).

   conflicts

   depends

   filelist

   install(install_progress=None)

      Install the package.

   missing_deps

   open(file)

      Open the package.

   provides

   replaces

   replaces_real_pkg(pkgname, oper, ver)

      Return True if a given non-virtual package is replaced.

      Return True if the deb packages replaces a real (not virtual)
      packages named (pkgname, oper, ver).

   required_changes

   satisfy_depends_str(dependsstr)

      Satisfy the dependencies in the given string.
