Metadata-Version: 2.1
Name: iscc
Version: 1.0.3
Summary: ISCC: Reference Implementation
Home-page: https://github.com/iscc/iscc-specs
Author: Titusz Pan
Author-email: tp@py7.de
License: BSD 2-clause
Description: # ISCC - Spec and Reference Code
        
        [![Build](https://travis-ci.org/iscc/iscc-specs.svg?branch=master)](https://travis-ci.org/iscc/iscc-specs)
        [![Version](https://img.shields.io/pypi/v/iscc.svg)](https://pypi.python.org/pypi/iscc/)
        [![License](https://img.shields.io/pypi/l/iscc.svg)](https://pypi.python.org/pypi/iscc/)
        [![Downloads](https://pepy.tech/badge/iscc)](https://pepi.tech/project/iscc)
        
        The **International Standard Content Code** is a proposal for an [open standard](https://en.wikipedia.org/wiki/Open_standard) for decentralized content identification. This repository contains the specification of the proposed **ISCC Standard** and a reference implementation in Python3. The latest published version of the specification can be found at [iscc.codes](http://iscc.codes>)
        
        ## Installing the reference code
        
        The reference code is published with the package name [iscc](https://pypi.python.org/pypi/iscc) on Python Package Index. Install it with:
        
        ``` bash
        pip install iscc
        ```
        
        ## Using the reference code
        
        A short example on how to create an ISCC Code with the reference implementation.
        
        ``` python
        import iscc
        
        # Generate ISCC Component Codes
        mid, title, extra = iscc.meta_id('Title of Content')
        cid = iscc.content_id_text('some text')
        did = iscc.data_id('path/to/mediafile.doc')
        iid, tophash = iscc.instance_id('path/to/mediafile.doc')
        
        # Join ISCC Components to fully qualified ISCC Code
        iscc_code = '-'.join([mid, cid, did, iid])
        print('ISCC:{}'.format(iscc_code))
        ```
        
        ## Working with the specification
        
        The entire **ISCC Specification** is written in plain text [Markdown](https://en.wikipedia.org/wiki/Markdown). The markdown content is than built and published with the excellent [mkdocs](http://www.mkdocs.org/) documetation tool. If you have some basic command line skills you can build and run the specification site on your own computer. Make sure you have the [git](https://git-scm.com/) and [Python](https://www.python.org/) installed on your system and follow these steps on the command line:
        
        ``` bash
        git clone https://github.com/iscc/iscc-specs.git
        cd iscc-specs
        pip install -r requirements.txt
        mkdocs serve
        ```
        
        All specification documents can be found in the `./docs` subfolder or the repository. The recommended editor for the markdown files is [Typora](https://typora.io/). If you have commit rights to the [main repository](https://github.com/iscc/iscc-specs) you can deploy the site with a simple `mkdocs gh-deploy`.
        
        ## Contribute
        
        Pull requests and other contributions are welcome. Use the [Github Issues](https://github.com/iscc/iscc-specs/issues) section of this project to discuss ideas for the **ISCC Specification**. You may also want  join our developer chat on Telegram at <https://t.me/iscc_dev>.
        
        ## License
        
        All of documentation is licensed under the [CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
        
        Reference code is licensed under BSD-2-Clause.
        
Keywords: iscc identifier media content hash blockchain similarity
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
