ipython/ipython-in-depth

IPython and Jupyter in-depth Tutorial, first presented at PyCon 2012

IPython: Productive Interactive Computing

Overview

Welcome to IPython. Our full documentation is available on ipython.readthedocs.io and contains information on how to install, use, and contribute to the project. IPython (Interactive Python) is a command shell for interactive computing in multiple programming languages, originally developed for the Python programming language, that offers introspection, rich media, shell syntax, tab completion, and history.

IPython versions and Python Support

Starting after IPython 8.16, we will progressively transition to Spec-0000.

Starting with IPython 7.10, IPython follows NEP 29

IPython 7.17+ requires Python version 3.7 and above.

IPython 7.10+ requires Python version 3.6 and above.

IPython 7.0 requires Python version 3.5 and above.

IPython 6.x requires Python version 3.3 and above.

IPython 5.x LTS is the compatible release for Python 2.7. If you require Python 2 support, you must use IPython 5.x LTS. Please update your project configurations and requirements as necessary.

The Notebook, Qt console and a number of other pieces are now parts of Jupyter. See the Jupyter installation docs if you want to use these.

Main features of IPython

Comprehensive object introspection.

Input history, persistent across sessions.

Caching of output results during a session with automatically generated references.

Extensible tab completion, with support by default for completion of python variables and keywords, filenames and function keywords.

Extensible system of ‘magic’ commands for controlling the environment and performing many tasks related to IPython or the operating system.

A rich configuration system with easy switching between different setups (simpler than changing $PYTHONSTARTUP environment variables every time).

Session logging and reloading.

Extensible syntax processing for special purpose situations.

Access to the system shell with user-extensible alias system.

Easily embeddable in other Python programs and GUIs.

Integrated access to the pdb debugger and the Python profiler.

Development and Instant running

You can find the latest version of the development documentation on readthedocs.

You can run IPython from this directory without even installing it system-wide by typing at the terminal:

$ python -m IPython

Or see the development installation docs for the latest revision on read the docs.

Documentation and installation instructions for older version of IPython can be found on the IPython website

Alternatives to IPython

IPython may not be to your taste; if that's the case there might be similar project that you might want to use:

• The classic Python REPL.
• bpython
• mypython
• ptpython and ptipython
• Xonsh

Ignoring commits with git blame.ignoreRevsFile

As of git 2.23, it is possible to make formatting changes without breaking git blame. See the git documentation for more details.

To use this feature you must:

• Install git >= 2.23

• Configure your local git repo by running:

  • POSIX: tools\configure-git-blame-ignore-revs.sh
  • Windows: tools\configure-git-blame-ignore-revs.bat

ipython-in-depth's Issues

00 - What's new in 1.0 raw_input and input

Should give a nod to the python3 people as well:

answer = input("What is your favourite colour? ")
answer

Broken image links in ipython-in-depth/exercises/Parallel Computing/Overview of IPython.parallel.ipynb

The "Overview of IPython.parallel.ipynb" notebook references the nonexistent "ipython-in-depth/exercises/figs/" folder instead of "ipython-in-depth/exercises/images/" thus causing broken image links.

dead links in ipython-in-depth/notebooks/Index - Basic.ipynb

spaces in file names and spaces in links lead to broken markdown links in tutorial

The front page notebook if accessed via clicking on the Python tutorial on the jupyter try website.
I assume it has to do with the spaces in the file names in the provided path. Some have them and the links apparently work in github's markdown but not in the markdown used by jupyter. A few links in the notebook substitute the spaces in the links with %20 and then they work.

This is extra annoying if you are visiting for the first time and have no clue how to fix the links temporarily to proceed.
Also, who would put spaces into file names? This can lead to a lot of issues under some systems.

• fix file names
• fix broken links
• also there is a mistake at the end of this part of the tutorial. You want to explain how to open a terminal but write one should click on "Text File"

!ls is not really a list

Expand beyond plain python to say that !ls is not really a list :-)

SciPy 2014 Display&Widget Tut TODOs

• Shrink or totally remove the introductory section.
• Add figures to widget section:
  
  
  
• Fix "walls of text" in custom widget section.
• Enable 'paulscroll' feature.

Beyond plain python : add section about shift tab.

Probably next to tab completion.

how to run code

01 - IPython - beyond plain Python error NameError: name '_7' is not defined

error

Walking through the tut and I found this error:

In [15]:

_7 == Out[7]#<<<<<<<<<<<<<<<<<<

NameError Traceback (most recent call last)
in ()
----> 1 _7 == Out[7]

NameError: name '_7' is not defined

df2.iloc[2]

NameError Traceback (most recent call last)
in
----> 1 df2.iloc[2]

NameError: name 'df2' is not defined

00 - What's new in 1.0 linking notebooks spaces in heading name kills anchors

