Difference between revisions of "Python Resources"

From Simson Garfinkel
Jump to navigationJump to search
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Learning Python==
I've reviewed these resources and highly recommend them. I periodically update this page, but it may be out of date.
I've reviewed these resources and highly recommend them.


==Learning to use Python==
If you want to learn to use python, here are the key skills that you need to know:
* Basic Python syntax, including the role of whitespace, variables, objects, functions and modules.
* Intermediate Python syntax, including lambdas, list comprehensions, generators, and decorators.
* Building unit tests with unittest or (better) pytest
* Python package management with setuptools and pip.
* Editing python programs with a decent editor, such as pycharm, or an interactive IDE such as spyder or Jupyter notebook. You can also use emacs or vim. Don't use Idle or Notepad++ or nano.
Do not learn python2.
To learn python you must be able to run Python programs. You have two main options:
# Although Python is pre-installed on many computers, do not use the pre-installed version, as it is typically out of date. (It's also frequently python2, which is abandoned.) You can instead download and install [https://www.anaconda.com/ the Anaconda Python distribution]. It has all of the packages you need.
# Alternatively, you can learn it entirely using web-based Jupyter notebooks.
===If you don't know how to program===
If you have never programmed with Python before, you may want to start with DataCamp's Learn python by example:
If you have never programmed with Python before, you may want to start with DataCamp's Learn python by example:
* https://www.learnpython.org, powered by DataCamp. For example, look at the [https://www.learnpython.org/en/String_Formatting String Formatting] lesson
* https://www.learnpython.org, powered by DataCamp. For example, look at the [https://www.learnpython.org/en/String_Formatting String Formatting] lesson
* [https://www.w3schools.com/python/default.asp  W3School's Python Tutorial]


If you want to just read, I recommend starting with the Python Tutorial:
I also recommend:  
* [https://docs.python.org/3/tutorial/index.html Python 3 Tutorial]
 
If you have not programmed before, you may try:
* [https://www.diveinto.org/python3/ Dive Into Python 3] (book, online for free; a little dated.)
* [https://www.diveinto.org/python3/ Dive Into Python 3] (book, online for free; a little dated.)
* [https://wiki.python.org/moin/BeginnersGuide/NonProgrammers Python for Non-Programmers]
* [https://wiki.python.org/moin/BeginnersGuide/NonProgrammers Python for Non-Programmers]


If you have programmed before, at this point I recommend:
===If you know how to program===
* [https://docs.python.org/3/ Official Python Documentation]. Just read the documentation. Honestly.
If you know another programming language (e.g. C, C++, FORTRAN, Java, etc.), you can learn Python in about 2 hours.
 
Start by reading the Python Tutorial:
* [https://docs.python.org/3/tutorial/index.html Python 3 Tutorial]
 
I then recommend reading the documentation:
* [https://docs.python.org/3/ Official Python Documentation]. Just read the documentation. Honestly. It's well-written.
* [http://book.pythontips.com/en/latest/index.html Python Tips] (book, online for free)
* [http://book.pythontips.com/en/latest/index.html Python Tips] (book, online for free)
* [https://github.com/google/styleguide/blob/gh-pages/pyguide.md Python Google Style Guide].
* [https://github.com/google/styleguide/blob/gh-pages/pyguide.md Python Google Style Guide].
Line 21: Line 41:


===Developer Tools===
===Developer Tools===
* PyCharm
* [https://www.jetbrains.com/pycharm/ PyCharm], free for educational use (if you have a .edu email address)
* Jupyter Notebook
* Jupyter Notebook (comes with Anaconda; also available https://jupyter.org/ on the web!)
 
===Financial Modeling===
Nice blog entries:
* [https://pbpython.com/amortization-model.html Building a Financial Model with Pandas], looks at mortgage calculator
 
Some books:
* [https://www.amazon.com/Python-Finance-Analyze-Financial-Data/dp/1491945281 Python for Finance: Analyzing Big Financial Data] (O'Reilly)
* [https://www.amazon.com/Financial-Modelling-Python-Shayne-Fletcher/dp/0470987847 Financial Modelling in Python] (Wiley Finance)


===Numerical Data Processing===
===Numerical Data Processing===
* numpy - numeric analysis in python (needed for matplotlib)
* numpy and scipy are the standard numerical analysis tools in python.
* pandas or SparkSQL
* pandas is a popular data analysis platform that integrates with numpy. You can make it run on a cluster with Dask.
* Alternatively, you can use Apache Spark and SparkSQL
* tabulate - create tables easily (but see my tytable replacement)
* tabulate - create tables easily (but see my tytable replacement)


===Date Data===
===Date Data===
* [http://labix.org/python-dateutil dateutil], part of Conda
For working with dates, see:
* [http://labix.org/python-dateutil dateutil], included in the Anaconda distribution
* [http://codespeak.net/icalendar/ iCalendar], package for Python, generates calendears
* [http://codespeak.net/icalendar/ iCalendar], package for Python, generates calendears
===String Formatting===
* https://pyformat.info --- Big how-to on using the % and .format() formatting


===Image Manipulation===
===Image Manipulation===
Line 48: Line 75:


===Graphing===
===Graphing===
* [http://matplotlib.org/ matplotlib] - a handy system for plotting in python. ([[Short example of using matplotlib within jupyter]])
* [http://matplotlib.org/ matplotlib] - A well-developed system for plotting 2d and 3d static graphis. (See my [[Short example of using matplotlib within jupyter]])
* holoview
* holoview - a more modern but less featured system.
* [https://altair-viz.github.io/index.html Altair: Declarative Visualization in Python]
* [https://altair-viz.github.io/index.html Altair: Declarative Visualization in Python]
* [https://github.com/geopy/geopy geopy] - geocoding for Python
* [https://github.com/geopy/geopy geopy] - geocoding for Python
Line 59: Line 86:
* http://plotdevice.io/
* http://plotdevice.io/
* http://www.cc.gatech.edu/classes/AY2013/cs1301_summer/presentations/calico_graphics.pdf
* http://www.cc.gatech.edu/classes/AY2013/cs1301_summer/presentations/calico_graphics.pdf
===Games===
* http://www.pygame.org/ pygame - a Python game development system
* [http://peak.telecommunity.com/DevCenter/EasyInstall PEAK Easy Install]
* [http://www.crystalspace3d.org/ Crystal Space 3D]
* [http://www.vpython.org/ VPython 3D Programming in Python]


===Database Access===
===Database Access===
Line 81: Line 102:


===Python GUI Options===
===Python GUI Options===
I need to write some programs that use GUI.  
I recommend writing GUI's using a web browser as a front end and a local web server (see next section).


If you must write a native app, I recommend using:
* pyqt - Use PyQT5 (it's part of Anaconda)
* pyqt - Use PyQT5 (it's part of Anaconda)
* [http://www.fltk.org/ FLTK], the Fast Light Toolkit
* [http://www.fltk.org/ FLTK], the Fast Light Toolkit
However, I strongly recommend writing your python program as a web-based app (see next section)


==Building Web Applications==
==Building Web Applications==
You basically have two options:
You should use a framework that implements Python's [https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface Web Server Gateway Interface (WSGI)] to write web apps. Popular implementations are:
* Write a CGI script (slow, but easy. Don't use for more than 1 request every 10 seconds)
 
* Some sort of [https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface Web Server Gateway Interface] (WSGI). Options include:
* Bottle (easy, and the whole thing runs from a single file)
** Bottle (easy, and the whole thing runs from a single file)
* Flask (can run on Apache with Passenger, but needs its own domain name)
** Flask (can run on Apache with Passenger, but needs its own domain name)
** Writing your own (don't do this.)


The WSGI server needs to be run from a program that receives the Port80 connections. The two ways I've done this are:
Bottle has an built-in web server for development. For high performance you can combine it with CherryPy or use the Apache wsgi module.


* mod_wsgi running within Apache. (This works surprisingly well and allows you to run bottle or flask side-by-side other systems)
* CherryPy (Includes its own web server and will hand off to Bottle or Flas.)


For more information, see:
For more information, see:
Line 103: Line 123:
* https://github.com/MichaelPereira/webhooks-demo-application
* https://github.com/MichaelPereira/webhooks-demo-application
* https://mattcarrier.com/flask-dreamhost-setup/
* https://mattcarrier.com/flask-dreamhost-setup/
* https://www.byteconsole.com/get-flask-up-and-running-on-a-dreamhost-server-with-passenger/


If you are using anything other CGI, you need some way to tell the web server to reload your python program. (You don't need to do this with CGI---it reloads Python and your program every time you serve another request. That's why it's so slow...)
If you are using anything other CGI, you need some way to tell the web server to reload your python program. (You don't need to do this with CGI---it reloads Python and your program every time you serve another request. That's why it's so slow...)


===Running WSGI on Dreamhost===
To reload your program on Dreamhost with passenger:
To reload your program on Dreamhost with passenger:


Line 116: Line 136:


===Using Passengers on Dreamhost:===
===Using Passengers on Dreamhost:===
* https://www.byteconsole.com/get-flask-up-and-running-on-a-dreamhost-server-with-passenger/
* https://help.dreamhost.com/hc/en-us/articles/215769578-Passenger-overview
* https://help.dreamhost.com/hc/en-us/articles/215769578-Passenger-overview
* https://help.dreamhost.com/hc/en-us/articles/216137717-Python-overview
* https://help.dreamhost.com/hc/en-us/articles/216137717-Python-overview
Line 123: Line 144:
* https://help.dreamhost.com/hc/en-us/articles/115000221112-Using-pip-to-install-Python-modules
* https://help.dreamhost.com/hc/en-us/articles/115000221112-Using-pip-to-install-Python-modules


==Python Installation==
===Good Tutorials===
If you are using a Mac, you almost certainly want to ditch Apple's python implementation and instead install your own.
Writing a full application with Apache, Bottle and MongoDB:
 
* https://reachtim.com/articles/BAM-Short-Stack.html
I now recommend the [https://www.anaconda.com/ Anaconda Python distribution], because it has almost everything that you need, and it's easy to add new modules.
 
If you want to write a Python program with a GUI that can be run on any system, you'll need to use  Tkinter (Python's Tcl/Tk bindings). If you want to actually enjoy what you are writing, you want to use PyQT5..


=Advanced Python=
=Advanced Python=

Latest revision as of 17:17, 2 February 2021

I've reviewed these resources and highly recommend them. I periodically update this page, but it may be out of date.

Learning to use Python

If you want to learn to use python, here are the key skills that you need to know:

  • Basic Python syntax, including the role of whitespace, variables, objects, functions and modules.
  • Intermediate Python syntax, including lambdas, list comprehensions, generators, and decorators.
  • Building unit tests with unittest or (better) pytest
  • Python package management with setuptools and pip.
  • Editing python programs with a decent editor, such as pycharm, or an interactive IDE such as spyder or Jupyter notebook. You can also use emacs or vim. Don't use Idle or Notepad++ or nano.

Do not learn python2.

To learn python you must be able to run Python programs. You have two main options:

  1. Although Python is pre-installed on many computers, do not use the pre-installed version, as it is typically out of date. (It's also frequently python2, which is abandoned.) You can instead download and install the Anaconda Python distribution. It has all of the packages you need.
  2. Alternatively, you can learn it entirely using web-based Jupyter notebooks.

If you don't know how to program

If you have never programmed with Python before, you may want to start with DataCamp's Learn python by example:

I also recommend:

If you know how to program

If you know another programming language (e.g. C, C++, FORTRAN, Java, etc.), you can learn Python in about 2 hours.

Start by reading the Python Tutorial:

I then recommend reading the documentation:

Using Python

Recommended packages and tools for different tasks

Developer Tools

  • PyCharm, free for educational use (if you have a .edu email address)
  • Jupyter Notebook (comes with Anaconda; also available https://jupyter.org/ on the web!)

Financial Modeling

Nice blog entries:

Some books:

Numerical Data Processing

  • numpy and scipy are the standard numerical analysis tools in python.
  • pandas is a popular data analysis platform that integrates with numpy. You can make it run on a cluster with Dask.
  • Alternatively, you can use Apache Spark and SparkSQL
  • tabulate - create tables easily (but see my tytable replacement)

Date Data

For working with dates, see:

  • dateutil, included in the Anaconda distribution
  • iCalendar, package for Python, generates calendears

Image Manipulation

  • Use Pillow, the Python2/3 fork of Python Image Library (PIL).

Fun examples:

Text Processing

See Text processing notes.

Graphing

Easy Graphics

Database Access

Python contains built-in support for SQLite3.

For using MySQL, you'll need a connector. There are many available.

Install MySQL connector on anaconda:

   conda install mysql-connector-python

Then you can:

   import mysql.connector as mysql
   c = mysql.connect(host=host,database=db,user=user,password=password)

I generally prefer PyMySQL, as it's pure-python and has fewer dependencies.

Python GUI Options

I recommend writing GUI's using a web browser as a front end and a local web server (see next section).

If you must write a native app, I recommend using:

  • pyqt - Use PyQT5 (it's part of Anaconda)
  • FLTK, the Fast Light Toolkit

However, I strongly recommend writing your python program as a web-based app (see next section)

Building Web Applications

You should use a framework that implements Python's Web Server Gateway Interface (WSGI) to write web apps. Popular implementations are:

  • Bottle (easy, and the whole thing runs from a single file)
  • Flask (can run on Apache with Passenger, but needs its own domain name)

Bottle has an built-in web server for development. For high performance you can combine it with CherryPy or use the Apache wsgi module.


For more information, see:

If you are using anything other CGI, you need some way to tell the web server to reload your python program. (You don't need to do this with CGI---it reloads Python and your program every time you serve another request. That's why it's so slow...)

Running WSGI on Dreamhost

To reload your program on Dreamhost with passenger:

   $ touch tmp/restart.txt         # reload your program

To reload your program with mod_wsgi:

   $ touch wsgi_app.py 

Using Passengers on Dreamhost:

Good Tutorials

Writing a full application with Apache, Bottle and MongoDB:

Advanced Python