Merge pull request #3 from tacaswell/wip_proposed_toplevel_api

WIP: Proposed top-level API

Author: story645

.coveragerc

@@ -0,0 +1,11 @@
+[run]
+branch = true
+source =
+    mplaltair
+
+[report]
+exclude_lines =
+    raise NotImplemented
+    def __str__
+    def __repr__
+    if __name__ == .__main__.:

.travis.yml

@@ -18,11 +18,11 @@ matrix:
 
 install:
   - python -m pip install --upgrade pip
-  - python -m pip install --upgrade codecov coverage
+  - python -m pip install --upgrade codecov coverage pytest
   - python -m pip install -ve .
 
 script:
-  - coverage run python -m pytest
+  - coverage run run_tests.py
   - coverage report -m
   - set -e
   - codecov

mplaltair/__init__.py

@@ -1,2 +1,35 @@
 import matplotlib
 import altair
+
+
+# TODO rename this?
+def convert(encoding, *, figure=None):
+    """Convert an altair encoding to a Matplotlib figure
+
+
+    Parameters
+    ----------
+    encoding
+        The Altair encoding of the plot.
+
+    figure : matplotib.figure.Figure, optional
+        # TODO: generalize this to 'thing that supports gridspec slicing?
+
+    Returns
+    -------
+    figure : matplotlib.figure.Figure
+        The Figure with all artists in it (ready to be saved or shown)
+
+    mapping : dict
+        Mapping from parts of the encoding to the Matplotlib artists.  This is
+        for later customization.
+
+
+    """
+    if figure is None:
+        from matplotlib import pyplot as plt
+        figure = plt.figure()
+
+    mapping = {}
+
+    return figure, mapping

run_tests.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python
+import sys
+import pytest
+
+if __name__ == '__main__':
+    sys.exit(pytest.main(sys.argv[1:]))

setup.py

@@ -23,7 +23,6 @@
     'Programming Language :: Python :: 3.5',
     'Programming Language :: Python :: 3.6',
     'Topic :: Scientific/Engineering :: Visualization',
-    classifiers=classifiers,
     ]
 
 
@@ -39,6 +38,7 @@
     python_requires='>=3.5',
     license="BSD",
     platforms='any',
+    classifiers=classifiers,
     long_description=descr)
 
 setup(**setup_parameters)