summaryrefslogtreecommitdiff
path: root/docs/quick_tutorial
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2018-10-07 02:26:10 -0700
committerSteve Piercy <web@stevepiercy.com>2018-10-07 04:26:35 -0700
commit50b8b42b7da17d20534e5fd21905c8fe56b68069 (patch)
treeaf83582e30c860af716ce81b6c5fe00a0c2c6cc5 /docs/quick_tutorial
parentd4c95cb20f6332b05513910bdd661b4032c38b7c (diff)
downloadpyramid-50b8b42b7da17d20534e5fd21905c8fe56b68069.tar.gz
pyramid-50b8b42b7da17d20534e5fd21905c8fe56b68069.tar.bz2
pyramid-50b8b42b7da17d20534e5fd21905c8fe56b68069.zip
One more py.test to pytest
Diffstat (limited to 'docs/quick_tutorial')
-rw-r--r--docs/quick_tutorial/ini.rst22
1 files changed, 8 insertions, 14 deletions
diff --git a/docs/quick_tutorial/ini.rst b/docs/quick_tutorial/ini.rst
index ce92914fe..6477b8e64 100644
--- a/docs/quick_tutorial/ini.rst
+++ b/docs/quick_tutorial/ini.rst
@@ -11,19 +11,16 @@ simpler, better application running.
Background
==========
-Pyramid has a first-class concept of :ref:`configuration <configuration_narr>`
-distinct from code. This approach is optional, but its presence makes it
-distinct from other Python web frameworks. It taps into Python's ``setuptools``
-library, which establishes conventions for installing and providing "entry
-points" for Python projects. Pyramid uses an entry point to let a Pyramid
-application know where to find the WSGI app.
+Pyramid has a first-class concept of :ref:`configuration <configuration_narr>` distinct from code.
+This approach is optional, but its presence makes it distinct from other Python web frameworks.
+It taps into Python's Setuptools library, which establishes conventions for installing and providing ":term:`entry point`\ s" for Python projects.
+Pyramid uses an :term:`entry point` to let a Pyramid application know where to find the WSGI app.
Objectives
==========
-- Modify our ``setup.py`` to have an entry point telling Pyramid the location
- of the WSGI app.
+- Modify our ``setup.py`` to have an :term:`entry point` telling Pyramid the location of the WSGI app.
- Create an application driven by an ``.ini`` file.
@@ -41,8 +38,7 @@ Steps
cd ..; cp -r package ini; cd ini
-#. Our ``ini/setup.py`` needs a setuptools "entry point" in the ``setup()``
- function:
+#. Our ``ini/setup.py`` needs a setuptools :term:`entry point` in the ``setup()`` function:
.. literalinclude:: ini/setup.py
:linenos:
@@ -89,8 +85,7 @@ application. Processing then proceeds as described in the Pyramid chapter on
- ``pserve`` looks for ``[app:main]`` and finds ``use = egg:tutorial``.
-- The projects's ``setup.py`` has defined an "entry point" (lines 10-13) for the
- project's "main" entry point of ``tutorial:main``.
+- The projects's ``setup.py`` has defined an :term:`entry point` (lines 10-13) for the project's "main" :term:`entry point` of ``tutorial:main``.
- The ``tutorial`` package's ``__init__`` has a ``main`` function.
@@ -133,8 +128,7 @@ Extra credit
#. Can we have multiple ``.ini`` configuration files for a project? Why might
you want to do that?
-#. The entry point in ``setup.py`` didn't mention ``__init__.py`` when it
- declared ``tutorial:main`` function. Why not?
+#. The :term:`entry point` in ``setup.py`` didn't mention ``__init__.py`` when it declared ``tutorial:main`` function. Why not?
#. What is the purpose of ``**settings``? What does the ``**`` signify?