Metadata-Version: 2.4
Name: aipscan
Version: 0.9.0a9
Summary: A reporting system for Archivematica using data from AIPs.
Project-URL: Homepage, https://github.com/artefactual-labs/AIPscan
Project-URL: Repository, https://github.com/artefactual-labs/AIPscan
Project-URL: Issues, https://github.com/artefactual-labs/AIPscan/issues
License-Expression: Apache-2.0
License-File: LICENSE
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
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: celery
Requires-Dist: click
Requires-Dist: faker
Requires-Dist: filelock
Requires-Dist: flask
Requires-Dist: flask-migrate
Requires-Dist: flask-restx
Requires-Dist: flask-sqlalchemy
Requires-Dist: flask-wtf
Requires-Dist: lxml
Requires-Dist: metsrw
Requires-Dist: natsort
Requires-Dist: pandas
Requires-Dist: plotly-express
Requires-Dist: pymysql[rsa]
Requires-Dist: python-dateutil
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: sqlalchemy
Requires-Dist: typesense
Requires-Dist: wtforms
Provides-Extra: server
Requires-Dist: gunicorn; extra == 'server'
Description-Content-Type: text/markdown

# AIPscan

By [Artefactual]

[![PyPI version][badge-pypi]][pypi-release]
[![GitHub CI][badge-ci]][test-workflow]
[![codecov][badge-codecov]][codecov-report]

AIPscan provides an in-depth reporting solution for Archivematica users. It
crawls METS files from AIPs in the Archivematica Storage Service to generate
tabular and visual reports about repository holdings. It is designed to run as a
stand-alone add-on to Archivematica and requires only a valid Storage Service
API key to fetch source data.

You are free to copy, modify, and distribute AIPscan, with attribution, under
the terms of the Apache License, version 2.0. See the [LICENSE] file for
details.

## Screenshots

### AIPscan fetch job

![screencap1](screencaps/aipscan_fetch_job.png)

### Finding an AIP

![screencap2](screencaps/aipscan_find_aip.png)

### Viewing an AIP

![screencap3](screencaps/aipscan_view_aip.png)

### Selecting a report

![screencap4](screencaps/aipscan_select_report.png)

### Example: pie chart "format types" report

![screencap5](screencaps/aipscan_piechart_report.png)

### Example: tabular "largest files" report

![screencap6](screencaps/aipscan_tabular_report.png)

## Installation

AIPscan is a web-based application that is built using the Python [Flask]
micro-framework. See [INSTALL.md] for production deployment instructions. See
[CONTRIBUTING.md] for guidelines on how to contribute to the project, including
how to set up the development environment and create a new AIPscan report.

## Contributing

See [CONTRIBUTING.md] for full contribution guidelines and
development environment setup instructions.

## Usage

Consult [USAGE.md] for a walkthrough of the web workflow and the helper scripts
in the `tools` directory. It covers verifying your deployment, running fetch
jobs, and seeding test data.

[badge-pypi]: https://badge.fury.io/py/aipscan.svg
[pypi-release]: https://badge.fury.io/py/aipscan
[badge-ci]: https://github.com/artefactual-labs/AIPscan/actions/workflows/test.yml/badge.svg
[test-workflow]: https://github.com/artefactual-labs/AIPscan/actions/workflows/test.yml
[badge-codecov]: https://codecov.io/gh/artefactual-labs/AIPscan/branch/main/graph/badge.svg
[codecov-report]: https://codecov.io/gh/artefactual-labs/AIPscan
[Artefactual]: https://www.artefactual.com/
[Flask]: https://pypi.org/project/Flask/
[LICENSE]: LICENSE
[INSTALL.md]: INSTALL.md
[CONTRIBUTING.md]: CONTRIBUTING.md
[USAGE.md]: USAGE.md
