Skip to main content

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

  1. Ensure you have an python environment. [Recommendations](https://github.com/blockchain-certificates/cert-issuer/blob/master/docs/virtualenv.md)

  2. Git clone the repository and change to the directory

`bash git clone https://github.com/blockchain-certificates/cert-core.git && cd cert-core `

  1. Run cert-core setup

`bash pip install . `

## Unit tests

This project uses tox to validate against several python environments.

  1. Ensure you have an python environment. [Recommendations](https://github.com/blockchain-certificates/cert-issuer/blob/master/docs/virtualenv.md)

  2. Run tests

    ` ./run_tests.sh `

## Publishing package to pypi

## Contact

Contact us at [the Blockcerts community forum](http://community.blockcerts.org/).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cert-core-2.1.10.tar.gz (12.0 kB view details)

Uploaded Source

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

Hashes for cert-core-2.1.10.tar.gz
Algorithm Hash digest
SHA256 1eb7b68181311c4736d6120e111e3c8736fd0eee42323954e494b3221d42bab6
MD5 6df584995b9902dee49ea52a051837c6
BLAKE2b-256 f9563cd95c9f9bace8a24a86718f0d8aaf21bf8d5f5e7bd18cf21008b2cdd120

See more details on using hashes here.

Supported by

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