Concept collection to RDF library
==============================

.. toctree::
   :hidden:
   :maxdepth: 1

   license
   reference

A small Python library for mapping a concept collection to rdf

The library contains helper classes for the following Skos classes:

* `Collection <https://www.w3.org/TR/vocab-dcat-2/#Class:Catalog>`_
* `Concept <https://www.w3.org/TR/vocab-dcat-2/#Class:Dataset>`_

Other relevant classes are also supported, such as:

* Contact (`vcard:Kind <https://www.w3.org/TR/2014/NOTE-vcard-rdf-20140522/#d4e1819>`_)

The library will map to `the Norwegian Application Profile <https://doc.difi.no/skos-ap-no/>`_ of `the DCAT standard <https://www.w3.org/TR/vocab-dcat-2/>`_.


Installation
------------

To install the concepttordf package,
run this command in your terminal:

.. code-block:: console

   $ pip install concepttordf


Usage
-----

This package can be used like this:

.. code-block::

  from concepttordf.catalog import Catalog, Dataset

  # Create catalog object
  catalog = Catalog()
  catalog.identifier = "http://example.com/catalogs/1"
  catalog.title = {"en": "A dataset catalog"}
  catalog.publisher = "https://example.com/publishers/1"

  # Create a dataset:
  dataset = Dataset()
  dataset.identifier = "http://example.com/datasets/1"
  dataset.title = {"nb": "inntektsAPI", "en": "incomeAPI"}
  #
  # Add concept to catalog:
  catalog.datasets.append(dataset)

  # get rdf representation in turtle (default)
  rdf = catalog.to_rdf()
  print(rdf)