Go to file
Daira-Emma Hopwood 1304a5d3b7
Merge pull request #55 from daira/add-repos
Add some repositories
2024-02-19 20:46:17 +00:00
.github/workflows Ignore errors with ZF DAG rendering 2024-01-04 15:46:09 +00:00
public Highlight nodes with S-waiting-on-review label 2023-01-23 21:12:25 +00:00
.gitignore Revert incorrect changes to `.gitignore`. 2023-10-19 23:16:29 +01:00
README.md Delete template_scripts and update README. 2023-10-19 23:22:18 +01:00
gen-dag.sh Pivot to requiring credentials to be in well-named files rather than env variables. 2023-10-19 09:23:44 -07:00
gen-schema.sh Pivot to requiring credentials to be in well-named files rather than env variables. 2023-10-19 09:23:44 -07:00
index.html Add TFL DAG to index and put Halo2 in the same view order we use elsewhere 2023-10-11 18:04:44 +01:00
pyproject.toml Update dependencies 2024-02-02 19:47:39 +00:00
requirements.txt Add pygraphviz to requirements 2021-05-07 12:30:13 +12:00
zcash-issue-dag.py Add Electric-Coin-Company/infrastructure repo. 2024-02-19 20:37:26 +00:00

README.md

Zcash Developers Hub

This is the source repository for the Zcash Developers Hub website: https://zcash.github.io/developers/

For now, this repo hosts the script used to generate ECC's development dependency graph, and a workflow that generates and hosts it.

Setup

This project uses poetry for dependency management: https://python-poetry.org/ It also depends on the Graphviz library; for Debian-based distros, install the libgraphviz-dev package.

After installing poetry, run poetry install.

Authorization Tokens

The scripts provided by this project require two files:

  • GITHUB_TOKEN: a GitHub API token with permission to read the necessary repositories.
  • ZENHUB_TOKEN: a ZenHub REST API token. (Not a GraphQL token.)

After generating each token, paste the literal contents into the associated file. There is a .gitignore which ignores these files to ensure they are not committed. Be careful to avoid that editor temporary files or any copies or renames of these files aren't committed.

You can generate a GitHub token with this url. This token should not have any excess authority; it only needs public read access! Make sure all of those extra capability checkboxes are unchecked.

The DAG script depends upon GraphQL APIs for GitHub which can be generated using ./gen-schema.sh.

Generating DAGs

The simplest way to generate one or more DAGs is to use ./gen-dag.sh script. This takes a list of DAGs to render as arguments (default: core wallet tfl halo2 zf).

Alternatively, the zcash-issue-dag.py script supports several configuration options supplied as environment variables:

  • DAG_VIEW=[core|halo2|tfl|wallet|wallet-ios|wallet-android|zf]: The DAG to render (default: core).
  • SHOW_MILESTONES=[true|false]: Whether or not to render GitHub milestones as boxes (default: false).
  • SHOW_EPICS=[true|false]: Whether or not to render ZenHub epics as boxes (default: false).
  • INCLUDE_FINISHED=[true|false]: Whether or not to include closed issues with no open blockers (default: false).

Example command:

DAG_VIEW=core SHOW_MILESTONES=false poetry run python ./zcash-issue-dag.py