Metadata-Version: 2.1
Name: gpkgstatus
Version: 2.0.2
Summary: Get Current Package Status from Fedora Updates System
Author: Dhanush Kovi
License: GPL-2.0-or-later
Project-URL: Homepage, https://dkvc.github.io/gpkgstatus/
Project-URL: Documentation, https://dkvc.github.io/gpkgstatus/
Project-URL: Repository, https://github.com/dkvc/gpkgstatus
Keywords: fedora,updates,package,status,fedora-updates,gpkgstatus,bodhi
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyInputPlus (==0.2.12)
Requires-Dist: pytest (==7.2.1)
Requires-Dist: requests (==2.28.2)
Requires-Dist: termcolor (==2.2.0)
Provides-Extra: dev
Requires-Dist: altgraph (>=0.17.3) ; extra == 'dev'
Requires-Dist: astroid (>=2.14.2) ; extra == 'dev'
Requires-Dist: attrs (>=22.2.0) ; extra == 'dev'
Requires-Dist: black (>=23.1.0) ; extra == 'dev'
Requires-Dist: bpyutils (>=0.5.8) ; extra == 'dev'
Requires-Dist: certifi (>=2022.12.7) ; extra == 'dev'
Requires-Dist: charset-normalizer (>=3.0.1) ; extra == 'dev'
Requires-Dist: click (>=8.1.3) ; extra == 'dev'
Requires-Dist: dill (>=0.3.6) ; extra == 'dev'
Requires-Dist: docopt (>=0.6.2) ; extra == 'dev'
Requires-Dist: fastjsonschema (>=2.16.2) ; extra == 'dev'
Requires-Dist: idna (>=3.4) ; extra == 'dev'
Requires-Dist: iniconfig (>=2.0.0) ; extra == 'dev'
Requires-Dist: isort (>=5.12.0) ; extra == 'dev'
Requires-Dist: Jinja2 (>=3.1.2) ; extra == 'dev'
Requires-Dist: lazy-object-proxy (>=1.9.0) ; extra == 'dev'
Requires-Dist: MarkupSafe (>=2.1.2) ; extra == 'dev'
Requires-Dist: mccabe (>=0.7.0) ; extra == 'dev'
Requires-Dist: mypy-extensions (>=1.0.0) ; extra == 'dev'
Requires-Dist: packaging (>=23.0) ; extra == 'dev'
Requires-Dist: pathspec (>=0.11.0) ; extra == 'dev'
Requires-Dist: pdoc (>=12.3.1) ; extra == 'dev'
Requires-Dist: pipreqs (>=0.4.11) ; extra == 'dev'
Requires-Dist: pipupgrade (>=1.12.0) ; extra == 'dev'
Requires-Dist: platformdirs (>=3.0.0) ; extra == 'dev'
Requires-Dist: pluggy (>=1.0.0) ; extra == 'dev'
Requires-Dist: Pygments (>=2.14.0) ; extra == 'dev'
Requires-Dist: PyInputPlus (>=0.2.12) ; extra == 'dev'
Requires-Dist: pyinstaller (>=5.7.0) ; extra == 'dev'
Requires-Dist: pyinstaller-hooks-contrib (>=2022.15) ; extra == 'dev'
Requires-Dist: pylint (>=2.16.2) ; extra == 'dev'
Requires-Dist: PySimpleValidate (>=0.2.12) ; extra == 'dev'
Requires-Dist: pytest (>=7.2.1) ; extra == 'dev'
Requires-Dist: requests (>=2.28.2) ; extra == 'dev'
Requires-Dist: stdiomask (>=0.0.6) ; extra == 'dev'
Requires-Dist: termcolor (>=2.2.0) ; extra == 'dev'
Requires-Dist: tomlkit (>=0.11.6) ; extra == 'dev'
Requires-Dist: urllib3 (>=1.26.14) ; extra == 'dev'
Requires-Dist: validate-pyproject (>=0.12.1) ; extra == 'dev'
Requires-Dist: wrapt (>=1.14.1) ; extra == 'dev'
Requires-Dist: yarg (>=0.1.9) ; extra == 'dev'

# gpkgstatus

## Get Current Package Status from Fedora Updates System

This program is a command-line tool for checking the status of packages on bodhi.fedoraproject.org.
It allows you to search for a specific package and get information about its current status, including the update ID, package name, and status.

[![Code Style](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)
[![linting: pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/PyCQA/pylint)

## Current Build Status

[![Python Tests](https://github.com/dkvc/gpkgstatus/actions/workflows/python-test.yml/badge.svg?branch=main)](https://github.com/dkvc/gpkgstatus/actions/workflows/python-test.yml)
[![CodeQL](https://github.com/dkvc/gpkgstatus/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/dkvc/gpkgstatus/actions/workflows/codeql.yml)

## Current PyPI Status

[![PyPI version](https://img.shields.io/pypi/v/gpkgstatus)](https://pypi.org/project/gpkgstatus/)
[![Dep Status](https://img.shields.io/librariesio/release/pypi/gpkgstatus)](https://pypi.org/project/gpkgstatus/)
[![Python support](https://img.shields.io/pypi/pyversions/gpkgstatus)](https://pypi.org/project/gpkgstatus/)

## Current Release Status

[![Last Pre-Release Date](https://img.shields.io/github/release-date-pre/dkvc/gpkgstatus?label=Github%20Release%20(Preview)&)](https://github.com/dkvc/gpkgstatus/releases)
[![Last Release Date](https://img.shields.io/github/release-date/dkvc/gpkgstatus?label=Github%20Release&)](https://github.com/dkvc/gpkgstatus/releases)

## Features

- Search for a specific package and get its status information.
- Option to specify a distro version to check for a specific version of the package.
- Caches the previous search results for 60 minutes (1 hour) to avoid DDoS.
- Allows you to force a new search, bypassing the cache.
- Displays the information in a user-friendly format.

## Installation

There are two ways of installing gpgkstatus:

1. **Using pip:** You can use `pip install gpkgstatus` and restart your terminal. Now you can use it!
2. **(Unsupported) Using executables from Github:** You can download executable from [Releases](https://github.com/dkvc/gpkgstatus) and use it directly. Make sure to set it as executable on Linux.

**Note:** If you want to run the file anywhere when using executable from Github, move the file to a directory in your system's PATH (usually /usr/local/bin)

### Why Way 2 is unsupported?

You have to update executable manually!

## Usage

The program can be used by running the executable file with the following command:

```console
$ gpkgstatus -h

usage: gpkgstatus [-h] [-f] [-l LIMIT] [--moreinfo] [-n NAME] [--noconfig] [-r RELEASE] [-v] [--version]

Get Current Package Status from Fedora Updates System

options:
  -h, --help            show this help message and exit
  -f, --force           Sync cached info with Fedora Updates System
  -l LIMIT, --limit LIMIT
                        Maximum limit on number of packages shown for package search
  --moreinfo            Verbose (More Info) in Update Info
  -n NAME, --name NAME  Name of the package
  --noconfig            Do not check for config file
  -r RELEASE, --release RELEASE
                        Checks package status for corresponding Fedora release
  -v, --verbose         Enable verbose output
  --version             gpkgstatus version
```

## Contributing

You are welcome to contribute to this project. Make sure to read [Contributing Guidelines](https://github.com/dkvc/gpkgstatus/blob/main/CONTRIBUTING.md). If you have any questions regarding contributing to this project, you can open an issue about it.
