Skip to main content

Library for conversions to/from the Commonmeta scholarly metadata format

Project description

Build PyPI version Coverage Maintainability Rating docs GitHub

commonmeta-py

commonmeta-py is a Python library to implement Commonmeta, the common Metadata Model for Scholarly Metadata. Use commonmeta-py to convert scholarly metadata, in a variety of formats, listed below. Commonmeta-py is work in progress, the first release on PyPi (version 0.5.0) was on February 16, 2023. Up until version 0.5.1, the library was called talbot. Commonmeta-py is modelled after the commonmeta-ruby ruby gem.

commonmeta-py uses semantic versioning. Currently, its major version number is still at 0, meaning the API is not yet stable, and breaking changes are expected in the internal API and commonmeta JSON format.

Installation

Stable version

pip (or pip3) install commonmeta-py

Dev version

pip install git+https://github.com/front-matter/commonmeta-py.git#egg=commonmeta-py

Supported Metadata Formats

Commometa-py reads and/or writes these metadata formats:

Format Name Content Type Read Write
Commonmeta commonmeta application/vnd.commonmeta+json yes yes
CrossRef XML crossref_xml application/vnd.crossref.unixref+xml yes yes
Crossref crossref application/vnd.crossref+json yes no
DataCite datacite application/vnd.datacite.datacite+json yes yes
Schema.org (in JSON-LD) schema_org application/vnd.schemaorg.ld+json yes yes
RDF XML rdf_xml application/rdf+xml no later
RDF Turtle turtle text/turtle no later
CSL-JSON csl pplication/vnd.citationstyles.csl+json yes yes
Formatted text citation citation text/x-bibliography no yes
Codemeta codemeta application/vnd.codemeta.ld+json yes later
Citation File Format (CFF) cff application/vnd.cff+yaml yes later
JATS jats application/vnd.jats+xml later later
CSV csv text/csv no later
BibTex bibtex application/x-bibtex later yes
RIS ris application/x-research-info-systems yes yes
InvenioRDM inveniordm application/vnd.inveniordm.v1+json later yes
JSON Feed json_feed_item application/feed+json yes later

commonmeta: the Commonmeta format is the native format for the library and used internally. Planned: we plan to implement this format for the v1.0 public release.
Later: we plan to implement this format in a later release.

Documentation

Documentation (work in progress) for using the library is available at the commonmeta-py Documentation website and includes several interactive Jupyter Notebooks .

Meta

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License: MIT

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

commonmeta_py-0.10.3.tar.gz (233.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

commonmeta_py-0.10.3-py3-none-any.whl (254.6 kB view details)

Uploaded Python 3

File details

Details for the file commonmeta_py-0.10.3.tar.gz.

File metadata

  • Download URL: commonmeta_py-0.10.3.tar.gz
  • Upload date:
  • Size: 233.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.5 Darwin/23.3.0

File hashes

Hashes for commonmeta_py-0.10.3.tar.gz
Algorithm Hash digest
SHA256 c98c385bee5f86b36bdd73ce016a9db2b34437f65712caae66415c164516d068
MD5 5321dc9dc5bb6982cf159966099c3b63
BLAKE2b-256 d7d37a6b02a39cd3c2787063d4ddb2ffd798f76a3fb0446004edff6ff1952deb

See more details on using hashes here.

File details

Details for the file commonmeta_py-0.10.3-py3-none-any.whl.

File metadata

  • Download URL: commonmeta_py-0.10.3-py3-none-any.whl
  • Upload date:
  • Size: 254.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.5 Darwin/23.3.0

File hashes

Hashes for commonmeta_py-0.10.3-py3-none-any.whl
Algorithm Hash digest
SHA256 849f74aad49c87977949fd17285dcc570d29f6c4683f1929c465e6d185a5b5c8
MD5 1f6f637bed91a94507a06d8b31f3d560
BLAKE2b-256 8572f181cf84a33e94470af520d93e9977c18864d478c270130855f05fb906ad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page