bibframe-json
bibframe-json provides a predictable, opinionated JSON shape for BIBFRAME data, in the spirit of Linked Open and Usable Data (LOUD).
LOUD names the audience as developers, and holds that use cases rather than ontological purity should drive what passes between systems. Two of its five principles do most of the work here: comprehensible by introspection, so the data makes sense by being looked at, and few exceptions, instead many consistent patterns, so there is less to learn.
Here that means every property is an array, so you can loop without checking
whether this one happens to hold a single value. A blank node never carries
an identifier you have to reconcile. title means bf:title rather than a
URI you have to expand. You can read a record without an RDF library or any
knowledge of the RDF data model, and check one against the JSON Schemas
without reading any of this.
It ships a JSON-LD context that produces the shape, JSON Schemas that check it, and a corpus of documents with expected verdicts so you can hold a reader in any language to the same standard.
Documentation: https://bibframe-json.org/
It grew out of the Blue Core project, and the schema is meant to be shared by anyone working with BIBFRAME JSON data.
The artifacts are published under v0.1. Every published version is frozen, but several more are expected before v1, and each is a breaking change from the one before. v1 is the point at which this becomes something to build on. See Versioning.
Working on it
uv run pytest # the library and the schemas
uv run python generate/from_ontology.py # context, ontology schema, vocabulary
uv run python generate/bundle.py # linked.json, bundled from schema/linked/
cd docs && npm install && npm run dev # the documentation site
The context, the ontology schema and bibframe_json/vocabulary.json are
generated from the BIBFRAME vocabulary vendored at generate/bibframe.rdf.
bibframe_json/schema/linked/ is written by hand, one file per definition,
and schema/linked.json is those files bundled into one. CI regenerates and
diffs, so an edit to a generator that was not followed by a rebuild fails.
generate/rebase.py moves every $id and published URL to a different host in
one command. Hosting and identity travel together: a relative $ref resolves
against the $id of the file it appears in, not against wherever you fetched
it.
If you have a record this shape handles badly, the most useful thing you can
send is a case in conformance/, which takes no Python at all. See
conformance/README.md.
Blue Core drives the work, and the wider aim is to make BIBFRAME more shareable as JSON, in any language.
Metadata
Release files for bibframe-json 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bibframe_json-0.1.0.tar.gz | 232.7 kB | Without provenance | Details for bibframe_json-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bibframe_json-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for bibframe_json-0.1.0-py3-none-any.whl |
Total release size: 292.1 kB
Release files / bibframe_json-0.1.0.tar.gz
| Download URL | bibframe_json-0.1.0.tar.gz |
|---|---|
| Size | 232.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
becfc99019121b07f12249a16b93ca5f9ca48bed647c957b1773c61b9ddb62f5
|
|
BLAKE2b-256 checksum How to use checksums |
c8ebeb54d705450223720f33180f67aa4092f4db928a522c4d3cd8c552c9816f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / bibframe_json-0.1.0-py3-none-any.whl
| Download URL | bibframe_json-0.1.0-py3-none-any.whl |
|---|---|
| Size | 59.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ffcbc3132fce24027c117fbb5d6922ac722a885a6630a826ee58c4bf0fb37b09
|
|
BLAKE2b-256 checksum How to use checksums |
ac8a0a7cfe7e208ea9bd191bec796bcea50d090378fb81acf32e84ce34c73d79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for bibframe-json 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.