.. image:: https://travis-ci.org/jiffyclub/ipythonblocks.png?branch=master :alt: Travis-CI :target: https://travis-ci.org/jiffyclub/ipythonblocks
.. image:: https://coveralls.io/repos/jiffyclub/ipythonblocks/badge.png :alt: Coveralls :target: https://coveralls.io/r/jiffyclub/ipythonblocks
ipythonblocks is a teaching tool for use with the IPython_ Notebook.
It provides a
BlockGrid object whose representation is an HTML table.
Individual table cells are represented by
Block objects that have
.blue attributes by which the color of that cell can be
ipythonblocks allows students to experiment with Python flow control concepts
and immediately see the effects of their code represented in a colorful,
BlockGrid objects can be indexed and sliced like 2D NumPy
arrays making them good practice for learning how to access arrays.
See these demo notebooks for more on using
Practicing with RGB_
Basic usage_ with explanations
JPEG to BlockGrid_ and text
ipythonblocks can be installed with
pip install ipythonblocks
However, the package is contained in a single
.py file and if you prefer
you can just grab
ipythonblocks.py_ and copy it to wherever you
want to use it (useful for packaging with other teaching materials).
The test suite is written using pytest_, so you can run the test suite with::
.. _IPython: http://ipython.org .. _Practicing with RGB: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/learning_colors.ipynb .. _Basic usage: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/ipythonblocks_demo.ipynb .. _Fun examples: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/ipythonblocks_fun.ipynb .. _Animation: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/ipythonblocks_animation.ipynb .. _ImageGrid: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/ipythonblocks_imagegrid.ipynb .. _JPEG to BlockGrid: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/starry_night_to_text.ipynb .. _firework animation: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/Firework.ipynb .. _Using ipythonblocks.org: http://nbviewer.ipython.org/urls/raw.github.com/jiffyclub/ipythonblocks/master/demos/ipythonblocks_org_demo.ipynb .. _ipythonblocks.py: https://github.com/jiffyclub/ipythonblocks/blob/master/ipythonblocks/ipythonblocks.py .. _Python: http://python.org/ .. _pytest: http://pytest.org/ .. _requests: http://docs.python-requests.org/en/latest/ .. _PIL: http://www.pythonware.com/products/pil/ .. _Pillow: https://python-pillow.org/ .. _responses: https://github.com/dropbox/responses .. _mock: http://www.voidspace.org.uk/python/mock/ .. _ipythonblocks.org: http://www.ipythonblocks.org