A toolkit for reading and writing ILCD format and it's derivatives
Project description
ILCD Lib
Python library providing parsing capabilities for ILCD XML files.
Installation
Install the library from PyPi. The following command will install the library with all optional dependencies:
pip install "ilcdlib[lxml,cli]"
If you don't need CLI tool, you can omit cli
extra. The following extras are available:
lxml
- install lxml library for faster XML parsingcli
- install CLI tool so it could be used from command line viailcdtool
command.
Usage
CLI
At the moment the primary function of the CLI tool is to convert ILCD XML files to openEPD (json) format.
Here is a simple example of how to use it to convert ILCD archive to openEPD format:
ilcdtool --debug convert-epd -i ilcd+epd -o openEPD "<path/to/archive.zip>"
It is also possible to point the tool to the http endpoint instead. At the moment Soda4Lca web UI and api endpoints are supported.
ilcdtool convert-epd -i ilcd+epd -o openEPD "https://oekobaudat.de/OEKOBAU.DAT/datasetdetail/process.xhtml?uuid=ee8863aa-7276-4896-b07a-713937a3134d&version=00.00.018&stock=OBD_2021_II&lang=en"
Another important feature is the ability to specify a dialect. Dialect is a set of rules that define how the handle provider specific data. It is useful for the cases when provider does not follow the standard or standard is not strict enough the provider has a multiple options how to persist the data.
convert-epd -i ilcd+epd -o openEPD -d environdec https://data.environdec.com/showProcess.xhtml?uuid=bfeb8678-b3cb-4a5b-b8cb-2512b551ad17&version=01.00.001&stock=Environdata
CLI tool provides comprehensive help for each of the supported commands. Use ilcdtool --help
to get the list of the
supported commands and a set of global parameters. And use ilcdtool <command> --help
to get help for the specific
command.
Use in Python code
There are 3 primary concepts in the library:
Medium
is a way how application reads ILCD XML data. It could be a zip file, some http API or anything else.IlcdXmlReader
is a class that reads ILCD XML data from the medium and provides a set of methods to access the data.Dialects
are just a subclasses of corresponding readers which override data extraction logic for some of the fields.
So very basic usage of the library would look like this:
from ilcdlib.epd.reader import IlcdEpdReader
from ilcdlib.medium.archive import ZipIlcdReader
lang = ["en", None] # Means "en" or any available language
# Create a medium capable to read data from the zip archive
zip_reader = ZipIlcdReader("<path/to/archive.zip>")
# Create a reader that will read data from the given medium and passing the target object to read
# (identified by id and version)
epd_reader = IlcdEpdReader(
"2eb43850-0ab2-4068-afe5-218d69a096f8",
"00.01.000",
zip_reader,
)
print(epd_reader.get_product_name(lang)) # Extract product name
print(epd_reader.get_declared_unit()) # Extract declared unit
# Convert to openEPD format
print(epd_reader.to_openepd_epd(lang).json(indent=2))
For Library Maintainers
Maintainer's Guide is available here.
Credits
This library has been written and maintained by C-Change Labs.
License
This library is licensed under Apache 2. This means you are free to use it in commercial projects.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ilcdlib-0.3.0.tar.gz
.
File metadata
- Download URL: ilcdlib-0.3.0.tar.gz
- Upload date:
- Size: 185.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.0 CPython/3.11.3 Linux/5.15.0-1037-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | aad0677a47522e8428842f2e3ae82d52bc084afa25ca59bbd4a152b841432aeb |
|
MD5 | 4ac1c9450c0c4b3351b0fad6adfd47c2 |
|
BLAKE2b-256 | 77fae18f5bf15404db9d2932ed827024dcd003f5318b97abfd14fbcf7ebfe312 |
File details
Details for the file ilcdlib-0.3.0-py3-none-any.whl
.
File metadata
- Download URL: ilcdlib-0.3.0-py3-none-any.whl
- Upload date:
- Size: 207.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.0 CPython/3.11.3 Linux/5.15.0-1037-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8d94bb88aa5977c2285b61c1816cc179555f5f2153633895effe4bc6092adb08 |
|
MD5 | 45338f2cf97e32309e9d8724b8138da5 |
|
BLAKE2b-256 | 546fa72f90a530b293cc04936913593c79af1a64581d411053d1c3245bf71531 |