Metadata-Version: 2.3
Name: ubuntu_package_download
Version: 0.0.8
Summary: Helpful utility to download Ubuntu debian packages
License: GPL-3.0-only
Author: Philip Roche
Author-email: phil.roche@canonical.com
Maintainer: Philip Roche
Maintainer-email: phil.roche@canonical.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: launchpadlib (>=2.0.0,<3.0.0)
Requires-Dist: python-debian (>=0.1.49,<0.2.0)
Requires-Dist: rich (>=13.7.1,<14.0.0)
Requires-Dist: typer (>=0.12.4,<0.13.0)
Project-URL: Bugs, https://github.com/canonical/ubuntu-package-download/issues
Project-URL: Changelog, https://github.com/canonical/ubuntu-package-download/blob/main/HISTORY.rst
Project-URL: homepage, https://github.com/canonical/ubuntu-package-download/
Project-URL: repository, https://github.com/canonical/ubuntu-package-download
Description-Content-Type: text/x-rst

=======================
Ubuntu Package Download
=======================


.. image:: https://img.shields.io/pypi/v/ubuntu_package_download.svg
        :target: https://pypi.python.org/pypi/ubuntu_package_download

.. image:: https://img.shields.io/travis/philroche/ubuntu_package_download.svg
        :target: https://travis-ci.com/philroche/ubuntu_package_download

.. image:: https://readthedocs.org/projects/ubuntu-package-download/badge/?version=latest
        :target: https://ubuntu-package-download.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

Helpful utility to download Ubuntu debian packages

Process/Order of finding the package and fallback logic:

    1. Attempt to find the package in the specified series and architecture
    2. If the package is not found in the specified series and architecture attempt to find the package in the `all` architecture (amd64)
    3. If the package is not found in the `all` architecture attempt to find the package in a previous series if the `fallback_series` flag is set to True
    4. If the package is not found in a previous series attempt to find the previous version of the package in the same series if the `fallback_version` flag is set to True

    If not found in any of the above steps log an error message to the console.

Usage: :code:`poetry install` will setup the tool to be used locally. You should then be able to use the tool by invoking :code:`poetry run ubuntu-package-download [args]` or :code:`ubuntu-package-download [args]`.

* Free software: GNU General Public License v3
* Documentation: https://ubuntu-package-download.readthedocs.io.


Features
--------

* TODO

Development
-----------

This project uses poetry for dependency management.

To make sure dev dependencies are installed use :code:`poetry install --with dev`. If you are a developer of this tool use :code:`poetry run ubuntu-package-download [args]` or :code:`ubuntu-package-download` inside :code:`poetry shell` as this will pickup any changes you make to the code.

For more information see: `Poetry Basic Usage`_

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Poetry Basic Usage: https://python-poetry.org/docs/basic-usage/
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage

