{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# The command line shell and git\n", "\n", " - The default shell on OSX is bash, which is taught in this set of\n", " lessons: or in this\n", " [detailed bash reference](https://programminghistorian.org/en/lessons/intro-to-bash)\n", " - if you are on Windows, powershell is somewhat similar -- here is\n", " a table listing commands for both shell side by side taken from\n", " this in-depth [powershell tutorial](https://programminghistorian.org/en/lessons/intro-to-powershell#quick-reference)\n", "\n", "## Using the command line\n", "\n", "### Powershell and Bash common commands\n", "\n", "* To go to your $HOME folder:\n", " \n", "```\n", "cd ~\n", "\n", "or\n", "\n", "cd $HOME\n", "```\n", "\n", "* To open explorer or finder for the current folder:\n", "\n", "```\n", "windows explorer do:\n", "\n", " start .\n", "\n", "MacOs finder do:\n", "\n", " open .\n", " \n", "```\n", " \n", "* To move up one folder:\n", "\n", "```\n", "cd ..\n", "```\n", "\n", "* To save typing, remember that hitting the tab key completes filenames\n", "\n", "### To configure powershell on windows\n", "\n", "* first start a powershell terminal with admin privileges, then type:\n", "\n", " `set-executionpolicy remotesigned`\n", " \n", "* then, in your miniconda3 powershel profile, do:\n", "\n", " `Test-Path $profile`\n", " \n", " to see whether you have an existing profile.\n", " \n", "* if you don't have a profile, then do the following (this will overwrite an existing profile, so be aware):\n", "\n", " `New-Item –Path $Profile –Type File –Force`\n", " \n", "* To add to your profile, open with:\n", "\n", " `start $profile`\n", " \n", "### To configure bash or zsh on MacOS\n", "\n", "* open a terminal then type either\n", "\n", " `open .bash_profile`\n", " \n", " or for Catalina\n", " \n", " `open .zshenv`\n", " \n", " \n", "\n", "### Bash and powershell command reference\n", "\n", "| Cmdlet | Alias | Bash Equivalent | Description |\n", "| ------- | ------- | ------- | ------- |\n", "| `Get-ChildItem` | `gci` | `ls` | List the directories and files in the current location. | \n", "| `Set-Location` | `sl` | `cd` | Change to the directory at the given path. Typing `..` rather than a path will move up one directory. |\n", "| `Push-Location` | `pushd` | `pushd` | Changes to the directory. |\n", "| `Pop-Location` | `popd` | `popd` | Changes back to the previous directory after using `pushd` |\n", "| `New-Item` | `ni` | (`touch`) | Creates a new item. Used with no parameter, the item is by default a file. Using `mkdir` is a shortcut for including the parameter `-ItemType dir`. |\n", "| `mkdir` | none | `mkdir` | Creates a new directory. (See `New-Item`.) |\n", "| `Explorer` | `start .` | `open .`) | Open something using File Explorer (the GUI) |\n", "| `Remove-Item` | `rm` | `rm` | Deletes something. Permanently! |\n", "| `Move-Item` | `mv` | `mv` | Moves something. Takes two arguments - first a filename (i.e. its present path), then a path for its new location (including the name it should have there). By not changing the path, it can be used to rename files. |\n", "| `Copy-Item` | `cp` | `cp` | Copies a file to a new location. Takes same arguments as move, but keeps the original file in its location. |\n", "| `Write-Output` | `write` | `echo` | Outputs whatever you type. Use redirection to output to a file. Redirection with `>>` will add to the file, rather than overwriting contents. |\n", "| `Get-Content` | `gc` | `cat` | Gets the contents of a file and prints it to the screen. Adding the parameter `-TotalCount` followed by a number x prints only the first x lines. Adding the parameter `-Tail` followed by a number x prints only the final x lines. |\n", "| `Select-String` | `sls` | (`grep`) | Searches for specific content. |\n", "| `Measure-Object` | `measure` | (`wc`) | Gets statistical information about an object. Use `Get-Content` and pipe the output to `Measure-Object` with the parameters `-line`, `-word`, and `-character` to get word count information. |\n", "| `>` | none | `>` |Redirection. Puts the output of the command to the left of `>` into a file to the right of `>`. |\n", "| `\\|` | none | `\\|` |Piping. Takes the output of the command to the left and uses it as the input for the command to the right. |\n", "| `Get-Help` | none | `man` | Gets the help file for a cmdlet. Adding the parameter `-online` opens the help page on TechNet. |\n", "| `exit` | none | `exit` | Exits PowerShell |\n", "\n", "Remember the keyboard shortcuts of `tab` for auto-completion and the up and down arrows to scroll through recent commands. These shortcuts can save a lot of typing!\n", "\n", "## Git\n", "\n", "- A good place to go to learn git fundamentals is this lesson\n", " \n", "\n", "## Pulling changes from the github repository\n", "\n", "When we commit changes to the master branch and push to our github\n", "repository, you'll need to download those changes to keep current. To do\n", "that:\n", "\n", "1) open a shell\n", "\n", "2) cd to the numeric repository\n", "\n", "3) fetch the changes with:\n", " \n", " git fetch origin\n", "\n", "4) make sure you aren't going to clobber any of your own files:\n", " \n", " git status\n", " \n", " you can ignore \"untracked files\", but pay attention to any files\n", " labeled \"modified\". Those will be overwritten when you reset to our\n", " commit, so copy them to a new name or folder.\n", "\n", "5) Finally, get to our commit with:\n", " \n", " git reset --hard origin/master\n", " \n", " If that worked, then printing the most recent log entry:\n", " \n", " git log -1\n", " \n", " should tell you the most recent commit message, and it should agree\n", " with what you see at our github repository.\n", "\n", "# Books and tutorials\n", "\n", " - We will be referring to our version of David Pine's Introduction to Python:\n", " http://phaustin.github.io/pyman. The notebooks for each chapter are included\n", " in the [numeric_students/pyman](https://github.com/phaustin/numeric_students/tree/downloads/pyman) folder.\n", " - If you are new to python, I would recommend you also go over the\n", " following short ebook in detail:\n", " - Jake Vanderplas' [Whirlwind tour of\n", " Python](https://github.com/jakevdp/WhirlwindTourOfPython/blob/f40b435dea823ad5f094d48d158cc8b8f282e9d5/Index.ipynb)\n", " is available both as a set of notebooks which you can clone from\n", " github or as a free ebook:\n", " \n", " - to get the notebooks do:\n", " \n", " git clone \n", " - We will be referencing chapters from:\n", " - A Springer ebook from the UBC library: [Numerical\n", " Python](https://login.ezproxy.library.ubc.ca/login?qurl=https%3a%2f%2flink.springer.com%2fopenurl%3fgenre%3dbook%26isbn%3d978-1-4842-0554-9)\n", " - with code on github:\n", " \n", " git clone\n", " \n", " - Two other texts that are available as a set of notebooks you can\n", " clone with git:\n", " - \n", " - \n", " - My favorite O'Reilly book is:\n", " - [Python for Data\n", " Analysis](http://shop.oreilly.com/product/0636920023784.do)\n", " - Some other resources:\n", " - If you know Matlab, there is [Numpy for Maltab\n", " users](http://wiki.scipy.org/NumPy_for_Matlab_Users)\n", " - Here is a [python\n", " translation](http://nbviewer.jupyter.org/gist/phaustin/1af744215e51562d010b9f6a19c0724c)\n", " by [Don\n", " MacMillen](http://blogs.siam.org/from-matlab-guide-to-ipython-notebook/)\n", " of [Chapter 1 of his matlab\n", " guide](http://clouds.eos.ubc.ca/~phil/courses/atsc301/downloads_pw/matlab_guide_2nd.pdf)\n", " - [Python data structure cheat\n", " sheet](pdfs/Python-data-manipulations.pdf)\n", " - [Numpy beginners\n", " guide](http://www.packtpub.com/numpy-mathematical-2e-beginners-guide/book)\n", " - [Learning\n", " Ipython](http://www.packtpub.com/learning-ipython-for-interactive-computing-and-data-visualization/book)\n", " - [The official Python\n", " tutorial](http://docs.python.org/tut/tut.html)\n", " - [Numpy\n", " cookbook](http://www.packtpub.com/numpy-for-python-cookbook/book)\n", " - A general computing introduction: [How to think like a computer\n", " scientist](http://www.openbookproject.net/thinkcs/python/english3e)\n", " with an [interactive\n", " version](http://interactivepython.org/courselib/static/thinkcspy/index.html)\n", " - [Think Stats](http://greenteapress.com/wp/think-stats-2e/)\n", " - [Think Bayes](http://greenteapress.com/wp/think-bayes/)" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "jupytext": { "cell_metadata_filter": "-all", "formats": "ipynb,py:percent", "notebook_metadata_filter": "all,-language_info,-toc,-latex_envs" }, "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.7.6" }, "toc": { "base_numbering": 1, "nav_menu": {}, "number_sections": true, "sideBar": true, "skip_h1_title": false, "title_cell": "Table of Contents", "title_sidebar": "Contents", "toc_cell": false, "toc_position": {}, "toc_section_display": true, "toc_window_display": true } }, "nbformat": 4, "nbformat_minor": 2 }