adding doc generation from the tests
MODIFY
docs/source/conf.py
docs/source/conf.py
@@ -183,3 +183,28 @@ epub_copyright = copyright
# A list of files that should not be packed into the epub file.
epub_exclude_files = ['search.html']
+
+# Build the repo2docker test syntax
+from glob import glob
+import os
+s = ''
+for folder, _, files in os.walk(os.path.join('..', '..', 'tests')):
+ if 'README.rst' not in files:
+ continue
+ header = files.pop(files.index('README.rst'))
+ with open(os.path.join(folder, header), 'r') as ff:
+ s += ff.read() + '\n'
+ for ifile in files:
+ filename = os.path.basename(ifile)
+ if filename == 'verify':
+ continue
+ with open(os.path.join(folder, ifile), 'r') as ff:
+ lines = ff.readlines()
+ lines = [' ' + line for line in lines]
+ this_s = '``{}``\n{}\n\n**Contents**::\n\n'.format(
+ filename, '~' * (len(filename) + 4))
+ this_s += '\n'.join(lines)
+ this_s += '\n\n'
+ s += this_s
+with open('./generated/test_file_text.txt', 'w') as ff:
+ ff.write(s)

MODIFY
docs/source/index.rst
docs/source/index.rst
@@ -18,3 +18,8 @@ Indices and tables
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
+
+Build Syntax
+============
+
+.. include:: generated/test_file_text.txt

ADD
tests/conda/requirements/README.rst
+Python - Mixed Requirements
+---------------------------
+
+You can specify both a ``requirements.txt`` and an ``environment.yml`` file,
+and both of these will be used to build your environment.

ADD
tests/conda/simple/README.rst
+Python - Conda Environment
+--------------------------
+
+Conda environments files may allow for more complex builds and dependencies. You
+can specify them in the standard YAML structure.

ADD
tests/julia/pyplot/README.rst
+Julia - REQUIRE
+---------------
+
+The simplest way to specify dependencies in Julia, a REQUIRE file simply
+lists the names of packages. Each one will be installed but not pre-compiled.

adding doc generation from the tests