From ef39ba774fa9fa938d3e15cb3da1701b2d2f86ff Mon Sep 17 00:00:00 2001 From: Pablion <36828324+Pablion@users.noreply.github.com> Date: Wed, 2 Feb 2022 17:37:58 +0100 Subject: [PATCH] docs: 0.0.5 polish --- README.md | 17 ++++++++--------- docs/dev-docs.md | 17 +++++++++++++++++ pyproject.toml | 11 +++++++++-- res/sss.schema.json | 2 +- sss_cli/__init__.py | 2 +- tests/injection/sss.json | 2 +- 6 files changed, 37 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index eff665d..bc5986d 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # symmetric-secrete-share -Share secret files via github with symmetric encryption ed25519. +CLI to share secret files via github with symmetric encryption ed25519. -- **IMPORTANT: The secret files at should be git-ignored.** +- **IMPORTANT: The secret files at should be git-ignored to avoid oblivious leakage.** - Temporarily supports only text files (only tested with `.env`). - Best used to store secrets and configurations. - Key should be a 32-byte long string. @@ -10,9 +10,9 @@ Share secret files via github with symmetric encryption ed25519. ## Use -1. Install CLI -2. Check the [Tutorial](#Tutorial) and `sss --help` -3. Recommend to set a global key with `sss key` +1. Install CLI `pip3 install symmetric-secrete-share`. +2. Check the [Tutorial Chapter](#Tutorial) and `sss --help`. +3. Recommended: set up a global key chain with `sss key`, or you would have to input key every time. 4. Get a config like `$REPO_ROOT/test/injection/sss.json`. The json-schema inside will help you write it. ### inject @@ -26,8 +26,6 @@ Share secret files via github with symmetric encryption ed25519. ### share -- **IMPORTANT: The generated secret (`*.encrypted`) at should be git-ignored to avoid oblivious leakage.** - 1. Run CLI ```bash @@ -39,8 +37,9 @@ Share secret files via github with symmetric encryption ed25519. ## Contribute -- Created for [Artcoin-Network](https://github.com/Artcoin-Network/), modifying the private repo[Artcoin-Network/artificial-dev-config](https://github.com/Artcoin-Network/artificial-dev-config). -- Read More in [dev-docs.md](./docs/dev-docs.md) +- Created for [Artcoin-Network](https://github.com/Artcoin-Network/), modifying the private repo [Artcoin-Network/artificial-dev-config](https://github.com/Artcoin-Network/artificial-dev-config). +- To contribute, please fork the repo and run `poetry install`. +- Read more in [dev-docs.md](./docs/dev-docs.md) ## Tutorial diff --git a/docs/dev-docs.md b/docs/dev-docs.md index db376a9..9654844 100644 --- a/docs/dev-docs.md +++ b/docs/dev-docs.md @@ -1,5 +1,22 @@ # Development Documentation +## Version + +### 0.0.5 + +- Publish to PyPI + +### 0.0.4 + +- Add `poetry` +- Add and chang json schema many times. +- Finish DEV LOG 7~15. + +### 0.0.2 + +- Work in [Artcoin-Network/artificial-dev-config](https://github.com/Artcoin-Network/artificial-dev-config). +- Finish DEV LOG 1~6. + ## DEV LOG 1. (DONE) Add a script to generate different files from one same file. We always use `.env` diff --git a/pyproject.toml b/pyproject.toml index 5cd218c..80f7d8c 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,13 +3,20 @@ authors = ["Pablion <36828324+Pablion@users.noreply.github.com>"] description = "Share secret files via github with symmetric encryption ed25519." license = "Apache-2.0" name = "symmetric-secrete-share" +packages = [ + {include = "sss_cli"}, +] readme = "README.md" -version = "0.0.4" +version = "0.0.5" + +[tool.poetry.urls] +documentation = "https://github.com/PabloLION/symmetric-secrete-share" +homepage = "https://github.com/PabloLION/symmetric-secrete-share" +repository = "https://github.com/PabloLION/symmetric-secrete-share" [tool.poetry.scripts] sss = "sss_cli.__main__:app" symmetric-secrete-share = "sss_cli.__main__:app" -tts = 'sss_cli.__main__:app' [tool.poetry.dependencies] PyNaCl = "^1.5.0" diff --git a/res/sss.schema.json b/res/sss.schema.json index 817b612..6de8c4e 100644 --- a/res/sss.schema.json +++ b/res/sss.schema.json @@ -49,7 +49,7 @@ "sss_version": { "description": "Version of symmetric_secrete_share", "enum": [ - "0.0.4" + "0.0.5" ], "type": "string" } diff --git a/sss_cli/__init__.py b/sss_cli/__init__.py index 03ddfa3..2ea6dbf 100644 --- a/sss_cli/__init__.py +++ b/sss_cli/__init__.py @@ -1,2 +1,2 @@ APP_NAME = "symmetric_secrete_share" -__version__ = "0.0.4" +__version__ = "0.0.5" diff --git a/tests/injection/sss.json b/tests/injection/sss.json index 169c5a9..97e452f 100644 --- a/tests/injection/sss.json +++ b/tests/injection/sss.json @@ -1,7 +1,7 @@ { "$schema": "https://raw.githubusercontent.com/PabloLION/symmetric-secrete-share/main/res/sss.schema.json", "$dev_schema": "./../../res/sss.schema.json", - "sss_version": "0.0.4", + "sss_version": "0.0.5", "config_id": "sss-example", "key_identifier": "test_key", "last_key_rotation": 0,