Metadata-Version: 2.1
Name: gpkgstatus
Version: 1.3
Summary: Get Current Package Status from Fedora Updates System
Home-page: https://github.com/dkvc/gpkgstatus
Author: Dhanush Kovi
License: GPL-2.0
Keywords: fedora,updates,package,status,fedora-updates,gpkgstatus,bodhi
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Topic :: Utilities
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: pytest (==7.2.1)
Requires-Dist: requests (==2.28.2)
Requires-Dist: setuptools (==62.6.0)
Requires-Dist: termcolor (==2.2.0)
Provides-Extra: dev
Requires-Dist: altgraph (==0.17.3) ; 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: docopt (==0.6.2) ; extra == 'dev'
Requires-Dist: idna (==3.4) ; extra == 'dev'
Requires-Dist: iniconfig (==2.0.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: 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: pyinstaller (==5.7.0) ; extra == 'dev'
Requires-Dist: pyinstaller-hooks-contrib (==2022.15) ; extra == 'dev'
Requires-Dist: pytest (==7.2.1) ; extra == 'dev'
Requires-Dist: requests (==2.28.2) ; extra == 'dev'
Requires-Dist: termcolor (==2.2.0) ; extra == 'dev'
Requires-Dist: urllib3 (==1.26.14) ; 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.

## 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 Release Status

[![Last Pre-Release Date](https://img.shields.io/github/release-date-pre/dkvc/gpkgstatus?label=Preview%20Release&)](https://github.com/dkvc/gpkgstatus/releases)
[![Last Release Date](https://img.shields.io/github/release-date/dkvc/gpkgstatus?label=Stable%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

1. Download the executable file for your operating system from the ![Releases](https://github.com/dkvc/gpkgstatus/releases) section of this repository.
2. Make sure the file is executable (e.g. chmod +x gpkgstatus on Linux).

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

## Usage

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

```bash
$ gpkgstatus -h

usage: gpkgstatus [-dv DISTRO_VERSION] [-f] name

Get Current Package Status from Fedora Updates System

positional arguments:
  name                  Name of the package

options:
  -h, --help            show this help message and exit
  -d DISTRO_VERSION, --distro-version DISTRO_VERSION
                        Checks package status for corresponding Fedora version
  -f, --force           Sync cached info with Fedora Updates System
  -v, --version         Returns gpkgstatus version
```

## Contributing

You are welcome to contribute to this project.
