Metadata-Version: 2.1
Name: dcc
Version: 0.7.3
Summary: Tools for interactive and programmatic access to the LIGO DCC.
Home-page: https://docs.ligo.org/sean-leavey/dcc/
Author: Sean Leavey
Author-email: sean.leavey@ligo.org
License: GPL-3.0-or-later
Download-URL: https://docs.ligo.org/sean-leavey/dcc/installation.html
Project-URL: Bug Tracker, https://git.ligo.org/sean-leavey/dcc/-/issues
Project-URL: Source Code, https://git.ligo.org/sean-leavey/dcc/
Project-URL: Documentation, https://docs.ligo.org/sean-leavey/dcc/
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
License-File: LICENSE

# DCC
Tools for interactive and programmatic access to the [LIGO Scientific
Collaboration](http://www.ligo.org/) [Document Control Center](https://dcc.ligo.org/)
(DCC).

## Features
- Interactive command line interface
- Retrieval and modification of DCC record metadata
- Extraction of attachment descriptions and URLs
- Local archival of downloaded content
- URL scraping and automatic, recursive archival of related documents and files

## Documentation
For help installing and using `dcc`, please visit the [online
documentation](https://docs.ligo.org/sean-leavey/dcc/).

## Installation
`dcc` has the following system requirements:

- Python 3.8 or later
- `kinit` and `klist` provided as part of Kerberos

Most users will find it easiest to use one of the [reference software
environments](https://computing.docs.ligo.org/guide/software/environments/) provided by
IGWN. The `igwn-py38` environment, for example, provides the required dependencies. If
you choose to manage system dependencies yourself, ensure you have the relevant Kerberos
packages above (provided on Linux by e.g. `krb5-user` on Debian derivatives or
`krb5-workstation` on Red Hat derivatives).

Once you have the required system dependencies, you can install `dcc` using your
favourite Python package manager, e.g. using pip:

```bash
$ pip install dcc
```

## Credits
- Sean Leavey `<sean.leavey@ligo.org>`
- Jameson Graef Rollins `<jameson.rollins@ligo.org>`
- Christopher Wipf
- Duncan Macleod


