Utility for batch operations on a Fedora 4 repository.
Requires Python 3.6+
**TODO**
add end-user instructions here once this is available via PyPI/pip
**TODO**
If you don't already have a Python 3 environment, or would like to install Plastron into its own isolated environment, a very convenient way to do this is to use the pyenv Python version manager.
See these instructions for installing pyenv, then run the following:
# install Python 3.6.2
pyenv install 3.6.2
# create a new virtual environment based on 3.6.2 for Plastron
pyenv virtualenv 3.6.2 plastron
# switch to that environment in your current shell
pyenv shell plastron
To install Plastron in development mode, do the following:
git clone git@github.com:umd-lib/plastron.git
cd plastron
pip install -e .
This allows for in-place editing of Plastron's source code in the git repository (i.e., it is not locked away in a Python site-packages directory structure).
Plastron is designed in a modular fashion. Its major components are:
- Fedora repository REST API client (http.py)
- RDF-to-Python object modeling (rdf.py, content models)
- Runnable commands (e.g., batch loading, exporting) (command modules)
- Data handlers for batch ingest formats (handler modules)
- Entrypoint interfaces (currently a command-line tool and a daemon) (cli.py, daemon.py)
The intent is that the runnable commands be useful units of work that are able to be called interchangeably from any of the entrypoint interfaces, or be directly included and called via import into other Python code.
The plastron is the nearly flat part of the shell structure of a turtle, what one would call the belly or ventral surface of the shell.
Source: Wikipedia
See the LICENSE file for license rights and limitations (Apache 2.0).