Metadata-Version: 2.1
Name: sruthi
Version: 0.1.1
Summary: SRU client for Python
Home-page: https://github.com/metaodi/sruthi
Author: Stefan Oderbolz
Author-email: odi@metaodi.ch
Maintainer: Stefan Oderbolz
Maintainer-email: odi@metaodi.ch
License: MIT
Download-URL: https://github.com/metaodi/sruthi/archive/v0.1.1.zip
Description: # sruthi
        
        **sru**thi is a client for python to make [SRU requests (Search/Retrieve via URL)](http://www.loc.gov/standards/sru/).
        
        Currently only SRU 1.2 is supported.
        
        ## Table of Contents
        
        * [Installation](#installation)
        * [Usage](#usage)
            * [`searchretrieve` operation](#searchretrieve-operation)
            * [`explain` operation](#explain-operation)
        * [Schemas](#schemas)
        * [Release](#release)
        
        ## Installation
        
        [sruthi is available on PyPI](https://pypi.org/project/sruthi/), so to install it simply use:
        
        ```
        $ pip install sruthi
        ```
        
        ## Usage
        
        See the [`examples` directory](https://github.com/metaodi/sruthi/tree/master/examples) for more scripts.
        
        ### `searchretrieve` operation
        
        ```python
        import sruthi
        
        records = sruthi.searchretrieve('https://suche.staatsarchiv.djiktzh.ch/SRU/', query='Zurich')
        
        for record in records:
            # print fields from schema
            print(record['reference'])
            print(record['title'])
            print(record['date'])
            print(record['extra']['link']) # extra record data is available at the 'extra' key
        ```
        
        ```python
        # you can get more information at each step
        import sruthi
        
        # note: records is an iterator
        records = sruthi.searchretrieve('https://suche.staatsarchiv.djiktzh.ch/SRU/', query='Human')
        print(records.sru_version)
        print(records.count)
        
        for record in records:
            print(record)
            print(record['schema'])
        ```
        
        The return value of `searchretrieve` is iterable, so you can easily loop over it. Or you can use indices to access elements, e.g. `records[1]` to get the second elemenet, or `records[-1]` to get the last one.
        
        Even [slicing](https://python-reference.readthedocs.io/en/latest/docs/brackets/slicing.html) is supported, so you can do things like only iterate over the first 5 elements using
        
        ```python
        for records in records[:5]:
           print(record)
        ```
        
        ### `explain` operation
        
        ```python
        import sruthi
        
        info = sruthi.explain('https://suche.staatsarchiv.djiktzh.ch/SRU/')
        print(info.server)
        print(info.database)
        print(info.index)
        print(info.schema)
        ```
        
        ## Schemas
        
        sruthi does not make any assumptions about the record data schema.
        The data is provided as-is (as a flattend dict).
        sruthi has been tested with the following schemas:
        
        * [Dublin Core Record Schema](http://www.loc.gov/standards/sru/recordSchemas/dc-schema.html) (dc)
        * [MARCXML: The MARC 21 XML Schema](http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd) (marcxml)
        * [ISAD(G): General International Standard Archival Description, Second edition](http://www.expertisecentrumdavid.be/xmlschemas/isad.xsd) (isad)
        
        ## Release
        
        To create a new release, follow these steps (please respect [Semantic Versioning](http://semver.org/)):
        
        1. Adapt the version number in `sruthi/__init__.py`
        1. Update the CHANGELOG with the version
        1. Create a pull request to merge `develop` into `master` (make sure the tests pass!)
        1. Create a [new release/tag on GitHub](https://github.com/metaodi/sruthi/releases) (on the master branch)
        1. The [publication on PyPI](https://pypi.python.org/pypi/sruthi) happens via [GitHub Actions](https://github.com/metaodi/sruthi/actions?query=workflow%3A%22Upload+Python+Package%22) on every tagged commit
        
Keywords: sru,search,retrieve,archive,library
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
