import matplotlib
if not hasattr(matplotlib.RcParams, "_get"):
    matplotlib.RcParams._get = dict.get

3.1. Bash commands#

3.1.1. Accessing Bash#

Before we dive into Bash commands, let’s clarify how to access Bash on different operating systems:

  • Windows: You need to use Git Bash, which was installed together with Git during the setup process (refer to this chapter if you haven’t installed Git yet). To open Git Bash, search for “Git Bash” in your Start menu and launch the application.

../../_images/bash_where.png
  • Linux/macOS: Bash comes pre-installed on these systems. Simply open the Terminal application (you can find it by searching for “Terminal” in your applications/Spotlight search).

Once you have Bash open, you can start entering and exploring commands as described below.

3.1.2. Bash commands#

To begin familiarizing yourself with the terminal, we first provide an overview of commonly used Bash commands (Table 3.1), which are explained in more detail below on this page. The overview is not exhaustive - if you want to perform an action not covered by the table, ask an LLM or search online to find an appropriate command.

Detailed help for every command

You can get more information on a command by ending it with the flag --help. This does not execute the command and instead prints detailed instructions on how to use the command into your terminal. Try executing the example below in your terminal to see for yourself with and without --help:

pwd --help

3.1.4. Manipulating directories#

With the terminal you can easily create (mkdir A/) or delete an empty directory A/ (rmdir A/), where A/ can be something like Movies/ in the figure above. You can also use rm to delete directories, cp to copy, and mv to move and rename them.

If you have a directory with files inside (i.e, a non-empty directory), you cannot use rmdir to delete it. In order to delete a non-empty directory with all its contents, you need to use rm in a recursive fashion: rm -r A/.

Similarly, if you wish to make a copy of a directory with files inside, this also has to be done recursively. Notice the nuanced differences between the following commands:

  • cp -r A/ new_A/ - copies the contents of source directory A/ into a new directory called new_A/.

  • cp -r A/ existing_A/ - makes a copy of the directory A/ with all its contents inside the existing directory existing_A/.

In addition to copying, we can also move directories. To move directory A/ with all its contents into directory B/, we can use mv A/ B/. We can also use mv to rename a directory like this: mv A/ new_name_A/.

Notice that when copying or moving to a destination that does not yet exist, the destination is created containing A/’s contents, not a copy of A/ itself.

Recalling previous commands

Sometimes you want to use the same command you used recently in your terminal, either to run it again, or make a small modification and then run it. There’s an easy way to fetch your previously executed commands instead of retyping them: you can simply press arrow up (↑) once or multiple times. To print a full list of recent commands, use the command history.

Try it in your terminal!

3.1.5. Working with files#

Several commands that apply to working with directories also apply to files. Let’s take a look at what the following commands mean:

  • cp a.txt b.txt - copies a.txt to b.txt in the same directory. Using mv instead of cp would rename a.txt into b.txt.

  • cp a.txt ../ - copies a.txt to one directory up (it can also be used with mv to move the file).

  • cp a.txt A/ - as previous command, but copies a.txt in the directory A/ (can also be used with mv).

  • cp ../a.txt . - copies a.txt from one directory up to the current (.) directory (it can also be used with mv).

3.1.5.1. Wildcard#

Sometimes you will want to copy or move multiple files or directories at the same time. To avoid typing each command individually or recalling the same command and changing it multiple times, you can use the wildcard * to replace any text.

For instance, let’s say we are located in the directory Physics:

../../_images/wildcard.png

Fig. 3.4 Example folder: wildcard usage.#

If we are in the directory Physics and want to move all Notes files into directory Materials/, we could use mv Notes* Materials/. With Notes*, we included all three .docx files. Therefore, * effectively means Nov21.docx or Nov24.docx or Oct16.docx.

We could alternatively use mv N* Materials/ because our three files with notes are the only files beginning with letter N, so mv N* already defines our selection. Another option would be to use mv *docx Materials/ because Notes are the only .docx files in the directory Physics/.

Note that it’s also possible to use multiple wildcards in one go if there are several patterns you wish to generalize. E.g., to delete all .docx files that have Nov in their name, you can use rm *Nov*.docx.

import micropip
await micropip.install("jupyterquiz")
from jupyterquiz import display_quiz
import json

with open("question2.json", "r") as file:
    questions=json.load(file)
    
display_quiz(questions, border_radius=4, colors={'--jq-multiple-choice-bg': '#c9b8f5', '--jq-many-choice-bg': '#d4845a', '--jq-numeric-bg': '#8b6cc4', '--jq-string-bg': '#8b6cc4', '--jq-mc-button-bg': '#f5f0ff', '--jq-mc-button-border': '#c9b8f5', '--jq-mc-button-inset-shadow': '#8b6cc4', '--jq-text-color': '#1e0e40', '--jq-correct-color': '#00843f', '--jq-incorrect-color': '#d72d47', '--jq-numeric-input-bg': '#d4c8f8', '--jq-numeric-input-label': '#1e0e40', '--jq-numeric-input-shadow': '#8b6cc4'})

3.1.5.2. Reading files#

