Integrate auto-generating filter list & curves, statically in docs

.gitignore

@@ -21,6 +21,7 @@ MANIFEST
 # Sphinx
 docs/api
 docs/_build
+docs/_facility_pages
 
 # Eclipse editor project files
 .project

.travis.yml

@@ -16,10 +16,6 @@ matrix:
         - python: 2.7
           env: SETUP_CMD='test --coverage'
 
-        # Generate docs in Python 2
-        - python: 2.7
-          env: SETUP_CMD='build_docs'
-
         # Do a coverage test in Python 3.
         - python: 3.6
           env: SETUP_CMD='test --coverage'

docs/_templates/facility_page.rst

@@ -0,0 +1,44 @@
+Filters of Observation Facility: {{ facility }}
+====================================================
+
+{% set facility_data=data[data['Obs. Facility']==facility] %}
+{% set inst_list=facility_data['Instrument'].unique().tolist() %}
+{% for inst in inst_list %}
+
+{% if inst!='NA' %}
+{% if loop.first %}
+Following **Instruments** are present:
+
+{% endif %}
+
+{{ inst }}
+--------------------------
+
+{% endif %}
+
+{% set inst_data=facility_data[facility_data['Instrument']==inst] %}
+
+.. list-table::
+   :header-rows: 1
+
+   * - {{ inst_data.index.name }}
+{% for col_name in inst_data.columns.values %}
+     - {{ col_name }}
+{% endfor %}
+
+{% for filter_info in inst_data.itertuples() %}
+{% for info in filter_info %}
+{% if loop.first %}
+   * - {{ info }}
+{% elif loop.last %}
+     - {{ info|replace('_ ','\_ ') }}
+{% else %}
+     - {{ info }}
+{% endif %}
+{% endfor %}
+{% endfor %}
+
+
+<Plots>
+
+{% endfor %}

docs/conf.py

@@ -178,3 +178,55 @@
 
     edit_on_github_source_root = ""
     edit_on_github_doc_root = "docs"
+
+
+# Render rst pages as a jinja template to be able 
+# to generate rst docs from data (i.e. passed to template context) ---------
+def rst_jinja(app, docname, source):
+    if app.builder.format != 'html':  # Make sure builder output is HTML
+        return
+    src = source[0]
+    context = app.config.html_context  # context dictionary, passed for rendering
+    context.update(facility_context(docname))
+    rendered = app.builder.templates.render_string(src, context)
+    source[0] = rendered
+
+def facility_context(docname):
+    dirs_in_path = docname.split(os.sep)
+    if '_facility_pages' in dirs_in_path[:-1]: 
+    # doc file (.rst) lies in directory "_facility_pages"
+        facility_name = dirs_in_path[-1]
+        context = {'facility': facility_name}
+    else:
+        context = {}
+    return context
+
+def setup(app):
+    app.connect("source-read", rst_jinja)
+
+
+import wsynphot
+import pandas as pd
+import shutil
+
+# Storing data into variables ------------------
+try:
+    df = wsynphot.list_filters()
+except IOError:  # If filter_data.h5 not present
+    wsynphot.download_filter_data()
+    df = wsynphot.list_filters()
+# Obtain list of Obsv. facilities from df
+facility_list = df['Obs. Facility'].unique().tolist()
+
+# Pass data variables to html_context for rendering templates ------
+html_context = {
+    'data': df,
+    'facility_list': facility_list
+}
+
+# Automatically create(or overwrite) doc for filters of each obsv. facility
+# by using facilty_page.rst as template file to populate all facilty pages
+os.makedirs('_facility_pages', exist_ok=True)
+for facility in facility_list:
+    shutil.copyfile('_templates/facility_page.rst',
+                    os.path.join('_facility_pages', '{0}.rst'.format(facility)))