Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 4241add

Browse filesBrowse files
mpoulinmpoulin
authored
Merge pull request realpython#987 from davidshq/master
Updates to GUI and CLI Files
2 parents bece495 + 8c7e008 commit 4241add
Copy full SHA for 4241add

File tree

Expand file treeCollapse file tree

3 files changed

+56
-56
lines changed
Filter options
Expand file treeCollapse file tree

3 files changed

+56
-56
lines changed

‎docs/scenarios/cli.rst

Copy file name to clipboardExpand all lines: docs/scenarios/cli.rst
+17-18Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,12 @@ Command-line Applications
55

66
.. image:: /_static/photos/34435690330_11930b5987_k_d.jpg
77

8-
Command-line applications, also referred to as
9-
`Console Applications <http://en.wikipedia.org/wiki/Console_application>`_,
10-
are computer programs designed to be used from a text interface, such as a
11-
`shell <http://en.wikipedia.org/wiki/Shell_(computing)>`_. Command-line
12-
applications usually accept various inputs as arguments, often referred to as
13-
parameters or sub-commands, as well as options, often referred to as flags or
14-
switches.
8+
Command-line applications, also referred to as `Console Applications
9+
<http://en.wikipedia.org/wiki/Console_application>`_, are computer programs
10+
designed to be used from a text interface, such as a `shell
11+
<http://en.wikipedia.org/wiki/Shell_(computing)>`_. Command-line applications
12+
usually accept various inputs as arguments, often referred to as parameters or
13+
sub-commands, as well as options, often referred to as flags or switches.
1514

1615
Some popular command-line applications include:
1716

@@ -29,9 +28,9 @@ Click
2928
*****
3029

3130
`click <http://click.pocoo.org/>`_ is a Python package for creating
32-
command-line interfaces in a composable way with as little code as
33-
possible. This “Command-Line Interface Creation Kit” is highly
34-
configurable but comes with good defaults out of the box.
31+
command-line interfaces in a composable way with as little code as possible.
32+
This “Command-Line Interface Creation Kit” is highly configurable but comes
33+
with good defaults out of the box.
3534

3635

3736
******
@@ -50,8 +49,8 @@ Plac
5049
`Plac <https://pypi.python.org/pypi/plac>`_ is a simple wrapper
5150
over the Python standard library `argparse <http://docs.python.org/2/library/argparse.html>`_,
5251
which hides most of its complexity by using a declarative interface: the
53-
argument parser is inferred rather than written down by imperatively. This
54-
module targets especially unsophisticated users, programmers, sysadmins,
52+
argument parser is inferred rather than written down imperatively. This
53+
module targets unsophisticated users, programmers, sysadmins,
5554
scientists, and in general people writing throw-away scripts for themselves,
5655
who choose to create a command-line interface because it is quick and simple.
5756

@@ -72,12 +71,12 @@ sub-command to do the work.
7271
Cement
7372
******
7473

75-
`Cement <http://builtoncement.com/>`_ is an advanced CLI Application Framework.
76-
Its goal is to introduce a standard and feature-full platform
77-
for both simple and complex command line applications as well
78-
as support rapid development needs without sacrificing quality.
79-
Cement is flexible, and its use cases span from the simplicity of a micro-framework
80-
to the complexity of a mega-framework.
74+
`Cement <http://builtoncement.com/>`_ is an advanced CLI Application
75+
Framework. Its goal is to introduce a standard and feature-full platform for
76+
both simple and complex command line applications as well as support rapid
77+
development needs without sacrificing quality. Cement is flexible, and its use
78+
cases span from the simplicity of a micro-framework to the complexity of a
79+
mega-framework.
8180

8281

8382
***********

‎docs/scenarios/gui.rst

Copy file name to clipboardExpand all lines: docs/scenarios/gui.rst
+38-37Lines changed: 38 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ Camelot
1414
*******
1515

1616
`Camelot <http://www.python-camelot.com>`_ provides components for building
17-
applications on top of Python, SQLAlchemy, and Qt. It is inspired by
18-
the Django admin interface.
17+
applications on top of Python, SQLAlchemy, and Qt. It is inspired by the Django
18+
admin interface.
1919

2020
The main resource for information is the website:
2121
http://www.python-camelot.com
@@ -33,19 +33,17 @@ Cocoa
3333
GTk
3434
***
3535

36-
PyGTK provides Python bindings for the GTK+ toolkit. Like the GTK+ library
37-
itself, it is currently licensed under the GNU LGPL. It is worth noting that
38-
PyGTK only currently supports the Gtk-2.X API (NOT Gtk-3.0). It is currently
39-
recommended that PyGTK not be used for new projects and that existing
40-
applications be ported from PyGTK to PyGObject.
36+
.. note:: PyGTK provides Python bindings for the GTK+ toolkit. However, it has been superseded by PyGObject. PyGTK should not be used for new projects and existing projects should be ported to PyGObject.
4137

4238

4339
********************
4440
PyGObject aka (PyGi)
4541
********************
4642

47-
`PyGObject <https://wiki.gnome.org/Projects/PyGObject>`_ provides Python bindings which gives access to the entire GNOME software platform.
48-
It is fully compatible with GTK+ 3. Here is a tutorial to get started with `Python GTK+ 3 Tutorial <https://python-gtk-3-tutorial.readthedocs.io/en/latest/>`_.
43+
`PyGObject <https://wiki.gnome.org/Projects/PyGObject>`_ provides Python
44+
bindings which gives access to the entire GNOME software platform. It is fully
45+
compatible with GTK+ 3. Here is a tutorial to get started with `Python GTK+ 3
46+
Tutorial <https://python-gtk-3-tutorial.readthedocs.io/en/latest/>`_.
4947

5048
`API Reference <http://lazka.github.io/pgi-docs/>`_
5149

@@ -56,8 +54,8 @@ Kivy
5654

5755
`Kivy <http://kivy.org>`_ is a Python library for development of multi-touch
5856
enabled media rich applications. The aim is to allow for quick and easy
59-
interaction design and rapid prototyping, while making your code reusable
60-
and deployable.
57+
interaction design and rapid prototyping, while making your code reusable and
58+
deployable.
6159

6260
Kivy is written in Python, based on OpenGL, and supports different input devices
6361
such as: Mouse, Dual Mouse, TUIO, WiiMote, WM_TOUCH, HIDtouch, Apple's products,
@@ -101,52 +99,55 @@ http://www.riverbankcomputing.co.uk/software/pyqt/download
10199

102100

103101
*****************************
104-
PyjamasDesktop (pyjs Desktop)
102+
Pyjs Desktop (formerly Pyjamas Desktop)
105103
*****************************
106104

107-
PyjamasDesktop is a port of Pyjamas. PyjamasDesktop is application widget set
108-
for desktop and a cross-platform framework. (After release v0.6 PyjamasDesktop
109-
is a part of Pyjamas (Pyjs)). Briefly, it allows the exact same Python web
110-
application source code to be executed as a standalone desktop application.
105+
Pyjs Desktop is a application widget set for desktop and a cross-platform
106+
framework. It allows the exact same Python web application source code to be
107+
executed as a standalone desktop application.
111108

112-
`Python Wiki for PyjamasDesktop <http://wiki.python.org/moin/PyjamasDesktop>`_.
113109

114-
The main website: `pyjs Desktop <http://pyjs.org/>`_.
110+
The main website: `pyjs <http://pyjs.org/>`_.
115111

116112

117113
**
118114
Qt
119115
**
120116

121-
`Qt <http://qt-project.org/>`_ is a cross-platform application framework that
122-
is widely used for developing software with a GUI but can also be used for
123-
non-GUI applications.
117+
`Qt <http://qt-project.org/>`_ is a cross-platform application framework that is
118+
widely used for developing software with a GUI but can also be used for non-GUI
119+
applications.
124120

125121

