Compatibility between Jupyter Notebooks / Binder and DAR / Texture / Stencila

[nuest]

[ Project Contact ] @minrk, @nuest
[ GitHub Repo ] https://github.com/minrk/jupyter-dar
[ Track ] Openness,
[ Location ] Cambridge UK, BST
[ Coach ] @chadsansing

Description

Binder is an online service for running Jupyter Notebooks and other environments. Texture/Stencila are editors for reproducible research documents. We want to connect them so that users can edit reproducible documents (DAR files) as part of a binder project.

Objectives:
Understanding DAR
Launching Stencila Editor on Binder (potentially not launching anything else, i.e. w/o the Jupyter Notebook start page)
repo2docker support for DAR files

---

Want to contribute to this project during #mozsprint?

Join us at the Global Sprint, May 10-11. Leave a comment below if you're interested in contributing to this project during #mozsprint 2018!

---

Note to the Project Lead 🎉

Congrats, @minrk, nuest! This is your official project listing for the Mozilla Global Sprint 2018. To confirm your registration, please complete and check off the following:

• Complete Open Leadership 101
• Provide a GitHub repository for work and discussion on your project (in a comment or at the top of this issue)
• Create a README file in your project repository. This file should help newcomers understand what your project is, why it's important, and kinds of help you're looking for.
• Create file: LICENSE to give your project an open license, allowing for sharing and remixing.
• Turn on your Issue Tracker and create at least three issues to describe each task that you need help with and how a contributor can get started on that task.
• Create a label called mozsprint and apply it to your issues.:

If you get stuck at any point, feel free to look at the requirements page and project templates or reach out to your Project Coach, @chadsansing. We're here to help you through this process.

[nuest]

🎉 First demo works!

[nuest]

The project had some world-wide contribution. "Over night" the Stencila devs (@nokome) worked on running Jupyter contexts and contributed some code: minrk/nbstencilaproxy#5

Read more at the Stencila Community: https://community.stenci.la/t/stencila-in-binder/142

And here is the direct link to a working example: https://mybinder.org/v2/gh/nokome/jupyter-dar/add-stencila-host?urlpath=%2Fstencila%2F

[nuest]

Since @stencila people are now helping out, chat about the project takes place at https://gitter.im/stencila/stencila

[nuest]

I am currently trying to get the R context working... found a mismatch in confguration file paths (see stencila/r#22) and the RContext is listed in Stencila

and errors are gone, but the code is not evaluated yet...

The error is

[E 10:39:53.361 NotebookApp] 500 POST /stencila-host/RContext (172.17.0.1) 6.96ms referer=http://localhost:8888/stencila/?archive=r-markdown

[nuest]

Status report

• We have stopped working on getting R to work - see RContext cannot be started minrk/nbstencilaproxy#9 (but did find a bug too: Update user dir to match other path configurations stencila/r#22); we need help from the Stencila experts for that, but there's other stuff to do...
• @nuest works on packaging the proxy as a proper Python module, which will make installation and maintenance easier down the road (base on https://github.com/jupyterhub/nbrsessionproxy)
• @minrk works on getting https://github.com/jupyter/repo2docker ready to handle repos with Dar archives - the Docker image generation will be like magix 🦄

[nuest]

The Python module for the proxy also allows us to extend the Jupyter landing page with a nice button (minrk/nbstencilaproxy#1):

[nuest]

Demo works (on an inofficial binder website) 🎉 💯

Try it at http://binder.minrk.net/v2/gh/minrk/jupyter-dar/master?urlpath=%2Fstencila%2F

[npscience]

@nuest many thanks for documenting your progress here, it's fab to have this record and all the links 💯

[nuest]

The software is ready for this to work on mybinder.org, we're working on some examples and a wrap-up blog post, see minrk/nbstencilaproxy#12

[nuest]

@chadsansing If you're still "coaching" this, feedback on a wrap-up blog post is very welcome: minrk/nbstencilaproxy#12 (comment)