Merge pull request #1 from plotly/publish-py-package

Add PyPi package configuration

Author: coopy

packages/dash-html-components/.gitignore

@@ -1,9 +1,11 @@
 build/
+dist/
 lib/
 node_modules/
 .npm
 vv/
 venv/
 *.pyc
+*.egg-info
 *.log
 .DS_Store

packages/dash-html-components/MANIFEST.in

@@ -0,0 +1 @@
+include lib/metadata.json

packages/dash-html-components/README.md

@@ -55,9 +55,25 @@ Now you should be able to restart the webpack process (in `dash2/renderer`:
 `ctrl-c`, `npm start`), after which webpack will automatically pick up new
 changes to the component suite.
 
+## Installing python package locally
+
+You don't need publishing access to test the module locally.
+
+```sh
+# Install in `site-packages` on your machine
+$ python setup.py install
+```
+
 ## Publishing
 
-Ask @coopy or @chriddyp to be added to the [NPM package authors][].
+For now, two different workflows are necessary for publishing to NPM and PyPi,
+respectively. TODO:
+[#5](https://github.com/plotly/dash-components-archetype/issues/5) will roll up
+publishing steps into one workflow.
+
+Ask @chriddyp to be added to the [NPM package authors][] or to [PyPi][].
+
+### Publishing to NPM
 
 ```sh
 # Bump the package version
@@ -70,6 +86,20 @@ $ git push --follow-tags
 $ npm publish
 ```
 
+### Publishing to PyPi
+
+```sh
+# Bump the package version
+$ vi setup.py
+
+# Commit to github
+$ git add setup.py
+$ git commit -m "Bump pypi package version to vx.x.x"
+
+# Publish to PyPi
+$ npm run publish-pypi
+```
+
 ## Builder / Archetype
 
 We use [Builder][] to centrally manage build configuration, dependencies, and
@@ -81,4 +111,5 @@ scripts. See the [dash-components-archetype][] repo for more information.
 [dash-components-archetype]: https://github.com/plotly/dash-components-archetype
 [MDN HTML attribute reference]: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes
 [NPM package authors]: https://www.npmjs.com/package/dash-html-components/access
+[PyPi]: https://pypi.python.org/pypi
 

packages/dash-html-components/dash_html_components/__init__.py

@@ -0,0 +1,9 @@
+import dash as _dash
+import sys as _sys
+
+_dash.development.component_loader.load_components(
+    '../lib/metadata.json',
+    ['content', 'id', 'key', 'className', 'style', 'dependencies'],
+    globals(),
+    _sys._getframe(1).f_globals.get('__name__', '__main__')
+)

packages/dash-html-components/package.json

@@ -14,6 +14,7 @@
   "homepage": "https://github.com/plotly/dash-html-components",
   "scripts": {
     "prepublish": "npm test",
+    "publish-pypi": "python setup.py sdist upload",
     "start": "builder run transpile-dev-watch",
     "test": "builder run check"
   },

packages/dash-html-components/requirements.txt

@@ -0,0 +1,3 @@
+--index-url https://pypi.python.org/simple/
+
+-e .

packages/dash-html-components/setup.py

@@ -0,0 +1,11 @@
+from setuptools import setup
+
+setup(
+    name='dash_html_components',
+    version='0.1.0',
+    author='plotly',
+    packages=['dash_html_components'],
+    license='MIT',
+    description='Dash UI component suite',
+    install_requires=['flask', 'plotly', 'flask-cors', 'dash.ly']
+)