Cobalt
Cobalt is a lightweight Python library for working with Akoma Ntoso documents. It makes it easy to work with Akoma Ntoso documents, metadata and FRBR URIs.
It is lightweight because most operations are done on the XML document directly without intermediate objects. You still need to understand how Akoma Ntoso works.
Read the full documentation at cobalt.readthedocs.io.
Quickstart
Install using:
$ pip install cobalt
Use it like this:
>>> from cobalt import Act
>>> act = Act()
>>> act.title = "Act 10 of 1980"
>>> act.frbr_uri = "/za/act/1980-05-03/10"
>>> act.frbr_uri.year
'1980'
>>> act.frbr_uri.date
'1980-05-03'
>>> act.frbr_uri.number
'10'
>>> act.frbr_uri.doctype
'act'
>>> print act.to_xml()
[ lots of xml ]
Contributing
-
Clone the repo
-
Install development dependencies:
pip install -e .[dev] -
Make your changes
-
Run tests:
nosetests && flake8 cobalt -
Send a pull request
Releasing a new version
- Run the tests with
python -m unittest - Update the version by changing the
__version__variable incobalt/__init__.py - Commit your changes and push to the master branch on GitHub
- Create a release in GitHub and it will automatically be pushed to PyPi
License
Cobalt is licensed under the LPGL 3.0 license.
Copyright 2015-2020 AfricanLII.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this program. If not, see https://www.gnu.org/licenses/.
1 maintainer
Release files for cobalt 9.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cobalt-9.0.1.tar.gz | 83.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cobalt-9.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 156.8 kB
Release files / cobalt-9.0.1.tar.gz
| Download URL | cobalt-9.0.1.tar.gz |
|---|---|
| Size | 83.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a1581f611d9dace7dee35f288e5f3891066a9dd1f5f0881532289fc37f89ea5
|
|
BLAKE2b-256 checksum How to use checksums |
95e08ba0deca45a1b9985d9dab0be36d55687f438ea8eea3f0a23e00bae3853d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 9, 2024.
Transparency logRelease files / cobalt-9.0.1-py3-none-any.whl
| Download URL | cobalt-9.0.1-py3-none-any.whl |
|---|---|
| Size | 73.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8339d0edcc470381ce0fc62daa8bd419f7cc731ffd83fcf57a7c6cf0b526e640
|
|
BLAKE2b-256 checksum How to use checksums |
1583d5be80b572064329066b8738e91f6b8dd42712007ae0c13e5e8911cdb1b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 9, 2024.
Transparency log
