Update readme and PyPI adjustments.

Author: poing

README.md

@@ -1,12 +1,73 @@
-# js2pysecrets
-
-[![codecov](https://codecov.io/gh/poing/JS2PySecrets/branch/main/graph/badge.svg?token=JS2PySecrets_token_here)](https://codecov.io/gh/poing/JS2PySecrets)
 [![CI](https://github.com/poing/JS2PySecrets/actions/workflows/main.yml/badge.svg)](https://github.com/poing/JS2PySecrets/actions/workflows/main.yml)
+[![codecov](https://codecov.io/gh/poing/JS2PySecrets/branch/main/graph/badge.svg?token=JS2PySecrets_token_here)](https://codecov.io/gh/poing/JS2PySecrets)
+[![PyPI version](https://badge.fury.io/py/js2pysecrets.svg)](https://badge.fury.io/py/js2pysecrets)
 [![Built with Material for MkDocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?logo=MaterialForMkDocs&logoColor=white)](https://squidfunk.github.io/mkdocs-material/)
-
 [![JS2PySecrets Documentation](https://img.shields.io/badge/Documentation-white?labelColor=3F00FF&logo=data:image/svg%2bxml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c3ZnIGlkPSJiIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNDEuNTUgMTUwLjUiPjxnIGlkPSJjIj48cGF0aCBkPSJNOTEuMy4yNWw1OC4yOC4wOGM2LjQ3LDAsMTEuNzIsNS4yNiwxMS43MiwxMS43M2gwYzAsNS4zLTIuMTEsMTAuMzktNS44NiwxNC4xNGwtMy41LDMuNWMtNi4wMyw2LjAzLTYuNDYsMTUuNjYtMS4wMSwyMi4yMWgwYzgsOS42LDIyLjczLDkuNiwzMC43MywwaDBjNS40Ni02LjU1LDUuMDItMTYuMTgtMS4wMS0yMi4yMWwtMy41LTMuNWMtMy43NS0zLjc1LTUuODYtOC44NC01Ljg2LTE0LjE0aDBjMC02LjQ3LDUuMjQtMTEuNzIsMTEuNzItMTEuNzNsNTguMjgtLjA4YzAsODIuMjktNjcuNzEsMTUwLTE1MCwxNTAtMjYuMzMsMC01Mi4yLTYuOTMtNzUtMjAuMWwyOS4xNy01MC41MmMzLjI0LTUuNiwxLjMyLTEyLjc3LTQuMjktMTZoMGMtNC41OS0yLjY1LTEwLjA1LTMuMzctMTUuMTgtMmwtNC43OCwxLjI4Yy04LjIzLDIuMjEtMTYuNzktMi4yMy0xOS43My0xMC4yM2gwYy00LjMxLTExLjcyLDMuMDYtMjQuNDgsMTUuMzYtMjYuNjFoMGM4LjQtMS40NSwxNi41MiwzLjc0LDE4LjczLDExLjk4bDEuMjgsNC43OGMxLjM3LDUuMTIsNC43Miw5LjQ5LDkuMzIsMTIuMTRoMGM1LjYsMy4yNCwxMi43NywxLjMyLDE2LTQuMjlMOTEuMy4yNVoiIHN0eWxlPSJmaWxsOiNmZmZmZmY7ICIvPjwvZz48L3N2Zz4=)](https://poing.github.io/JS2PySecrets/)
 
+# About
+
+`js2pysecrets` is a port of the [`secrets.js-grempe`](https://github.com/grempe/secrets.js) JavaScript package to Python. 
+
+This package allows for cross-platform compatible shares, *generated using [Shamir's Secret Sharing](http://en.wikipedia.org/wiki/Shamir's_Secret_Sharing)*, to seamlessly interoperate between JavaScript and Python.
+
+Function names and arguments used in the JavaScript package have been maintained for consistency and maintainability. 
+
+The functionality is essentially the same as the JavaScript package, with an exception around random number generation.  Python doesn't have to adapt to different environments for random number generation like the JavaScript does.
+
+*For additional details, see the [documentation](https://poing.github.io/JS2PySecrets/).*
+
+
+## Installation and Usage
+
+Install the PyPI package:
+
+```
+pip install js2pysecrets
+```
+
+Import the library:
+
+```
+import js2pysecrets as secrets
+```
+
+### Examples
+
+Divide a 512-bit key, expressed in hexadecimal form, into 10 shares, requiring that any 5 of them are necessary to reconstruct the original key:
+
+```python
+import js2pysecrets as secrets
+
+# generate a 512-bit key
+key = secrets.random(512) 
+print(key) # => key is a hex string
+
+# split into 10 shares with a threshold of 5
+shares = secrets.share(key, 10, 5)
+print(shares) # => ['801xxx...xxx','802xxx...xxx', ... ,'809xxx...xxx','810xxx...xxx']
+
+# combine 4 shares
+comb = secrets.combine(shares[:4])
+print(comb == key) # => False
+
+# combine 5 shares
+comb = secrets.combine(shares[:5])
+print(comb == key) # => True
+
+# combine ALL shares
+comb = secrets.combine(shares)
+print(comb == key) # => True
+
+# create another share with id 8
+new_share = secrets.newShare(8, shares)
+print(new_share) # => '808xxx...xxx'
+
+# reconstruct using 4 original shares and the new share:
+comb = secrets.combine(shares[:4] + [new_share])
+print(comb == key) # => True
+```
 
+---
 
 This is a `Python` implementation of [Shamir's threshold secret sharing scheme](http://en.wikipedia.org/wiki/Shamir's_Secret_Sharing), based **and compatible with** the `JavaScript` fork of `secrets.js` [*maintained by `grempe`*](https://github.com/grempe/secrets.js).  Which is orginally based on the code created by `amper5and` on Github. The [original secrets.js can be found there](https://github.com/amper5and/secrets.js/).
 

js2pysecrets/__init__.py

@@ -1,3 +1,5 @@
 from .base import *  # noqa
 
+init()
+
 # import .node  # noqa

setup.py

@@ -32,7 +32,7 @@ def read_requirements(path):
 setup(
     name="js2pysecrets",
     version=read("js2pysecrets", "VERSION"),
-    description="Shamir's Secret Sharing - Port of secrets.js-grempe to Python, allowing cross-platform compatable share usage between JavaScript and Python.",
+    description="Shamir's Secret Sharing - A port of secrets.js-grempe to Python, allowing cross-platform compatable shares between JavaScript and Python.",
     url="https://github.com/poing/JS2PySecrets/",
     project_urls={
         'Documentation': 'https://poing.github.io/JS2PySecrets',