Metadata-Version: 2.1
Name: sochugc
Version: 1.1.0
Summary: API library for the cultural heritage K-Samsök (SOCH) UGC API.
Home-page: https://github.com/Abbe98/soch-ugc-py
Author: Albin Larsson
Author-email: albin.post@gmail.com
License: MIT
Download-URL: https://github.com/Abbe98/soch-ugc-py/tarball/1.1.0
Keywords: SOCH,K-Samsök,heritage,cultural,API,UGC
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Requires-Python: >=3.4.0
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: ksamsok

# SOCH UGC

SOCH UGC is a Python library for accessing and writing data to the [User Generated Content API](https://www.raa.se/hitta-information/k-samsok/anvandargenererat-innehall-ugc-hubben/) that is a part of the Swedish Open Cultural Heritage (SOCH/K-Samsök) API.

## Install SOCH UGC

```bash
pip install sochugc
```

## Usage Examples

```python
from sochugc import UGC

# the endpoint defaults to http://ugc.kulturarvsdata.se/
ugc = UGC('<API-KEY>', endpoint='http://lx-ra-ugchubtest:8080/')

# get the total number of user generated items
ugc.get_total_items_count()

# return an user generated content item by its id
ugc.get_item(679)

# Searching all items or items tied to a specific URI
# to search all items and not only ones connected to an specific URI omit the uri parameter
ugc.search_items(uri='http://kulturarvsdata.se/raa/bbr/21400000440954', offset=0, limit=100)

#
# Writing data is not available for everyone
#

# deleting an item using its id
ugc.delete_item(679)

# creating a new relation, see below for possible relations
ugc.create_item_relation('http://kulturarvsdata.se/raa/kmb/16001000004075', 'isPartOf', 'http://kulturarvsdata.se/pm/photo/POST036605', 'Albin Larsson')
```

## Supported Item Relations

 - sameAs
 - isDescribedBy
 - visualizes
 - hasPart
 - isPartOf
 - isVisualizedBy
 - isContainedIn
 - author
 - authorOf
 - hasBeenUsedIn
 - isRelatedTo
 - architectOf
 - architect
 - user
 - userOf
 - child
 - mother
 - father
 - photographerOf
 - photographer
 - isMentionedBy
 - mentions


