Blockcerts core models for python
Project description
[![Build Status](https://travis-ci.org/blockchain-certificates/cert-core.svg?branch=master)](https://travis-ci.org/blockchain-certificates/cert-core) [![PyPI version](https://badge.fury.io/py/cert-core.svg)](https://badge.fury.io/py/cert-core)
# cert-core This python library contains common Blockcerts models and accessors used by other Blockcerts python libraries.
Subpackages:
## cert-model
Parses different versions of Blockcerts JSON files into a common Certificate model.
## cert-store
Blockchain certificate storage. This is used as a library in the cert-viewer project.
The certificate storage interface is [simplekv](https://pypi.python.org/pypi/simplekv/). The default configurations use the FilesystemStore, which is highly recommended if you are getting started. This makes it easier to issue, copy, and view your Blockchain Certificates.
## Certificate Storage Configuration
The certificate storage location can be modified with the following configuration entries in your conf.ini file:
cert_store_type: which key-value backing store to use. Current supported values are: - simplekv_fs: (Default) file system store - simplekv_gridfs: (Advanced) gridfs store
cert_store_path: file system path if using simplekv_fs
mongodb_uri: mongo db uri (including db name) if using simplekv_gridfs
Example File System config:
` cert_store_type = simplekv_fs cert_store_path = ./cert_data `
Example GridFS config (Advanced):
` cert_store_type = simplekv_gridfs mongodb_uri = mongodb://localhost:27017/test `
### Legacy options
Warning
Most users should ignore these instructions, which are only included as a temporary bridge for earlier users of blockcerts. We recommend migrating to the latest version of Blockcerts.
### V1 Aware Certificate Store
Warning: avoid this option unless you are sure you need it. Earlier versions of the Blockchain Certificate required a separate storage of the certificate transaction id. That was managed in a certificates mongo db table.
The –v1_aware flag allows support for these certificates.
## Running the python code locally
Ensure you have an python environment. [Recommendations](https://github.com/blockchain-certificates/cert-issuer/blob/master/docs/virtualenv.md)
Git clone the repository and change to the directory
`bash git clone https://github.com/blockchain-certificates/cert-core.git && cd cert-core `
Run cert-core setup
`bash pip install . `
## Unit tests
This project uses tox to validate against several python environments.
Ensure you have an python environment. [Recommendations](https://github.com/blockchain-certificates/cert-issuer/blob/master/docs/virtualenv.md)
- Run tests
` ./run_tests.sh `
## Publishing package to pypi
[First time info](http://peterdowns.com/posts/first-time-with-pypi.html)
Publish script: ./release_package.sh
## Contact
Contact us at [the Blockcerts community forum](http://community.blockcerts.org/).
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
File details
Details for the file cert-core-2.1.10.tar.gz
.
File metadata
- Download URL: cert-core-2.1.10.tar.gz
- Upload date:
- Size: 12.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.10.0 pkginfo/1.2.1 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/3.6.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1eb7b68181311c4736d6120e111e3c8736fd0eee42323954e494b3221d42bab6 |
|
MD5 | 6df584995b9902dee49ea52a051837c6 |
|
BLAKE2b-256 | f9563cd95c9f9bace8a24a86718f0d8aaf21bf8d5f5e7bd18cf21008b2cdd120 |