SDMX to JSON-LD Parser

About The Project

A SDMX in RDF Turtle 1.1 format parser to generate valid JSON-LD and send to FIWARE Context Brokers using ETSI NGSI-LD.

It is based on a EBNF LALR(1) grammar.

This project is part of INTERSTAT. For more information about the INTERSTAT Project, please check the url https://cef-interstat.eu.

(back to top)

Dependencies

The dependencies of the sdmx2jsonld python package are the following:

• Lark - a modern general-purpose parsing library for Python.
• hi-dateinfer - a python library to infer date format from examples.
• Loguru - a library which aims to bring enjoyable logging in Python.
• Requests - an elegant and simple HTTP library for Python, built for human beings.
• RDFLib - a pure Python package for working with RDF.

For more details about the versions of each library, please refer to requirements.txt.

(back to top)

Installing SDMX2JSON-LD and Supported Versions

SDMX2JSON-LD is available on PyPI:

$ python -m pip install sdmx2jsonld

SDMX2JSON-LD officially supports Python 3.10+.

(back to top)

Usage

To execute the python module you can follow the following code to parse the RDF Turtle file to generate the JSON-LD content to be sent to the FIWARE Context Broker:

from sdmx2jsonld.transform.parser import Parser
from sdmx2jsonld.exceptions import UnexpectedEOF, UnexpectedInput, UnexpectedToken

file_in = open("structures-accounts.ttl")
generate_files = True

# Start parsing the file
my_parser = Parser()

try:
    my_parser.parsing(content=file_in, out=generate_files)
except UnexpectedToken as e:
    print(e)
except UnexpectedInput as e:
    print(e)
except UnexpectedEOF as e:
    print(e)

Where:

• file_in is the RDF Turtle content that can be a string in StringIO class or a read file in TextIOWrapper class.
• file_out is a boolean variable to indicate if we want to save the JSON-LD parser content into files (True) or we want to show the content in the screen (False).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

Fernando López - @flopezaguilar - fernando.lopez@fiware.org

Project Link: https://github.com/flopezag/IoTAgent-Turtle

(back to top)

License

Distributed under the Apache2.0 License. See LICENSE for more information.

(back to top)