[Python-modules-commits] [ipywidgets] 01/09: Imported Upstream version 5.2.2
Gordon Ball
chronitis-guest at moszumanska.debian.org
Sun Nov 6 13:17:25 UTC 2016
This is an automated email from the git hooks/post-receive script.
chronitis-guest pushed a commit to branch master
in repository ipywidgets.
commit 67681957821f1c4dc3363cd100a6174c923abaf0
Author: Gordon Ball <gordon at chronitis.net>
Date: Sun Nov 6 12:41:43 2016 +0100
Imported Upstream version 5.2.2
---
CONTRIBUTING.md | 3 +
COPYING.md | 60 +
PKG-INFO | 42 +
README.md | 78 +
docs/Makefile | 36 +
docs/build-local.sh | 4 +
docs/build-rtd.sh | 7 +
docs/environment.yml | 14 +
docs/make.bat | 65 +
docs/package.json | 46 +
docs/requirements.txt | 3 +
docs/source/.babelrc | 1 +
docs/source/_static/custom.css | 39 +
docs/source/_static/index.js | 10 +
docs/source/_templates/layout.html | 9 +
docs/source/_templates/navbar.html | 45 +
docs/source/_templates/relations.html | 19 +
docs/source/_templates/sidebartoc.html | 1 +
docs/source/changelog.md | 30 +
docs/source/conf.py | 67 +
docs/source/contributing.md | 6 +
docs/source/dev_install.md | 52 +
docs/source/dev_release.md | 51 +
docs/source/dev_testing.md | 12 +
docs/source/examples.md | 4 +
.../.ipynb_checkpoints/Untitled-checkpoint.ipynb | 65 +
.../Widget List-checkpoint.ipynb | 1454 +++++++++++++
docs/source/examples/Beat Frequencies.ipynb | 303 +++
docs/source/examples/Controller.ipynb | 178 ++
.../examples/Custom Widget - Hello World.ipynb | 1267 +++++++++++
docs/source/examples/Date Picker Widget.ipynb | 1379 ++++++++++++
docs/source/examples/Exploring Graphs.ipynb | 216 ++
docs/source/examples/Export As (nbconvert).ipynb | 334 +++
docs/source/examples/Factoring.ipynb | 190 ++
docs/source/examples/File Upload Widget.ipynb | 306 +++
docs/source/examples/Flexbox Layout.ipynb | 529 +++++
docs/source/examples/Image Browser.ipynb | 194 ++
docs/source/examples/Image Processing.ipynb | 1605 ++++++++++++++
docs/source/examples/Index.ipynb | 101 +
.../examples/Lorenz Differential Equations.ipynb | 738 +++++++
docs/source/examples/Nonblocking Console.ipynb | 334 +++
docs/source/examples/Using Interact.ipynb | 2291 ++++++++++++++++++++
docs/source/examples/Variable Inspector.ipynb | 282 +++
docs/source/examples/Widget Basics.ipynb | 719 ++++++
docs/source/examples/Widget Events.ipynb | 1008 +++++++++
docs/source/examples/Widget Layout.ipynb | 975 +++++++++
docs/source/examples/Widget List.ipynb | 1752 +++++++++++++++
docs/source/examples/Widget Low Level.ipynb | 709 ++++++
docs/source/examples/Widget Styling.ipynb | 1569 ++++++++++++++
.../examples/images/MultilanguageKernels.graffle | 442 ++++
.../examples/images/MultilanguageKernels.png | Bin 0 -> 22608 bytes
.../source/examples/images/ParallelKernels.graffle | 876 ++++++++
docs/source/examples/images/ParallelKernels.png | Bin 0 -> 38764 bytes
.../examples/images/VizInteractCompute.graffle | 426 ++++
docs/source/examples/images/VizInteractCompute.png | Bin 0 -> 30013 bytes
docs/source/examples/images/WidgetArch.graffle | 322 +++
docs/source/examples/images/WidgetArch.png | Bin 0 -> 23058 bytes
.../source/examples/images/WidgetModelView.graffle | 523 +++++
docs/source/examples/images/WidgetModelView.png | Bin 0 -> 38681 bytes
docs/source/examples/images/assoc.svg | 15 +
docs/source/examples/images/busy.svg | 15 +
docs/source/examples/images/display.svg | 15 +
docs/source/examples/images/execute.svg | 15 +
docs/source/examples/images/inputoutput.PNG | Bin 0 -> 1885 bytes
docs/source/examples/images/state.svg | 15 +
docs/source/examples/images/state_sync.svg | 15 +
docs/source/examples/images/transport.svg | 16 +
docs/source/examples/images/widgetcomm.svg | 15 +
docs/source/examples/images/widgetcomm2.svg | 15 +
docs/source/examples/images/widgets.PNG | Bin 0 -> 5057 bytes
docs/source/index.rst | 30 +
docs/source/user_install.md | 23 +
docs/webpack.config.js | 24 +
ipywidgets/__init__.py | 68 +
ipywidgets/_version.py | 3 +
ipywidgets/widgets/__init__.py | 20 +
ipywidgets/widgets/domwidget.py | 120 +
ipywidgets/widgets/eventful.py | 299 +++
ipywidgets/widgets/interaction.py | 393 ++++
ipywidgets/widgets/tests/__init__.py | 0
ipywidgets/widgets/tests/test_interaction.py | 654 ++++++
ipywidgets/widgets/tests/test_link.py | 39 +
ipywidgets/widgets/tests/test_traits.py | 83 +
ipywidgets/widgets/trait_types.py | 71 +
ipywidgets/widgets/widget.py | 497 +++++
ipywidgets/widgets/widget_bool.py | 83 +
ipywidgets/widgets/widget_box.py | 116 +
ipywidgets/widgets/widget_button.py | 72 +
ipywidgets/widgets/widget_color.py | 24 +
ipywidgets/widgets/widget_controller.py | 56 +
ipywidgets/widgets/widget_float.py | 276 +++
ipywidgets/widgets/widget_image.py | 40 +
ipywidgets/widgets/widget_int.py | 268 +++
ipywidgets/widgets/widget_layout.py | 54 +
ipywidgets/widgets/widget_link.py | 103 +
ipywidgets/widgets/widget_output.py | 82 +
ipywidgets/widgets/widget_selection.py | 215 ++
ipywidgets/widgets/widget_selectioncontainer.py | 61 +
ipywidgets/widgets/widget_string.py | 103 +
setup.cfg | 2 +
setup.py | 125 ++
101 files changed, 25931 insertions(+)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..6aa0d6f
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,3 @@
+# Contributing
+
+See [this page](docs/source/contributing.md).
diff --git a/COPYING.md b/COPYING.md
new file mode 100644
index 0000000..1ef6243
--- /dev/null
+++ b/COPYING.md
@@ -0,0 +1,60 @@
+# Licensing terms
+
+This project is licensed under the terms of the Modified BSD License
+(also known as New or Revised or 3-Clause BSD), as follows:
+
+- Copyright (c) 2016, Jupyter Development Team
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this
+list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+Neither the name of the Jupyter Development Team nor the names of its
+contributors may be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## About the Jupyter Development Team
+
+The Jupyter Development Team is the set of all contributors to the Jupyter project.
+This includes all of the Jupyter subprojects.
+
+The core team that coordinates development on GitHub can be found here:
+- https://github.com/jupyter/
+- https://github.com/ipython/
+
+## Our Copyright Policy
+
+Jupyter uses a shared copyright model. Each contributor maintains copyright
+over their contributions to Jupyter. But, it is important to note that these
+contributions are typically only changes to the repositories. Thus, the Jupyter
+source code, in its entirety is not the copyright of any single person or
+institution. Instead, it is the collective copyright of the entire Jupyter
+Development Team. If individual contributors want to maintain a record of what
+changes/contributions they have specific copyright on, they should indicate
+their copyright in the commit message of the change, when they commit the
+change to one of the Jupyter repositories.
+
+With this in mind, the following banner should be used in any source code file
+to indicate the copyright and license terms:
+
+ # Copyright (c) Jupyter Development Team.
+ # Distributed under the terms of the Modified BSD License.
diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..1f9fcb9
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,42 @@
+Metadata-Version: 1.1
+Name: ipywidgets
+Version: 5.2.2
+Summary: IPython HTML widgets for Jupyter
+Home-page: http://ipython.org
+Author: IPython Development Team
+Author-email: ipython-dev at scipy.org
+License: BSD
+Description:
+ .. image:: https://img.shields.io/pypi/v/ipywidgets.svg
+ :target: https://pypi.python.org/pypi/ipywidgets/
+ :alt: Version Number
+
+ .. image:: https://img.shields.io/pypi/dm/ipywidgets.svg
+ :target: https://pypi.python.org/pypi/ipywidgets/
+ :alt: Number of PyPI downloads
+
+ Interactive HTML Widgets
+ ========================
+
+ Interactive HTML widgets for Jupyter notebooks and the IPython kernel.
+
+ Usage
+ =====
+
+ .. code-block:: python
+
+ from ipywidgets import IntSlider
+ IntSlider()
+
+Keywords: Interactive,Interpreter,Shell,Web
+Platform: Linux
+Platform: Mac OS X
+Platform: Windows
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9c45539
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# ipywidgets: Interactive HTML Widgets
+
+[](https://pypi.python.org/pypi/ipywidgets)
+[](https://pypi.python.org/pypi/ipywidgets)
+[](https://travis-ci.org/ipython/ipywidgets)
+[](http://ipywidgets.readthedocs.org/en/latest/?badge=latest)
+[](https://gitter.im/ipython/ipywidgets?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+ipywidgets are [interactive HTML widgets](https://github.com/ipython/ipywidgets/blob/master/docs/source/examples/Index.ipynb)
+for Jupyter notebooks and the IPython kernel.
+
+Notebooks come alive when interactive widgets are used. Users gain control of their data and can visualize changes in the data.
+
+Learning becomes an immersive, plus fun, experience. Researchers can easily see how changing inputs to a model impact the results. We hope you will add ipywidgets to your notebooks, and we're here to help you get started.
+
+## Features
+A [demonstration notebook](https://github.com/ipython/ipywidgets/blob/master/docs/source/examples/Index.ipynb) provides an overview of the core interactive widgets, including:
+
+- sliders
+- progress bars
+- text boxes
+- toggle buttons and checkboxes
+- display areas
+- and more
+
+Besides the widgets already provided with the library, the framework can be
+extended with custom widget libraries. Examples of custom widget libraries
+built upon ipywidgets are
+
+- [bqplot](https://github.com/bloomberg/bqplot) a 2d data visualization library
+ enabling custom user interactions.
+- [pythreejs](https://github.com/jovyan/pythreejs) a Jupyter - Three.js wrapper,
+ bringing Three.js to the notebook.
+
+The resulting widgets can then be embeded into web pages other than the
+Jupyter notebook.
+
+For detailed information, please refer to the [ipywidgets documentation](http://ipywidgets.readthedocs.org/en/latest/).
+
+## Install
+
+Install the current version of ipywidgets using pip or conda:
+
+ pip install ipywidgets
+
+or
+
+ conda install ipywidgets
+
+Then run
+
+ jupyter nbextension enable --py widgetsnbextension
+
+See the [Installation](docs/source/user_install.md) section of the documentation for additional details.
+
+#### Compatibility
+
+| ipywidgets version | Jupyter/notebook version |
+| ------------------- | ------------------------ |
+| master | master |
+| 4.1.x | 4.1 |
+| 4.0.x | 4.0 |
+
+[Change log](docs/source/changelog.md)
+
+## Usage
+See the [examples](docs/source/examples.md) section of the documentation. The widgets are being used in a variety of ways; some uses can be seen in these notebooks:
+
+- [Demo notebook of interactive widgets](https://github.com/ipython/ipywidgets/blob/master/docs/source/examples/Index.ipynb)
+
+## Contributing to ipywidgets
+- [Developer install](docs/source/dev_install.md)
+
+### Project Jupyter resources
+- [Project Jupyter website](https://jupyter.org)
+- [Online Demo of Jupyter Notebook at try.jupyter.org](https://try.jupyter.org)
+- [Documentation for Project Jupyter](http://jupyter.readthedocs.org/en/latest/index.html) [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]
+- [](https://groups.google.com/forum/#!forum/jupyter)
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..6ba8b3a
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,36 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS =
+SPHINXBUILD = sphinx-build
+PAPER =
+BUILDDIR = build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4 = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+
+.PHONY: help clean html
+
+help:
+ @echo "Please use \`make <target>' where <target> is one of"
+ @echo " html to make standalone HTML files"
+ @echo " clean remove built files"
+
+
+clean:
+ rm -rf $(BUILDDIR)/*
+
+html:
+ $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+ @echo
+ @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
diff --git a/docs/build-local.sh b/docs/build-local.sh
new file mode 100644
index 0000000..3a001cf
--- /dev/null
+++ b/docs/build-local.sh
@@ -0,0 +1,4 @@
+cd ../../jupyter-js-widgets
+npm install
+cd ../docs
+npm install
diff --git a/docs/build-rtd.sh b/docs/build-rtd.sh
new file mode 100644
index 0000000..20f9104
--- /dev/null
+++ b/docs/build-rtd.sh
@@ -0,0 +1,7 @@
+curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.31.0/install.sh | bash
+source /home/docs/.profile
+nvm install 5
+nvm use 5
+nvm alias default 5
+npm install -g npm
+bash build-local.sh
diff --git a/docs/environment.yml b/docs/environment.yml
new file mode 100644
index 0000000..384a97c
--- /dev/null
+++ b/docs/environment.yml
@@ -0,0 +1,14 @@
+name: ipywidget_docs
+dependencies:
+- python=3.5
+- sphinx_rtd_theme
+- jinja2
+- tornado
+- nbformat
+- jupyter_client
+- ipykernel
+- ipywidgets
+- pip:
+ - sphinx==1.3.6
+ - nbsphinx
+ - jupyter_sphinx_theme==0.0.6
\ No newline at end of file
diff --git a/docs/make.bat b/docs/make.bat
new file mode 100644
index 0000000..b9658cf
--- /dev/null
+++ b/docs/make.bat
@@ -0,0 +1,65 @@
+ at ECHO OFF
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+ set SPHINXBUILD=sphinx-build
+)
+set BUILDDIR=build
+set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% source
+set I18NSPHINXOPTS=%SPHINXOPTS% source
+if NOT "%PAPER%" == "" (
+ set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
+ set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
+)
+
+if "%1" == "" goto help
+
+if "%1" == "help" (
+ :help
+ echo.Please use `make ^<target^>` where ^<target^> is one of
+ echo. html to make standalone HTML files
+ echo. clean remove built files"
+ goto end
+)
+
+if "%1" == "clean" (
+ for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
+ del /q /s %BUILDDIR%\*
+ goto end
+)
+
+
+REM Check if sphinx-build is available and fallback to Python version if any
+%SPHINXBUILD% 1>NUL 2>NUL
+if errorlevel 9009 goto sphinx_python
+goto sphinx_ok
+
+:sphinx_python
+
+set SPHINXBUILD=python -m sphinx.__init__
+%SPHINXBUILD% 2> nul
+if errorlevel 9009 (
+ echo.
+ echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+ echo.installed, then set the SPHINXBUILD environment variable to point
+ echo.to the full path of the 'sphinx-build' executable. Alternatively you
+ echo.may add the Sphinx directory to PATH.
+ echo.
+ echo.If you don't have Sphinx installed, grab it from
+ echo.http://sphinx-doc.org/
+ exit /b 1
+)
+
+:sphinx_ok
+
+
+if "%1" == "html" (
+ %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
+ if errorlevel 1 exit /b 1
+ echo.
+ echo.Build finished. The HTML pages are in %BUILDDIR%/html.
+ goto end
+)
+
+:end
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 0000000..d83d6b1
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,46 @@
+{
+ "name": "docjs",
+ "version": "1.0.0",
+ "description": "",
+ "main": "index.js",
+ "private": true,
+ "directories": {
+ "doc": "docs",
+ "example": "examples"
+ },
+ "scripts": {
+ "test": "echo \"Error: no test specified\" && exit 1",
+ "prepublish": "npm run build",
+ "clean": "rimraf source/_static/built",
+ "prebuild": "npm run clean",
+ "build": "webpack"
+ },
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/jdfreder/ipywidgets.git"
+ },
+ "author": "",
+ "license": "BSD-3-Clause",
+ "bugs": {
+ "url": "https://github.com/jdfreder/ipywidgets/issues"
+ },
+ "homepage": "https://github.com/jdfreder/ipywidgets#readme",
+ "devDependencies": {
+ "babel-core": "^6.6.4",
+ "babel-loader": "^6.2.4",
+ "babel-preset-es2015": "^6.3.13",
+ "bower": "^1.7.0",
+ "css-loader": "^0.23.1",
+ "file-loader": "^0.8.5",
+ "json-loader": "^0.5.4",
+ "jupyter-js-widgets": "file:../jupyter-js-widgets",
+ "rimraf": "^2.5.2",
+ "style-loader": "^0.13.0",
+ "url-loader": "^0.5.7",
+ "webpack": "^1.12.14"
+ },
+ "dependencies": {
+ "jquery": "^2.2.1",
+ "jquery-ui": "^1.10.5"
+ }
+}
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000..0634a69
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,3 @@
+jupyter_client
+sphinx==1.3.6
+jupyter_sphinx_theme==0.0.6
diff --git a/docs/source/.babelrc b/docs/source/.babelrc
new file mode 100644
index 0000000..9d8d516
--- /dev/null
+++ b/docs/source/.babelrc
@@ -0,0 +1 @@
+{ "presets": ["es2015"] }
diff --git a/docs/source/_static/custom.css b/docs/source/_static/custom.css
new file mode 100644
index 0000000..97e5c6e
--- /dev/null
+++ b/docs/source/_static/custom.css
@@ -0,0 +1,39 @@
+p.caption {
+ padding-left: 0.75em;
+ margin-bottom: 0em;
+}
+p.caption:not(:first-child) {
+ padding-top: 0.75em;
+}
+.toctree-l1 a.reference:before {
+ padding-right: 0.5em !important;
+ content: '';
+}
+.glyphicon-spin {
+ -webkit-animation: spin 1000ms infinite linear;
+ animation: spin 1000ms infinite linear;
+}
+ at -webkit-keyframes spin {
+ 0% {
+ -webkit-transform: rotate(0deg);
+ transform: rotate(0deg);
+ }
+ 100% {
+ -webkit-transform: rotate(359deg);
+ transform: rotate(359deg);
+ }
+}
+ at keyframes spin {
+ 0% {
+ -webkit-transform: rotate(0deg);
+ transform: rotate(0deg);
+ }
+ 100% {
+ -webkit-transform: rotate(359deg);
+ transform: rotate(359deg);
+ }
+}
+.widget-loading {
+ text-align: center;
+ padding: 10px;
+}
diff --git a/docs/source/_static/index.js b/docs/source/_static/index.js
new file mode 100644
index 0000000..e6ffe76
--- /dev/null
+++ b/docs/source/_static/index.js
@@ -0,0 +1,10 @@
+require("jupyter-js-widgets/src/embed-webpack");
+
+window.onload = function() {
+ // TODO: See if md parsing conf can do this, or extension (compile time)
+ Array.prototype.forEach.call(document.querySelectorAll('a'), a => {
+ a.href = a.href
+ .replace(/\.md$/, '.html')
+ .replace(/\.ipynb$/, '.html');
+ });
+};
diff --git a/docs/source/_templates/layout.html b/docs/source/_templates/layout.html
new file mode 100644
index 0000000..a04ecf2
--- /dev/null
+++ b/docs/source/_templates/layout.html
@@ -0,0 +1,9 @@
+{# Import the theme's layout. #}
+{% extends "!layout.html" %}
+
+{% set bootswatch_css_custom = ['_static/custom.css'] %}
+
+{% block extrahead %}
+{{ super() }}
+<script src='_static/built/index.js'></script>
+{% endblock extrahead %}
diff --git a/docs/source/_templates/navbar.html b/docs/source/_templates/navbar.html
new file mode 100644
index 0000000..96bab6e
--- /dev/null
+++ b/docs/source/_templates/navbar.html
@@ -0,0 +1,45 @@
+<div id="navbar" class="{{ theme_navbar_class }} navbar-default {% if theme_navbar_fixed_top|tobool -%} navbar-fixed-top{%- endif -%}">
+ <div class="container">
+ <div class="navbar-header">
+ <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="{{ pathto(master_doc) }}">
+ {%- block sidebarlogo %}
+ {%- if logo %}<img src="{{ pathto('_static/' + logo, 1) }}">{%- endif %}
+ {%- endblock %}
+ {% if theme_navbar_title -%}{{ theme_navbar_title|e }}{%- else -%}{{ project|e }}{%- endif -%}
+ </a>
+ <span class="navbar-text navbar-version pull-left"><b>{{ version|e }}</b></span>
+ </div>
+
+ <div class="collapse navbar-collapse nav-collapse">
+ <ul class="nav navbar-nav">
+ {% if theme_navbar_links %}
+ {%- for link in theme_navbar_links %}
+ <li><a href="{{ pathto(*link[1:]) }}">{{ link[0] }}</a></li>
+ {%- endfor %}
+ {% endif %}
+ {% block navbarextra %}
+ {% endblock %}
+ {% if theme_source_link_position == "nav" %}
+ <li class="hidden-sm">{% include "sourcelink.html" %}</li>
+ {% endif %}
+ </ul>
+
+ {% block navbarsearch %}
+ {% include "navbarsearchbox.html" %}
+ {% endblock %}
+ {% if theme_navbar_sidebarrel %}
+ {% block sidebarrel %}
+ <ul class='nav navbar-nav navbar-right'>
+ {% include "relations.html" %}
+ </ul>
+ {% endblock %}
+ {% endif %}
+ </div>
+ </div>
+</div>
diff --git a/docs/source/_templates/relations.html b/docs/source/_templates/relations.html
new file mode 100644
index 0000000..0db3df0
--- /dev/null
+++ b/docs/source/_templates/relations.html
@@ -0,0 +1,19 @@
+{# Switch to icon instead of text in `sm` view size for BS3 only. #}
+{%- if prev %}
+ <li>
+ <a href="{{ prev.link|e }}" title="{{ _('Previous Chapter: ') + prev.title|striptags }}">
+ {%- if theme_bootstrap_version == "2" -%}<span class="icon-chevron-left visible-tablet"></span>{%- endif -%}
+ {%- if theme_bootstrap_version == "3" -%}<span class="glyphicon glyphicon-chevron-left visible-sm"></span>{%- endif -%}
+ <span class="hidden-sm hidden-tablet">{{ "«"|safe }} {{ prev.title|striptags|truncate(length=26, killwords=True) }}</span>
+ </a>
+ </li>
+{%- endif %}
+{%- if next %}
+ <li>
+ <a href="{{ next.link|e }}" title="{{ _('Next Chapter: ') + next.title|striptags }}">
+ {%- if theme_bootstrap_version == "2" -%}<span class="icon-chevron-right visible-tablet"></span>{%- endif -%}
+ {%- if theme_bootstrap_version == "3" -%}<span class="glyphicon glyphicon-chevron-right visible-sm"></span>{%- endif -%}
+ <span class="hidden-sm hidden-tablet">{{ next.title|striptags|truncate(length=26, killwords=True) }} {{ "»"|safe }}</span>
+ </a>
+ </li>
+{%- endif %}
diff --git a/docs/source/_templates/sidebartoc.html b/docs/source/_templates/sidebartoc.html
new file mode 100644
index 0000000..f9f1fde
--- /dev/null
+++ b/docs/source/_templates/sidebartoc.html
@@ -0,0 +1 @@
+{{ toctree(maxdepth=theme_globaltoc_depth|toint, collapse=False, includehidden=theme_globaltoc_includehidden|tobool) }}
diff --git a/docs/source/changelog.md b/docs/source/changelog.md
new file mode 100644
index 0000000..7ec8044
--- /dev/null
+++ b/docs/source/changelog.md
@@ -0,0 +1,30 @@
+ipywidgets changelog
+====================
+
+A summary of changes in ipywidgets. For more detailed information, see [GitHub](https://github.com/ipython/ipywidgets).
+
+4.1.x
+-----
+
+### 4.1.1
+
+### 4.1.0
+
+4.0.x
+-----
+
+### 4.0.3
+
+Bump version with miscellaneous bug fixes.
+
+### 4.0.2
+
+Add README.rst documentation.
+
+### 4.0.1
+
+Remove ipynb checkpoints.
+
+### 4.0.0
+
+First release of **ipywidgets** as a standalone package.
diff --git a/docs/source/conf.py b/docs/source/conf.py
new file mode 100644
index 0000000..a887cf2
--- /dev/null
+++ b/docs/source/conf.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+
+from jupyter_sphinx_theme import *
+init_theme()
+
+if on_rtd:
+ print('On RTD, installing node and building...')
+ bash('../build-rtd.sh')
+else:
+ print('Not on RTD, building...')
+ bash('../build-local.sh')
+print('Done bulding')
+
+_release = {}
+exec(compile(open('../../ipywidgets/_version.py').read(), '../../ipywidgets/_version.py', 'exec'), _release)
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+master_doc = 'index'
+
+# General information about the project.
+project = 'ipywidgets and jupyter-js-widgets'
+copyright = '2016, Jupyter Team, https://jupyter.org'
+author = 'Jupyter Team'
+
+version = '.'.join(map(str, _release['version_info'][:2]))
+release = _release['__version__']
+language = None
+exclude_patterns = []
+pygments_style = 'sphinx'
+todo_include_todos = False
+htmlhelp_basename = 'ipywidgetsdoc'
+
+latex_elements = { }
+latex_documents = [
+ (master_doc, 'ipywidgets.tex', 'ipywidgets Documentation',
+ 'https://jupyter.org', 'manual'),
+]
+texinfo_documents = [
+ (master_doc, 'ipywidgets', 'ipywidgets Documentation',
+ author, 'ipywidgets', 'One line description of project.',
+ 'Miscellaneous'),
+]
+
+# Bibliographic Dublin Core info.
+epub_title = project
+epub_author = author
+epub_publisher = author
+epub_copyright = copyright
+
+intersphinx_mapping = {
+ 'ipython': ('http://ipython.org/ipython-doc/dev/', None),
+ 'nbconvert': ('http://nbconvert.readthedocs.org/en/latest/', None),
+ 'nbformat': ('http://nbformat.readthedocs.org/en/latest/', None),
+ 'jupyter': ('http://jupyter.readthedocs.org/en/latest/', None),
+}
+html_static_path = ['_static']
+
+# Theme options are theme-specific and customize the look and feel of a
+# theme further.
+html_theme_options = {
+ 'navbar_title': "ipywidgets and jupyter-js-widgets",
+}
+
+nbsphinx_allow_errors = True
diff --git a/docs/source/contributing.md b/docs/source/contributing.md
new file mode 100644
index 0000000..a7c64d9
--- /dev/null
+++ b/docs/source/contributing.md
@@ -0,0 +1,6 @@
+Contributing
+============
+
+We appreciate contributions from the community.
+
+We follow the [IPython Contributing Guide](https://github.com/ipython/ipython/blob/master/CONTRIBUTING.md) and [Jupyter document on Contributing to the Code](https://jupyter.readthedocs.org/en/latest/contrib_guide_code.html)
diff --git a/docs/source/dev_install.md b/docs/source/dev_install.md
new file mode 100644
index 0000000..fd0e9da
--- /dev/null
+++ b/docs/source/dev_install.md
@@ -0,0 +1,52 @@
+Developer Install
+=================
+To install ipywidgets from git, you will need [npm](https://www.npmjs.com/) and
+the latest [development copy of the Jupyter
+notebook](https://github.com/jupyter/notebook) because everything in the
+ipywidgets repository is developed using Jupyter notebook master. If you want
+to have a copy of ipywidgets that works against a stable version of the
+notebook, checkout the appropriate tag (see the
+[Compatibility table](https://github.com/ipython/ipywidgets#compatibility)).
+
+NOTE: If you install using sudo, you need to make sure that npm is also
+available in the PATH used with sudo.
+
+0. Clone the repo:
+
+ git clone https://github.com/ipython/ipywidgets
+
+1. Build the Jupyter Widgets package
+
+ cd jupyter-js-widgets
+ npm install
+ cd ..
+
+2. Install the Jupyter Widgets nbextension
+
+ cd widgetsnbextension
+ npm install
+ npm run update:widgets
+ pip install -v -e .
+ cd ..
+ jupyter nbextension install --py --symlink --user widgetsnbextension
+ jupyter nbextension enable --py --user widgetsnbextension
+
+3. Dev-install of the package (run from ipywidgets repo directory):
+
+ cd ipywidgets
+ pip install -v -e .
+
+
+After you've made changes to `jupyter-js-widgets` if you want to test those
+changes, run the following, empty your browsers cache, and refresh the page.
+
+ cd widgetsnbextension
+ npm run update:widgets
+ cd ..
+
+TIPS: If you have any problems with the above install procedure, make sure that
+permissions on npm and pip related install directories are correct. Sometimes
+it helps to clear cached files too by running `git clean -dfx`. Also, when
+you make changes to the Javascript, if you're not seeing the changes it could
+be your browser is caching aggressively. Try using "incognito" or "private"
+browsing tabs to avoid caching.
diff --git a/docs/source/dev_release.md b/docs/source/dev_release.md
new file mode 100644
index 0000000..671e189
--- /dev/null
+++ b/docs/source/dev_release.md
@@ -0,0 +1,51 @@
+Developer Release Procedure
+===========================
+
+To release a new version of the widgets on PyPI and npm, first checkout
+master and cd into the repo root. Make sure the version in `widget.py` matches
+the JS frontend version. Also check that the frontend version specified in
+`manager-base.js` (`version`) is correct.
+
+### Publish jupyter-js-widgets
+```
+# nuke the `dist` and `node_modules`
+git clean -fdx
+npm version [patch/minor/major]
+npm install
+npm publish
+```
+
+### Prepare widgetsnbextension npm module
+ - npm module
+```
+edit package.json to point to new jupyter-js-widgets version
+npm version [patch/minor/major]
+```
+
+### Here we commit our changes to the two package.json files
+ - python module
+```
+edit widgetsnbextension/_version.py (Remove dev from the version. If it's the first beta, use b1, etc...)
+python setup.py sdist upload && python setup.py bdist_wheel upload
+
+edit ipywidgets/_version.py (remove dev from the version and update the frontend version requirement)
+
+Change install_requires to point to new widgetsnbextension version
+python setup.py sdist upload && python setup.py bdist_wheel upload
+commit and tag (ipywidgets) release
+```
+
+### Back to dev
+```
+edit ipywidgets/_version.py (increase version and add dev tag)
+edit widgetsnbextension/widgetsnbextension/_version.py (increase version and add dev tag)
+git add ipywidgets/_version.py
+git add widgetsnbextension/widgetsnbextension/_version.py
+git commit -m "Back to dev"
+git push [upstream master]
+git push [upstream] --tags
+```
+
+On GitHub
+1. Go to https://github.com/ipython/ipywidgets/milestones and click "Close" for the released version.
+2. Make sure patch, minor, and/or major milestones exist as appropriate.
diff --git a/docs/source/dev_testing.md b/docs/source/dev_testing.md
new file mode 100644
index 0000000..38eae5d
--- /dev/null
+++ b/docs/source/dev_testing.md
@@ -0,0 +1,12 @@
+Testing
+=======
+
+To run the Python tests:
+
+ nosetests --with-coverage --cover-package=ipywidgets ipywidgets
+
+To run the Javascript tests:
+
+ cd jupyter-js-widgets; npm run test
+
+This will run the test suite using `karma` with 'debug' level logging.
diff --git a/docs/source/examples.md b/docs/source/examples.md
new file mode 100644
index 0000000..6cb6e86
--- /dev/null
+++ b/docs/source/examples.md
@@ -0,0 +1,4 @@
+Examples
+========
+
+There is a subdirectory called examples in the GitHub repo for **ipywidgets**. In the samples subdirectory are two directories, notebooks and development.
diff --git a/docs/source/examples/.ipynb_checkpoints/Untitled-checkpoint.ipynb b/docs/source/examples/.ipynb_checkpoints/Untitled-checkpoint.ipynb
new file mode 100644
index 0000000..36d03bb
--- /dev/null
+++ b/docs/source/examples/.ipynb_checkpoints/Untitled-checkpoint.ipynb
@@ -0,0 +1,65 @@
+{
+ "cells": [
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "metadata": {
+ "collapsed": false
+ },
+ "outputs": [],
+ "source": [
+ "from ipywidgets import Play\n",
+ "x = Play()"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "metadata": {
+ "collapsed": false
+ },
+ "outputs": [
+ {
+ "data": {
+ "application/vnd.jupyter.widget": "2ce20e140e3644ce975d25c6b5fee7f2"
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
... 25639 lines suppressed ...
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/ipywidgets.git
More information about the Python-modules-commits
mailing list