Metadata-Version: 2.4
Name: fandanGO-aria
Version: 2.2.6
Summary: A Python client library and CLI tool for interfacing with ARIA within the FandanGO ecosystem
Home-page: https://github.com/FragmentScreen/fandanGO-aria
Author: FragmentScreen
Author-email: lui.holliday@instruct-eric.org
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: PyYAML>=6.0.2
Requires-Dist: click>=8.1.8
Requires-Dist: cryptography>=48.0.1
Requires-Dist: keyring>=25.6.0
Requires-Dist: prompt_toolkit>=3.0.51
Requires-Dist: python-dotenv>=1.1.1
Requires-Dist: questionary>=2.1.0
Requires-Dist: requests>=2.32.4
Requires-Dist: urllib3>=2.5.0
Dynamic: author-email
Dynamic: home-page
Dynamic: license-file




<div align="center">
  <img src="https://instruct-eric.org/upload/KIZ6uJYFfVnfSmcXqOrm6vuceCTUiYdT.png" alt="Alt text" width="200" margin='auto'>
  <h1>fandanGO-aria</h1>
</div>

![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)



[![Connect on LinkedIn](https://img.shields.io/badge/Connect%20on-LinkedIn-blue.svg)](https://www.linkedin.com/company/instruct-eric/mycompany/)
[![GitHub issues](https://img.shields.io/github/issues/FragmentScreen/fandanGO-aria)](https://github.com/FragmentScreen/fandanGO-aria/issues)
[![GitHub forks](https://img.shields.io/github/forks/FragmentScreen/fandanGO-aria)](https://github.com/FragmentScreen/fandanGO-aria/network/members)
[![GitHub contributors](https://img.shields.io/github/contributors/FragmentScreen/fandanGO-aria)](https://github.com/FragmentScreen/fandanGO-aria/graphs/contributors)
[![PyPI version](https://badge.fury.io/py/fandanGO-aria.svg)](https://badge.fury.io/py/fandanGO-aria)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Documentation](https://img.shields.io/badge/Documentation-Wiki-brightgreen)](https://github.com/FragmentScreen/fandanGO-aria/wiki)
[![OSV Scanner](https://github.com/FragmentScreen/fandanGO-aria/actions/workflows/osv-scanner.yml/badge.svg)](https://github.com/FragmentScreen/fandanGO-aria/actions/workflows/osv-scanner.yml)



## Intro

Welcome to the fandanGO-aria package.

This package allows the user to do the following:
- Metadata Deposition in ARIA
- Manage Access in ARIA

Please refer to our [Wiki](https://github.com/FragmentScreen/fandanGO-aria/wiki) for full documentation. 

## Installation

Install via [PYPI](https://pypi.org/project/fandanGO-aria)

`pip install fandanGO-aria`


## Setup

Connections are configured in the `.env` file located in the root of your project.

Here, you will be required to complete the following:

### All Connections

- ARIA_CONNECTION_LOGIN_URL
- ARIA_CONNECTION_GRANT_TYPE
- ARIA_CONNECTION_SCOPE
- ARIA_CLIENT_ID
- ARIA_CLIENT_SECRET
- ARIA_CONNECTION_REFRESH_GRANT
- DEV (Set to LIVE unless in development/beta)
- ARIA_FACILITY_ID



### Caveats

The following `env` options are not neccessary and are mostly used for development : 

- ARIA_CONNECTION_USERNAME : If a CLI user, this will remove the need to re-enter your login email
- ARIA_CONNECTION_PASSWORD : Similar to Email. Use with caution if on a communal computer.

### Post Setup

If you've successfully completed the above setup options, you're ready to start using the package.


### Note

This package uses [Keyring](https://pypi.org/project/keyring) to store token information securely.
Keyring is usable accross multiple os and supports the following backends:

- macOS Keychain
- Freedesktop Secret Service supports many DE including GNOME (requires [secretstorage](https://pypi.org/project/SecretStorage/))
- KDE4 & KDE5 KWallet (requires dbus)
- Windows Credential Locker

**Linux**

If problems arise when storing tokens on a Linux device, it may be required to download `dbus-python`.

Please use the [dbus package](https://pypi.org/project/dbus-python/) to solve the issue

## Security Scanning

This repo uses [OSV Scanner](https://github.com/google/osv-scanner) for vulnerability detection.

**When it runs:**
- Daily at 03:00 UTC (full scan)
- On PRs targeting main (changed deps only)
- On push to main (full scan)

**If vulnerabilities are found:**
1. Check the [Security tab](../../security) for alerts
2. To ignore false positives, add entries to `osv-scanner.toml`:
   ```toml
   [[IgnoredVulns]]
   id = "GHSA-xxxx-xxxx-xxxx"
   reason = "Justification"
   ```

**References:**
- [OSV Scanner docs](https://google.github.io/osv-scanner/)
- [GitHub Action](https://github.com/google/osv-scanner-action)
- [OSV Database](https://osv.dev/)

