marc2iiif

Introduction

This is library code that will allow the user to do the following

1. point it at 1 or more MARC files (either binary or MARCXML)
2. tell the application what type of MARC file it is (binary or MARCXML)
3. have the system convert all the MARC records into IIIF manifests with only the descriptive metadata defined.

Quickstart

$ git clone git@github.com:uchicago-library/marc2iiif
$ cd marc2iiif
$ python -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python setup.py install

PROTIP: if you are planning to add code to the library and want to be able to run tests without having to run install every time you test you can use

python setup.py develop

Using the Library

>>> from marc2iiif.classes import IIIFDataExtractionFromMarc
>>> record = {"leaders": "088325aabb 83dfasd0adf00",
              "fields": [{"245": {"subfields": [{"a": "A title"}, {"c": "statement of responsbility"}]}},
                         {"300": {"subfields": [{"a": "A subject"}]}},
                         {"100": {"subfields": [{"a": "a title"}]}}]}
>>> new_object = IIIFDataExtractionFromMarc.from_dict(record)

You now have a very a defined instance of a IIIFDataExtractionFromMarc object. You can get the name of the CHO that this record describes by entering

>>> from marc2iiif import IIIFMetadataField, IIIFMetadataBoxFromMarc
>>> a_field = IIIFMetadataField("Local Subject", "foo bar")
>>> a_box = IIIFMetadataBoxFromMarc("a label", "this describes a CHO and why it is important", "/foo/bar", [a_field])

>>> new_object.show_title()
'Jane\'s Wonderful Cultural Heritage Object'

Or, if you want the description of the CHO you can type

>>> new_object.show_description()
'This is a description line composed of multiple description fields from MARC records'

If on the other hand you just want to know what metadata fields that were extracted from the inputted MARC record, you can type

>>> new_object.show_metadata()
{
    "Added Entry - Personal Name": "Doe, Jane",
    "Edition Statement": "3rd"
}

Should you want to add additional metadata before you export your IIIF record, you can do the following

>> new_metadata_field = {
    "field_name": "Production, Publication, Publication, Distribution, Manufacture, and Copyright Notice"
    "field_value": "2018 University of Chicago"
}
>>> new_object.add_metadata()

If you want to edit a particular metadata field or remove a particular metadata entry do the following:

>>> new_object.modify_metadata({"Added Entry - Personal Name": "Doe, Jane"}, "Franklin, Diana")
>>> new_object.remove_metadata({"Added Entry - Personal Name": "Doe, Jane"})

If you want to change the title or description of the CHO then use these handy methods.

new_object.change_title("New Title")
new_object.change_description("A totally new description that is way better than the old description")

Output the object to JSON:

json.dumps(new_object.to_dict())

Contract for metadata labels

See this wiki page for information about metadata field names to use when editing the metadata block.

And, check out this wiki page for how to structure the dictionary passed to IIIFDataEXtractionFromMarc.from_dict() method.

Additional Information

• IIIF Presentation
• MARC21

Author

• verbalhanglider (tdanstrom@uchicago.edu)