26 |
27 |
28 |
29 |
30 |
31 |
--------------------------------------------------------------------------------
/setup.cfg:
--------------------------------------------------------------------------------
1 | [bdist_wheel]
2 | universal=1
3 |
4 | [metadata]
5 | license_file = COPYING.md
6 |
7 | [nosetests]
8 | warningfilters=module |.* |DeprecationWarning |notebook.*
9 | default |.* | Warning | notebook.*
10 | ignore |.*metadata.* |DeprecationWarning |notebook.*
11 | ignore |.*schema.* |UserWarning |nbfor.*
12 | ignore |The 'warn' method is deprecated, use 'warning' instead | DeprecationWarning |notebook.*
13 | error |encodestring\(\) is a deprecated alias, use encodebytes\(\)| DeprecationWarning | notebook.*
14 | error |decodestring\(\) is a .*| DeprecationWarning | notebook.*
15 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | MANIFEST
2 | build
3 | dist
4 | _build
5 | docs/man/*.gz
6 | docs/source/api/generated
7 | docs/source/config.rst
8 | docs/gh-pages
9 | notebook/i18n/*/LC_MESSAGES/*.mo
10 | notebook/i18n/*/LC_MESSAGES/nbjs.json
11 | notebook/static/components
12 | notebook/static/style/*.min.css*
13 | notebook/static/*/js/built/
14 | notebook/static/*/built/
15 | notebook/static/built/
16 | notebook/static/*/js/main.min.js*
17 | notebook/static/lab/*bundle.js
18 | node_modules
19 | *.py[co]
20 | __pycache__
21 | *.egg-info
22 | *~
23 | *.bak
24 | .ipynb_checkpoints
25 | .tox
26 | .DS_Store
27 | \#*#
28 | .#*
29 | .coverage
30 | src
31 |
32 | *.swp
33 | *.map
34 | .idea/
35 | Read the Docs
36 | config.rst
37 |
38 | /.project
39 | /.pydevproject
40 |
41 |
--------------------------------------------------------------------------------
/notebook/services/nbconvert/handlers.py:
--------------------------------------------------------------------------------
1 | import json
2 |
3 | from tornado import web
4 |
5 | from ...base.handlers import APIHandler
6 |
7 | class NbconvertRootHandler(APIHandler):
8 |
9 | @web.authenticated
10 | def get(self):
11 | try:
12 | from nbconvert.exporters.export import exporter_map
13 | except ImportError as e:
14 | raise web.HTTPError(500, "Could not import nbconvert: %s" % e)
15 | res = {}
16 | for format, exporter in exporter_map.items():
17 | res[format] = info = {}
18 | info['output_mimetype'] = exporter.output_mimetype
19 |
20 | self.finish(json.dumps(res))
21 |
22 | default_handlers = [
23 | (r"/api/nbconvert", NbconvertRootHandler),
24 | ]
25 |
--------------------------------------------------------------------------------
/notebook/auth/logout.py:
--------------------------------------------------------------------------------
1 | """Tornado handlers for logging out of the notebook.
2 | """
3 |
4 | # Copyright (c) Jupyter Development Team.
5 | # Distributed under the terms of the Modified BSD License.
6 |
7 | from ..base.handlers import IPythonHandler
8 |
9 |
10 | class LogoutHandler(IPythonHandler):
11 |
12 | def get(self):
13 | self.clear_login_cookie()
14 | if self.login_available:
15 | message = {'info': 'Successfully logged out.'}
16 | else:
17 | message = {'warning': 'Cannot log out. Notebook authentication '
18 | 'is disabled.'}
19 | self.write(self.render_template('logout.html',
20 | message=message))
21 |
22 |
23 | default_handlers = [(r"/logout", LogoutHandler)]
--------------------------------------------------------------------------------
/notebook/tests/notebook/inject_js.js:
--------------------------------------------------------------------------------
1 | //
2 | // Test robustness about JS injection in different place
3 | //
4 | // This assume malicious document arrive to the frontend.
5 | //
6 |
7 | casper.notebook_test(function () {
8 | var messages = [];
9 | this.on('remote.alert', function (msg) {
10 | messages.push(msg);
11 | });
12 |
13 | this.evaluate(function () {
14 | var cell = IPython.notebook.get_cell(0);
15 | var json = cell.toJSON();
16 | json.execution_count = "";
17 | cell.fromJSON(json);
18 | });
19 |
20 | this.then(function () {
21 | this.test.assert(messages.length == 0, "Captured log message from script tag injection !");
22 | });
23 | });
24 |
--------------------------------------------------------------------------------
/appveyor.yml:
--------------------------------------------------------------------------------
1 | # miniconda bootstrap from conda-forge recipe
2 | matrix:
3 | fast_finish: true
4 |
5 | environment:
6 | matrix:
7 | - CONDA_PY: 36
8 | CONDA_INSTALL_LOCN: "C:\\Miniconda36-x64"
9 | - CONDA_PY: 27
10 | CONDA_INSTALL_LOCN: "C:\\Miniconda-x64"
11 |
12 | platform:
13 | - x64
14 |
15 | build: off
16 |
17 | install:
18 | - cmd: call %CONDA_INSTALL_LOCN%\Scripts\activate.bat
19 | - cmd: conda config --set show_channel_urls true
20 | - cmd: conda config --add channels conda-forge
21 | #- cmd: conda update --yes --quiet conda
22 | - cmd: conda install -y pyzmq tornado jupyter_client nbformat nbconvert ipykernel pip nodejs nose
23 | - cmd: pip install .[test]
24 |
25 | test_script:
26 | - nosetests -v notebook --exclude-dir notebook\tests\selenium
27 |
--------------------------------------------------------------------------------
/docs/resources/Info.plist.example:
--------------------------------------------------------------------------------
1 | # Add this into the info.plist file of an application
2 | # and the icns icon in Contents/Resources
3 | # then move the application twice :
4 | # https://superuser.com/questions/178316/how-to-set-an-icon-for-a-file-type-on-mac
5 |
6 |
18 | {% block h1_error %}
19 |
30 |
31 | {% endblock %}
32 |
33 | {% block script %}
34 | {{super()}}
35 |
42 | {% endblock script %}
43 |
--------------------------------------------------------------------------------
/docs-translations/ko-KR/Installation.md:
--------------------------------------------------------------------------------
1 | # Jupyter Notebook 설치하기
2 |
3 | ## 필요한 것 : Python
4 |
5 | Jupyter Notebook 을 설치하기 위해선 Jupyter가 많은 프로그래밍 언어들로 동작되기 때문에, Python이 필요합니다. (Python 3.3이상, Python 2.7)
6 |
7 | Python과 Jupyter를 설치할 때 Anaconda를 이용하는 것을 추천합니다. 밑에서 이를 이용하여 설치할 것입니다.
8 |
9 | ## Anaconda 와 conda 를 이용하여 Jupyter 설치하기
10 |
11 | 새로운 이용자들은 Anaconda를 설치하는 것을 강력하게 추천합니다. Anaconda는 Python과 Jupyter를 쉽게 설치하게 해주고, 과학적인 계산과 데이터를 위한 자주 사용되는 패키지들의 설치에도 유용합니다.
12 |
13 | 설치 순서 :
14 |
15 | 1. Anaconda를 다운받으세요. Anaconda의 가장 최신의 Python 3버전을 다운 받는 것을 추천합니다.
16 | 2. 다운 받은 Anaconda 의 다운로드 페이지에 있는 설명을 읽고 설치해주세요.
17 | 3. 축하합니다. Jupyter Notebook 을 설치하셨습니다. Jupyter Notebook을 실행하려면 :
18 |
19 | $ jupyter notebook
20 |
21 | ## 숙련된 Python 이용자 : pip을 통해 설치하기
22 |
23 | Python 이용자라면, Anaconda 대신에 Python의 패키지 매니저 pip을 이용하여 설치하세요.
24 |
25 | 첫째로, 가장 최신의 pip인지를 확인하세요; 구 버전은 독립성에 문제가 있을 수 있습니다.
26 |
27 | $ pip install --upgrade pip
28 |
29 | 이제 다음을 이용하여 Jupyter Notebook를 설치하세요 :
30 |
31 | $ pip install jupyter
32 |
33 | (축하합니다. Jupyter Notebook를 설치하셨습니다.)
34 |
--------------------------------------------------------------------------------
/docs/source/index.rst:
--------------------------------------------------------------------------------
1 | ====================
2 | The Jupyter Notebook
3 | ====================
4 |
5 | * `Installation {{status_code}} : {{status_message}}
20 | {% endblock h1_error %} 21 | {% block error_detail %} 22 | {% if message %} 23 |{% trans %}The error was:{% endtrans %}
24 |
25 |
27 | {% endif %}
28 | {% endblock %}
29 | {{message}}
26 |
27 |
28 |
29 | {% endblock %}
30 |
31 | {% block script %}
32 |
33 | {{super()}}
34 |
35 |
36 | {% endblock %}
37 |
--------------------------------------------------------------------------------
/notebook/static/edit/less/edit.less:
--------------------------------------------------------------------------------
1 | .dirty-indicator{
2 | .fa();
3 | width:20px;
4 | }
5 | .dirty-indicator-dirty{
6 | .dirty-indicator();
7 | }
8 |
9 | .dirty-indicator-clean{
10 | .dirty-indicator();
11 | &:before{
12 | .icon(@fa-var-check);
13 | }
14 | }
15 |
16 | #filename {
17 | font-size: 16pt;
18 | display: table;
19 | padding: 0px 5px;
20 | }
21 |
22 | #current-mode{
23 | padding-left: 5px;
24 | padding-right: 5px;
25 | }
26 |
27 | #texteditor-backdrop {
28 | padding-top: @page-header-padding;
29 | padding-bottom: @page-header-padding;
30 |
31 | @media not print{
32 | background-color: @page-backdrop-color;
33 | }
34 |
35 | #texteditor-container {
36 | .CodeMirror-gutter, .CodeMirror-gutters {
37 | @media print {
38 | background-color: @body-bg;
39 | }
40 | @media not print {
41 | background-color: @page-color;
42 | }
43 | }
44 |
45 | @media not print{
46 | padding: 0px;
47 | background-color : @page-color;
48 | .box-shadow(@global-shadow);
49 | }
50 | }
51 | }
52 |
53 | .CodeMirror-dialog {
54 | background-color: @page-color;
55 | }
56 |
--------------------------------------------------------------------------------
/notebook/tests/selenium/test_prompt_numbers.py:
--------------------------------------------------------------------------------
1 | import os
2 | import pytest
3 | import time
4 |
5 | # selenium test version for 'prompt_numbers.js'
6 |
7 | def get_prompt(nb, index):
8 | cell = nb.cells[0]
9 | return cell.find_element_by_class_name('input').find_element_by_class_name('input_prompt').get_attribute('innerHTML').strip()
10 |
11 | def set_prompt(nb, index, value):
12 | nb.set_cell_input_prompt(index, value)
13 |
14 | def test_prompt_numbers(notebook):
15 | cell_index = 0
16 | a = 'print("a")'
17 | notebook.edit_cell(index=cell_index, content=a)
18 | assert get_prompt(notebook, cell_index) == "In [ ]:"
19 | set_prompt(notebook, cell_index, 2);
20 | assert get_prompt(notebook, cell_index) == "In [2]:"
21 | set_prompt(notebook, cell_index, 0);
22 | assert get_prompt(notebook, cell_index) == "In [0]:"
23 | set_prompt(notebook, cell_index, "'*'");
24 | assert get_prompt(notebook, cell_index) == "In [*]:"
25 | set_prompt(notebook, cell_index, "undefined");
26 | assert get_prompt(notebook, cell_index) == "In [ ]:"
27 | set_prompt(notebook, cell_index, "null");
28 | assert get_prompt(notebook, cell_index) == "In [ ]:"
29 |
--------------------------------------------------------------------------------
/notebook/tests/selenium/test_markdown.py:
--------------------------------------------------------------------------------
1 |
2 | def get_rendered_contents(nb):
3 | cl = ["text_cell", "render"]
4 | rendered_cells = [cell.find_element_by_class_name("text_cell_render")
5 | for cell in nb.cells
6 | if all([c in cell.get_attribute("class") for c in cl])]
7 | return [x.get_attribute('innerHTML').strip()
8 | for x in rendered_cells
9 | if x is not None]
10 |
11 |
12 | def test_markdown_cell(notebook):
13 | nb = notebook
14 | cell_text = ["# Foo",
15 | '**Bar**',
16 | '*Baz*',
17 | '```\nx = 1\n```',
18 | '```aaaa\nx = 1\n```',
19 | ]
20 | expected_contents = ['Foo¶
', 21 | 'Bar
', 22 | 'Baz
', 23 | 'x = 1x = 1
21 |
22 | {% if message %}
23 | {% for key in message %}
24 |
27 | {% endfor %}
28 | {% endif %}
29 |
30 | {% if not login_available %}
31 | {% trans %}Proceed to the dashboard{% endtrans %}.
32 | {% else %}
33 | {% trans %}Proceed to the login page{% endtrans %}.
34 | {% endif %}
35 |
36 |
37 |
38 |
39 | {% endblock %}
40 |
41 | {% block script %}
42 | {{super()}}
43 |
44 |
49 |
50 | {% endblock %}
51 |
--------------------------------------------------------------------------------
/notebook/static/tree/js/shutdownbutton.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | define([
5 | 'jquery',
6 | 'base/js/dialog',
7 | 'base/js/i18n',
8 | 'base/js/utils'
9 | ], function(
10 | $,
11 | dialog,
12 | i18n,
13 | utils
14 | ){
15 | "use strict";
16 |
17 | function display_shutdown_dialog() {
18 | var body = $('').append(
19 | $('').text(i18n.msg._("You have shut down Jupyter. You can now close this tab."))
20 | ).append(
21 | $('').text(i18n.msg._("To use Jupyter again, you will need to relaunch it."))
22 | );
23 |
24 | dialog.modal({
25 | title: i18n.msg._("Server stopped"),
26 | body: body
27 | })
28 | }
29 |
30 | function activate() {
31 | // Add shutdown button
32 | $("button#shutdown").click(function () {
33 | utils.ajax(utils.url_path_join(
34 | utils.get_body_data("baseUrl"),
35 | "api",
36 | "shutdown"
37 | ), {
38 | type: "POST",
39 | success: display_shutdown_dialog,
40 | error: function (error) {
41 | console.log(error);
42 | }
43 | });
44 | });
45 | }
46 |
47 | return {activate: activate}
48 | });
49 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/interrupt.js:
--------------------------------------------------------------------------------
1 | //
2 | // Test kernel interrupt
3 | //
4 | casper.notebook_test(function () {
5 | this.evaluate(function () {
6 | var cell = IPython.notebook.get_cell(0);
7 | cell.set_text(
8 | 'import time'+
9 | '\nfor x in range(3):'+
10 | '\n time.sleep(1)'
11 | );
12 | cell.execute();
13 | });
14 |
15 | this.wait_for_busy();
16 |
17 | // interrupt using menu item (Kernel -> Interrupt)
18 | this.thenClick('li#int_kernel');
19 |
20 | this.wait_for_output(0);
21 |
22 | this.then(function () {
23 | var result = this.get_output_cell(0);
24 | this.test.assertEquals(result.ename, 'KeyboardInterrupt', 'keyboard interrupt (mouseclick)');
25 | });
26 |
27 | // run cell 0 again, now interrupting using keyboard shortcut
28 | this.thenEvaluate(function () {
29 | var cell = IPython.notebook.get_cell(0);
30 | cell.clear_output();
31 | cell.execute();
32 | });
33 |
34 | // interrupt using ii keyboard shortcut
35 | this.then(function(){
36 | this.trigger_keydown('esc', 'i', 'i');
37 | });
38 |
39 | this.wait_for_output(0);
40 |
41 | this.then(function () {
42 | var result = this.get_output_cell(0);
43 | this.test.assertEquals(result.ename, 'KeyboardInterrupt', 'keyboard interrupt (shortcut)');
44 | });
45 | });
46 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/tagbar.less:
--------------------------------------------------------------------------------
1 |
2 |
3 | .tags_button_container {
4 | width: 100%;
5 | display: flex;
6 | }
7 |
8 | .tag-container {
9 | display: flex;
10 | flex-direction: row;
11 | flex-grow: 1;
12 | overflow: hidden;
13 | position: relative;
14 | }
15 |
16 | .tag-container > * {
17 | margin: 0 4px;
18 | }
19 |
20 | .remove-tag-btn {
21 | margin-left: 4px;
22 | }
23 |
24 | .tags-input {
25 | display: flex;
26 | }
27 |
28 | .cell-tag:last-child:after {
29 | content: "";
30 | position: absolute;
31 | right: 0;
32 | width: 40px;
33 | height: 100%;
34 | /* Fade to background color of cell toolbar */
35 | background: linear-gradient(to right, rgba(0,0,0,0), #EEE);
36 | }
37 |
38 | .tags-input > * {
39 | margin-left: 4px;
40 | }
41 |
42 | .cell-tag,
43 | .tags-input input,
44 | .tags-input button {
45 | .form-control();
46 | .input-sm();
47 | // undo some of the sizing caused by the above mixins
48 | box-shadow: none;
49 | width: inherit;
50 | font-size: inherit;
51 | height: 22px;
52 | line-height: 22px;
53 | padding: 0px 4px;
54 |
55 | display: inline-block;
56 | }
57 |
58 | .cell-tag,
59 | .tags-input button {
60 | padding: 0px 4px;
61 | }
62 |
63 | .cell-tag {
64 | background-color: #fff;
65 | white-space: nowrap;
66 | }
67 |
68 | .tags-input input[type=text]:focus {
69 | outline: none;
70 | box-shadow: none;
71 | border-color: #ccc;
72 | }
73 |
--------------------------------------------------------------------------------
/notebook/static/terminal/js/terminado.js:
--------------------------------------------------------------------------------
1 | define (["xterm", "xtermjs-fit"], function(Terminal, fit) {
2 | "use strict";
3 | function make_terminal(element, ws_url) {
4 | var ws = new WebSocket(ws_url);
5 | Terminal.applyAddon(fit);
6 | var term = new Terminal();
7 | ws.onopen = function(event) {
8 | term.on('data', function(data) {
9 | ws.send(JSON.stringify(['stdin', data]));
10 | });
11 |
12 | term.on('title', function(title) {
13 | document.title = title;
14 | });
15 |
16 | term.open(element);
17 | term.fit();
18 | // send the terminal size to the server.
19 | ws.send(JSON.stringify(["set_size", term.rows, term.cols,
20 | window.innerHeight, window.innerWidth]));
21 |
22 | ws.onmessage = function(event) {
23 | var json_msg = JSON.parse(event.data);
24 | switch(json_msg[0]) {
25 | case "stdout":
26 | term.write(json_msg[1]);
27 | break;
28 | case "disconnect":
29 | term.write("\r\n\r\n[CLOSED]\r\n");
30 | break;
31 | }
32 | };
33 | };
34 | return {socket: ws, term: term};
35 | }
36 |
37 | return {make_terminal: make_terminal};
38 | });
39 |
--------------------------------------------------------------------------------
/docs/source/examples/Notebook/nbpackage/mynotebook.ipynb:
--------------------------------------------------------------------------------
1 | {
2 | "cells": [
3 | {
4 | "cell_type": "markdown",
5 | "metadata": {},
6 | "source": [
7 | "# My Notebook"
8 | ]
9 | },
10 | {
11 | "cell_type": "code",
12 | "execution_count": 1,
13 | "metadata": {
14 | "collapsed": false
15 | },
16 | "outputs": [],
17 | "source": [
18 | "def foo():\n",
19 | " return \"foo\""
20 | ]
21 | },
22 | {
23 | "cell_type": "code",
24 | "execution_count": 2,
25 | "metadata": {
26 | "collapsed": false
27 | },
28 | "outputs": [],
29 | "source": [
30 | "def has_ip_syntax():\n",
31 | " listing = !ls\n",
32 | " return listing"
33 | ]
34 | },
35 | {
36 | "cell_type": "code",
37 | "execution_count": 4,
38 | "metadata": {
39 | "collapsed": false
40 | },
41 | "outputs": [],
42 | "source": [
43 | "def whatsmyname():\n",
44 | " return __name__"
45 | ]
46 | }
47 | ],
48 | "metadata": {
49 | "kernelspec": {
50 | "display_name": "Python 3",
51 | "language": "python",
52 | "name": "python3"
53 | },
54 | "language_info": {
55 | "codemirror_mode": {
56 | "name": "ipython",
57 | "version": 3
58 | },
59 | "file_extension": ".py",
60 | "mimetype": "text/x-python",
61 | "name": "python",
62 | "nbconvert_exporter": "python",
63 | "pygments_lexer": "ipython3",
64 | "version": "3.5.1+"
65 | }
66 | },
67 | "nbformat": 4,
68 | "nbformat_minor": 0
69 | }
70 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/merge_cells_api.js:
--------------------------------------------------------------------------------
1 | //
2 | // Test merging two notebook cells.
3 | //
4 | casper.notebook_test(function() {
5 | var that = this;
6 | var set_cells_text = function () {
7 | that.evaluate(function() {
8 | var cell_one = IPython.notebook.get_selected_cell();
9 | cell_one.set_text('a = 5');
10 | });
11 |
12 | that.trigger_keydown('b');
13 |
14 | that.evaluate(function() {
15 | var cell_two = IPython.notebook.get_selected_cell();
16 | cell_two.set_text('print(a)');
17 | });
18 | };
19 |
20 | this.evaluate(function () {
21 | IPython.notebook.command_mode();
22 | });
23 |
24 | // merge_cell_above()
25 | set_cells_text();
26 | var output_above = this.evaluate(function () {
27 | IPython.notebook.merge_cell_above();
28 | return IPython.notebook.get_selected_cell().get_text();
29 | });
30 |
31 | // merge_cell_below()
32 | set_cells_text();
33 | var output_below = this.evaluate(function() {
34 | IPython.notebook.select(0);
35 | IPython.notebook.merge_cell_below();
36 | return IPython.notebook.get_selected_cell().get_text();
37 | });
38 |
39 | this.test.assertEquals(output_above, 'a = 5\n\nprint(a)',
40 | 'Successful merge_cell_above().');
41 | this.test.assertEquals(output_below, 'a = 5\n\nprint(a)',
42 | 'Successful merge_cell_below().');
43 | });
44 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/toolbar.less:
--------------------------------------------------------------------------------
1 | .toolbar {
2 | padding: 0px;
3 | margin-left: -5px;
4 | margin-top: 2px;
5 | margin-bottom: 5px;
6 |
7 | select, label {
8 | width: auto;
9 | vertical-align:middle;
10 | margin-right:2px;
11 | margin-bottom:0px;
12 | display: inline;
13 | font-size: 92%;
14 | margin-left:0.3em;
15 | margin-right:0.3em;
16 | padding: 0px;
17 | padding-top: 3px;
18 | }
19 | .btn {
20 | padding: 2px 8px;
21 | }
22 |
23 | .border-box-sizing();
24 | }
25 |
26 | .toolbar .btn-group {
27 | margin-top: 0px;
28 | margin-left: 5px;
29 | }
30 |
31 | .toolbar-btn-label {
32 | margin-left: 6px;
33 | }
34 |
35 | #maintoolbar {
36 | margin-bottom: -3px;
37 | margin-top: -8px;
38 | border: 0px;
39 | min-height: 27px;
40 | margin-left: 0px;
41 | padding-top: 11px;
42 | padding-bottom: 3px;
43 |
44 | .navbar-text {
45 | float: none;
46 | vertical-align: middle;
47 | text-align: right;
48 | margin-left: 5px;
49 | margin-right: 0px;
50 | margin-top: 0px;
51 | }
52 | }
53 |
54 | .select-xs {
55 | height: @btn_small_height;
56 | }
57 |
58 | [dir="rtl"] .btn-group > .btn, .btn-group-vertical > .btn {
59 | float: right;
60 | }
61 |
62 | // highlight the new menu where celltoolbar is
63 | .pulse, .dropdown-menu > li > a.pulse, li.pulse > a.dropdown-toggle, li.pulse.open > a.dropdown-toggle {
64 | background-color: #F37626;
65 | color: white;
66 | }
67 |
--------------------------------------------------------------------------------
/notebook/tests/base/misc.js:
--------------------------------------------------------------------------------
1 |
2 | //
3 | // Miscellaneous javascript tests
4 | //
5 | casper.notebook_test(function () {
6 | var jsver = this.evaluate(function () {
7 | var cell = IPython.notebook.get_cell(0);
8 | cell.set_text('import notebook; print(notebook.__version__)');
9 | cell.execute();
10 | return IPython.version;
11 | });
12 |
13 | this.wait_for_output(0);
14 |
15 | // refactor this into just a get_output(0)
16 | this.then(function () {
17 | var result = this.get_output_cell(0);
18 | this.test.assertEquals(result.text.trim(), jsver, 'IPython.version in JS matches server-side.');
19 | });
20 |
21 | // verify that requirejs loads the same CodeCell prototype at runtime as build time
22 | this.thenEvaluate(function () {
23 | require(['notebook/js/codecell'], function (codecell) {
24 | codecell.CodeCell.prototype.test = function () {
25 | return 'ok';
26 | }
27 | window._waitForMe = true;
28 | })
29 | })
30 |
31 | this.waitFor(function () {
32 | return this.evaluate(function () {
33 | return window._waitForMe;
34 | });
35 | })
36 |
37 | this.then(function () {
38 | var result = this.evaluate(function () {
39 | var cell = Jupyter.notebook.get_cell(0);
40 | return cell.test();
41 | });
42 | this.test.assertEquals(result, 'ok', "runtime-requirejs loads the same modules")
43 | })
44 |
45 | });
46 |
--------------------------------------------------------------------------------
/notebook/metrics.py:
--------------------------------------------------------------------------------
1 | """
2 | Prometheus metrics exported by Jupyter Notebook Server
3 |
4 | Read https://prometheus.io/docs/practices/naming/ for naming
5 | conventions for metrics & labels.
6 | """
7 |
8 | from prometheus_client import Histogram
9 |
10 | # This is a fairly standard name for HTTP duration latency reporting
11 | HTTP_REQUEST_DURATION_SECONDS = Histogram(
12 | 'http_request_duration_seconds',
13 | 'duration in seconds for all HTTP requests',
14 | ['method', 'handler', 'status_code'],
15 | )
16 |
17 | def prometheus_log_method(handler):
18 | """
19 | Tornado log handler for recording RED metrics.
20 |
21 | We record the following metrics:
22 | Rate - the number of requests, per second, your services are serving.
23 | Errors - the number of failed requests per second.
24 | Duration - The amount of time each request takes expressed as a time interval.
25 |
26 | We use a fully qualified name of the handler as a label,
27 | rather than every url path to reduce cardinality.
28 |
29 | This function should be either the value of or called from a function
30 | that is the 'log_function' tornado setting. This makes it get called
31 | at the end of every request, allowing us to record the metrics we need.
32 | """
33 | HTTP_REQUEST_DURATION_SECONDS.labels(
34 | method=handler.request.method,
35 | handler='{}.{}'.format(handler.__class__.__module__, type(handler).__name__),
36 | status_code=handler.get_status()
37 | ).observe(handler.request.request_time())
38 |
--------------------------------------------------------------------------------
/notebook/terminal/handlers.py:
--------------------------------------------------------------------------------
1 | #encoding: utf-8
2 | """Tornado handlers for the terminal emulator."""
3 |
4 | # Copyright (c) Jupyter Development Team.
5 | # Distributed under the terms of the Modified BSD License.
6 |
7 | from tornado import web
8 | import terminado
9 | from notebook._tz import utcnow
10 | from ..base.handlers import IPythonHandler
11 | from ..base.zmqhandlers import WebSocketMixin
12 |
13 |
14 | class TerminalHandler(IPythonHandler):
15 | """Render the terminal interface."""
16 | @web.authenticated
17 | def get(self, term_name):
18 | self.write(self.render_template('terminal.html',
19 | ws_path="terminals/websocket/%s" % term_name))
20 |
21 |
22 | class TermSocket(WebSocketMixin, IPythonHandler, terminado.TermSocket):
23 |
24 | def origin_check(self):
25 | """Terminado adds redundant origin_check
26 |
27 | Tornado already calls check_origin, so don't do anything here.
28 | """
29 | return True
30 |
31 | def get(self, *args, **kwargs):
32 | if not self.get_current_user():
33 | raise web.HTTPError(403)
34 | return super(TermSocket, self).get(*args, **kwargs)
35 |
36 | def on_message(self, message):
37 | super(TermSocket, self).on_message(message)
38 | self.application.settings['terminal_last_activity'] = utcnow()
39 |
40 | def write_message(self, message, binary=False):
41 | super(TermSocket, self).write_message(message, binary=binary)
42 | self.application.settings['terminal_last_activity'] = utcnow()
43 |
--------------------------------------------------------------------------------
/docs-translations/ko-KR/HowtoRun.md:
--------------------------------------------------------------------------------
1 | # Notebook 실행하기
2 |
3 | ## 첫 걸음
4 | 1. 다음 명령어를 통해 Notebook 서버를 시작하세요 :
5 |
6 | $ jupyter notebook
7 |
8 | 2. 브라우저에 Notebook이 실행된 것을 확인할 수 있습니다.
9 |
10 |
11 | # Notebook 서버 시작하기
12 |
13 | Notebook을 컴퓨터에 설치하였으면 Notebook 서버를 시작할 수 있습니다. 다음 명령어를 이용하여 Notebook서버를 시작할 수 있습니다.
14 |
15 | $ jupyter notebook
16 |
17 | 이 명령어를 실행하면, 터미널에 웹 응용프로그램의 주소와 서버에 대한 정보가 출력됩니다.
18 |
19 | $ jupyter notebook
20 | $ [I 08:58:24.417 NotebookApp] Serving notebooks from local directory: /Users/catherline
21 | $ [I 08:58:24.417 NotebookApp] 0 active kernels
22 | $ [I 08:58:24.417 NotebookApp] The Jupyter Notebook is running at: http://localhost:8888/
23 | $ [I 08:58:24.417 NotebookApp] Use Control-C to stop this server and shut down all kernels
24 |
25 | 기본 브라우저를 통해 이 주소가 열립니다.
26 |
27 | Notebook이 브라우저에 열리면, Notebook의 목록을 보여주는 Notebook Dashboard를 볼 수 있습니다. 대체로 가장 상위의 디렉토리를 열어줄 것입니다.
28 |
29 | **Notebook Dashboard**
30 |
31 | 
32 |
33 | # Notebook 서버의 명령어 소개
34 |
35 | ## 커스텀 IP 나 포트를 이용하여 시작하려면 어떻게 해야할까?
36 |
37 | 기본값으로, Notebook 서버는 포트 8888로 시작됩니다. 만약 포트8888이 사용할 수 없다면, Notebook 서버는 다른 가능한 포트를 찾습니다. 또한 임의로 포트를 설정해주는 것도 가능합니다. 예를 들어 포트 9999로 실행하면 :
38 |
39 | $ jupyter notebook --port 9999
40 |
41 |
42 | ## 브라우저를 열지않고 Notebook를 열기
43 |
44 | 브라우저를 열지 않고 Notebook 서버를 시작하려면 :
45 |
46 | $ jupyter notebook --no-browser
47 |
48 |
49 | ## Notebook 서버 옵션 도움말 보기
50 |
51 | Notebook 서버는 --help 옵션을 통해 도움말 메시지를 제공합니다 :
52 |
53 | $ jupyter notebook --help
54 |
55 |
56 |
57 |
58 |
--------------------------------------------------------------------------------
/notebook/terminal/__init__.py:
--------------------------------------------------------------------------------
1 | import os
2 |
3 | import terminado
4 | from ..utils import check_version
5 |
6 | if not check_version(terminado.__version__, '0.8.1'):
7 | raise ImportError("terminado >= 0.8.1 required, found %s" % terminado.__version__)
8 |
9 | from ipython_genutils.py3compat import which
10 | from terminado import NamedTermManager
11 | from tornado.log import app_log
12 | from notebook.utils import url_path_join as ujoin
13 | from .handlers import TerminalHandler, TermSocket
14 | from . import api_handlers
15 |
16 | def initialize(webapp, notebook_dir, connection_url, settings):
17 | if os.name == 'nt':
18 | default_shell = 'powershell.exe'
19 | else:
20 | default_shell = which('sh')
21 | shell = settings.get('shell_command',
22 | [os.environ.get('SHELL') or default_shell]
23 | )
24 | terminal_manager = webapp.settings['terminal_manager'] = NamedTermManager(
25 | shell_command=shell,
26 | extra_env={'JUPYTER_SERVER_ROOT': notebook_dir,
27 | 'JUPYTER_SERVER_URL': connection_url,
28 | },
29 | )
30 | terminal_manager.log = app_log
31 | base_url = webapp.settings['base_url']
32 | handlers = [
33 | (ujoin(base_url, r"/terminals/(\w+)"), TerminalHandler),
34 | (ujoin(base_url, r"/terminals/websocket/(\w+)"), TermSocket,
35 | {'term_manager': terminal_manager}),
36 | (ujoin(base_url, r"/api/terminals"), api_handlers.TerminalRootHandler),
37 | (ujoin(base_url, r"/api/terminals/(\w+)"), api_handlers.TerminalHandler),
38 | ]
39 | webapp.add_handlers(".*$", handlers)
40 |
--------------------------------------------------------------------------------
/notebook/auth/__main__.py:
--------------------------------------------------------------------------------
1 | from notebook.auth import passwd
2 | from getpass import getpass
3 | from notebook.config_manager import BaseJSONConfigManager
4 | from jupyter_core.paths import jupyter_config_dir
5 | import argparse
6 | import sys
7 |
8 | def set_password(args):
9 | password = args.password
10 | while not password :
11 | password1 = getpass("" if args.quiet else "Provide password: ")
12 | password_repeat = getpass("" if args.quiet else "Repeat password: ")
13 | if password1 != password_repeat:
14 | print("Passwords do not match, try again")
15 | elif len(password1) < 4:
16 | print("Please provide at least 4 characters")
17 | else:
18 | password = password1
19 |
20 | password_hash = passwd(password)
21 | cfg = BaseJSONConfigManager(config_dir=jupyter_config_dir())
22 | cfg.update('jupyter_notebook_config', {
23 | 'NotebookApp': {
24 | 'password': password_hash,
25 | }
26 | })
27 | if not args.quiet:
28 | print("password stored in config dir: %s" % jupyter_config_dir())
29 |
30 | def main(argv):
31 | parser = argparse.ArgumentParser(argv[0])
32 | subparsers = parser.add_subparsers()
33 | parser_password = subparsers.add_parser('password', help='sets a password for your notebook server')
34 | parser_password.add_argument("password", help="password to set, if not given, a password will be queried for (NOTE: this may not be safe)",
35 | nargs="?")
36 | parser_password.add_argument("--quiet", help="suppress messages", action="store_true")
37 | parser_password.set_defaults(function=set_password)
38 | args = parser.parse_args(argv[1:])
39 | args.function(args)
40 |
41 | if __name__ == "__main__":
42 | main(sys.argv)
--------------------------------------------------------------------------------
/notebook/static/notebook/less/savewidget.less:
--------------------------------------------------------------------------------
1 | span.save_widget {
2 | height: 30px;
3 | margin-top: 4px;
4 | display: flex;
5 | justify-content: flex-start;
6 | align-items: baseline;
7 | width: 50%;
8 | flex: 1;
9 |
10 | span.filename {
11 | height: 100%;
12 | line-height: 1em;
13 | margin-left: @padding-large-horizontal;
14 | border: none;
15 | font-size: 146.5%;
16 | text-overflow: ellipsis;
17 | overflow: hidden;
18 | white-space: nowrap;
19 | &:hover{
20 | // ensure body is lighter on dark palette,
21 | // and vice versa
22 | background-color:contrast(@body-bg, lighten(@body-bg,30%), darken(@body-bg,10%));
23 | }
24 | .corner-all;
25 | }
26 | }
27 |
28 | [dir="rtl"] span.save_widget.pull-left {
29 | .pull-right();
30 | }
31 |
32 | [dir="rtl"] span.save_widget {
33 | span.filename {
34 | margin-left : 0;
35 | margin-right : @padding-large-horizontal;
36 | }
37 | }
38 |
39 | span.checkpoint_status, span.autosave_status {
40 | font-size: small;
41 | white-space: nowrap;
42 | padding: 0 5px;
43 | }
44 |
45 | @media (max-width: @screen-xs-max) {
46 | span.save_widget {
47 | font-size: small;
48 | padding: 0 0 0 5px;
49 | }
50 | span.checkpoint_status, span.autosave_status {
51 | display: none;
52 | }
53 | }
54 |
55 | @media (min-width: @screen-sm-min) and (max-width: @screen-sm-max) {
56 | span.checkpoint_status {
57 | display: none;
58 | }
59 | span.autosave_status {
60 | font-size: x-small;
61 | }
62 | }
63 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/kernel_menu.js:
--------------------------------------------------------------------------------
1 |
2 | casper.notebook_test(function () {
3 | var that = this;
4 |
5 | var menuItems = ['#restart_kernel', '#restart_clear_output', '#restart_run_all', '#shutdown_kernel']
6 | var cancelSelector = ".modal-footer button:first-of-type"
7 |
8 | menuItems.forEach( function(selector) {
9 | that.thenClick(selector);
10 | that.waitForSelector(cancelSelector);
11 | that.thenClick(cancelSelector);
12 |
13 | that.waitWhileSelector(".modal-content", function() {
14 | that.test.assert(true, selector + " confirmation modal pops up and is cancelable");
15 | });
16 | });
17 |
18 | var shutdownSelector = menuItems.pop();
19 | var confirmSelector = ".modal-footer .btn-danger"
20 |
21 | menuItems.forEach( function(selector) {
22 | that.thenClick(shutdownSelector);
23 | that.waitForSelector(confirmSelector);
24 | that.thenClick(confirmSelector);
25 |
26 | // wait for shutdown to go through
27 | that.waitFor(function() { return this.evaluate(function() {
28 | return IPython.notebook.kernel.is_connected() === false;
29 | })});
30 |
31 | // Click on one of the restarts
32 | that.thenClick(selector);
33 |
34 | // Kernel should get connected, no need for confirmation.
35 | that.waitFor(function() { return this.evaluate(function() {
36 | return IPython.notebook.kernel.is_connected() === true;
37 | })});
38 | that.then(function() {
39 | that.test.assert(true, "no confirmation for " + selector + " after session shutdown")
40 | })
41 | });
42 |
43 | });
44 |
45 |
--------------------------------------------------------------------------------
/notebook/static/notebook/js/codemirror-ipython.js:
--------------------------------------------------------------------------------
1 | // IPython mode is just a slightly altered Python Mode with `?` beeing a extra
2 | // single operator. Here we define `ipython` mode in the require `python`
3 | // callback to auto-load python mode, which is more likely not the best things
4 | // to do, but at least the simple one for now.
5 |
6 | (function(mod) {
7 | if (typeof exports == "object" && typeof module == "object"){ // CommonJS
8 | mod(requirejs("codemirror/lib/codemirror"),
9 | requirejs("codemirror/mode/python/python")
10 | );
11 | } else if (typeof define == "function" && define.amd){ // AMD
12 | define(["codemirror/lib/codemirror",
13 | "codemirror/mode/python/python"], mod);
14 | } else {// Plain browser env
15 | mod(CodeMirror);
16 | }
17 | })(function(CodeMirror) {
18 | "use strict";
19 |
20 | CodeMirror.defineMode("ipython", function(conf, parserConf) {
21 | var pythonConf = {};
22 | for (var prop in parserConf) {
23 | if (parserConf.hasOwnProperty(prop)) {
24 | pythonConf[prop] = parserConf[prop];
25 | }
26 | }
27 | pythonConf.name = 'python';
28 | pythonConf.singleOperators = new RegExp("^[\\+\\-\\*/%&|@\\^~<>!\\?]");
29 | if (pythonConf.version === 3) {
30 | pythonConf.identifiers = new RegExp("^[_A-Za-z\u00A1-\uFFFF][_A-Za-z0-9\u00A1-\uFFFF]*");
31 | } else if (pythonConf.version === 2) {
32 | pythonConf.identifiers = new RegExp("^[_A-Za-z][_A-Za-z0-9]*");
33 | }
34 | return CodeMirror.getMode(conf, pythonConf);
35 | }, 'python');
36 |
37 | CodeMirror.defineMIME("text/x-ipython", "ipython");
38 | })
39 |
--------------------------------------------------------------------------------
/notebook/static/notebook/js/celltoolbarpresets/attachments.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | define([
5 | 'notebook/js/celltoolbar',
6 | 'base/js/dialog',
7 | 'base/js/i18n'
8 | ], function(celltoolbar, dialog, i18n) {
9 | "use strict";
10 |
11 | var CellToolbar = celltoolbar.CellToolbar;
12 |
13 | var edit_attachments_dialog = function(cell) {
14 | dialog.edit_attachments({
15 | attachments: cell.attachments,
16 | callback: function(attachments) {
17 | cell.attachments = attachments;
18 | // Force cell refresh
19 | cell.unrender();
20 | cell.render();
21 | },
22 | name: 'Cell',
23 | notebook: cell.notebook,
24 | keyboard_manager: cell.keyboard_manager
25 | });
26 | };
27 |
28 | var add_dialog_button = function(div, cell) {
29 | var button_container = $(div);
30 | var button = $('')
31 | .addClass('btn btn-default btn-xs')
32 | .text(i18n.msg._('Edit Attachments'))
33 | .click( function() {
34 | edit_attachments_dialog(cell);
35 | return false;
36 | });
37 | button_container.append(button);
38 | };
39 |
40 | var register = function(notebook) {
41 | CellToolbar.register_callback('attachments.edit', add_dialog_button);
42 |
43 | var attachments_preset = [];
44 | attachments_preset.push('attachments.edit');
45 |
46 | CellToolbar.register_preset(i18n.msg._('Attachments'), attachments_preset, notebook);
47 |
48 | };
49 | return {'register' : register};
50 | });
51 |
--------------------------------------------------------------------------------
/notebook/static/notebook/js/celltoolbarpresets/default.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | define([
5 | 'notebook/js/celltoolbar',
6 | 'base/js/dialog',
7 | 'base/js/i18n'
8 | ], function(celltoolbar, dialog, i18n) {
9 | "use strict";
10 |
11 | var CellToolbar = celltoolbar.CellToolbar;
12 |
13 | var raw_edit = function (cell) {
14 | dialog.edit_metadata({
15 | md: cell.metadata,
16 | callback: function (md) {
17 | cell.metadata = md;
18 | },
19 | name: i18n.msg._('Cell'),
20 | notebook: this.notebook,
21 | keyboard_manager: this.keyboard_manager
22 | });
23 | };
24 |
25 | var add_raw_edit_button = function(div, cell) {
26 | var button_container = $(div);
27 | var button = $('')
28 | .addClass("btn btn-default btn-xs")
29 | .text(i18n.msg._("Edit Metadata"))
30 | .click( function () {
31 | raw_edit(cell);
32 | return false;
33 | });
34 | button_container.append(button);
35 | };
36 |
37 | var register = function (notebook) {
38 | CellToolbar.register_callback('default.rawedit', add_raw_edit_button);
39 | raw_edit = $.proxy(raw_edit, {
40 | notebook: notebook,
41 | keyboard_manager: notebook.keyboard_manager
42 | });
43 |
44 | var example_preset = [];
45 | example_preset.push('default.rawedit');
46 |
47 | CellToolbar.register_preset(i18n.msg._('Edit Metadata'), example_preset, notebook);
48 | };
49 | return {'register': register};
50 | });
51 |
--------------------------------------------------------------------------------
/notebook/bundler/tarball_bundler.py:
--------------------------------------------------------------------------------
1 | # Copyright (c) Jupyter Development Team.
2 | # Distributed under the terms of the Modified BSD License.
3 | import os
4 | import io
5 | import tarfile
6 | import nbformat
7 |
8 | def _jupyter_bundlerextension_paths():
9 | """Metadata for notebook bundlerextension"""
10 | return [{
11 | # unique bundler name
12 | "name": "tarball_bundler",
13 | # module containing bundle function
14 | "module_name": "notebook.bundler.tarball_bundler",
15 | # human-redable menu item label
16 | "label" : "Notebook Tarball (tar.gz)",
17 | # group under 'deploy' or 'download' menu
18 | "group" : "download",
19 | }]
20 |
21 | def bundle(handler, model):
22 | """Create a compressed tarball containing the notebook document.
23 |
24 | Parameters
25 | ----------
26 | handler : tornado.web.RequestHandler
27 | Handler that serviced the bundle request
28 | model : dict
29 | Notebook model from the configured ContentManager
30 | """
31 | notebook_filename = model['name']
32 | notebook_content = nbformat.writes(model['content']).encode('utf-8')
33 | notebook_name = os.path.splitext(notebook_filename)[0]
34 | tar_filename = '{}.tar.gz'.format(notebook_name)
35 |
36 | info = tarfile.TarInfo(notebook_filename)
37 | info.size = len(notebook_content)
38 |
39 | with io.BytesIO() as tar_buffer:
40 | with tarfile.open(tar_filename, "w:gz", fileobj=tar_buffer) as tar:
41 | tar.addfile(info, io.BytesIO(notebook_content))
42 |
43 | handler.set_attachment_header(tar_filename)
44 | handler.set_header('Content-Type', 'application/gzip')
45 |
46 | # Return the buffer value as the response
47 | handler.finish(tar_buffer.getvalue())
48 |
--------------------------------------------------------------------------------
/notebook/tests/selenium/test_save_as_notebook.py:
--------------------------------------------------------------------------------
1 | from notebook.tests.selenium.utils import wait_for_selector
2 | from selenium.webdriver.common.keys import Keys
3 | from selenium.webdriver.support.ui import WebDriverWait
4 |
5 | def wait_for_rename(browser, nbname, timeout=10):
6 | wait = WebDriverWait(browser, timeout)
7 | def notebook_renamed(browser):
8 | elem = browser.find_element_by_id('notebook_name')
9 | current_name = browser.execute_script('return arguments[0].innerText', elem)
10 | return current_name == nbname
11 | return wait.until(notebook_renamed)
12 |
13 | def save_as(nb):
14 | JS = 'Jupyter.notebook.save_notebook_as()'
15 | return nb.browser.execute_script(JS)
16 |
17 | def get_notebook_name(nb):
18 | JS = 'return Jupyter.notebook.notebook_name'
19 | return nb.browser.execute_script(JS)
20 |
21 | def set_notebook_name(nb, name):
22 | JS = 'Jupyter.notebook.rename("{}")'.format(name)
23 | nb.browser.execute_script(JS)
24 |
25 | def test_save_notebook_as(notebook):
26 | # Set a name for comparison later
27 | set_notebook_name(notebook, name="nb1.ipynb")
28 | wait_for_rename(notebook.browser, "nb1")
29 | assert get_notebook_name(notebook) == "nb1.ipynb"
30 | # Wait for Save As modal, save
31 | save_as(notebook)
32 | wait_for_selector(notebook.browser, '.save-message')
33 | inp = notebook.browser.find_element_by_xpath('//input[@data-testid="save-as"]')
34 | inp.send_keys('new_notebook.ipynb')
35 | inp.send_keys(Keys.RETURN)
36 | wait_for_rename(notebook.browser, "new_notebook")
37 | # Test that the name changed
38 | assert get_notebook_name(notebook) == "new_notebook.ipynb"
39 | # Test that address bar was updated (TODO: get the base url)
40 | assert "new_notebook.ipynb" in notebook.browser.current_url
--------------------------------------------------------------------------------
/notebook/static/notebook/less/notificationarea.less:
--------------------------------------------------------------------------------
1 | #notification_area {
2 | .pull-right();
3 | z-index: 10;
4 | }
5 |
6 | [dir="rtl"] #notification_area {
7 | .pull-left();
8 | }
9 |
10 | .indicator_area {
11 | .pull-right();
12 | color: @navbar-default-link-color;
13 | margin-left: 5px;
14 | margin-right: 5px;
15 | width: 11px;
16 | z-index: 10;
17 | text-align: center;
18 | width: auto;
19 | }
20 |
21 | [dir="rtl"] .indicator_area {
22 | .pull-left();
23 | }
24 |
25 | #kernel_indicator {
26 | .indicator_area();
27 |
28 | border-left: 1px solid;
29 |
30 | .kernel_indicator_name {
31 | padding-left: 5px;
32 | padding-right: 5px;
33 | }
34 | }
35 |
36 | [dir="rtl"] #kernel_indicator {
37 | .pull-left();
38 | border-left: 0;
39 | border-right : 1px solid;
40 | }
41 |
42 | #modal_indicator {
43 | .pull-right();
44 | .indicator_area();
45 | }
46 |
47 | [dir="rtl"] #modal_indicator {
48 | .pull-left();
49 | }
50 |
51 | #readonly-indicator {
52 | .pull-right();
53 | .indicator_area();
54 |
55 | margin-top: 2px;
56 | margin-bottom: 0px;
57 | margin-left: 0px;
58 | margin-right: 0px;
59 |
60 | // Start out hidden.
61 | display: none;
62 | }
63 |
64 | .modal_indicator:before {
65 | .fa-fw();
66 | }
67 |
68 | .edit_mode .modal_indicator:before {
69 | .icon(@fa-var-pencil);
70 | }
71 |
72 | .command_mode .modal_indicator:before {
73 | .icon(' ');
74 | }
75 |
76 | .kernel_idle_icon:before {
77 | .icon(@fa-var-circle-o);
78 | }
79 |
80 | .kernel_busy_icon:before {
81 | .icon(@fa-var-circle);
82 | }
83 |
84 | .kernel_dead_icon:before {
85 | .icon(@fa-var-bomb);
86 | }
87 |
88 | .kernel_disconnected_icon:before {
89 | .icon(@fa-var-chain-broken);
90 | }
91 |
92 |
93 |
--------------------------------------------------------------------------------
/notebook/services/api/handlers.py:
--------------------------------------------------------------------------------
1 | """Tornado handlers for api specifications."""
2 |
3 | # Copyright (c) Jupyter Development Team.
4 | # Distributed under the terms of the Modified BSD License.
5 |
6 | from itertools import chain
7 | import json
8 |
9 | from tornado import gen, web
10 |
11 | from ...base.handlers import IPythonHandler, APIHandler
12 | from notebook._tz import utcfromtimestamp, isoformat
13 |
14 | import os
15 |
16 | class APISpecHandler(web.StaticFileHandler, IPythonHandler):
17 |
18 | def initialize(self):
19 | web.StaticFileHandler.initialize(self, path=os.path.dirname(__file__))
20 |
21 | @web.authenticated
22 | def get(self):
23 | self.log.warning("Serving api spec (experimental, incomplete)")
24 | return web.StaticFileHandler.get(self, 'api.yaml')
25 |
26 | def get_content_type(self):
27 | return 'text/x-yaml'
28 |
29 | class APIStatusHandler(APIHandler):
30 |
31 | _track_activity = False
32 |
33 | @web.authenticated
34 | @gen.coroutine
35 | def get(self):
36 | # if started was missing, use unix epoch
37 | started = self.settings.get('started', utcfromtimestamp(0))
38 | started = isoformat(started)
39 |
40 | kernels = yield gen.maybe_future(self.kernel_manager.list_kernels())
41 | total_connections = sum(k['connections'] for k in kernels)
42 | last_activity = isoformat(self.application.last_activity())
43 | model = {
44 | 'started': started,
45 | 'last_activity': last_activity,
46 | 'kernels': len(kernels),
47 | 'connections': total_connections,
48 | }
49 | self.finish(json.dumps(model, sort_keys=True))
50 |
51 | default_handlers = [
52 | (r"/api/spec.yaml", APISpecHandler),
53 | (r"/api/status", APIStatusHandler),
54 | ]
55 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/pager.less:
--------------------------------------------------------------------------------
1 | div#pager {
2 | background-color: @body-bg;
3 | font-size: @notebook_font_size;
4 | line-height: @notebook_line_height;
5 | overflow: hidden;
6 | display: none;
7 | position: fixed;
8 | bottom: 0px;
9 | width: 100%;
10 | max-height: 50%;
11 | padding-top: 8px;
12 |
13 | .box-shadow(@global-shadow);
14 |
15 | /* Display over codemirror */
16 | z-index: 100;
17 |
18 | /* Hack which prevents jquery ui resizable from changing top. */
19 | top: auto !important;
20 |
21 | pre {
22 | line-height: @code_line_height;
23 | color: @text-color;
24 | background-color: @cell_background;
25 | padding: @code_padding;
26 | }
27 |
28 | #pager-button-area {
29 | position: absolute;
30 | top: 8px;
31 | right: 20px;
32 | }
33 |
34 | #pager-contents {
35 | position: relative;
36 | overflow: auto;
37 | width: 100%;
38 | height: 100%;
39 |
40 | #pager-container {
41 | position: relative;
42 | padding: 15px 0px;
43 | .border-box-sizing();
44 | }
45 | }
46 |
47 | .ui-resizable-handle {
48 | top: 0px;
49 | height: 8px;
50 | background: @cell_background;
51 | border-top: 1px solid @light_border_color;
52 | border-bottom: 1px solid @light_border_color;
53 |
54 | /* This injects handle bars (a short, wide = symbol) for
55 | the resize handle. */
56 | &::after {
57 | content: '';
58 |
59 | top: 2px;
60 | left: 50%;
61 | height: 3px;
62 | width: 30px;
63 | margin-left: -15px;
64 | position: absolute;
65 |
66 | border-top: 1px solid @light_border_color;
67 | }
68 | }
69 | }
70 |
--------------------------------------------------------------------------------
/docs/source/ui_components.rst:
--------------------------------------------------------------------------------
1 | User interface components
2 | =========================
3 |
4 | When opening bug reports or sending emails to the Jupyter mailing list, it is
5 | useful to know the names of different UI components so that other developers
6 | and users have an easier time helping you diagnose your problems. This section
7 | will familiarize you with the names of UI elements within the Notebook and the
8 | different Notebook modes.
9 |
10 | Notebook Dashboard
11 | -------------------
12 |
13 | When you launch ``jupyter notebook`` the first page that you encounter is the
14 | Notebook Dashboard.
15 |
16 | .. image:: ./_static/images/jupyter-notebook-dashboard.png
17 |
18 | Notebook Editor
19 | ---------------
20 |
21 | Once you've selected a Notebook to edit, the Notebook will open in the Notebook
22 | Editor.
23 |
24 | .. image:: ./_static/images/jupyter-notebook-default.png
25 |
26 | Interactive User Interface Tour of the Notebook
27 | -----------------------------------------------
28 |
29 | If you would like to learn more about the specific elements within the Notebook
30 | Editor, you can go through the user interface tour by selecting *Help* in the
31 | menubar then selecting *User Interface Tour*.
32 |
33 | Edit Mode and Notebook Editor
34 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
35 |
36 | When a cell is in edit mode, the Cell Mode Indicator will change to reflect
37 | the cell's state. This state is indicated by a small pencil icon on the
38 | top right of the interface. When the cell is in command mode, there is no
39 | icon in that location.
40 |
41 | .. image:: ./_static/images/jupyter-notebook-edit.png
42 |
43 | File Editor
44 | -----------
45 |
46 | Now let's say that you've chosen to open a Markdown file instead of a Notebook
47 | file whilst in the Notebook Dashboard. If so, the file will be opened in the
48 | File Editor.
49 |
50 | .. image:: ./_static/images/jupyter-file-editor.png
51 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/shutdown.js:
--------------------------------------------------------------------------------
1 | //
2 | // Test shutdown of a kernel.
3 | //
4 | casper.notebook_test(function () {
5 | // XXX: test.begin allows named sections but requires casperjs 1.1.0-DEV.
6 | // We will put it back into place when the next version of casper is
7 | // released. Following that, all instances of this.test can be changed
8 | // to just test.
9 | //this.test.begin("shutdown tests (notebook)", 2, function(test) {
10 |
11 | // Our shutdown test closes the browser window, which will delete the
12 | // casper browser object, and the rest of the test suite will fail with
13 | // errors that look like:
14 | //
15 | // "Error: cannot access member `evaluate' of deleted QObject"
16 | //
17 | // So what we do here is make a quick popup window, and run the test inside
18 | // of it.
19 | this.then(function() {
20 | this.evaluate(function(url){
21 | window.open(url);
22 | }, {url : this.getCurrentUrl()});
23 | })
24 |
25 | this.waitForPopup('');
26 | this.withPopup('', function () {
27 | this.thenEvaluate(function () {
28 | $('#close_and_halt').click();
29 | });
30 |
31 | this.thenEvaluate(function () {
32 | var cell = IPython.notebook.get_cell(0);
33 | cell.set_text('a=10; print(a)');
34 | cell.execute();
35 | });
36 |
37 | this.then(function () {
38 | var outputs = this.evaluate(function() {
39 | return IPython.notebook.get_cell(0).output_area.outputs;
40 | })
41 | this.test.assertEquals(outputs.length, 0, "after shutdown: no execution results");
42 | this.test.assertNot(this.kernel_running(),
43 | 'after shutdown: IPython.notebook.kernel.running is false ');
44 | });
45 | });
46 |
47 | //}); // end of test.begin
48 | });
49 |
50 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/celltoolbar.less:
--------------------------------------------------------------------------------
1 | /* CSS for the cell toolbar */
2 | @celltoolbar-height: 29px;
3 |
4 | .celltoolbar {
5 | border: thin solid #CFCFCF;
6 | border-bottom: none;
7 | background : #EEE;
8 | border-radius : @border-radius-base @border-radius-base 0px 0px;
9 | width:100%;
10 | -webkit-box-pack: end;
11 | height: @celltoolbar-height;
12 | padding-right: 4px;
13 | .hbox();
14 | .end();
15 | // safari fix, we cannot use -webkit-flex on hbox
16 | // and vbox either or all css get borked
17 | // cf https://github.com/jupyter/nbgrader/issues/394
18 | display: -webkit-flex;
19 | @media print{
20 | display: none;
21 | }
22 | }
23 |
24 |
25 | .ctb_hideshow {
26 | display:none;
27 | vertical-align:bottom;
28 | }
29 |
30 | /* ctb_show is added to the ctb_hideshow div to show the cell toolbar.
31 | Cell toolbars are only shown when the ctb_global_show class is also set.
32 | */
33 | .ctb_global_show .ctb_show.ctb_hideshow {
34 | display: block;
35 | }
36 |
37 | .ctb_global_show .ctb_show + .input_area,
38 | .ctb_global_show .ctb_show + div.text_cell_input,
39 | .ctb_global_show .ctb_show ~ div.text_cell_render {
40 | border-top-right-radius: 0px;
41 | border-top-left-radius: 0px;
42 | }
43 |
44 | .ctb_global_show .ctb_show ~ div.text_cell_render {
45 | // add border to rendered markdown cells
46 | border: @border_width solid @light_border_color;
47 | }
48 |
49 | .celltoolbar {
50 | font-size: 87%;
51 | padding-top: 3px;
52 | }
53 |
54 | .celltoolbar select {
55 | .form-control();
56 | .input-sm();
57 | // undo some of the sizing caused by the above mixins
58 | width: inherit;
59 | font-size: inherit;
60 | height: 22px;
61 | padding: 0px;
62 |
63 | display: inline-block;
64 |
65 | }
66 |
67 | .celltoolbar label {
68 | margin-left: 5px;
69 | margin-right: 5px;
70 | }
71 |
--------------------------------------------------------------------------------
/docs/source/development_release.rst:
--------------------------------------------------------------------------------
1 | .. _notebook_release:
2 |
3 | Making a Notebook release
4 | =========================
5 |
6 | This document guides a contributor through creating a release of the Jupyter
7 | notebook.
8 |
9 | Check installed tools
10 | ---------------------
11 |
12 | Review ``CONTRIBUTING.rst``. Make sure all the tools needed to generate the
13 | minified JavaScript and CSS files are properly installed.
14 |
15 | Clean the repository
16 | --------------------
17 |
18 | You can remove all non-tracked files with:
19 |
20 | .. code:: bash
21 |
22 | git clean -xfdi
23 |
24 | This would ask you for confirmation before removing all untracked files. Make
25 | sure the ``dist/`` folder is clean and avoid stale build from
26 | previous attempts.
27 |
28 | Create the release
29 | ------------------
30 |
31 | #. Update version number in ``notebook/_version.py``.
32 |
33 | #. Run this command:
34 |
35 | .. code:: bash
36 |
37 | python setup.py jsversion
38 |
39 | It will modify (at least) ``notebook/static/base/js/namespace.js`` which
40 | makes the notebook version available from within JavaScript.
41 |
42 | #. Commit and tag the release with the current version number:
43 |
44 | .. code:: bash
45 |
46 | git commit -am "release $VERSION"
47 | git tag $VERSION
48 |
49 | #. You are now ready to build the ``sdist`` and ``wheel``:
50 |
51 | .. code:: bash
52 |
53 | python setup.py sdist
54 | python setup.py bdist_wheel
55 |
56 | #. You can now test the ``wheel`` and the ``sdist`` locally before uploading
57 | to PyPI. Make sure to use `twine `_ to
58 | upload the archives over SSL.
59 |
60 | .. code:: bash
61 |
62 | twine upload dist/*
63 |
64 | #. If all went well, change the ``notebook/_version.py`` back adding the
65 | ``.dev`` suffix.
66 |
67 | #. Push directly on master, not forgetting to push ``--tags`` too.
68 |
--------------------------------------------------------------------------------
/notebook/tests/selenium/quick_selenium.py:
--------------------------------------------------------------------------------
1 | """Utilities for driving Selenium interactively to develop tests.
2 |
3 | These are not used in the tests themselves - rather, the developer writing tests
4 | can use them to experiment with Selenium.
5 | """
6 | from selenium.webdriver import Firefox
7 |
8 | from notebook.tests.selenium.utils import Notebook
9 | from notebook.notebookapp import list_running_servers
10 |
11 | class NoServerError(Exception):
12 |
13 | def __init__(self, message):
14 | self.message = message
15 |
16 | def quick_driver(lab=False):
17 | """Quickly create a selenium driver pointing at an active noteboook server.
18 |
19 | Usage example:
20 |
21 | from notebook.tests.selenium.quick_selenium import quick_driver
22 | driver = quick_driver
23 |
24 | Note: you need to manually close the driver that opens with driver.quit()
25 | """
26 | try:
27 | server = list(list_running_servers())[0]
28 | except IndexError as e:
29 | raise NoServerError('You need a server running before you can run '
30 | 'this command')
31 | driver = Firefox()
32 | auth_url = '{url}?token={token}'.format(**server)
33 | driver.get(auth_url)
34 |
35 | # If this redirects us to a lab page and we don't want that;
36 | # then we need to redirect ourselves to the classic notebook view
37 | if driver.current_url.endswith('/lab') and not lab:
38 | driver.get(driver.current_url.rstrip('lab')+'tree')
39 | return driver
40 |
41 |
42 | def quick_notebook():
43 | """Quickly create a new classic notebook in a selenium driver
44 |
45 |
46 | Usage example:
47 |
48 | from notebook.tests.selenium.quick_selenium import quick_notebook
49 | nb = quick_notebook()
50 |
51 | Note: you need to manually close the driver that opens with nb.browser.quit()
52 | """
53 | return Notebook.new_notebook(quick_driver())
54 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/codecell.less:
--------------------------------------------------------------------------------
1 | div.code_cell {
2 | /* avoid page breaking on code cells when printing */
3 | @media print {
4 | page-break-inside: avoid;
5 | }
6 | }
7 |
8 | /* any special styling for code cells that are currently running goes here */
9 | div.code_cell.running {
10 | }
11 |
12 | div.input {
13 | page-break-inside: avoid;
14 | .hbox();
15 | }
16 |
17 | @media (max-width: @screen-xs-min) {
18 | // move prompts above code on small screens
19 | div.input {
20 | .vbox();
21 | }
22 | }
23 |
24 | /* input_area and input_prompt must match in top border and margin for alignment */
25 | div.input_prompt {
26 | color: @input_prompt_color;
27 | border-top: 1px solid transparent;
28 | }
29 |
30 | .run_this_cell {
31 | visibility: hidden;
32 | cursor: pointer;
33 | color: #333;
34 | padding-top: 5px;
35 | padding-bottom: 5px;
36 | padding-left: 1ex;
37 | padding-right: 1ex;
38 | width: 1ex;
39 | }
40 |
41 | div.code_cell div.input_prompt {
42 | min-width: 11ex;
43 | }
44 |
45 | div.code_cell:hover div.input .run_this_cell {
46 | visibility: visible;
47 | }
48 |
49 | @media (-moz-touch-enabled: 1), (any-pointer: coarse) {
50 | .run_this_cell {
51 | visibility: visible;
52 | }
53 | }
54 |
55 | // The styles related to div.highlight are for nbconvert HTML output only. This works
56 | // because the .highlight div isn't present in the live notebook. We could put this into
57 | // nbconvert, but it easily falls out of sync, can't use our less variables and doesn't
58 | // help the basic template when paired with our CSS.
59 |
60 | div.input_area > div.highlight {
61 | margin: @code_padding;
62 | border: none;
63 | padding: 0px;
64 | background-color: transparent;
65 | }
66 |
67 | div.input_area > div.highlight > pre {
68 | margin: 0px;
69 | border: none;
70 | padding: 0px;
71 | background-color: transparent;
72 | }
73 |
--------------------------------------------------------------------------------
/notebook/log.py:
--------------------------------------------------------------------------------
1 | #-----------------------------------------------------------------------------
2 | # Copyright (c) Jupyter Development Team
3 | #
4 | # Distributed under the terms of the BSD License. The full license is in
5 | # the file COPYING, distributed as part of this software.
6 | #-----------------------------------------------------------------------------
7 |
8 | import json
9 | from tornado.log import access_log
10 | from .metrics import prometheus_log_method
11 |
12 | def log_request(handler):
13 | """log a bit more information about each request than tornado's default
14 |
15 | - move static file get success to debug-level (reduces noise)
16 | - get proxied IP instead of proxy IP
17 | - log referer for redirect and failed requests
18 | - log user-agent for failed requests
19 | """
20 | status = handler.get_status()
21 | request = handler.request
22 | if status < 300 or status == 304:
23 | # Successes (or 304 FOUND) are debug-level
24 | log_method = access_log.debug
25 | elif status < 400:
26 | log_method = access_log.info
27 | elif status < 500:
28 | log_method = access_log.warning
29 | else:
30 | log_method = access_log.error
31 |
32 | request_time = 1000.0 * handler.request.request_time()
33 | ns = dict(
34 | status=status,
35 | method=request.method,
36 | ip=request.remote_ip,
37 | uri=request.uri,
38 | request_time=request_time,
39 | )
40 | msg = "{status} {method} {uri} ({ip}) {request_time:.2f}ms"
41 | if status >= 400:
42 | # log bad referers
43 | ns['referer'] = request.headers.get('Referer', 'None')
44 | msg = msg + ' referer={referer}'
45 | if status >= 500 and status != 502:
46 | # log all headers if it caused an error
47 | log_method(json.dumps(dict(request.headers), indent=2))
48 | log_method(msg.format(**ns))
49 | prometheus_log_method(handler)
50 |
--------------------------------------------------------------------------------
/notebook/static/notebook/js/celltoolbarpresets/slideshow.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | define([
5 | 'notebook/js/celltoolbar',
6 | 'base/js/i18n'
7 | ], function(celltoolbar, i18n) {
8 | "use strict";
9 |
10 | var CellToolbar = celltoolbar.CellToolbar;
11 | var slideshow_preset = [];
12 |
13 | var select_type = CellToolbar.utils.select_ui_generator([
14 | ["-" ,"-" ],
15 | [i18n.msg._("Slide") ,"slide" ],
16 | [i18n.msg._("Sub-Slide") ,"subslide" ],
17 | [i18n.msg._("Fragment") ,"fragment" ],
18 | [i18n.msg._("Skip") ,"skip" ],
19 | [i18n.msg._("Notes") ,"notes" ],
20 | ],
21 | // setter
22 | function(cell, value){
23 | // we check that the slideshow namespace exist and create it if needed
24 | if (cell.metadata.slideshow === undefined){cell.metadata.slideshow = {};}
25 | // set the value
26 | cell.metadata.slideshow.slide_type = value;
27 | },
28 | //geter
29 | function(cell){ var ns = cell.metadata.slideshow;
30 | // if the slideshow namespace does not exist return `undefined`
31 | // (will be interpreted as `false` by checkbox) otherwise
32 | // return the value
33 | return (ns === undefined)? undefined: ns.slide_type;
34 | },
35 | i18n.msg._("Slide Type"));
36 |
37 | var register = function (notebook) {
38 | CellToolbar.register_callback('slideshow.select',select_type);
39 | slideshow_preset.push('slideshow.select');
40 |
41 | CellToolbar.register_preset(i18n.msg._('Slideshow'),slideshow_preset, notebook);
42 | };
43 | return {'register': register};
44 | });
45 |
--------------------------------------------------------------------------------
/notebook/static/base/less/variables.less:
--------------------------------------------------------------------------------
1 | // Our customizations to bootstrap go here.
2 |
3 | @black: #000;
4 | @text-color: @black;
5 | @font-size-base: 13px;
6 | @font-family-monospace: monospace; // to allow user to customize their fonts
7 | @navbar-height: 30px;
8 | @breadcrumb-color: darken(@border_color, 30%);
9 | @blockquote-font-size: inherit;
10 | @modal-inner-padding: 15px;
11 | @grid-float-breakpoint: 541px;
12 | @screen-xs: 540px;
13 | @logo_height: 28px;
14 | @border-radius-small: 1px;
15 | @border-radius-base: 2px;
16 | @border-radius-large: 3px;
17 | @grid-gutter-width: 0px;
18 | @kbd-color: #888;
19 | @kbd-bg: transparent;
20 |
21 | @icon-font-path: "../components/bootstrap/fonts/";
22 |
23 | // Disable modal slide-in from top animation.
24 | .modal {
25 | &.fade .modal-dialog {
26 | .translate(0, 0);
27 | }
28 | }
29 |
30 | // Set the default code color.
31 | code {
32 | color: @black; // default code color in bootstrap is #d14 (crimson / amaranth)
33 | }
34 |
35 | // Override bootstrap pre element styling.
36 | pre {
37 | // bootstrap has pre defaults that we don't want to inherit.
38 | // start pre tag defaults based on the surrounding context instead.
39 | font-size: inherit;
40 | line-height: inherit;
41 | }
42 |
43 | // Disable bold labels in BS3
44 | label {
45 | font-weight: normal;
46 | }
47 |
48 | // Our own global variables for all pages go here
49 | @global-shadow: 0px 0px 12px 1px rgba(87, 87, 87, 0.2);
50 | @global-shadow-dark: 0px 0px 12px 1px rgba(87, 87, 87, 0.4);
51 | @page-header-padding: 20px;
52 | /* Make the page background atleast 100% the height of the view port */
53 | @page-backdrop-height: 100vh;
54 | /* Make the page itself atleast 70% the height of the view port */
55 | @page-min-height: 0;
56 | @page-backdrop-color: #EEE;
57 | @page-color: @body-bg;
58 | @page-padding: 15px;
59 |
60 | // preven container size to jump from 768px to 720px
61 | // when window width go from 768 to 769+
62 | @container-sm : @screen-sm-min;
63 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/ansicolors.less:
--------------------------------------------------------------------------------
1 | /* CSS font colors for translated ANSI escape sequences */
2 |
3 | .ansicolors(@name, @normal, @intense) {
4 | .ansi-@{name}-fg { color: @normal; }
5 | .ansi-@{name}-bg { background-color: @normal; }
6 | .ansi-@{name}-intense-fg { color: @intense; }
7 | .ansi-@{name}-intense-bg { background-color: @intense; }
8 | }
9 |
10 | /* The color values are a mix of
11 | http://www.xcolors.net/dl/baskerville-ivorylight and
12 | http://www.xcolors.net/dl/euphrasia */
13 |
14 | .ansicolors(black, #3E424D, #282C36);
15 | .ansicolors(red, #E75C58, #B22B31);
16 | .ansicolors(green, #00A250, #007427);
17 | .ansicolors(yellow, #DDB62B, #B27D12);
18 | .ansicolors(blue, #208FFB, #0065CA);
19 | .ansicolors(magenta, #D160C4, #A03196);
20 | .ansicolors(cyan, #60C6C8, #258F8F);
21 | .ansicolors(white, #C5C1B4, #A1A6B2);
22 |
23 | .ansi-default-inverse-fg { color: #FFFFFF; }
24 | .ansi-default-inverse-bg { background-color: #000000; }
25 |
26 | .ansi-bold { font-weight: bold; }
27 | .ansi-underline { text-decoration: underline; }
28 |
29 | /* The following styles are deprecated an will be removed in a future version */
30 |
31 | .ansibold {font-weight: bold;}
32 | .ansi-inverse { outline: 0.5px dotted; }
33 |
34 | /* use dark versions for foreground, to improve visibility */
35 | .ansiblack {color: black;}
36 | .ansired {color: darkred;}
37 | .ansigreen {color: darkgreen;}
38 | .ansiyellow {color: #c4a000;}
39 | .ansiblue {color: darkblue;}
40 | .ansipurple {color: darkviolet;}
41 | .ansicyan {color: steelblue;}
42 | .ansigray {color: gray;}
43 |
44 | /* and light for background, for the same reason */
45 | .ansibgblack {background-color: black;}
46 | .ansibgred {background-color: red;}
47 | .ansibggreen {background-color: green;}
48 | .ansibgyellow {background-color: yellow;}
49 | .ansibgblue {background-color: blue;}
50 | .ansibgpurple {background-color: magenta;}
51 | .ansibgcyan {background-color: cyan;}
52 | .ansibggray {background-color: gray;}
53 |
--------------------------------------------------------------------------------
/notebook/static/notebook/less/textcell.less:
--------------------------------------------------------------------------------
1 | div.text_cell {
2 | .hbox();
3 | }
4 | @media (max-width: @screen-xs-min) {
5 | // remove prompt indentation on small screens
6 | div.text_cell > div.prompt {
7 | display: none;
8 | }
9 | }
10 |
11 | div.text_cell_render {
12 | /*font-family: "Helvetica Neue", Arial, Helvetica, Geneva, sans-serif;*/
13 | outline: none;
14 | resize: none;
15 | width: inherit;
16 | border-style: none;
17 | padding: 0.5em 0.5em 0.5em @code_padding;
18 | color: @text-color;
19 | .border-box-sizing();
20 | }
21 |
22 | a.anchor-link:link {
23 | text-decoration: none;
24 | padding: 0px 20px;
25 | visibility: hidden;
26 | }
27 |
28 | h1,h2,h3,h4,h5,h6 {
29 | &:hover .anchor-link {
30 | visibility: visible;
31 | }
32 | }
33 |
34 | .text_cell.rendered .input_area {
35 | display: none;
36 | }
37 |
38 | .text_cell.rendered .rendered_html {
39 | overflow-x: auto;
40 |
41 | // Content in the y direction should cause the rendered content to grow,
42 | // the overflow-x: auto causes chrome to assume the same of y, so we need
43 | // to tell it explicitly otherwise.
44 | overflow-y: hidden;
45 | }
46 |
47 | .text_cell.rendered .rendered_html {
48 | tr, th, td {
49 | max-width: none;
50 | }
51 | }
52 |
53 | .text_cell.unrendered .text_cell_render {
54 | display:none;
55 | }
56 |
57 | .text_cell .dropzone .input_area {
58 | border: 2px dashed #bababa;
59 | margin: -1px;
60 | }
61 |
62 | .cm-header-1,
63 | .cm-header-2,
64 | .cm-header-3,
65 | .cm-header-4,
66 | .cm-header-5,
67 | .cm-header-6 {
68 | font-weight: bold;
69 | font-family: @font-family-sans-serif;
70 | }
71 |
72 | .cm-header-1 { font-size: 185.7%; }
73 | .cm-header-2 { font-size: 157.1%; }
74 | .cm-header-3 { font-size: 128.6%; }
75 | .cm-header-4 { font-size: 110%; }
76 | .cm-header-5 {
77 | font-size: 100%;
78 | font-style: italic;
79 | }
80 | .cm-header-6 {
81 | font-size: 100%;
82 | font-style: italic;
83 | }
84 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/buffering.js:
--------------------------------------------------------------------------------
1 | //
2 | // Test buffering for execution requests.
3 | //
4 | casper.notebook_test(function () {
5 | this.then(function() {
6 | // make sure there are at least three cells for the tests below.
7 | this.append_cell();
8 | this.append_cell();
9 | this.append_cell();
10 | })
11 |
12 | this.thenEvaluate(function () {
13 | IPython.notebook.kernel.stop_channels();
14 | var cell = IPython.notebook.get_cell(0);
15 | cell.set_text('a=10; print(a)');
16 | IPython.notebook.execute_cells([0]);
17 | IPython.notebook.kernel.reconnect(1);
18 | });
19 |
20 | this.wait_for_output(0);
21 |
22 | this.then(function () {
23 | var result = this.get_output_cell(0);
24 | this.test.assertEquals(result.text, '10\n', 'kernels buffer messages if connection is down');
25 | });
26 |
27 | this.thenEvaluate(function () {
28 | var cell = IPython.notebook.get_cell(0);
29 | var cellplus = IPython.notebook.get_cell(1);
30 | var cellprint = IPython.notebook.get_cell(2);
31 | cell.set_text('k=1');
32 | cellplus.set_text('k+=1');
33 | cellprint.set_text('k*=2')
34 |
35 | IPython.notebook.kernel.stop_channels();
36 |
37 | // Repeated execution of cell queued up in the kernel executes
38 | // each execution request in order.
39 | IPython.notebook.execute_cells([0]);
40 | IPython.notebook.execute_cells([2]);
41 | IPython.notebook.execute_cells([1]);
42 | IPython.notebook.execute_cells([1]);
43 | IPython.notebook.execute_cells([1]);
44 | cellprint.set_text('print(k)')
45 | IPython.notebook.execute_cells([2]);
46 |
47 | IPython.notebook.kernel.reconnect(1);
48 | });
49 |
50 | this.wait_for_output(2);
51 |
52 | this.then(function () {
53 | var result = this.get_output_cell(2);
54 | this.test.assertEquals(result.text, '5\n', 'kernels send buffered messages in order');
55 | });
56 | });
57 |
--------------------------------------------------------------------------------
/docs/source/links.txt:
--------------------------------------------------------------------------------
1 | .. This (-*- rst -*-) format file contains commonly used link targets
2 | and name substitutions. It may be included in many files,
3 | therefore it should only contain link targets and name
4 | substitutions. Try grepping for "^\.\. _" to find plausible
5 | candidates for this list.
6 |
7 | NOTE: this file must have an extension *opposite* to that of the main reST
8 | files in the manuals, so that we can include it with ".. include::"
9 | directives, but without triggering warnings from Sphinx for not being listed
10 | in any toctree. Since IPython uses .txt for the main files, this one will
11 | use .rst.
12 |
13 | NOTE: reST targets are
14 | __not_case_sensitive__, so only one target definition is needed for
15 | ipython, IPython, etc.
16 |
17 | NOTE: Some of these were taken from the nipy links compendium.
18 |
19 | .. Main Jupyter notebook links
20 |
21 | .. _Notebook Basics: notebook_p2_
22 | .. _notebook_p2: https://nbviewer.jupyter.org/github/jupyter/notebook/blob/master/docs/source/examples/Notebook/Notebook%20Basics.ipynb
23 |
24 | .. _Running Code in the Jupyter Notebook: notebook_p1_
25 | .. _notebook_p1: https://nbviewer.jupyter.org/github/jupyter/notebook/blob/master/docs/source/examples/Notebook/Running%20Code.ipynb
26 |
27 | .. Other python projects
28 | .. _matplotlib: https://matplotlib.org
29 | .. _nbviewer: https://nbviewer.jupyter.org
30 | .. _nbconvert: https://nbconvert.readthedocs.io/en/latest/
31 |
32 | .. Other tools and projects
33 | .. _Markdown: https://daringfireball.net/projects/markdown/syntax
34 |
35 | .. _Rich Output: notebook_p5_
36 | .. _notebook_p5: https://nbviewer.jupyter.org/github/ipython/ipython/blob/master/examples/IPython%20Kernel/Rich%20Output.ipynb
37 |
38 | .. _Plotting with Matplotlib: notebook_p3_
39 | .. _notebook_p3: https://nbviewer.jupyter.org/github/ipython/ipython/blob/master/examples/IPython%20Kernel/Plotting%20in%20the%20Notebook.ipynb
40 |
41 | .. _Working with Markdown Cells: https://nbviewer.jupyter.org/github/jupyter/notebook/blob/master/docs/source/examples/Notebook/Working%20With%20Markdown%20Cells.ipynb
42 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/dualmode_arrows.js:
--------------------------------------------------------------------------------
1 |
2 | // Test
3 | casper.notebook_test(function () {
4 | var a = 'print("a")';
5 | var index = this.append_cell(a);
6 | this.execute_cell_then(index);
7 |
8 | var b = 'print("b")';
9 | index = this.append_cell(b);
10 | this.execute_cell_then(index);
11 |
12 | var c = 'print("c")';
13 | index = this.append_cell(c);
14 | this.execute_cell_then(index);
15 |
16 | this.then(function () {
17 |
18 | // Up and down in command mode
19 | this.select_cell(3);
20 | this.trigger_keydown('j');
21 | this.validate_notebook_state('j at end of notebook', 'command', 3);
22 | this.trigger_keydown('down');
23 | this.validate_notebook_state('down at end of notebook', 'command', 3);
24 | this.trigger_keydown('up');
25 | this.validate_notebook_state('up', 'command', 2);
26 | this.select_cell(0);
27 | this.validate_notebook_state('select 0', 'command', 0);
28 | this.trigger_keydown('k');
29 | this.validate_notebook_state('k at top of notebook', 'command', 0);
30 | this.trigger_keydown('up');
31 | this.validate_notebook_state('up at top of notebook', 'command', 0);
32 | this.trigger_keydown('down');
33 | this.validate_notebook_state('down', 'command', 1);
34 |
35 | // Up and down in edit mode
36 | this.click_cell_editor(3);
37 | this.validate_notebook_state('click cell 3', 'edit', 3);
38 | this.trigger_keydown('down');
39 | this.validate_notebook_state('down at end of notebook', 'edit', 3);
40 | this.set_cell_editor_cursor(3, 0, 0);
41 | this.trigger_keydown('up');
42 | this.validate_notebook_state('up', 'edit', 2);
43 | this.click_cell_editor(0);
44 | this.validate_notebook_state('click 0', 'edit', 0);
45 | this.trigger_keydown('up');
46 | this.validate_notebook_state('up at top of notebook', 'edit', 0);
47 | this.set_cell_editor_cursor(0, 0, 10);
48 | this.trigger_keydown('down');
49 | this.validate_notebook_state('down', 'edit', 1);
50 | });
51 | });
52 |
--------------------------------------------------------------------------------
/notebook/tests/selenium/test_dualmode_insertcell.py:
--------------------------------------------------------------------------------
1 | from selenium.webdriver.common.keys import Keys
2 | from .utils import shift
3 |
4 | def test_insert_cell(notebook):
5 | a = "print('a')"
6 | b = "print('b')"
7 | c = "print('c')"
8 |
9 | notebook.edit_cell(index=0, content=a)
10 | notebook.append(b, c)
11 | notebook.to_command_mode()
12 |
13 | assert notebook.get_cells_contents() == [a, b, c]
14 |
15 | notebook.to_command_mode()
16 | notebook.focus_cell(2)
17 | notebook.convert_cell_type(2, "markdown")
18 |
19 | # insert code cell above
20 | notebook.current_cell.send_keys("a")
21 | assert notebook.get_cell_contents(2) == ""
22 | assert notebook.get_cell_type(2) == "code"
23 | assert len(notebook.cells) == 4
24 |
25 | # insert code cell below
26 | notebook.current_cell.send_keys("b")
27 | assert notebook.get_cell_contents(2) == ""
28 | assert notebook.get_cell_contents(3) == ""
29 | assert notebook.get_cell_type(3) == "code"
30 | assert len(notebook.cells) == 5
31 |
32 | notebook.edit_cell(index=1, content="cell1")
33 | notebook.focus_cell(1)
34 | notebook.current_cell.send_keys("a")
35 | assert notebook.get_cell_contents(1) == ""
36 | assert notebook.get_cell_contents(2) == "cell1"
37 |
38 | notebook.edit_cell(index=1, content='cell1')
39 | notebook.edit_cell(index=2, content='cell2')
40 | notebook.edit_cell(index=3, content='cell3')
41 | notebook.focus_cell(2)
42 | notebook.current_cell.send_keys("b")
43 | assert notebook.get_cell_contents(1) == "cell1"
44 | assert notebook.get_cell_contents(2) == "cell2"
45 | assert notebook.get_cell_contents(3) == ""
46 | assert notebook.get_cell_contents(4) == "cell3"
47 |
48 | # insert above multiple selected cells
49 | notebook.focus_cell(1)
50 | shift(notebook.browser, Keys.DOWN)
51 | notebook.current_cell.send_keys('a')
52 |
53 | # insert below multiple selected cells
54 | notebook.focus_cell(2)
55 | shift(notebook.browser, Keys.DOWN)
56 | notebook.current_cell.send_keys('b')
57 | assert notebook.get_cells_contents()[1:5] == ["", "cell1", "cell2", ""]
58 |
--------------------------------------------------------------------------------
/tools/build-main.js:
--------------------------------------------------------------------------------
1 | // build main.min.js
2 | // spawned by gulp to allow parallelism
3 |
4 | var rjs = require('requirejs').optimize;
5 |
6 | var name = process.argv[2];
7 |
8 | var rjs_config = {
9 | name: name + '/js/main',
10 | out: './notebook/static/' + name + '/js/main.min.js',
11 | baseUrl: 'notebook/static',
12 | preserveLicenseComments: false, // license comments conflict with sourcemap generation
13 | generateSourceMaps: true,
14 | optimize: "none",
15 | paths: {
16 | underscore : 'components/underscore/underscore-min',
17 | backbone : 'components/backbone/backbone-min',
18 | jed: 'components/jed/jed',
19 | jquery: 'components/jquery/jquery.min',
20 | json: 'components/requirejs-plugins/src/json',
21 | text: 'components/requirejs-text/text',
22 | bootstrap: 'components/bootstrap/js/bootstrap.min',
23 | bootstraptour: 'components/bootstrap-tour/build/js/bootstrap-tour.min',
24 | "jquery-ui": 'components/jquery-ui/ui/minified/jquery-ui.min',
25 | moment: 'components/moment/min/moment-with-locales',
26 | codemirror: 'components/codemirror',
27 | xterm: 'components/xterm.js/index',
28 | 'xtermjs-fit': 'components/xterm.js-fit/index',
29 | typeahead: 'components/jquery-typeahead/dist/jquery.typeahead',
30 | contents: 'empty:',
31 | custom: 'empty:',
32 | },
33 | map: { // for backward compatibility
34 | "*": {
35 | "jqueryui": "jquery-ui",
36 | }
37 | },
38 | shim: {
39 | typeahead: {
40 | deps: ["jquery"],
41 | exports: "typeahead"
42 | },
43 | underscore: {
44 | exports: '_'
45 | },
46 | backbone: {
47 | deps: ["underscore", "jquery"],
48 | exports: "Backbone"
49 | },
50 | bootstrap: {
51 | deps: ["jquery"],
52 | exports: "bootstrap"
53 | },
54 | bootstraptour: {
55 | deps: ["bootstrap"],
56 | exports: "Tour"
57 | },
58 | "jquery-ui": {
59 | deps: ["jquery"],
60 | exports: "$"
61 | },
62 | },
63 |
64 | exclude: [
65 | "custom/custom",
66 | ]
67 | };
68 |
69 | rjs(rjs_config, console.log, function (err) {
70 | console.log("Failed to build", name, err);
71 | process.exit(1);
72 | });
73 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/dualmode_markdown.js:
--------------------------------------------------------------------------------
1 |
2 | // Test
3 | casper.notebook_test(function () {
4 | var a = 'print("a")';
5 | var index = this.append_cell(a);
6 | this.execute_cell_then(index, function(index) {
7 | // Markdown rendering / unredering
8 | this.select_cell(index);
9 | this.validate_notebook_state('select ' + index, 'command', index);
10 | this.trigger_keydown('m');
11 | this.test.assertEquals(this.get_cell(index).cell_type, 'markdown', 'm; cell is markdown');
12 | this.test.assert(!this.is_cell_rendered(index), 'm; cell is unrendered');
13 | this.trigger_keydown('enter');
14 | this.test.assert(!this.is_cell_rendered(index), 'enter; cell is unrendered');
15 | this.validate_notebook_state('enter', 'edit', index);
16 | this.trigger_keydown('ctrl-enter');
17 | this.test.assert(this.is_cell_rendered(index), 'ctrl-enter; cell is rendered');
18 | this.validate_notebook_state('enter', 'command', index);
19 | this.trigger_keydown('enter');
20 | this.test.assert(!this.is_cell_rendered(index), 'enter; cell is unrendered');
21 | this.select_cell(index-1);
22 | this.test.assert(!this.is_cell_rendered(index), 'select ' + (index-1) + '; cell ' + index + ' is still unrendered');
23 | this.validate_notebook_state('select ' + (index-1), 'command', index-1);
24 | this.select_cell(index);
25 | this.validate_notebook_state('select ' + index, 'command', index);
26 | this.trigger_keydown('ctrl-enter');
27 | this.test.assert(this.is_cell_rendered(index), 'ctrl-enter; cell is rendered');
28 | this.select_cell(index-1);
29 | this.validate_notebook_state('select ' + (index-1), 'command', index-1);
30 | this.trigger_keydown('shift-enter');
31 | this.validate_notebook_state('shift-enter', 'command', index);
32 | this.test.assert(this.is_cell_rendered(index), 'shift-enter; cell is rendered');
33 | this.trigger_keydown('shift-enter'); // Creates one cell
34 | this.validate_notebook_state('shift-enter', 'edit', index+1);
35 | this.test.assert(this.is_cell_rendered(index), 'shift-enter; cell is rendered');
36 | });
37 | });
--------------------------------------------------------------------------------
/notebook/tests/base/highlight.js:
--------------------------------------------------------------------------------
1 | casper.notebook_test(function () {
2 | this.on('remote.callback', function(data){
3 | if(data.error_expected){
4 | that.test.assertEquals(
5 | data.error,
6 | true,
7 | "!highlight: " + data.provided + " errors"
8 | );
9 | }else{
10 | that.test.assertEquals(
11 | data.observed,
12 | data.expected,
13 | "highlight: " + data.provided + " as " + data.expected
14 | );
15 | }
16 | });
17 |
18 | var that = this;
19 | // syntax highlighting
20 | [
21 | {to: "gfm"},
22 | {to: "python"},
23 | {to: "ipython"},
24 | {to: "ipythongfm"},
25 | {to: "text/x-markdown", from: [".md"]},
26 | {to: "text/x-python", from: [".py", "Python"]},
27 | {to: "application/json", from: ["json", "JSON"]},
28 | {to: "text/x-ruby", from: [".rb", "ruby", "Ruby"]},
29 | {to: "application/ld+json", from: ["json-ld", "JSON-LD"]},
30 | {from: [".pyc"], error: true},
31 | {from: ["../"], error: true},
32 | {from: ["//"], error: true},
33 | ].map(function (mode) {
34 | (mode.from || []).concat(mode.to || []).map(function(from){
35 | casper.evaluate(function(from, expected, error_expected){
36 | IPython.utils.requireCodeMirrorMode(from, function(observed){
37 | window.callPhantom({
38 | provided: from,
39 | expected: expected,
40 | observed: observed,
41 | error_expected: error_expected
42 | });
43 | }, function(error){
44 | window.callPhantom({
45 | provided: from,
46 | expected: expected,
47 | error: true,
48 | error_expected: error_expected
49 | });
50 | });
51 | }, {
52 | from: from,
53 | expected: mode.to,
54 | error_expected: mode.error
55 | });
56 | });
57 | });
58 | });
--------------------------------------------------------------------------------
/notebook/static/terminal/js/main.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | requirejs([
5 | 'jquery',
6 | 'base/js/utils',
7 | 'base/js/page',
8 | 'auth/js/loginwidget',
9 | 'services/config',
10 | 'terminal/js/terminado',
11 | ], function(
12 | $,
13 | utils,
14 | page,
15 | loginwidget,
16 | configmod,
17 | terminado
18 | ){
19 | "use strict";
20 | requirejs(['custom/custom'], function() {});
21 | page = new page.Page('div#header', 'div#site');
22 |
23 | var common_options = {
24 | base_url : utils.get_body_data("baseUrl"),
25 | };
26 |
27 | var config = new configmod.ConfigSection('terminal', common_options);
28 | config.load();
29 | var common_config = new configmod.ConfigSection('common', common_options);
30 | common_config.load();
31 |
32 | // This makes the 'logout' button in the top right work.
33 | var login_widget = new loginwidget.LoginWidget('span#login_widget', common_options);
34 |
35 | var base_url = utils.get_body_data('baseUrl').replace(/\/?$/, '/');
36 | var ws_path = utils.get_body_data('wsPath');
37 | var ws_url = utils.get_body_data('wsUrl');
38 | if (!ws_url) {
39 | // trailing 's' in https will become wss for secure web sockets
40 | ws_url = location.protocol.replace('http', 'ws') + "//" + location.host;
41 | }
42 | ws_url = ws_url + base_url + ws_path;
43 |
44 | page.show_header();
45 |
46 | var terminal = terminado.make_terminal($("#terminado-container")[0], ws_url);
47 |
48 | page.show_site();
49 |
50 | utils.load_extensions_from_config(config);
51 | utils.load_extensions_from_config(common_config);
52 |
53 | window.onresize = function() {
54 | terminal.term.fit();
55 | // send the new size to the server so that it can trigger a resize in the running process.
56 | terminal.socket.send(JSON.stringify(["set_size", terminal.term.rows, terminal.term.cols,
57 | $(window).height(), $(window).width()]));
58 | };
59 |
60 | // Expose terminal for fiddling with in the browser
61 | window.terminal = terminal;
62 |
63 | });
64 |
--------------------------------------------------------------------------------
/notebook/static/bidi/numericshaping.js:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jupyter Development Team.
2 | // Distributed under the terms of the Modified BSD License.
3 |
4 | define([],
5 | function(bidi) {
6 | "use strict";
7 |
8 | var regex = /([0-9])|([\u0660-\u0669])|([\u0608\u060B\u060D\u061B-\u064A\u066D-\u066F\u0671-\u06D5\u06E5-\u06E6\u06EE-\u06EF\u06FA-\u06FF\u0750-\u077F\u08A0-\u08E3\u200F\u202B\u202E\u2067\uFB50-\uFD3D\uFD40-\uFDCF\uFDF0-\uFDFC\uFDFE-\uFDFF\uFE70-\uFEFE]+)|([^0-9\u0660-\u0669\u0608\u060B\u060D\u061B-\u064A\u066D-\u066F\u0671-\u06D5\u06E5-\u06E6\u06EE-\u06EF\u06FA-\u06FF\u0750-\u077F\u08A0-\u08E3\u200F\u202B\u202E\u2067\uFB50-\uFD3D\uFD40-\uFDCF\uFDF0-\uFDFC\uFDFE-\uFDFF\uFE70-\uFEFE\u0600-\u0607\u0609-\u060A\u060C\u060E-\u061A\u064B-\u066C\u0670\u06D6-\u06E4\u06E7-\u06ED\u06F0-\u06F9\u08E4-\u08FF\uFD3E-\uFD3F\uFDD0-\uFDEF\uFDFD\uFEFF\u0000-\u0040\u005B-\u0060\u007B-\u007F\u0080-\u00A9\u00AB-\u00B4\u00B6-\u00B9\u00BB-\u00BF\u00D7\u00F7\u02B9-\u02BA\u02C2-\u02CF\u02D2-\u02DF\u02E5-\u02ED\u02EF-\u02FF\u2070\u2074-\u207E\u2080-\u208E\u2100-\u2101\u2103-\u2106\u2108-\u2109\u2114\u2116-\u2118\u211E-\u2123\u2125\u2127\u2129\u212E\u213A-\u213B\u2140-\u2144\u214A-\u214D\u2150-\u215F\u2189\uA720-\uA721\uA788\uFF01-\uFF20\uFF3B-\uFF40\uFF5B-\uFF65\uFFE0-\uFFE6\uFFE8-\uFFEE]+)/g;
9 |
10 | var shape = function(text, shaperType) {
11 | text = text.toString();
12 | if (!text) {
13 | return text;
14 | }
15 | switch (shaperType) {
16 | case "defaultNumeral":
17 | return _shapeEuropean(text);
18 | case "national":
19 | return _shapeArabic(text);
20 | default:
21 | return text;
22 | }
23 | };
24 |
25 | var _shapeEuropean = function(text) {
26 | return text.replace(/[\u0660-\u0669]/g, function(c) {
27 | return c.charCodeAt(0) - 1632;
28 | });
29 | };
30 |
31 | var _shapeArabic = function(text) {
32 | return text.replace(/[0-9]/g, function(c) {
33 | return String.fromCharCode(parseInt(c) + 1632);
34 | });
35 | };
36 |
37 | var numericshaping = {
38 | shapeNumerals : shape
39 | };
40 |
41 | return numericshaping;
42 | });
43 |
--------------------------------------------------------------------------------
/notebook/tests/test_config_manager.py:
--------------------------------------------------------------------------------
1 | import json
2 | import os
3 | import shutil
4 | import tempfile
5 |
6 | from notebook.config_manager import BaseJSONConfigManager
7 |
8 |
9 | def test_json():
10 | tmpdir = tempfile.mkdtemp()
11 | try:
12 | root_data = dict(a=1, x=2, nest={'a':1, 'x':2})
13 | with open(os.path.join(tmpdir, 'foo.json'), 'w') as f:
14 | json.dump(root_data, f)
15 | # also make a foo.d/ directory with multiple json files
16 | os.makedirs(os.path.join(tmpdir, 'foo.d'))
17 | with open(os.path.join(tmpdir, 'foo.d', 'a.json'), 'w') as f:
18 | json.dump(dict(a=2, b=1, nest={'a':2, 'b':1}), f)
19 | with open(os.path.join(tmpdir, 'foo.d', 'b.json'), 'w') as f:
20 | json.dump(dict(a=3, b=2, c=3, nest={'a':3, 'b':2, 'c':3}, only_in_b={'x':1}), f)
21 | manager = BaseJSONConfigManager(config_dir=tmpdir, read_directory=False)
22 | data = manager.get('foo')
23 | assert 'a' in data
24 | assert 'x' in data
25 | assert 'b' not in data
26 | assert 'c' not in data
27 | assert data['a'] == 1
28 | assert 'x' in data['nest']
29 | # if we write it out, it also shouldn't pick up the subdirectoy
30 | manager.set('foo', data)
31 | data = manager.get('foo')
32 | assert data == root_data
33 |
34 | manager = BaseJSONConfigManager(config_dir=tmpdir, read_directory=True)
35 | data = manager.get('foo')
36 | assert 'a' in data
37 | assert 'b' in data
38 | assert 'c' in data
39 | # files should be read in order foo.d/a.json foo.d/b.json foo.json
40 | assert data['a'] == 1
41 | assert data['b'] == 2
42 | assert data['c'] == 3
43 | assert data['nest']['a'] == 1
44 | assert data['nest']['b'] == 2
45 | assert data['nest']['c'] == 3
46 | assert data['nest']['x'] == 2
47 |
48 | # when writing out, we don't want foo.d/*.json data to be included in the root foo.json
49 | manager.set('foo', data)
50 | manager = BaseJSONConfigManager(config_dir=tmpdir, read_directory=False)
51 | data = manager.get('foo')
52 | assert data == root_data
53 |
54 | finally:
55 | shutil.rmtree(tmpdir)
56 |
57 |
58 |
--------------------------------------------------------------------------------
/notebook/bundler/zip_bundler.py:
--------------------------------------------------------------------------------
1 | # Copyright (c) Jupyter Development Team.
2 | # Distributed under the terms of the Modified BSD License.
3 | import os
4 | import io
5 | import zipfile
6 | import notebook.bundler.tools as tools
7 |
8 | def _jupyter_bundlerextension_paths():
9 | """Metadata for notebook bundlerextension"""
10 | return [{
11 | 'name': 'notebook_zip_download',
12 | 'label': 'IPython Notebook bundle (.zip)',
13 | 'module_name': 'notebook.bundler.zip_bundler',
14 | 'group': 'download'
15 | }]
16 |
17 | def bundle(handler, model):
18 | """Create a zip file containing the original notebook and files referenced
19 | from it. Retain the referenced files in paths relative to the notebook.
20 | Return the zip as a file download.
21 |
22 | Assumes the notebook and other files are all on local disk.
23 |
24 | Parameters
25 | ----------
26 | handler : tornado.web.RequestHandler
27 | Handler that serviced the bundle request
28 | model : dict
29 | Notebook model from the configured ContentManager
30 | """
31 | abs_nb_path = os.path.join(handler.settings['contents_manager'].root_dir,
32 | model['path'])
33 | notebook_filename = model['name']
34 | notebook_name = os.path.splitext(notebook_filename)[0]
35 |
36 | # Headers
37 | zip_filename = os.path.splitext(notebook_name)[0] + '.zip'
38 | handler.set_attachment_header(zip_filename)
39 | handler.set_header('Content-Type', 'application/zip')
40 |
41 | # Get associated files
42 | ref_filenames = tools.get_file_references(abs_nb_path, 4)
43 |
44 | # Prepare the zip file
45 | zip_buffer = io.BytesIO()
46 | zipf = zipfile.ZipFile(zip_buffer, mode='w', compression=zipfile.ZIP_DEFLATED)
47 | zipf.write(abs_nb_path, notebook_filename)
48 |
49 | notebook_dir = os.path.dirname(abs_nb_path)
50 | for nb_relative_filename in ref_filenames:
51 | # Build absolute path to file on disk
52 | abs_fn = os.path.join(notebook_dir, nb_relative_filename)
53 | # Store file under path relative to notebook
54 | zipf.write(abs_fn, nb_relative_filename)
55 |
56 | zipf.close()
57 |
58 | # Return the buffer value as the response
59 | handler.finish(zip_buffer.getvalue())
--------------------------------------------------------------------------------
/notebook/services/config/manager.py:
--------------------------------------------------------------------------------
1 | """Manager to read and modify frontend config data in JSON files.
2 | """
3 | # Copyright (c) Jupyter Development Team.
4 | # Distributed under the terms of the Modified BSD License.
5 |
6 | import os.path
7 |
8 | from notebook.config_manager import BaseJSONConfigManager, recursive_update
9 | from jupyter_core.paths import jupyter_config_dir, jupyter_config_path
10 | from traitlets import Unicode, Instance, List, observe, default
11 | from traitlets.config import LoggingConfigurable
12 |
13 |
14 | class ConfigManager(LoggingConfigurable):
15 | """Config Manager used for storing notebook frontend config"""
16 |
17 | # Public API
18 |
19 | def get(self, section_name):
20 | """Get the config from all config sections."""
21 | config = {}
22 | # step through back to front, to ensure front of the list is top priority
23 | for p in self.read_config_path[::-1]:
24 | cm = BaseJSONConfigManager(config_dir=p)
25 | recursive_update(config, cm.get(section_name))
26 | return config
27 |
28 | def set(self, section_name, data):
29 | """Set the config only to the user's config."""
30 | return self.write_config_manager.set(section_name, data)
31 |
32 | def update(self, section_name, new_data):
33 | """Update the config only to the user's config."""
34 | return self.write_config_manager.update(section_name, new_data)
35 |
36 | # Private API
37 |
38 | read_config_path = List(Unicode())
39 |
40 | @default('read_config_path')
41 | def _default_read_config_path(self):
42 | return [os.path.join(p, 'nbconfig') for p in jupyter_config_path()]
43 |
44 | write_config_dir = Unicode()
45 |
46 | @default('write_config_dir')
47 | def _default_write_config_dir(self):
48 | return os.path.join(jupyter_config_dir(), 'nbconfig')
49 |
50 | write_config_manager = Instance(BaseJSONConfigManager)
51 |
52 | @default('write_config_manager')
53 | def _default_write_config_manager(self):
54 | return BaseJSONConfigManager(config_dir=self.write_config_dir)
55 |
56 | @observe('write_config_dir')
57 | def _update_write_config_dir(self, change):
58 | self.write_config_manager = BaseJSONConfigManager(config_dir=self.write_config_dir)
59 |
--------------------------------------------------------------------------------
/notebook/tests/notebook/move_multiselection.js:
--------------------------------------------------------------------------------
1 |
2 |
3 | // Test
4 | casper.notebook_test(function () {
5 | this.append_cell('1');
6 | this.append_cell('2');
7 | this.append_cell('3');
8 | this.append_cell('4');
9 | this.append_cell('5');
10 | this.append_cell('6');
11 |
12 | function assert_order(that, pre_message, expected_state){
13 |
14 | for (var i=1; i
'; 16 | text = text + i18n.msg._('The version of the notebook server is: '); 17 | text = text + _.template('<%- version %>')({ version: sys_info.notebook_version }); 18 | if (sys_info.commit_hash) { 19 | text = text + _.template('-<%- hash %>')({ hash: sys_info.commit_hash }); 20 | } 21 | text = text + '
'; 22 | text = text + i18n.msg._('The server is running on this version of Python:'); 23 | text = text + _.template('
![]()
">',
13 | '
',
14 | '<',
15 | '
'; 16 | text = text + i18n.msg._('The version of the notebook server is: '); 17 | text = text + _.template('<%- version %>')({ version: sys_info.notebook_version }); 18 | if (sys_info.commit_hash) { 19 | text = text + _.template('-<%- hash %>')({ hash: sys_info.commit_hash }); 20 | } 21 | text = text + '
'; 22 | text = text + i18n.msg._('The server is running on this version of Python:'); 23 | text = text + _.template('
Python <%- pyver %>')({ 24 | pyver: sys_info.sys_version }); 25 | var kinfo = $('').attr('id', '#about-kinfo').text(i18n.msg._('Waiting for kernel to be available...')); 26 | var body = $(''); 27 | body.append($('').text(i18n.msg._('Server Information:'))); 28 | body.append($('').html(text)); 29 | body.append($('').text(i18n.msg._('Current Kernel Information:'))); 30 | body.append(kinfo); 31 | } else { 32 | var text = i18n.msg._('Could not access sys_info variable for version information.'); 33 | var body = $(''); 34 | body.append($('').text(i18n.msg._('Cannot find sys_info!'))); 35 | body.append($('').html(text)); 36 | } 37 | dialog.modal({ 38 | title: i18n.msg._('About Jupyter Notebook'), 39 | body: body, 40 | buttons: { 'OK': {} } 41 | }); 42 | try { 43 | IPython.notebook.session.kernel.kernel_info(function (data) { 44 | kinfo.html($('').text(data.content.banner)); 45 | }); 46 | } catch (e) { 47 | kinfo.html($('').text(i18n.msg._('unable to contact kernel'))); 48 | } 49 | }); 50 | }); 51 | -------------------------------------------------------------------------------- /notebook/static/notebook/js/codemirror-ipythongfm.js: -------------------------------------------------------------------------------- 1 | // IPython GFM (GitHub Flavored Markdown) mode is just a slightly altered GFM 2 | // Mode with support for latex. 3 | // 4 | // Latex support was supported by Codemirror GFM as of 5 | // https://github.com/codemirror/CodeMirror/pull/567 6 | // But was later removed in 7 | // https://github.com/codemirror/CodeMirror/commit/d9c9f1b1ffe984aee41307f3e927f80d1f23590c 8 | 9 | 10 | (function(mod) { 11 | if (typeof exports == "object" && typeof module == "object"){ // CommonJS 12 | mod(requirejs("codemirror/lib/codemirror") 13 | ,requirejs("codemirror/addon/mode/multiplex") 14 | ,requirejs("codemirror/mode/gfm/gfm") 15 | ,requirejs("codemirror/mode/stex/stex") 16 | ); 17 | } else if (typeof define == "function" && define.amd){ // AMD 18 | define(["codemirror/lib/codemirror" 19 | ,"codemirror/addon/mode/multiplex" 20 | ,"codemirror/mode/python/python" 21 | ,"codemirror/mode/stex/stex" 22 | ], mod); 23 | } else {// Plain browser env 24 | mod(CodeMirror); 25 | } 26 | })( function(CodeMirror){ 27 | "use strict"; 28 | 29 | CodeMirror.defineMode("ipythongfm", function(config, parserConfig) { 30 | 31 | var gfm_mode = CodeMirror.getMode(config, "gfm"); 32 | var tex_mode = CodeMirror.getMode(config, "stex"); 33 | 34 | return CodeMirror.multiplexingMode( 35 | gfm_mode, 36 | // By defining the $$ delimiter before the $ delimiter we don't run 37 | // into the problem that $$ is interpreted as two consecutive $. 38 | { 39 | open: "$$", close: "$$", 40 | mode: tex_mode, 41 | delimStyle: "delimit" 42 | }, 43 | { 44 | open: "$", close: "$", 45 | mode: tex_mode, 46 | delimStyle: "delimit" 47 | }, 48 | { 49 | open: "\\(", close: "\\)", 50 | mode: tex_mode, 51 | delimStyle: "delimit" 52 | }, 53 | { 54 | open: "\\[", close: "\\]", 55 | mode: tex_mode, 56 | delimStyle: "delimit" 57 | } 58 | // .. more multiplexed styles can follow here 59 | ); 60 | }, 'gfm'); 61 | 62 | CodeMirror.defineMIME("text/x-ipythongfm", "ipythongfm"); 63 | }) 64 | -------------------------------------------------------------------------------- /notebook/services/config/tests/test_config_api.py: -------------------------------------------------------------------------------- 1 | # coding: utf-8 2 | """Test the config webservice API.""" 3 | 4 | import json 5 | 6 | import requests 7 | 8 | from notebook.utils import url_path_join 9 | from notebook.tests.launchnotebook import NotebookTestBase 10 | 11 | 12 | class ConfigAPI(object): 13 | """Wrapper for notebook API calls.""" 14 | def __init__(self, request): 15 | self.request = request 16 | 17 | def _req(self, verb, section, body=None): 18 | response = self.request(verb, 19 | url_path_join('api/config', section), 20 | data=body, 21 | ) 22 | response.raise_for_status() 23 | return response 24 | 25 | def get(self, section): 26 | return self._req('GET', section) 27 | 28 | def set(self, section, values): 29 | return self._req('PUT', section, json.dumps(values)) 30 | 31 | def modify(self, section, values): 32 | return self._req('PATCH', section, json.dumps(values)) 33 | 34 | class APITest(NotebookTestBase): 35 | """Test the config web service API""" 36 | def setUp(self): 37 | self.config_api = ConfigAPI(self.request) 38 | 39 | def test_create_retrieve_config(self): 40 | sample = {'foo': 'bar', 'baz': 73} 41 | r = self.config_api.set('example', sample) 42 | self.assertEqual(r.status_code, 204) 43 | 44 | r = self.config_api.get('example') 45 | self.assertEqual(r.status_code, 200) 46 | self.assertEqual(r.json(), sample) 47 | 48 | def test_modify(self): 49 | sample = {'foo': 'bar', 'baz': 73, 50 | 'sub': {'a': 6, 'b': 7}, 'sub2': {'c': 8}} 51 | self.config_api.set('example', sample) 52 | 53 | r = self.config_api.modify('example', {'foo': None, # should delete foo 54 | 'baz': 75, 55 | 'wib': [1,2,3], 56 | 'sub': {'a': 8, 'b': None, 'd': 9}, 57 | 'sub2': {'c': None} # should delete sub2 58 | }) 59 | self.assertEqual(r.status_code, 200) 60 | self.assertEqual(r.json(), {'baz': 75, 'wib': [1,2,3], 61 | 'sub': {'a': 8, 'd': 9}}) 62 | 63 | def test_get_unknown(self): 64 | # We should get an empty config dictionary instead of a 404 65 | r = self.config_api.get('nonexistant') 66 | self.assertEqual(r.status_code, 200) 67 | self.assertEqual(r.json(), {}) 68 | 69 | -------------------------------------------------------------------------------- /notebook/notebook/handlers.py: -------------------------------------------------------------------------------- 1 | """Tornado handlers for the live notebook view.""" 2 | 3 | # Copyright (c) Jupyter Development Team. 4 | # Distributed under the terms of the Modified BSD License. 5 | 6 | from collections import namedtuple 7 | import os 8 | from tornado import web 9 | HTTPError = web.HTTPError 10 | 11 | from ..base.handlers import ( 12 | IPythonHandler, FilesRedirectHandler, path_regex, 13 | ) 14 | from ..utils import url_escape 15 | from ..transutils import _ 16 | 17 | 18 | def get_custom_frontend_exporters(): 19 | from nbconvert.exporters.base import get_export_names, get_exporter 20 | 21 | ExporterInfo = namedtuple('ExporterInfo', ['name', 'display']) 22 | 23 | for name in sorted(get_export_names()): 24 | exporter = get_exporter(name)() 25 | ux_name = getattr(exporter, 'export_from_notebook', None) 26 | if ux_name is not None: 27 | display = _('{} ({})'.format(ux_name, exporter.file_extension)) 28 | yield ExporterInfo(name, display) 29 | 30 | 31 | class NotebookHandler(IPythonHandler): 32 | 33 | @web.authenticated 34 | def get(self, path): 35 | """get renders the notebook template if a name is given, or 36 | redirects to the '/files/' handler if the name is not given.""" 37 | path = path.strip('/') 38 | cm = self.contents_manager 39 | 40 | # will raise 404 on not found 41 | try: 42 | model = cm.get(path, content=False) 43 | except web.HTTPError as e: 44 | if e.status_code == 404 and 'files' in path.split('/'): 45 | # 404, but '/files/' in URL, let FilesRedirect take care of it 46 | return FilesRedirectHandler.redirect_to_files(self, path) 47 | else: 48 | raise 49 | if model['type'] != 'notebook': 50 | # not a notebook, redirect to files 51 | return FilesRedirectHandler.redirect_to_files(self, path) 52 | name = path.rsplit('/', 1)[-1] 53 | self.write(self.render_template('notebook.html', 54 | notebook_path=path, 55 | notebook_name=name, 56 | kill_kernel=False, 57 | mathjax_url=self.mathjax_url, 58 | mathjax_config=self.mathjax_config, 59 | get_custom_frontend_exporters=get_custom_frontend_exporters 60 | ) 61 | ) 62 | 63 | 64 | #----------------------------------------------------------------------------- 65 | # URL to handler mappings 66 | #----------------------------------------------------------------------------- 67 | 68 | 69 | default_handlers = [ 70 | (r"/notebooks%s" % path_regex, NotebookHandler), 71 | ] 72 | 73 | -------------------------------------------------------------------------------- /notebook/tests/base/security.js: -------------------------------------------------------------------------------- 1 | safe_tests = [ 2 | "
Hi there
", 3 | 'Hi There!
', 4 | 'citation', 5 | 'Hi There
',
6 | ];
7 |
8 | unsafe_tests = [
9 | "",
10 | '999',
11 | '999',
12 | '