Skip to main content

Library for conversions to/from the Commonmeta scholarly metadata format

Project description

DOI 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 n/a
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 application/vnd.citationstyles.csl+json yes yes
Formatted text citation citation text/x-bibliography n/a 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.16.6.tar.gz (295.5 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.16.6-py3-none-any.whl (331.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: commonmeta_py-0.16.6.tar.gz
  • Upload date:
  • Size: 295.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.5 Darwin/23.4.0

File hashes

Hashes for commonmeta_py-0.16.6.tar.gz
Algorithm Hash digest
SHA256 bf0329b5f180e23e4ea0bdf9da1a172a3f027cfbb1fd2522cfd898f8c9ecd170
MD5 1db0a84cc14d6cfdaeaca027e90fffae
BLAKE2b-256 3bdc18a9d1d5a912f7487126477a588c93b46e8c203bf98e092636fa4dc7ad14

See more details on using hashes here.

File details

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

File metadata

  • Download URL: commonmeta_py-0.16.6-py3-none-any.whl
  • Upload date:
  • Size: 331.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.5 Darwin/23.4.0

File hashes

Hashes for commonmeta_py-0.16.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a5d86c3e6067603a8324ee20f3bf778429db23f6d9ddf8efea0d7e8560d06a48
MD5 41199458b0efcd56f8b57ccd10a5eae1
BLAKE2b-256 eb3fb080a1d90c5d9b7dc0a677072bd77e4842b276a4abe585a8af4763ba8aea

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