openstack-manuals/tools
Adam Spiers 4a53589fea www-generator.py: cache expensive repo/project metadata to disk
Gathering the metadata of repos and projects requires a significant
number of HTTP calls and is therefore slow and expensive.  When
hacking on www-generator.py the ability to skip these calls can save a
lot of time allowing much more rapid iteration.  So add a persistent
cache for this data, using the percache Python module.

This is mostly run in the gate, where the cache will be deleted on
each run.  Documentation contributors running this locally may
occasionally need to manually remove the cache file, although
governance data generally changes slow enough that this is expected to
be a rare corner case.

As noted by the comment in _get_official_repos(), in the future we may
add support for loading governance data from a local repo, thereby
skipping the need for slow HTTP calls.  But for now this is a simpler
solution.

Change-Id: Ib52171625e37169d00da03f436b58456c103b04d
2019-01-04 17:10:22 +00:00
..
README-USE-openstack-doc-tools.txt Remove 'autogenerate-config-flagmappings' 2018-09-25 16:12:47 +01:00
build-all-rst.sh Remove arch-design docs 2018-11-29 15:33:43 -06:00
build-rst.sh PDF generation support with --pdf option 2016-12-01 21:55:40 +00:00
generatepot-rst.sh Convert glossary to RST 2016-05-02 09:20:30 +02:00
glossary-sort.sh Fix cross-platform for checkniceness test 2017-02-25 21:50:39 +00:00
publishdocs.sh switch the build to use python3 2018-06-28 15:31:10 -04:00
sync-projects.sh Sync common files to ops and ha guides 2018-11-23 06:21:34 +01:00
test.sh use whereto to test redirect rules 2017-08-25 18:56:14 -04:00
www-generator.py www-generator.py: cache expensive repo/project metadata to disk 2019-01-04 17:10:22 +00:00