126122
***********
127123
PySimpleGUI
128124
***********
129125

130-
`PySimpleGUI <https://pysimplegui.readthedocs.io/>`_ is a wrapper for Tkinter and Qt (others on the way). The amount of code required to implement custom GUIs is much shorter using PySimpleGUI than if the same GUI were written directly using Tkinter or Qt. PySimpleGUI code can be "ported" between GUI frameworks by changing import statements.
126+
`PySimpleGUI <https://pysimplegui.readthedocs.io/>`_ is a wrapper for Tkinter
127+
and Qt (others on the way). The amount of code required to implement custom
128+
GUIs is much shorter using PySimpleGUI than if the same GUI were written
129+
directly using Tkinter or Qt. PySimpleGUI code can be "ported" between GUI
130+
frameworks by changing import statements.
131131

132132
.. code-block:: console
133133
134134
$ pip install pysimplegui
135135
136-
PySimpleGUI is contained in a single PySimpleGUI.py file. Should pip installation be impossible, copying the PySimpleGUI.py file into a project's folder is all that's required to import and begin using.
136+
PySimpleGUI is contained in a single PySimpleGUI.py file. Should pip
137+
installation be impossible, copying the PySimpleGUI.py file into a project's
138+
folder is all that's required to import and begin using.
137139

138140

139141
****
140142
Toga
141143
****
142144

143-
`Toga <https://toga.readthedocs.io/en/latest/>`_ is a Python native, OS
144-
native, cross platform GUI toolkit. Toga consists of a library of base
145-
components with a shared interface to simplify platform-agnostic GUI
146-
development.
145+
`Toga <https://toga.readthedocs.io/en/latest/>`_ is a Python native, OS native,
146+
cross platform GUI toolkit. Toga consists of a library of base components with a
147+
shared interface to simplify platform-agnostic GUI development.
147148

148-
Toga is available on mOS, Windows, Linux (GTK), and mobile platforms such
149-
as Android and iOS.
149+
Toga is available on mOS, Windows, Linux (GTK), and mobile platforms such as
150+
Android and iOS.
150151

151152

152153
**
@@ -161,21 +162,21 @@ Both Tk and Tkinter are available on most Unix platforms, as well as on Windows
161162
and Macintosh systems. Starting with the 8.0 release, Tk offers native look and
162163
feel on all platforms.
163164

164-
There's a good multi-language Tk tutorial with Python examples at
165-
`TkDocs <http://www.tkdocs.com/tutorial/index.html>`_. There's more information
165+
There's a good multi-language Tk tutorial with Python examples at `TkDocs
166+
<http://www.tkdocs.com/tutorial/index.html>`_. There's more information
166167
available on the `Python Wiki <http://wiki.python.org/moin/TkInter>`_.
167168

168169

169170
********
170171
wxPython
171172
********
172173

173-
wxPython is a GUI toolkit for the Python programming language. It allows
174-
Python programmers to create programs with a robust, highly functional
175-
graphical user interface, simply and easily. It is implemented as a Python
176-
extension module (native code) that wraps the popular wxWidgets cross platform
177-
GUI library, which is written in C++.
174+
wxPython is a GUI toolkit for the Python programming language. It allows Python
175+
programmers to create programs with a robust, highly functional graphical user
176+
interface, simply and easily. It is implemented as a Python extension module
177+
(native code) that wraps the popular wxWidgets cross platform GUI library, which
178+
is written in C++.
178179

179180
**Install (Stable) wxPython**
180-
*go to http://www.wxpython.org/download.php#stable and download the appropriate
181+
*go to https://www.wxpython.org/pages/downloads/ and download the appropriate
181182
package for your OS.*

‎docs/writing/structure.rst

Copy file name to clipboardExpand all lines: docs/writing/structure.rst
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -891,4 +891,4 @@ Further Reading
891891
***************
892892

893893
- http://docs.python.org/3/library/
894-
- http://www.diveintopython.net/toc/index.html
894+
- https://www.diveinto.org/python3/

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.