This page lists web sites, PDF documents, Jupyter notebooks, and Python packages that have been mentioned during the course.
It’s not an attempt to list everything related to each of those topics; just to collect those resources that have already been mentioned into one place.
It is a companion to the Recipes page.
Stack Overflow is a community of programmers, and a knowledge base of programming questions and answers. You can search it directly from its site; it also shows up in Google search.
- Think Python, by Allen Downey – the class text
- Python 3.6 Documentation
- Python 3.6 Standard Library
- The Hitchhiker’s Guide to Python, especially Writing Great Python Code
- Python Tutor interactive visualization
- HackerRank Python Introduction
- How to Think Like a Computer Scientist interactive course. Register here and enter “thinkcspy” as the course name.
- Google’s Python Class
- Automate the Boring Stuff with Python (includes video tutorials)
- Practice Python exercises
- Official Python Tutorial
- Spring 2014 NINJA tutorial: Python exercises
Python Style Guides
- PEP 8 – Style Guide for Python Code
- PEP 257 – Docstring Conventions
- Google Style Guide
- GeneFinder in Google Style (see how it compares to master here)
These have moved to Atom recipes.
https://teletype.atom.io is like Google Docs for Atom. It enables real-time collaborative editing of a single Python file from two or more computers.
- Pro Git
- Great visualization of basic Git commands for moving source around
- A Visual Git Reference
- GitHub’s Git Cheat Sheet (PDF)
- A fantastic visual introduction to the high-level concepts around Git and branching. If you are at all interested in using branches, this is one is not to be missed.
- Why is Git so hard? (it’s not just you!)
- Try Git
- Learn Git Branching
Git Tutorials From Past Semesters
- Spring 2014 NINJA tutorial: GitHub Help
- Spring 2014 NINJA tutorial: Introduction to Version Control
- Spring 2014 NINJA tutorial: Pushing to your GitHub repository
Git & GitHub presentation (thanks: Chris)
One-page cheat sheet (PDF, thanks: Celine)
- How to use Jupyter Notebooks
- Jupyter Keyboard Shortcuts (compact)
- Jupyter Keyboard Shortcuts (longer)
- 28 Jupyter Notebook tips, tricks and shortcuts
There are a number of types of UML diagrams. For this class, the most useful are:
- A Class Diagram describes the responsibilities of and relationships between the classes in a system.
- An Object Diagram shows the relationship between objects (instances of classes). (The relationship between a class diagram and an object diagram is the “noun” version of the relationship between a static call graph and a dynamic call graph.)
- A Sequence Diagram shows how objects operate with each other. You can use it to show function (including method) calls and returns between two or more objects. You can also use it to show the flow of actions and responses between a user and the system.
Depending on your project, these may also be helpful:
- A State Diagram depicts the different states that a system can be in. In this class, it is most useful to describe interactive programs, where a game might be displaying one of several screens. Sometimes it is useful to create state diagrams for individual objects within a program, rather than one diagram for the entire program state.
- A Use Case diagram represents the relationship between the user and the system. In a complex system that is defined UOCD-style, starting from use cases, this kind of diagram can be helpful in collecting use cases and starting to translate them into system structure and behavior.
Diagram Type Directories
These online references variously include examples, text descriptions, and discussions of when to use each one.
UML Distilled, by Martin Fowler, is more involved reference that also has a lot of good material for how to think about programming in general. It’s available at the Olin Library.
Drawing by Hand
Any of the Olin printer/scanners can mail a scan to you. For a diagram, taking a photo from a recent phone will probably work just as well.
For simple diagrams, you can get by with the draw tools in PowerPoint, Keynote, or Google Slides.
- Gliffy and LucidChart are cloud-based collaborative diagram editors. Gliffy is free for students. (I don’t know whether the collaborative features are free.)
- There’s a variety of free / open source draw programs, and also UML-specific drawing programs, mostly written in Java; I’m not familiar with that world.
Text-based diagram tools.
PlantUML produces an image from a text description. It can create a variety of different kinds of diagrams, shown on its home page.
Mermaid is (IMO) easier to install and use, and produces several useful diagram types, but not class diagrams.
There are Atom plugins for PlantUML and Mermaid, that display the image in one pane while you edit the text in another. I’ve used the Mermaid plugin.
GraphViz is a general-purpose text-to-graph program. It’s not specific to, and doesn’t know about, class diagrams or UML, but can be used for this. It’s a useful tool to have in your toolbox.
These are tools that create UML diagrams from Python sources.
The PyCharm Python IDE (Integrated Development Environment) has this feature. I’ve heard that quite a few students in the Olin community use PyCharm; I don’t know that any use this feature.
These appealing, but I’ve found it more helpfully for understanding a pile of code that has been left, without adequate docs, or your doorstep, than for designing of documenting your own code. Done properly, a diagram is expressive and reflects intent: how you position elements, what you leave out, focus on and emphasize different elements in your design. Just as writing prose documentation for your code can lead you to realize how you should have written it (and cause you to go back and revise it, if you’ve got time), the process of creating a diagrams can help you design your system. Tools that run on code that’s already written, and make diagrams mechanically, don’t come out as well, and deprive you of those benefits.