Generate help text in readthedocs

.readthedocs.yaml

@@ -9,11 +9,19 @@ conda:
 
 # Required for project building and versioning
 python:
-   version: 3.8 # matches in environment.yml
    install:
       - method: pip
         path: .
 
+build:
+  os: ubuntu-22.04
+  tools:
+    # Ref: https://github.com/readthedocs/readthedocs.org/issues/9008
+    python: "miniconda3-4.7"
+  jobs:
+    post_install:
+      - make -C doc cmdline-help
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: doc/conf.py

doc/Makefile

@@ -41,7 +41,8 @@ clean:
 
 $(CMDLINEHELPDIR)/%.help.txt:
 	@mkdir -p $(@D)
-	python gethelp.py $* > $@
+	python3 --version
+	python3 gethelp.py $* > $@
 
 cmdline-help: $(addprefix $(CMDLINEHELPDIR)/segtools-,compare.help.txt preprocess.help.txt aggregation.help.txt feature-distance.help.txt flatten.help.txt gmtk-parameters.help.txt html-report.help.txt transition.help.txt length-distribution.help.txt nucleotide-frequency.help.txt overlap.help.txt signal-distribution.help.txt relabel.help.txt)
 

doc/gethelp.py

@@ -13,7 +13,7 @@
 sys.path.insert(0, "..")
 
 def gethelp(scriptname):
-    (entry_point,_) = entry_points(group="console_scripts", name=scriptname)
+    (entry_point,_) = entry_points().select(group="console_scripts", name=scriptname)
     entry = entry_point.value
     module_name, _, func_name = entry.partition(":")
 

environment.yml

@@ -6,6 +6,7 @@ channels:
 dependencies:
   - genomedata
   - python=3.8
+  - importlib_metadata
   - r-base
   - rpy2 >=2.6.0
   - r-latticeextra