build: simplifying table building

Author: Sam Kleinman

bin/builder_data.py

@@ -11,7 +11,6 @@
 .. code-block:: makefile
 
    -include $(output)/makefile.pdfs
-   -include $(output)/makefile.tables
    -include $(output)/makefile.links
    -include $(output)/makefile.sphinx
    -include $(output)/makefile.releases
@@ -80,27 +79,6 @@
 # The elements in the ``texinfo`` list are the texinfo filenames generated by Sphinx.
 texinfo = [ 'mongodb-reference', 'mongodb-crud', 'mongodb-manual' ]
 
-tables = [
-# The elements of the tuples in the ``pdfs`` list are:
-#     0. ``name``: the name of the source, without the .yaml extenison.
-#     1. ``makefile_block``: the name block of the makefile, which
-#        captures which group of charts this file contributes to.
-#
-#    (name, makefile_block),
-     ('$(rst-include)/table-sql-to-agg-terms', 'agg'),
-     ('$(rst-include)/table-sql-to-agg-examples', 'agg'),
-     ('$(rst-include)/table-sql-to-mongo-executables', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-terms', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-schema-examples', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-insert-examples', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-select-examples', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-update-examples', 'sql'),
-     ('$(rst-include)/table-sql-to-mongo-delete-examples', 'sql'),
-     ('$(rst-include)/table-lock-behavior-per-operation', 'concurrency'),
-     ('$(rst-include)/table-mongodb-extended-json', 'json'),
-     ('$(rst-include)/table-index-nav', 'struct'),
-]
-
 sphinx = [
 # The items in the ``sphinx`` list are the name of the sphinx builder.
 #

bin/makefile-builder/tables.py

@@ -1,6 +1,6 @@
 sphinx-content += manual-pdfs
 sphinx-content += manual-info
-sphinx-content += $(public-branch-output) 
+sphinx-content += $(public-branch-output)
 sphinx-content += $(public-branch-output)/single
 sphinx-content += $(public-branch-output)/single/index.html
 sphinx-content += $(public-branch-output)/MongoDB-Manual.epub

bin/makefile.content

@@ -3,7 +3,6 @@
 
 -include $(output)/makefile.pdfs
 -include $(output)/makefile.texinfo
--include $(output)/makefile.tables
 -include $(output)/makefile.links
 -include $(output)/makefile.intersphinx
 -include $(output)/makefile.sphinx

bin/makefile.dynamic

@@ -0,0 +1,12 @@
+table-output = $(subst yaml,rst,$(shell find $(rst-include)/ -name "table-*.yaml"))
+
+$(rst-include)/table-%.rst:$(rst-include)/table-%.yaml
+	@$(PYTHONBIN) bin/table_builder.py $< $@
+	@echo [table-builder]: generated $@ table for inclusion
+
+.PHONY:tables clean-tables
+tables:$(table-output)
+	@-git update-index --assume-unchanged
+	@echo [tables]: cleansing git index of compiled tables
+clean-tables:
+	@-rm -rf $(table-output)

bin/makefile.tables

@@ -33,6 +33,7 @@ help:
 include bin/makefile.dynamic
 include bin/makefile.clean
 include bin/makefile.content
+include bin/makefile.tables
 include bin/makefile.push
 
 ############# Meta targets that control the build and publication process. #############