mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
fixed a few typos
This commit is contained in:
@@ -23,7 +23,7 @@ both popular and exotic.
|
|||||||
pydoc
|
pydoc
|
||||||
-----
|
-----
|
||||||
|
|
||||||
:program:`pydoc` is a utlity that is installed when you install Python.
|
:program:`pydoc` is a utility that is installed when you install Python.
|
||||||
It allows you to quickly retrieve and search for documentation from your
|
It allows you to quickly retrieve and search for documentation from your
|
||||||
shell. For example, if you needed a quick refresher on the
|
shell. For example, if you needed a quick refresher on the
|
||||||
:mod:`time` module, pulling up documentation would be as simple as
|
:mod:`time` module, pulling up documentation would be as simple as
|
||||||
|
|||||||
@@ -255,8 +255,8 @@ system. `Puppet Forge <https://forge.puppetlabs.com/>`_ is a repository for
|
|||||||
modules written by the community for Open Source and Enterprise Puppet.
|
modules written by the community for Open Source and Enterprise Puppet.
|
||||||
|
|
||||||
Puppet Agents are installed on nodes whose state needs to be monitored or
|
Puppet Agents are installed on nodes whose state needs to be monitored or
|
||||||
changed. A desginated server known as the Puppet Master is responsible for
|
changed. A designated server known as the Puppet Master is responsible for
|
||||||
orchastrating the agent nodes.
|
orchestrating the agent nodes.
|
||||||
|
|
||||||
Agent nodes send basic facts about the system such as to the operating system,
|
Agent nodes send basic facts about the system such as to the operating system,
|
||||||
kernel, architecture, ip address, hostname etc. to the Puppet Master.
|
kernel, architecture, ip address, hostname etc. to the Puppet Master.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ and the mailing list https://groups.google.com/forum/#!forum/project-camelot
|
|||||||
|
|
||||||
Cocoa
|
Cocoa
|
||||||
-----
|
-----
|
||||||
.. note:: The Cocoa framework is only available on OS X. Don't pick this if you're writing a cross-platform application!
|
.. note:: The Cocoa framework is only available on OS X. Don't pick this if you're writing a cross-platform application!
|
||||||
|
|
||||||
GTk
|
GTk
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -107,7 +107,7 @@ Prerequisite is to have installed :ref:`Python, Setuptools and pywin32 dependenc
|
|||||||
- `Manual <http://www.pyinstaller.org/export/d3398dd79b68901ae1edd761f3fe0f4ff19cfb1a/project/doc/Manual.html?format=raw>`_
|
- `Manual <http://www.pyinstaller.org/export/d3398dd79b68901ae1edd761f3fe0f4ff19cfb1a/project/doc/Manual.html?format=raw>`_
|
||||||
|
|
||||||
|
|
||||||
OS X
|
OS X
|
||||||
----
|
----
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -23,7 +23,7 @@ The downside of distributing code like this is that it relies on the
|
|||||||
recipient understanding how to install the required version of Python,
|
recipient understanding how to install the required version of Python,
|
||||||
and being able and willing to use tools such as pip to install your code's
|
and being able and willing to use tools such as pip to install your code's
|
||||||
other dependencies. This is fine when distributing to other developers, but
|
other dependencies. This is fine when distributing to other developers, but
|
||||||
makes this method unsuitable for distributing applications to end-uers.
|
makes this method unsuitable for distributing applications to end-users.
|
||||||
|
|
||||||
The `Python Packaging Guide <https://python-packaging-user-guide.readthedocs.org/en/latest/>`_
|
The `Python Packaging Guide <https://python-packaging-user-guide.readthedocs.org/en/latest/>`_
|
||||||
provides an extensive guide on creating and maintaining Python packages.
|
provides an extensive guide on creating and maintaining Python packages.
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ Further Configuration of Pip and Virtualenv
|
|||||||
Requiring an active virtual environment for ``pip``
|
Requiring an active virtual environment for ``pip``
|
||||||
---------------------------------------------------
|
---------------------------------------------------
|
||||||
|
|
||||||
By now it should be clear that using virtual envirtonments is a great way to
|
By now it should be clear that using virtual environments is a great way to
|
||||||
keep your development environment clean and keeping different projects'
|
keep your development environment clean and keeping different projects'
|
||||||
requirements separate.
|
requirements separate.
|
||||||
|
|
||||||
@@ -71,7 +71,7 @@ add the following lines to this new file:
|
|||||||
|
|
||||||
|
|
||||||
You will of course need to install some packages globally (usually ones that
|
You will of course need to install some packages globally (usually ones that
|
||||||
you use across different projects consistenly) and this can be accomplished by
|
you use across different projects consistently) and this can be accomplished by
|
||||||
adding the following to your :file:`~/.bashrc` file:
|
adding the following to your :file:`~/.bashrc` file:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
@@ -94,7 +94,7 @@ that you use. For example, you may be using the ``requests`` library in a lot
|
|||||||
of different projects.
|
of different projects.
|
||||||
|
|
||||||
It is surely unnecessary to re-download the same packages/libraries each time
|
It is surely unnecessary to re-download the same packages/libraries each time
|
||||||
you start working on a new project (and in a new virtual environmen as a result).
|
you start working on a new project (and in a new virtual environment as a result).
|
||||||
Fortunately, you can configure pip in such a way that it tries to reuse already
|
Fortunately, you can configure pip in such a way that it tries to reuse already
|
||||||
installed packages.
|
installed packages.
|
||||||
|
|
||||||
|
|||||||
@@ -141,7 +141,7 @@ comment block is a programmer's note. The docstring describes the
|
|||||||
"""Returns the square root of self times self."""
|
"""Returns the square root of self times self."""
|
||||||
...
|
...
|
||||||
|
|
||||||
.. seealso:: Further reading on docstrings: :pep:`257`
|
.. see also:: Further reading on docstrings: :pep:`257`
|
||||||
|
|
||||||
|
|
||||||
Other Tools
|
Other Tools
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ Code Style
|
|||||||
If you ask Python programmers what they like most in Python, they will
|
If you ask Python programmers what they like most in Python, they will
|
||||||
often say its high readability. Indeed, a high level of readability
|
often say its high readability. Indeed, a high level of readability
|
||||||
is at the heart of the design of the Python language, following the
|
is at the heart of the design of the Python language, following the
|
||||||
recognised fact that code is read much more often than it is written.
|
recognized fact that code is read much more often than it is written.
|
||||||
|
|
||||||
One reason for Python code to be easily read and understood is its relatively
|
One reason for Python code to be easily read and understood is its relatively
|
||||||
complete set of Code Style guidelines and "Pythonic" idioms.
|
complete set of Code Style guidelines and "Pythonic" idioms.
|
||||||
|
|||||||
Reference in New Issue
Block a user