Metadata-Version: 2.4
Name: rcsb.exdb
Version: 1.33
Summary: RCSB Python ExDB data extraction and loading workflows
Project-URL: Homepage, https://github.com/rcsb/py-rcsb_exdb
Author-email: John Westbrook <john.westbrook@rcsb.org>
Maintainer-email: Dennis Piehl <dennis.piehl@rcsb.org>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Requires-Dist: jsonschema>=2.6.0
Requires-Dist: numpy
Requires-Dist: openeye-toolkits>=2024.1.1
Requires-Dist: rcsb-db>=1.808
Requires-Dist: rcsb-utils-chem>=0.84
Requires-Dist: rcsb-utils-chemref>=0.91
Requires-Dist: rcsb-utils-config>=0.40
Requires-Dist: rcsb-utils-dictionary>=1.27
Requires-Dist: rcsb-utils-ec>=0.25
Requires-Dist: rcsb-utils-go>=0.18
Requires-Dist: rcsb-utils-io>=1.48
Requires-Dist: rcsb-utils-seq>=0.82
Requires-Dist: rcsb-utils-struct>=0.51
Requires-Dist: rcsb-utils-targets>=0.82
Requires-Dist: rcsb-utils-taxonomy>=0.43
Provides-Extra: tests
Requires-Dist: black>=21.5b1; extra == 'tests'
Requires-Dist: check-manifest; extra == 'tests'
Requires-Dist: coverage; extra == 'tests'
Requires-Dist: flake8; extra == 'tests'
Requires-Dist: pylint; extra == 'tests'
Requires-Dist: rcsb-utils-citation>=0.25; extra == 'tests'
Requires-Dist: tox; extra == 'tests'
Description-Content-Type: text/markdown

# py-rcsb_exdb

[![Build Status](https://dev.azure.com/rcsb/RCSB%20PDB%20Python%20Projects/_apis/build/status/rcsb.py-rcsb_exdb?branchName=master)](https://dev.azure.com/rcsb/RCSB%20PDB%20Python%20Projects/_build/latest?definitionId=18&branchName=master)

RCSB exchange database extraction and loading workflow tools

## Introduction

This module contains a collection of utility classes for extracting data from
the RCSB exchange database and subsequently reloading processed or integrated data.

### Installation

Download the library source software from the project repository:

```bash

git clone --recurse-submodules https://github.com/rcsb/py-rcsb_exdb.git

```

Optionally, run test suite (Python versions 2.7 and 3.7) using
[tox](http://tox.readthedocs.io/en/latest/example/platform.html):

```bash
tox
```

Installation is via the program [pip](https://pypi.python.org/pypi/pip).  To run tests
from the source tree, the package must be installed in editable mode (i.e. -e):

```bash
pip install -e . --extra-index-url https://pypi.anaconda.org/OpenEye/simple

# or using uv

uv pip install -e .
```

#### Installing in Ubuntu Linux (tested in 18.04)

You will need a few packages, before `pip install .` can work:

```bash

sudo apt install flex bison

```

### Installing on macOS

To use and develop this package on macOS requires a number of packages that are not
distributed as part of the base macOS operating system.
The following steps provide one approach to creating the development environment for this
package.  First, install the Apple [XCode](https://developer.apple.com/xcode/) package and associate command-line tools.
This will provide essential compilers and supporting tools.  The [HomeBrew](https://brew.sh/) package
manager provides further access to a variety of common open source services and tools.
Follow the instructions provided by at the [HomeBrew](https://brew.sh/) site to
install this system.   Once HomeBrew is installed, you can further install the
[MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) packages which
are required to support the ExDB tools.  HomeBrew also provides a variety of options for
managing a [Python virtual environments](https://gist.github.com/Geoyi/f55ed54d24cc9ff1c14bd95fac21c042).
