This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Brython magic for the Jupyter notebook.

The brythonmagic provides you a cell magic, %%brython, to run brython code and show the results in a html div tag below the code cell. Best way to start with Brython is to check the Brython docs in their home page.

Tested on

The brythonmagic extension has been tested on:

  • Jupyter versions >= (4, 0, 0, ”)
  • Python version >= 3.3 and == 2.7
  • Brython versions >= (2,0,0)

Installation

You should have Jupyter (notebook) already installed in order to use Brythonmagic. In case you don’t have Jupyter installed you can follow the instructions on the Jupyter official page.

To install brythonmagic itself just type the following:

pip install brythonmagic

or download this repo and on the brythonmagic downloaded folder type:

python setup.py install

Then, load the extension:

%load_ext brythonmagic

And, finally, load the stable brython js lib in the notebook using the following code:

from brythonmagic import load_brython_stable
load_brython_stable()

In case you want to use the development brython js lib in the notebook use the following code:

from brythonmagic import load_brython_dev
load_brython_dev()

If you have any problem with the installation, please, open an issue.

WARNING

In order to load javascript libraries in a safety way you should try to use https instead of http when possible (read more here). If you don’t trust the source and/or the source cannot be loaded using https then you could download the javascript library and load it from a local location.

Brythonmagic doesn’t load any javascript library and the user should take care about the security and should use trusted sources.

You can load third party javascript libraries using the following code:

from brythonmagic import load_js_lib
load_js_lib("https://url/to/your/lib.js")

Usage

example:

%%brython -c zone
# First of all, the import of some libraries
from browser import document, html

# All the elements will be inserted in the div with the "zone" id
zone = document['zone']

# We create a new div element
newdiv = html.DIV(Id = "new-div")
# Now we add some style
newdiv.style = {"padding": "5px",
           "backgroundColor": "#ADD8E6"}

# We create a new link and add the link to a string
blink = html.A('brython',href="http://brython.info")
text = "Brython is really cool, look at "+ blink + " for more"

# Now we add the text to the div with id="new-div"
newdiv <= html.DIV(text)

# Finally, we add the newdiv to the outer div with id="zone"
zone <= newdiv

You can use several options:

  • -p, –print: will show you the generated html code below the results obtained from the brython code.
  • -c, –container: you can define the name of the div container in case you want to ‘play’ with it in other cell. If you don’t define an output the div will have an id with the following format ‘brython-container-[random number between 0 and 999999]’. Just one container name is accepted. If you pass more than one only the first one will be used and a warning will raise.
  • -i, –input: you can pass variables defined in the Python namespace separated by whitespaces. If you pass a python list it will be converted to a brython list, a python tuple will be converted to a brython tuple, a python dict will be converted to a brython dict, a python string will be converted to a brython string.
  • -h, –html: you can pass a string with html markup code. This html code will be inserted inside the div container. In this way you can avoid the generation of HTML markup code via a Brython script so you can separate the layout from the ‘action’. Just one html markup code string name is accepted. If you pass more than one only the first one will be used and a warning will raise.
  • -s, –script: Use this option to provide an id to the script defined in the Brython code cell. Also, this value could be used to run the code of this cell in other brython cells. Just one script name is accepted. If you pass more than one only the first one will be used and a warning will raise.
  • -S, –scripts: Use this option to run code previously defined in other Brython code cells. The values should be the provided values in the -s/–script option in other Brython code cells.
  • -f, –fiddle: With this option, the code in the cell will be automatically uploaded to gist.github.com/ as an anonymous gist with several files in it. This files will be used to create an anonymous ‘fiddle’ on jsfiddle.net. Finally, some links will be printed in the output linking to the gist and the fiddle. See an example here (https://gist.github.com/anonymous/b664e8b4617afc09db6c and http://jsfiddle.net/gh/gist/library/pure/b664e8b4617afc09db6c/)
  • -e, –embedfiddle: With this option, the code in the cell will be automatically uploaded to gist.github.com/ as an anonymous gist with several files in it. This files will be used to create an anonymous ‘fiddle’ on jsfiddle.net. Finally, some links will be printed in the output linking to the gist and the fiddle and an iframe will be created showing the fiddle on jsfiddle.net.

WARNING This options may change as the brythonmagic depending the development of Brython and/or Jupyter.

To see some examples download the notebooks available in the repository and run it locally or see it in the nbviewer (you will lose the interactivity if you choose the second option). Also, you can take a look on the following video: http://youtu.be/adQzjuUX0kw

Support

If you need Brython support, please, ask here: https://groups.google.com/forum/?fromgroups=#!forum/brython

If you need Jupyter support, please, ask here: http://mail.scipy.org/mailman/listinfo/ipython-dev

If you find a bug or want to propose a new feature open a new issue here: https://github.com/kikocorreoso/brythonmagic/issues

If you want to improve the code, fork, commit and send a PR ;·D

Release History

Release History

0.2.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
brythonmagic-0.2.1-py3-none-any.whl (11.6 kB) Copy SHA256 Checksum SHA256 py3 Wheel Apr 23, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting