Developers

Overview

The SettingsQR Generator pulls the SettingsDefinition class from the main SeedSigner repo and outputs the settings options as json. A python script in this repo then reads that json in and injects the settings options into a Jinja2 template for a one-time process that renders the final static index.html. At that point the user can run the index.html as a standalone, static html page. A Github Action is also set up for this repo to automatically publish the index.html to Github Pages.

Set up a local copy of this repo

To make deeper changes to the SettingsQR Generator, you'll want to clone the repo with the --recursive option so that it includes the nested SeedSigner core repo as well:

git clone --recursive https://github.com/seedsigner/seedsigner-settings-generator.git

Note: If you don't include `--recursive`...

You'll need to make two follow-up calls:

git submodule init
git submodule update --remote

You should now have a complete copy of this repo AND the SeedSigner repo in your src/ subdir.

Local dev environment

We rely on a python script that uses a Jinja2 template to generate the static index.html. So you'll need to set up a new python3 virtualenv (plenty of python3 virtualenv guides you can follow) and install the Jinja2 dependencies:

pip install -r requirements.txt

We also need the main SeedSigner code installed in our virtualenv:

pip install -e src/seedsigner

Updating changes from `SettingsDefinition` in the SeedSigner repo

Any time a change is made in SettingsDefinition in SeedSigner, you'll need to regenerate the SettingsQR Generator's index.html in order to see the latest settings options changes.

Targeting the SeedSigner submodule to your own repo or branch

If you're changing the settings options in your own SeedSigner fork/branch, you'll need to make sure that .gitmodules in this project's root dir is pointing to your repo and your target branch.

Change the url and branch as needed:

[submodule "src/seedsigner"]
	path = src/seedsigner
	url = https://github.com/my_user/seedsigner.git
	branch = my_branch

The generate.sh script in the next step will automatically update the submodule to your specified fork and branch.

Generate updated `index.html`

With your target SettingsDefinition and your virtualenv set up, you can now just run the generate.sh script from the src/ directory:

cd src
./generate.sh

The script runs src/parse_settings_json.py which extracts SeedSigner's SettingsDefinition. That is then used to generate the final static index.html that gets written to the docs/ dir.

Note: Why are the static web files in the docs/ subdir (a better place would be something like a www/ subdir)? A limitation in Github Pages only lets us host the static website from either the repo root or from a hard-coded docs/ subdir.

SettingsQR Format

Review the SettingsQR Specification for details on the SettingsQR format, legal values, etc.

3.1 KiB Raw Permalink Blame History