mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Merge pull request #355 from smithandrewl/master
Capitalization / Spelling
This commit is contained in:
+2
-2
@@ -64,7 +64,7 @@ to do that which also shows status and warning messages in the statusbar would b
|
|||||||
Python-mode
|
Python-mode
|
||||||
^^^^^^^^^^^
|
^^^^^^^^^^^
|
||||||
|
|
||||||
Python-mode_ is a complex solution in VIM for working with python code.
|
Python-mode_ is a complex solution in VIM for working with Python code.
|
||||||
It has:
|
It has:
|
||||||
|
|
||||||
- Asynchronous Python code checking (pylint, pyflakes, pep8, mccabe) in any combination
|
- Asynchronous Python code checking (pylint, pyflakes, pep8, mccabe) in any combination
|
||||||
@@ -94,7 +94,7 @@ Emacs is a powerful text editor. It's fully programmable (lisp), but
|
|||||||
it can be some work to wire up correctly. A good start if you're
|
it can be some work to wire up correctly. A good start if you're
|
||||||
already an Emacs user is `Python Programming in Emacs`_ at EmacsWiki.
|
already an Emacs user is `Python Programming in Emacs`_ at EmacsWiki.
|
||||||
|
|
||||||
1. Emacs itself comes with a python mode.
|
1. Emacs itself comes with a Python mode.
|
||||||
2. Python ships with an alternate version:
|
2. Python ships with an alternate version:
|
||||||
`python-mode.el <https://launchpad.net/python-mode>`_
|
`python-mode.el <https://launchpad.net/python-mode>`_
|
||||||
3. Fabián Ezequiel Gallina's `python.el <https://github.com/fgallina/python.el>`_
|
3. Fabián Ezequiel Gallina's `python.el <https://github.com/fgallina/python.el>`_
|
||||||
|
|||||||
+12
-12
@@ -7,9 +7,9 @@ Beginner
|
|||||||
Learn Python Interactive Tutorial
|
Learn Python Interactive Tutorial
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Learnpython.org is an easy non-intimidating way to get introduced to python.
|
Learnpython.org is an easy non-intimidating way to get introduced to Python.
|
||||||
The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_
|
The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_
|
||||||
website, it has an interactive python interpreter built into the site that
|
website, it has an interactive Python interpreter built into the site that
|
||||||
allows you to go through the lessons without having to install Python locally.
|
allows you to go through the lessons without having to install Python locally.
|
||||||
|
|
||||||
`Learn Python <http://www.learnpython.org/>`_
|
`Learn Python <http://www.learnpython.org/>`_
|
||||||
@@ -52,11 +52,11 @@ Think Python: How to Think Like a Computer Scientist
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Think Python attempts to give an introduction to basic concepts in computer
|
Think Python attempts to give an introduction to basic concepts in computer
|
||||||
science through the use of the python language. The focus was to create a book
|
science through the use of the Python language. The focus was to create a book
|
||||||
with plenty of exercises, minimal jargon and a section in each chapter devoted
|
with plenty of exercises, minimal jargon and a section in each chapter devoted
|
||||||
to the subject of debugging.
|
to the subject of debugging.
|
||||||
|
|
||||||
While exploring the various features available in the python language the
|
While exploring the various features available in the Python language the
|
||||||
author weaves in various design patterns and best practices.
|
author weaves in various design patterns and best practices.
|
||||||
|
|
||||||
The book also includes several case studies which have the reader explore the
|
The book also includes several case studies which have the reader explore the
|
||||||
@@ -72,11 +72,11 @@ Python Koans
|
|||||||
|
|
||||||
Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven
|
Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven
|
||||||
approach, q.v. TEST DRIVEN DESIGN SECTION to provide an interactive tutorial
|
approach, q.v. TEST DRIVEN DESIGN SECTION to provide an interactive tutorial
|
||||||
teaching basic python concepts. By fixing assertion statements that fail in a
|
teaching basic Python concepts. By fixing assertion statements that fail in a
|
||||||
test script, this provides sequential steps to learning python.
|
test script, this provides sequential steps to learning Python.
|
||||||
|
|
||||||
For those used to languages and figuring out puzzles on their own, this can be
|
For those used to languages and figuring out puzzles on their own, this can be
|
||||||
a fun, attractive option. For those new to python and programming, having an
|
a fun, attractive option. For those new to Python and programming, having an
|
||||||
additional resource or reference will be helpful.
|
additional resource or reference will be helpful.
|
||||||
|
|
||||||
`Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_
|
`Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_
|
||||||
@@ -88,7 +88,7 @@ More information about test driven development can be found at these resources:
|
|||||||
A Byte of Python
|
A Byte of Python
|
||||||
~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
A free introductory book that teaches python at the beginner level, it assumes no
|
A free introductory book that teaches Python at the beginner level, it assumes no
|
||||||
previous programming experience.
|
previous programming experience.
|
||||||
|
|
||||||
`A Byte of Python for Python 2.x <http://www.ibiblio.org/swaroopch/byteofpython/read/>`_
|
`A Byte of Python for Python 2.x <http://www.ibiblio.org/swaroopch/byteofpython/read/>`_
|
||||||
@@ -137,8 +137,8 @@ A Primer on Scientific Programming with Python
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
A Primer on Scientific Programming with Python, written by Hans Petter Langtangen,
|
A Primer on Scientific Programming with Python, written by Hans Petter Langtangen,
|
||||||
mainly covers python's usage in scientific field. In the book, examples are
|
mainly covers Python's usage in scientific field. In the book, examples are
|
||||||
choosen from mathematics and the natural sciences.
|
chosen from mathematics and the natural sciences.
|
||||||
|
|
||||||
`A Primer on Scientific Programming with Python <http://www.springer.com/mathematics/computational+science+%26+engineering/book/978-3-642-18365-2>`_
|
`A Primer on Scientific Programming with Python <http://www.springer.com/mathematics/computational+science+%26+engineering/book/978-3-642-18365-2>`_
|
||||||
|
|
||||||
@@ -146,7 +146,7 @@ Numerical Methods in Engineering with Python
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Numerical Methods in Engineering with Python,written by Jaan Kiusalaas, attempts to
|
Numerical Methods in Engineering with Python,written by Jaan Kiusalaas, attempts to
|
||||||
emphasis on numerical methods and how to implement them in python.
|
emphasis on numerical methods and how to implement them in Python.
|
||||||
|
|
||||||
`Numerical Methods in Engineering with Python <http://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_
|
`Numerical Methods in Engineering with Python <http://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_
|
||||||
|
|
||||||
@@ -157,7 +157,7 @@ Python in a Nutshell
|
|||||||
~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Python in a Nutshell, written by Alex Martelli, covers most cross-platform
|
Python in a Nutshell, written by Alex Martelli, covers most cross-platform
|
||||||
python's usage, from its syntax to built-in libraries to advanced topics such
|
Python's usage, from its syntax to built-in libraries to advanced topics such
|
||||||
as writing C extensions.
|
as writing C extensions.
|
||||||
|
|
||||||
`Python in a Nutshell <http://shop.oreilly.com/product/9780596001889.do>`_
|
`Python in a Nutshell <http://shop.oreilly.com/product/9780596001889.do>`_
|
||||||
|
|||||||
+1
-1
@@ -19,7 +19,7 @@ Python-related news.
|
|||||||
Pycoder's Weekly
|
Pycoder's Weekly
|
||||||
~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Pycoder's Weekly is a free weekly python newsletter for Python developers
|
Pycoder's Weekly is a free weekly Python newsletter for Python developers
|
||||||
by Python developers (Project, Articles, News, and Jobs).
|
by Python developers (Project, Articles, News, and Jobs).
|
||||||
|
|
||||||
`Pycoder's Weekly <http://www.pycoders.com/>`_
|
`Pycoder's Weekly <http://www.pycoders.com/>`_
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ Fabric
|
|||||||
|
|
||||||
`Fabric <http://docs.fabfile.org>`_ is a library for simplifying system
|
`Fabric <http://docs.fabfile.org>`_ is a library for simplifying system
|
||||||
administration tasks. While Chef and Puppet tend to focus on managing servers
|
administration tasks. While Chef and Puppet tend to focus on managing servers
|
||||||
and system libraries, fabric is more focused on application level tasks such
|
and system libraries, Fabric is more focused on application level tasks such
|
||||||
as deployment.
|
as deployment.
|
||||||
|
|
||||||
Install Fabric:
|
Install Fabric:
|
||||||
@@ -77,7 +77,7 @@ It supports remote command execution from a central point (master host) to multi
|
|||||||
hosts (minions). It also supports system states which can be used to configure
|
hosts (minions). It also supports system states which can be used to configure
|
||||||
multiple servers using simple template files.
|
multiple servers using simple template files.
|
||||||
|
|
||||||
Salt supports python versions 2.6 and 2.7 and can be installed via pip:
|
Salt supports Python versions 2.6 and 2.7 and can be installed via pip:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
@@ -95,7 +95,7 @@ The following command lists all available minion hosts, using the ping module.
|
|||||||
The host filtering is accomplished by matching the minion id, or using the grains system.
|
The host filtering is accomplished by matching the minion id, or using the grains system.
|
||||||
The `grains <http://docs.saltstack.org/en/latest/topics/targeting/grains.html>`_ system
|
The `grains <http://docs.saltstack.org/en/latest/topics/targeting/grains.html>`_ system
|
||||||
uses static host information like the operating system version or the CPU architecture to
|
uses static host information like the operating system version or the CPU architecture to
|
||||||
provide a host taxonomy for the salt modules.
|
provide a host taxonomy for the Salt modules.
|
||||||
|
|
||||||
The following command lists all available minions running CentOS using the grains system:
|
The following command lists all available minions running CentOS using the grains system:
|
||||||
|
|
||||||
@@ -119,7 +119,7 @@ and start the Apache server:
|
|||||||
- require:
|
- require:
|
||||||
- pkg: apache
|
- pkg: apache
|
||||||
|
|
||||||
State files can be written using YAML, the Jinja2 template system or pure python.
|
State files can be written using YAML, the Jinja2 template system or pure Python.
|
||||||
|
|
||||||
`Salt Documentation <http://docs.saltstack.com>`_
|
`Salt Documentation <http://docs.saltstack.com>`_
|
||||||
|
|
||||||
|
|||||||
@@ -47,7 +47,7 @@ which provides the following features:
|
|||||||
interpreters
|
interpreters
|
||||||
* Running tests in each of the environments, configuring your test tool of
|
* Running tests in each of the environments, configuring your test tool of
|
||||||
choice
|
choice
|
||||||
* Acting as a frontend to Continuous Integration servers, reducing boilerplate
|
* Acting as a front-end to Continuous Integration servers, reducing boilerplate
|
||||||
and merging CI and shell-based testing.
|
and merging CI and shell-based testing.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ Python is frequently used for high-performance scientific applications. Python
|
|||||||
is widely used in academia and scientific projects because it is easy to write,
|
is widely used in academia and scientific projects because it is easy to write,
|
||||||
and it performs really well.
|
and it performs really well.
|
||||||
|
|
||||||
Due to its high performance nature, scientific computing in python often refers
|
Due to its high performance nature, scientific computing in Python often refers
|
||||||
to external libraries, typically written in faster languages (like C, or
|
to external libraries, typically written in faster languages (like C, or
|
||||||
FORTRAN for matrix operations). The main libraries used are `NumPy`_, `SciPy`_
|
FORTRAN for matrix operations). The main libraries used are `NumPy`_, `SciPy`_
|
||||||
and `Matplotlib`_. Going into detail about these libraries is beyond the scope
|
and `Matplotlib`_. Going into detail about these libraries is beyond the scope
|
||||||
@@ -24,11 +24,11 @@ Tools
|
|||||||
IPython
|
IPython
|
||||||
-------
|
-------
|
||||||
|
|
||||||
`IPytthon <http://ipython.org/>`_ is an enhanced version of Python interpreter.
|
`IPython <http://ipython.org/>`_ is an enhanced version of Python interpreter.
|
||||||
The features it provides are of great interest for the scientists. The `inline mode`
|
The features it provides are of great interest for the scientists. The `inline mode`
|
||||||
allow graphics and plots to be displayed in the terminal (Qt based version).
|
allow graphics and plots to be displayed in the terminal (Qt based version).
|
||||||
Moreover the `notebook` mode supports literate programming and reproducible science
|
Moreover the `notebook` mode supports literate programming and reproducible science
|
||||||
generating a web-based python notebook. This notebook allowing to store chunk of
|
generating a web-based Python notebook. This notebook allowing to store chunk of
|
||||||
Python code along side to the results and additional comments (HTML, LaTeX, Markdown).
|
Python code along side to the results and additional comments (HTML, LaTeX, Markdown).
|
||||||
The notebook could be shared and exported in various file formats.
|
The notebook could be shared and exported in various file formats.
|
||||||
|
|
||||||
@@ -64,7 +64,7 @@ SciPy
|
|||||||
|
|
||||||
`SciPy <http://scipy.org/>`_ is a library that uses Numpy for more mathematical
|
`SciPy <http://scipy.org/>`_ is a library that uses Numpy for more mathematical
|
||||||
functions. SciPy uses NumPy arrays as the basic data structure. SciPy comes
|
functions. SciPy uses NumPy arrays as the basic data structure. SciPy comes
|
||||||
with modules for various commonly used tasks in scientific programing, for
|
with modules for various commonly used tasks in scientific programming, for
|
||||||
example: linear algebra, integration (calculus), ordinary differential equation
|
example: linear algebra, integration (calculus), ordinary differential equation
|
||||||
solvers and signal processing.
|
solvers and signal processing.
|
||||||
|
|
||||||
@@ -86,7 +86,7 @@ based on Numpy and which provides many useful functions for accessing,
|
|||||||
indexing, merging and grouping data easily. The main data structure (DataFrame)
|
indexing, merging and grouping data easily. The main data structure (DataFrame)
|
||||||
is close to what could be found in the R statistical package, that is
|
is close to what could be found in the R statistical package, that is
|
||||||
an heterogeneous data tables with name indexing, time series operations
|
an heterogeneous data tables with name indexing, time series operations
|
||||||
and auto-alignement of data.
|
and auto-alignment of data.
|
||||||
|
|
||||||
Rpy2
|
Rpy2
|
||||||
----
|
----
|
||||||
@@ -120,7 +120,7 @@ Many people who do scientific computing are on Windows. And yet many of the
|
|||||||
scientific computing packages are notoriously difficult to build and install.
|
scientific computing packages are notoriously difficult to build and install.
|
||||||
`Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ however, has
|
`Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ however, has
|
||||||
compiled a list of Windows binaries for many useful Python packages. The list
|
compiled a list of Windows binaries for many useful Python packages. The list
|
||||||
of packages has grown from a mainly scientific python resource to a more
|
of packages has grown from a mainly scientific Python resource to a more
|
||||||
general list. It might be a good idea to check it out if you're on Windows.
|
general list. It might be a good idea to check it out if you're on Windows.
|
||||||
|
|
||||||
Enthought Python Distribution (EPD)
|
Enthought Python Distribution (EPD)
|
||||||
|
|||||||
@@ -271,10 +271,10 @@ and to the templates themselves.
|
|||||||
templates. This convenience can lead to uncontrolled
|
templates. This convenience can lead to uncontrolled
|
||||||
increase in complexity, and often harder to find bugs.
|
increase in complexity, and often harder to find bugs.
|
||||||
|
|
||||||
- It is often necessary to mix javascript templates with
|
- It is often necessary to mix JavaScript templates with
|
||||||
HTML templates. A sane approach to this design is to isolate
|
HTML templates. A sane approach to this design is to isolate
|
||||||
the parts where the HTML template passes some variable content
|
the parts where the HTML template passes some variable content
|
||||||
to the javascript code.
|
to the JavaScript code.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@@ -370,7 +370,7 @@ The `base.html` file can be used as base for all site pages which are for exampl
|
|||||||
</body>
|
</body>
|
||||||
|
|
||||||
|
|
||||||
The next listing is our site page (`site.html`) loaded in the python app which extends `base.html`. The content block is
|
The next listing is our site page (`site.html`) loaded in the Python app which extends `base.html`. The content block is
|
||||||
automatically set into the corresponding block in the base.html page.
|
automatically set into the corresponding block in the base.html page.
|
||||||
|
|
||||||
.. code-block:: html
|
.. code-block:: html
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ untangle
|
|||||||
an XML document and returns a Python object which mirrors the nodes and
|
an XML document and returns a Python object which mirrors the nodes and
|
||||||
attributes in its structure.
|
attributes in its structure.
|
||||||
|
|
||||||
For example, an xml file like this:
|
For example, an XML file like this:
|
||||||
|
|
||||||
.. code-block:: xml
|
.. code-block:: xml
|
||||||
|
|
||||||
@@ -36,9 +36,9 @@ xmltodict
|
|||||||
---------
|
---------
|
||||||
|
|
||||||
`xmltodict <http://github.com/martinblech/xmltodict>`_ is another simple
|
`xmltodict <http://github.com/martinblech/xmltodict>`_ is another simple
|
||||||
library that aims at making xml feel like working with json.
|
library that aims at making XML feel like working with JSON.
|
||||||
|
|
||||||
An xml file like this:
|
An XML file like this:
|
||||||
|
|
||||||
.. code-block:: xml
|
.. code-block:: xml
|
||||||
|
|
||||||
@@ -52,7 +52,7 @@ An xml file like this:
|
|||||||
</plus>
|
</plus>
|
||||||
</mydocument>
|
</mydocument>
|
||||||
|
|
||||||
can be loaded into a python dict like this:
|
can be loaded into a Python dict like this:
|
||||||
|
|
||||||
.. code-block:: python
|
.. code-block:: python
|
||||||
|
|
||||||
@@ -68,6 +68,6 @@ and then you can access elements, attributes and values like this:
|
|||||||
doc['mydocument']['plus']['@a'] # == u'complex'
|
doc['mydocument']['plus']['@a'] # == u'complex'
|
||||||
doc['mydocument']['plus']['#text'] # == u'element as well'
|
doc['mydocument']['plus']['#text'] # == u'element as well'
|
||||||
|
|
||||||
xmltodict also lets you roundtrip back to xml with the unparse function,
|
xmltodict also lets you roundtrip back to XML with the unparse function,
|
||||||
has a streaming mode suitable for handling files that don't fit in memory
|
has a streaming mode suitable for handling files that don't fit in memory
|
||||||
and supports namespaces.
|
and supports namespaces.
|
||||||
|
|||||||
@@ -46,7 +46,7 @@ Go to your command prompt and type:
|
|||||||
$ python -m SimpleHTTPServer 9000
|
$ python -m SimpleHTTPServer 9000
|
||||||
|
|
||||||
This runs a simple http server running on port 9000 and will list all packages
|
This runs a simple http server running on port 9000 and will list all packages
|
||||||
(like **MyPackage**). Now you can install **MyPackage** using any python
|
(like **MyPackage**). Now you can install **MyPackage** using any Python
|
||||||
package installer. Using Pip, you would do it like:
|
package installer. Using Pip, you would do it like:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|||||||
Reference in New Issue
Block a user