new: dev: add vendoring bits for stand-alone sum repo

Signed-off-by: Steve Arnold <[email protected]>

.gitignore

@@ -69,7 +69,10 @@ instance/
 .scrapy
 
 # Sphinx documentation
-docs/_build/
+docs/build/
+
+# not-Sphinx documentation (externel)
+docs/sum/
 
 # PyBuilder
 .pybuilder/

.repolite.yml

@@ -0,0 +1,23 @@
+prog_name: repolite
+top_dir: docs  # local directory path for enabled repositories
+pull_with_rebase: false  # use --ff-only if false
+# add new repo_name sections as needed
+repos:
+  - repo_name: timew-addons-sum
+    repo_alias: sum
+    repo_url: [email protected]:sarnold/timew-addons-sum.git
+    repo_depth: 0
+    repo_remote: origin
+    repo_opts: []
+    repo_branch: draft-v0
+    repo_hash: null
+    repo_create_tag_msg: tag for RC release
+    repo_create_tag_annotated: true
+    repo_create_tag_signed: false
+    repo_push_new_tags: false
+    repo_signing_key: null
+    repo_use_rebase: false
+    repo_has_lfs_files: false
+    repo_init_submodules: false
+    repo_install: false
+    repo_enable: true

docs/source/conf.py

@@ -61,7 +61,7 @@
 source_suffix = {'.rst': 'restructuredtext'}
 master_doc = "index"
 
-description = 'Timewarrior addon bits including report extensions and a status GUI.'
+description = 'Timewarrior addons including an appindicator GUI and report extensions.'
 
 # -- Options for PDF output --------------------------------------------------
 
@@ -81,7 +81,7 @@
 
 pdf_documents = [
     #('filename', u'output filename', 'Title', 'author(s)'),
-    ('index', u'timew_status', u'Timew Addons', u"Stephen L Arnold"),
+    ('index_pdf', u'timew_status', u'Timew Status Indicator and Report Extensions', u"Stephen L Arnold"),
 ]
 
 # A comma-separated list of custom stylesheets. Example:

requirements-sync.txt

@@ -0,0 +1,3 @@
+# tool requirements, useful for tox/pip/git
+#gitchangelog @ https://github.com/sarnold/gitchangelog/releases/download/3.2.0/gitchangelog-3.2.0-py3-none-any.whl
+repolite @ https://github.com/sarnold/repolite/releases/download/0.6.2/repolite-0.6.2-py3-none-any.whl

tox.ini

@@ -88,6 +88,42 @@ depends =
 [coverage:run]
 parallel=True
 
+[testenv:{sync,do}]
+envdir = {toxinidir}/.sync
+# these tox env cmds share a virtual env using the following plugin
+# https://github.com/masenf/tox-ignore-env-name-mismatch
+runner = ignore_env_name_mismatch
+
+description =
+    do: Run cmd following "--" from .sync environment, e.g. "tox -e do -- repolite --show"
+    sync: Install repolite and use it for cloning worflow deps
+
+passenv =
+    REPO_CFG
+    DISPLAY
+    XAUTHORITY
+    HOME
+    USERNAME
+    USER
+    CI
+    LANG
+    LC_COLLATE
+    SSH_*
+    GID
+    UID
+    XDG_*
+    PYTHONIOENCODING
+    PIP_DOWNLOAD_CACHE
+
+deps =
+    # logging_tree
+    {[base]deps}
+    -r requirements-sync.txt
+
+commands =
+    sync: repolite {posargs:--quiet}
+    do: {posargs:python -c 'print("No cmd provided")'}
+
 [testenv:dev]
 skip_install = true
 
@@ -104,6 +140,7 @@ passenv =
 
 allowlist_externals =
     bash
+    make
 
 deps =
     {[base]deps}
@@ -134,7 +171,7 @@ commands =
     ldocs: make -C docs linkcheck
     cdocs: make -C docs clean
 
-[testenv:changes]
+[testenv:changes,sum]
 skip_install = true
 
 allowlist_externals =
@@ -146,10 +183,13 @@ passenv =
 
 deps =
     pip>=21.1
-    https://github.com/sarnold/gitchangelog/releases/download/3.2.0/gitchangelog-3.2.0-py3-none-any.whl
+    changes: https://github.com/sarnold/gitchangelog/releases/download/3.2.0/gitchangelog-3.2.0-py3-none-any.whl
+    sum: rst2pdf[svgsupport]
+    sum: docutils==0.20.1
 
 commands =
-    bash -c 'gitchangelog {posargs} > CHANGELOG.rst'
+    changes: bash -c 'gitchangelog {posargs} > CHANGELOG.rst'
+    sum: make -C docs/sum/sum
 
 [testenv:build]
 skip_install = true
@@ -232,4 +272,4 @@ deps =
     pip>=21.1
 
 commands =
-    bash -c 'rm -rf __pycache__ build dist src/*.egg-info src/*/__pycache__'
+    bash -c 'rm -rf __pycache__ build dist docs/sum/sum/*.pdf src/*.egg-info src/*/__pycache__'