Metadata-Version: 2.4
Name: geniussis-api-fr8train
Version: 0.1.0
Summary: A Python SDK for integrating with the GeniusSIS API
Author-email: Tyler Collette <tyler.collette@gmail.com>
Project-URL: Documentation, https://github.com/fr8train-sv/geniussis-api/wiki
Project-URL: Source, https://github.com/fr8train-sv/geniussis-api
Project-URL: Changelog, https://github.com/fr8train-sv/geniussis-api/releases
Keywords: genius,api,sdk,geniussis,integration
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: dotenv
Requires-Dist: python-dotenv
Dynamic: license-file

# GeniusSIS API
### By fr8train-sv

A Python 3.12 SDK for integrating with GeniusSIS API. Install with:

```bash
  pip install geniussis-api-fr8train
```

Upgrade this specific library by running:

```bash
  pip install --upgrade geniussis-api-fr8train
```

## Important Commands

The following list of commands are important for project maintenance.

## Building the Library

To build the library, ensure that the necessary build tools are installed in your environment. This can be done by installing `setuptools`, `build`, and `wheel`:

```bash
  pip install build twine setuptools wheel
```

`twine` can also be installed here while we're installing shit since we'll need it later. 

**REMEMBER**: INCREMENT YOUR VERSION NUMBER IN THE TOML BEFORE BUILDING.  

**REMEMBER**: REMOVE THE /DIST DIRECTORY BEFORE BUILDING FOR A CLEAN BUILD

Now, you can create the distribution files (source distribution and wheel) using the following command:

```bash
  python3 -m build
```

This will generate builds in the `dist/` directory.

## Deploying to PyPI

Ensure you have a valid PyPI account and credentials added to your `.pypirc` file or provide them during the publish process. Then, upload your package to PyPI with:

```bash
  python3 -m twine upload dist/*
```

Follow any prompts from `twine` to successfully upload your package. Once deployed, your package will be available on PyPI. 

# Usage

## Initialization

To start using the API SDK, you will need to initialize an API object:

```python
from geniussis_api_fr8train.api import Api

api = Api()
```

This will reach out into your project for a .env file for credentials to establish a connection to the Agilix API Gateway.
Structure your .env file like the example below and maintain it at the root of your project directory.

```dotenv
API_CLIENT_KEY=
API_SECRET=
API_HOST=
```