Heading cells automatically get anchors with their text, so you can link to them:

    [like this](#Autosave)

[like this](#Autosave)

or like this

[test with underscore](#New_cell_magics)#works

[test with spaces](#New cell magics) #won't work<<<<<<<<<<

[nospaces](#Newcellmagics)#works

small code correction: with open('00 - Notebook Basics.ipynb') as f:

00 - Notebook Basics

first code line should read

from IPython.nbformat import current
with open('00 - Notebook Basics.ipynb') as f:
nb = current.read(f, 'json')

Error on checkout on windows

C:\data\external\ipython-in-depth>git checkout origin/master -f
error: unable to create file notebooks/Notebook/What is the IPython Notebook?.ip
ynb (Invalid argument)
HEAD is now at 3a95c0c... Last minute changes.

I suspect that windows does not like ?. Would it be possible to rename the notebook?

doc request: more details around how to use ipdb

I'm not finding much on how to use ipdb in the docs or vids of ipython.
Could someone please post a link or more details on how ipdb is used?

thank you
Dennis

Invalid character in notebook filename

The file examples/Notebook/What is the IPython Notebook?.ipynb contains a character (?) which is invalid on Windows.

This leads to issues when cloning the repo or unzipping an archive:

oberstet@THINKPAD-T410S /f/scm/3rdparty
$ git clone [email protected]:ipython/ipython-in-depth.git
Cloning into 'ipython-in-depth'...
remote: Counting objects: 1255, done.
remote: Total 1255 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (1255/1255), 12.23 MiB | 39.00 KiB/s, done.
Resolving deltas: 100% (680/680), done.
error: unable to create file examples/Notebook/What is the IPython Notebook?.ipynb (Invalid argument)
fatal: unable to checkout working tree
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status'
and retry the checkout with 'git checkout -f HEAD'

FileNotFoundError

Question : Error pop-up but I cannot find the path - /srv/conda/envs/notebook/lib/python3.6/site-packages/selenium/webdriver/common/.
Which path could I put "chromedriver.exe" back to solve FileNotFoundError?

Cell : Driver = webdriver.Chrome(r'C:\Users\chromedriver.exe')

Error:

FileNotFoundError Traceback (most recent call last)
/srv/conda/envs/notebook/lib/python3.6/site-packages/selenium/webdriver/common/service.py in start(self)
75 stderr=self.log_file,
---> 76 stdin=PIPE)
77 except TypeError:

/srv/conda/envs/notebook/lib/python3.6/subprocess.py in init(self, args, bufsize, executable, stdin, stdout, stderr, preexec_fn, close_fds, shell, cwd, env, universal_newlines, startupinfo, creationflags, restore_signals, start_new_session, pass_fds, encoding, errors)
728 errread, errwrite,
--> 729 restore_signals, start_new_session)
730 except:

/srv/conda/envs/notebook/lib/python3.6/subprocess.py in _execute_child(self, args, executable, preexec_fn, close_fds, pass_fds, cwd, env, startupinfo, creationflags, shell, p2cread, p2cwrite, c2pread, c2pwrite, errread, errwrite, restore_signals, start_new_session)
1363 err_msg += ': ' + repr(err_filename)
-> 1364 raise child_exception_type(errno_num, err_msg, err_filename)
1365 raise child_exception_type(err_msg)

FileNotFoundError: [Errno 2] No such file or directory: 'C:\Users\chromedriver.exe': 'C:\Users\chromedriver.exe'

During handling of the above exception, another exception occurred:

WebDriverException Traceback (most recent call last)
in
----> 1 Driver = webdriver.Chrome(r'C:\Users\chromedriver.exe')

/srv/conda/envs/notebook/lib/python3.6/site-packages/selenium/webdriver/chrome/webdriver.py in init(self, executable_path, port, options, service_args, desired_capabilities, service_log_path, chrome_options, keep_alive)
71 service_args=service_args,
72 log_path=service_log_path)
---> 73 self.service.start()
74
75 try:

/srv/conda/envs/notebook/lib/python3.6/site-packages/selenium/webdriver/common/service.py in start(self)
81 raise WebDriverException(
82 "'%s' executable needs to be in PATH. %s" % (
---> 83 os.path.basename(self.path), self.start_error_message)
84 )
85 elif err.errno == errno.EACCES:

WebDriverException: Message: 'C:\Users\chromedriver.exe' executable needs to be in PATH. Please see https://sites.google.com/a/chromium.org/chromedriver/home

Update License

00 - What's new in 1.0 kernel busy nuisance with New cell magics

python 3.2
running ipython3 notebook
latest GIT pull

In order to get New cell magics to run I have to close down the notebook and restart it. Having to restart the kernel to get new cell magics to work is undesirable behavior.

Initially I run the cells then I came to new cell magics %%html.
kernel busy and stays busy.
the terminal displays no errors.
I shut down the kernel and then restart 00 - What's new in 1.0
THEN the new cell magics will work but I have to restart the kernel. I can reproduce this behavior.

Same for all new cell magics
%%html
%%latex
%%javascript

thank you

Nodejs==9.11?

I am trying to transfer environment.yml to requirements.txt and use pip install -r requirements.txt to install all packages.. Looks like nodejs package only have 0.1 version...??

Is Nodejs we install here a python package?