For taking a glance at the contents of a text file in read-only mode, less comes in very handy. To open a file for reading, we use less file.txt. We can further navigate through the text of a file by scrolling or search for specific text patterns like this: /Pattern (note that this is case sensitive, i.e., there is a difference between /Pattern and /pattern). To navigate to the end of the file, use G. To move to the beginning of the file, use g. To close the file, simply press q (for “quit”) on your keyboard.

An alternative command used to read the contents of a file is cat. Unlike the less command which opens a file, cat prints a file’s contents to your terminal. If you use it with more than one file, e.g., cat fileA.txt fileB.txt, it will concatenate the files and print the output in the terminal.

3.1.5.3. Editing files with Vim#

Vim is a powerful text editor which you can use from within the terminal. Unlike text editors such as Notepad or MS Word, which emphasize click-to-type style editing, Vim is entirely command-based. That means that writing new text in the file requires extra steps instead of just starting to type. When opening a file, Vim starts out in normal mode, which is meant for navigation and large edits. To start typing new text, press i to go into insert mode. Having different modes allows Vim to take advantage of the full keyboard, which makes it very fast for users familiar with it. Vim takes some getting used to, but is ultimately a powerful text editor that usually comes pre-installed on computer systems (like DelftBlue), making it a safe fallback.

3.1.5.3.1. Opening and closing files#

To open a file in Vim, use:

vim filename.txt

If filename.txt exists, it will open for editing. If it does not exist, a new file with that name will be created.

There are several options to exit Vim:

  • :quit → quit (only works if no changes were made)

  • :quit! → quit without saving

  • :write → save without quitting

  • :write followed by :quit → save and quit

In practice, most users abbreviate these commands as :q, :q!, and :wq respectively, which do the exact same thing but are quicker to type.

3.1.5.3.2. Vim’s modes#

Unlike standard text editors, Vim operates in different modes:

  • Normal mode (default) – used for navigation, copying, pasting, deleting, and running commands.

  • Insert mode (activated with i) – used for typing text.

  • Visual mode (activated with v or V) – used for selecting text. See more here.

  • Command mode (activated with :) – used for saving, quitting, and running advanced commands.

You can also switch between modes when you work on a file. To do so:

  • Press i to enter insert mode

  • Press Esc to return to normal mode

  • Use : to enter command mode

Table 3.2 Basic Vim commands. More commands can be found online.#

Operation

Effect

Details

i

Insert text

Puts Vim in insert mode, allowing text entry.

Esc

Exit insert mode

Return to normal mode.

yy, dd

Yank (copy) line, delete (cut) line

Copies (y) or removes (d) the current line. Use yG or dG to copy or delete everything from the current line to the end of the file. The character after y / d tells Vim what to copy / delete.

p, P

paste below, paste above

Pastes copied (y) or deleted (d) content.

v, V

Enter visual mode

Enables text selection for copy/delete, press Esc to leave. v selects individual characters, V selects whole lines.

u, Ctrl+r

Undo, redo

Reverts the last change, re-applies an undone change.

/, /pattern

Search for pattern in text

Finds the next occurrence of the pattern you type after /. /pattern finds the next occurence of the phrase pattern. Use n to jump to the next match, or N to go the previous one.

q

Record macro

Allows for defining custom macros to automate repetitive tasks.

Motion

Where it moves the cursor

Details

h, j, k,l

Left, down, up, and right.

You can also use your arrow keys, but hjkl is faster.

gg, 0

Beginning

gg brings the cursor to the beginning of the file, 0 to the beginning of the line.

G, $

End

G brings the cursor to the end of the file, $ to the end of the line.

Command

Effect

Details

:write, :w

Save file

Saves changes without quitting.

:quit, :q, :q!

Close file

Closes file if there are no unsaved changes. :q! closes file without saving the even if there unsaved changes. It can be used together with :w as :wq, which saves all changes and closes the file in one go.

:substitute/old/new, :%s/old/new/gc

Substitute first old in line with new, substitute all old with new.

Replaces occurrences of old with new. The %, g, and c are optional but make the command more user friendly. % tells Vim to look in the whole file. g tells Vim to target all matches per line. c tells Vim to ask you for each old whether it should be changed to new.

:set number

Show line numbers

Displays line numbers on the left.

import micropip
await micropip.install("jupyterquiz")
from jupyterquiz import display_quiz
import json

with open("question3.json", "r") as file:
    questions=json.load(file)
    
display_quiz(questions, border_radius=4, colors={'--jq-multiple-choice-bg': '#c9b8f5', '--jq-many-choice-bg': '#d4845a', '--jq-numeric-bg': '#8b6cc4', '--jq-string-bg': '#8b6cc4', '--jq-mc-button-bg': '#f5f0ff', '--jq-mc-button-border': '#c9b8f5', '--jq-mc-button-inset-shadow': '#8b6cc4', '--jq-text-color': '#1e0e40', '--jq-correct-color': '#00843f', '--jq-incorrect-color': '#d72d47', '--jq-numeric-input-bg': '#d4c8f8', '--jq-numeric-input-label': '#1e0e40', '--jq-numeric-input-shadow': '#8b6cc4'})