CLN: Followup to formatting

- CSS update
- whatsnew example
- print_versions
- requirements_all

Author: TomAugspurger

ci/requirements_all.txt

@@ -20,3 +20,4 @@ lxml
 sqlalchemy
 bottleneck
 pymysql
+Jinja2

doc/make.py

@@ -104,11 +104,14 @@ def clean():
 
 def html():
     check_build()
+    os.system('jupyter nbconvert --to=html --template=basic '
+              '--output=source/html-styling.html source/html-styling.ipynb')
     if os.system('sphinx-build -P -b html -d build/doctrees '
                  'source build/html'):
         raise SystemExit("Building HTML failed.")
     try:
         # remove stale file
+        os.system('rm source/html-styling.html')
         os.system('cd build; rm -f html/pandas.zip;')
     except:
         pass

doc/source/html-styling.html

@@ -299,6 +299,19 @@ td.field-body blockquote {
     padding-left: 30px;
 }
 
+.rendered_html table {
+    margin-left: auto;
+    margin-right: auto;
+    border-right: 1px solid #cbcbcb;
+    border-bottom: 1px solid #cbcbcb;
+}
+
+.rendered_html td, th {
+    border-left: 1px solid #cbcbcb;
+    border-top: 1px solid #cbcbcb;
+    margin: 0;
+    padding: 0.5em .75em;
+}
 
 /**
  * See also

doc/source/html-styling.ipynb

@@ -25,11 +25,25 @@ New features
 Conditional HTML Formatting
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-We've added *experimental* support for conditional HTML formatting,
+We've added *experimental* support for conditional HTML formatting:
 the visual styling of a DataFrame based on the data.
 The styling is accomplished with HTML and CSS.
 Acesses the styler class with :attr:`pandas.DataFrame.style`, attribute,
 an instance of :class:`~pandas.core.style.Styler` with your data attached.
+
+Here's a quick example:
+
+  .. ipython:: python
+
+    np.random.seed(123)
+    df = DataFrame(np.random.randn(10, 5), columns=list('abcde'))
+    html = df.style.background_gradient(cmap='viridis', low=.5)
+
+We can render the HTML to get the following table.
+
+.. raw:: html
+   :file: whatsnew_0171_html_table.html
+
 See the :ref:`example notebook <style>` for more.
 
 .. _whatsnew_0171.enhancements:

doc/source/themes/nature_with_gtoc/static/nature.css_t

@@ -93,7 +93,7 @@ class Styler(object):
         {% endfor %}
         </style>
 
-        <table id="T_{{uuid}}">
+        <table id="T_{{uuid}}" {{ table_attributes }}>
         {% if caption %}
             <caption>{{caption}}</caption>
         {% endif %}
@@ -125,7 +125,7 @@ class Styler(object):
         """)
 
     def __init__(self, data, precision=None, table_styles=None, uuid=None,
-                 caption=None):
+                 caption=None, table_attributes=None):
         self.ctx = defaultdict(list)
         self._todo = []
 
@@ -146,6 +146,7 @@ def __init__(self, data, precision=None, table_styles=None, uuid=None,
         if precision is None:
             precision = pd.options.display.precision
         self.precision = precision
+        self.table_attributes = table_attributes
 
     def _repr_html_(self):
         '''
@@ -230,7 +231,7 @@ def _translate(self):
 
         return dict(head=head, cellstyle=cellstyle, body=body, uuid=uuid,
                     precision=precision, table_styles=table_styles,
-                    caption=caption)
+                    caption=caption, table_attributes=self.table_attributes)
 
     def render(self):
         """
@@ -415,6 +416,25 @@ def set_precision(self, precision):
         self.precision = precision
         return self
 
+    def set_table_attributes(self, attributes):
+        """
+        Set the table attributes. These are the items
+        that show up in the opening <table> tag in addition
+        to to automatic (by default) id.
+
+        .. versionadded:: 0.17.1
+
+        Parameters
+        ----------
+        precision: int
+
+        Returns
+        -------
+        self
+        """
+        self.table_attributes = attributes
+        return self
+
     def export(self):
         """
         Export the styles to applied to the current Styler.

doc/source/whatsnew/v0.17.1.txt

@@ -277,6 +277,15 @@ def test_table_styles(self):
         self.assertTrue(styler is result)
         self.assertEqual(styler.table_styles, style)
 
+    def test_table_attributes(self):
+        attributes = 'class="foo" data-bar'
+        styler = Styler(self.df, table_attributes=attributes)
+        result = styler.render()
+        self.assertTrue('class="foo" data-bar' in result)
+
+        result = self.df.style.set_table_attributes(attributes).render()
+        self.assertTrue('class="foo" data-bar' in result)
+
     def test_precision(self):
         with pd.option_context('display.precision', 10):
             s = Styler(self.df)

doc/source/whatsnew/whatsnew_0171_html_table.html

@@ -89,6 +89,7 @@ def show_versions(as_json=False):
         ("sqlalchemy", lambda mod: mod.__version__),
         ("pymysql", lambda mod: mod.__version__),
         ("psycopg2", lambda mod: mod.__version__),
+        ("Jinja2", lambda mod: mod.__version__)
     ]
 
     deps_blob = list()