From caee6c5c6125013e638cd38db5916c67fd0e7f26 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Sun, 25 Dec 2016 04:38:42 -0800 Subject: [PATCH 01/29] quick_tutorial/requirements - add prompt --- docs/quick_tutorial/requirements.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/quick_tutorial/requirements.rst b/docs/quick_tutorial/requirements.rst index 913e08a625..f95dac488c 100644 --- a/docs/quick_tutorial/requirements.rst +++ b/docs/quick_tutorial/requirements.rst @@ -172,7 +172,7 @@ time of its release. .. code-block:: bash # Mac and Linux - $VENV/bin/pip install --upgrade pip setuptools + $ $VENV/bin/pip install --upgrade pip setuptools .. code-block:: doscon From 910b8a085085fae3d8b44bca6f037fc61d4b10d0 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Sun, 25 Dec 2016 04:46:25 -0800 Subject: [PATCH 02/29] quick_tutorial/tutorial_approach - Fix up the process description to reflect reality --- docs/quick_tutorial/tutorial_approach.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/quick_tutorial/tutorial_approach.rst b/docs/quick_tutorial/tutorial_approach.rst index 49a6bfd858..d944aaebdb 100644 --- a/docs/quick_tutorial/tutorial_approach.rst +++ b/docs/quick_tutorial/tutorial_approach.rst @@ -10,18 +10,17 @@ Details, references, and deeper discussions are mentioned in "See also" notes. This "Getting Started" tutorial is broken into independent steps, starting with the smallest possible "single file WSGI app" example. Each of these steps introduce a topic and a very small set of concepts via working code. The steps -each correspond to a directory in this repo, where each step/topic/directory is +each correspond to a directory in this repository, where each step's directory is a Python package. -To successfully run each step: +To successfully run each step, you'll usually copy the current step's directory to a new directory, change your working directory to the new directory, then install your project: .. code-block:: bash - $ cd request_response + $ cd ..; cp -r package ini; cd ini $ $VENV/bin/pip install -e . -...and repeat for each step you would like to work on. In most cases we will -start with the results of an earlier step. +For a few steps, you won't copy the step's directory. Directory tree ============== @@ -43,5 +42,5 @@ below: Each of the first-level directories (e.g., ``request_response``) is a *Python project* (except as noted for the ``hello_world`` step). The ``tutorial`` -directory is a *Python package*. At the end of each step, we copy a previous +directory is a *Python package*. At the start of each step, we usually copy a previous directory into a new directory to use as a starting point. From b00c4e46cafbaefa32288480477005caabf88bc9 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Mon, 26 Dec 2016 23:09:42 -0800 Subject: [PATCH 03/29] quick_tutorial/tutorial_approach - Fix up the process description to reflect reality, and improve flow --- docs/quick_tutorial/tutorial_approach.rst | 34 +++++++++++------------ 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/quick_tutorial/tutorial_approach.rst b/docs/quick_tutorial/tutorial_approach.rst index d944aaebdb..8da9f71b3d 100644 --- a/docs/quick_tutorial/tutorial_approach.rst +++ b/docs/quick_tutorial/tutorial_approach.rst @@ -7,24 +7,16 @@ Details, references, and deeper discussions are mentioned in "See also" notes. .. seealso:: This is an example "See also" note. -This "Getting Started" tutorial is broken into independent steps, starting with -the smallest possible "single file WSGI app" example. Each of these steps -introduce a topic and a very small set of concepts via working code. The steps -each correspond to a directory in this repository, where each step's directory is -a Python package. - -To successfully run each step, you'll usually copy the current step's directory to a new directory, change your working directory to the new directory, then install your project: - -.. code-block:: bash - - $ cd ..; cp -r package ini; cd ini - $ $VENV/bin/pip install -e . - -For a few steps, you won't copy the step's directory. Directory tree ============== +This "Getting Started" tutorial is broken into independent steps, starting with +the smallest possible "single file WSGI app" example. Each of these steps +introduces a topic and a very small set of concepts via working code. The steps +each correspond to a directory in our workspace, where each step's directory is +a Python package. + As we develop our tutorial, our directory tree will resemble the structure below: @@ -40,7 +32,15 @@ below: │── development.ini `── setup.py -Each of the first-level directories (e.g., ``request_response``) is a *Python +Each of the directories in our ``quick_tutorial`` workspace (e.g., ``request_response``) is a *Python project* (except as noted for the ``hello_world`` step). The ``tutorial`` -directory is a *Python package*. At the start of each step, we usually copy a previous -directory into a new directory to use as a starting point. +directory is a *Python package*. + +For most steps you will copy the previous step's directory to a new directory, and change your working directory to the new directory, then install your project: + +.. code-block:: bash + + $ cd ..; cp -r package ini; cd ini + $ $VENV/bin/pip install -e . + +For a few steps, you won't copy the previous step's directory, but you will still need to install your project with ``$VENV/bin/pip install -e .``. From 558f3e772a1416ebdd9cd8122c0aeac3f0b0d72c Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Mon, 26 Dec 2016 23:11:28 -0800 Subject: [PATCH 04/29] quick_tutorial/cookiecutters - renamed from scaffolds - rewrite for use of cookiecutters instead of scaffolds - update source files --- docs/quick_tutorial/cookiecutters.rst | 79 ++++ docs/quick_tutorial/cookiecutters/.coveragerc | 3 + docs/quick_tutorial/cookiecutters/CHANGES.txt | 4 + docs/quick_tutorial/cookiecutters/MANIFEST.in | 2 + docs/quick_tutorial/cookiecutters/README.txt | 29 ++ .../cc_starter}/__init__.py | 2 +- .../cc_starter/static/pyramid-16x16.png | Bin 0 -> 1319 bytes .../cc_starter/static/pyramid.png | Bin 0 -> 12901 bytes .../cookiecutters/cc_starter/static/theme.css | 154 ++++++++ .../cc_starter/templates/layout.jinja2 | 64 +++ .../cc_starter/templates/mytemplate.jinja2 | 8 + .../cookiecutters/cc_starter/tests.py | 29 ++ .../cookiecutters/cc_starter/views.py | 6 + .../development.ini | 14 +- .../production.ini | 10 +- docs/quick_tutorial/cookiecutters/pytest.ini | 3 + docs/quick_tutorial/cookiecutters/setup.py | 51 +++ docs/quick_tutorial/index.rst | 2 +- docs/quick_tutorial/scaffolds.rst | 87 ---- docs/quick_tutorial/scaffolds/CHANGES.txt | 4 - docs/quick_tutorial/scaffolds/MANIFEST.in | 2 - docs/quick_tutorial/scaffolds/README.txt | 1 - .../scaffolds/scaffolds/static/favicon.ico | Bin 1406 -> 0 bytes .../scaffolds/scaffolds/static/footerbg.png | Bin 333 -> 0 bytes .../scaffolds/scaffolds/static/headerbg.png | Bin 203 -> 0 bytes .../scaffolds/scaffolds/static/ie6.css | 8 - .../scaffolds/scaffolds/static/middlebg.png | Bin 2797 -> 0 bytes .../scaffolds/scaffolds/static/pylons.css | 372 ------------------ .../scaffolds/static/pyramid-small.png | Bin 7044 -> 0 bytes .../scaffolds/scaffolds/static/pyramid.png | Bin 33055 -> 0 bytes .../scaffolds/static/transparent.gif | Bin 49 -> 0 bytes .../scaffolds/templates/mytemplate.pt | 73 ---- .../scaffolds/scaffolds/tests.py | 17 - .../scaffolds/scaffolds/views.py | 6 - docs/quick_tutorial/scaffolds/setup.py | 42 -- 35 files changed, 446 insertions(+), 626 deletions(-) create mode 100644 docs/quick_tutorial/cookiecutters.rst create mode 100644 docs/quick_tutorial/cookiecutters/.coveragerc create mode 100644 docs/quick_tutorial/cookiecutters/CHANGES.txt create mode 100644 docs/quick_tutorial/cookiecutters/MANIFEST.in create mode 100644 docs/quick_tutorial/cookiecutters/README.txt rename docs/quick_tutorial/{scaffolds/scaffolds => cookiecutters/cc_starter}/__init__.py (89%) create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/static/pyramid-16x16.png create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/static/pyramid.png create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/static/theme.css create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/templates/layout.jinja2 create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/templates/mytemplate.jinja2 create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/tests.py create mode 100644 docs/quick_tutorial/cookiecutters/cc_starter/views.py rename docs/quick_tutorial/{scaffolds => cookiecutters}/development.ini (79%) rename docs/quick_tutorial/{scaffolds => cookiecutters}/production.ini (80%) create mode 100644 docs/quick_tutorial/cookiecutters/pytest.ini create mode 100644 docs/quick_tutorial/cookiecutters/setup.py delete mode 100644 docs/quick_tutorial/scaffolds.rst delete mode 100644 docs/quick_tutorial/scaffolds/CHANGES.txt delete mode 100644 docs/quick_tutorial/scaffolds/MANIFEST.in delete mode 100644 docs/quick_tutorial/scaffolds/README.txt delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/favicon.ico delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/footerbg.png delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/headerbg.png delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/ie6.css delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/middlebg.png delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/pylons.css delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/pyramid-small.png delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/pyramid.png delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/static/transparent.gif delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/templates/mytemplate.pt delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/tests.py delete mode 100644 docs/quick_tutorial/scaffolds/scaffolds/views.py delete mode 100644 docs/quick_tutorial/scaffolds/setup.py diff --git a/docs/quick_tutorial/cookiecutters.rst b/docs/quick_tutorial/cookiecutters.rst new file mode 100644 index 0000000000..8e7048f785 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters.rst @@ -0,0 +1,79 @@ +.. _qtut_cookiecutters: + +================================================= +Prelude: Quick Project Startup with Cookiecutters +================================================= + +To ease the process of getting started on a project, the Pylons Project provides :term:`cookiecutter`\ s that generate sample :app:`Pyramid` projects from project templates. These cookiecutters will install :app:`Pyramid` and its dependencies as well. We will still cover many topics of web application development using :app:`Pyramid`, but it's good to know of this facility. This prelude will demonstrate how to get a working :app:`Pyramid` web application running via ``cookiecutter``. + + +Objectives +========== + +- Use a cookiecutter to make a new project. + +- Start up a :app:`Pyramid` application and visit it in a web browser. + + +Steps +===== + +#. Install cookiecutter into your virtual environment. + + .. code-block:: bash + + $VENV/bin/pip install cookiecutter + +#. Let's use the cookiecutter ``pyramid-cookiecutter-starter`` to create a starter :app:`Pyramid` project in the current directory, entering values at the prompts as shown below for the following command. + + .. code-block:: bash + + $ $VENV/bin/cookiecutter https://github.com/Pylons/pyramid-cookiecutter-starter + + If prompted for the first item, accept the default ``yes`` by hitting return. + + #. ``You've cloned ~/.cookiecutters/pyramid-cookiecutter-starter before. Is it okay to delete and re-clone it? [yes]:`` + #. ``project_name [Pyramid Scaffold]: cc_starter`` + #. ``repo_name [scaffold]: cc_starter`` + +#. We then run through the following commands. + + .. code-block:: bash + + # Change directory into your newly created project. + $ cd cc_starter + # Create a new virtual environment... + $ python3 -m venv env + # ...where we upgrade packaging tools... + $ env/bin/pip install --upgrade pip setuptools + # ...and into which we install our project. + $ env/bin/pip install -e . + +#. Start up the application by pointing :app:`Pyramid`'s ``pserve`` command at the + project's (generated) configuration file: + + .. code-block:: bash + + $ env/bin/pserve development.ini --reload + + On start up, ``pserve`` logs some output: + + .. code-block:: text + + Starting subprocess with file monitor + Starting server in PID 73732. + Serving on http://localhost:6543 + Serving on http://localhost:6543 + +#. Open http://localhost:6543/ in your browser. + +Analysis +======== + +Rather than starting from scratch, a cookiecutter can make it easy to get a Python +project containing a working :app:`Pyramid` application. The Pylons Project provides `several cookiecutters `_. + +``pserve`` is :app:`Pyramid`'s application runner, separating operational details from +your code. When you install :app:`Pyramid`, a small command program called ``pserve`` +is written to your ``bin`` directory. This program is an executable Python +module. It is passed a configuration file (in this case, ``development.ini``). diff --git a/docs/quick_tutorial/cookiecutters/.coveragerc b/docs/quick_tutorial/cookiecutters/.coveragerc new file mode 100644 index 0000000000..1bcbb8c3e5 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/.coveragerc @@ -0,0 +1,3 @@ +[run] +source = cc_starter +omit = cc_starter/test* diff --git a/docs/quick_tutorial/cookiecutters/CHANGES.txt b/docs/quick_tutorial/cookiecutters/CHANGES.txt new file mode 100644 index 0000000000..14b902fd10 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/CHANGES.txt @@ -0,0 +1,4 @@ +0.0 +--- + +- Initial version. diff --git a/docs/quick_tutorial/cookiecutters/MANIFEST.in b/docs/quick_tutorial/cookiecutters/MANIFEST.in new file mode 100644 index 0000000000..79c7ec16c5 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/MANIFEST.in @@ -0,0 +1,2 @@ +include *.txt *.ini *.cfg *.rst +recursive-include cc_starter *.ico *.png *.css *.gif *.jpg *.pt *.txt *.mak *.mako *.js *.html *.xml *.jinja2 diff --git a/docs/quick_tutorial/cookiecutters/README.txt b/docs/quick_tutorial/cookiecutters/README.txt new file mode 100644 index 0000000000..4b1f31bf3d --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/README.txt @@ -0,0 +1,29 @@ +cc_starter +=============================== + +Getting Started +--------------- + +- Change directory into your newly created project. + + cd cc_starter + +- Create a Python virtual environment. + + python3 -m venv env + +- Upgrade packaging tools. + + env/bin/pip install --upgrade pip setuptools + +- Install the project in editable mode with its testing requirements. + + env/bin/pip install -e ".[testing]" + +- Run your project's tests. + + env/bin/pytest + +- Run your project. + + env/bin/pserve development.ini diff --git a/docs/quick_tutorial/scaffolds/scaffolds/__init__.py b/docs/quick_tutorial/cookiecutters/cc_starter/__init__.py similarity index 89% rename from docs/quick_tutorial/scaffolds/scaffolds/__init__.py rename to docs/quick_tutorial/cookiecutters/cc_starter/__init__.py index ad5ecbc6f1..49dde36d4d 100644 --- a/docs/quick_tutorial/scaffolds/scaffolds/__init__.py +++ b/docs/quick_tutorial/cookiecutters/cc_starter/__init__.py @@ -5,7 +5,7 @@ def main(global_config, **settings): """ This function returns a Pyramid WSGI application. """ config = Configurator(settings=settings) - config.include('pyramid_chameleon') + config.include('pyramid_jinja2') config.add_static_view('static', 'static', cache_max_age=3600) config.add_route('home', '/') config.scan() diff --git a/docs/quick_tutorial/cookiecutters/cc_starter/static/pyramid-16x16.png b/docs/quick_tutorial/cookiecutters/cc_starter/static/pyramid-16x16.png new file mode 100644 index 0000000000000000000000000000000000000000..979203112e76ba4cfdb8cd6f108f4275e987d99a GIT binary patch literal 1319 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`k|nMYCBgY=CFO}lsSJ)O`AMk? zp1FzXsX?iUDV2pMQ*9U+n3Xd_B1$5BeXNr6bM+EIYV;~{3xK*A7;Nk-3KEmEQ%e+* zQqwc@Y?a>c-mj#PnPRIHZt82`Ti~3Uk?B!Ylp0*+7m{3+ootz+WN)WnQ(*-(AUCxn zQK2F?C$HG5!d3}vt`(3C64qBz04piUwpD^SD#ABF!8yMuRl!uxR5#hc&_u!9QqR!T z(8R(}N5ROz&{*HVSl`fC*U-qyz|zXlQ~?TIxIyg#@@$ndN=gc>^!3Zj z%k|2Q_413-^$jg8E%gnI^o@*kfhu&1EAvVcD|GXUm0>2hq!uR^WfqiV=I1GZOiWD5 zFD$Tv3bSNU;+l1ennz|zM-B0$V)JVzP|XC=H|jx7ncO3BHWAB;NpiyW)Z+ZoqGVvir744~DzI`cN=+=uFAB-e&w+(vKt_H^esM;Afr7KMf`)Hma%LWg zuL;)R>ucqiS6q^qmz?V9Vygr+LN7Bj#mdRl*wM}0&C<--)xyxw)!5S9(bdAp)YZVy zz`)Yd%><^`B|o_|H#M&WrZ)wl*Ab^)P+G_>0NU)5T9jFqn&MWJpQ`}&vsET;x0vHJ z52`l>w_7Z5>eUB2MjsTjNHGl)0wy026P|8?9C*r4%>yR)B4E1CQ{KVEz`!`m)5S5Q z;#SXOUk#T)k>lxKj4~&v95M;sSJp8lNikLV)bX~~P1`qaNLZPZ<6^QgASli8jmk<% zZdJ~1%}JBkHhu^^q;ghbe{lMjv_0X)ug#yI+xz_S{hiM(g*saf_f6Pt#!wis>2u+! z{;RjXUlmP?^Kq|yJMn}2uJ~!L3EU-*{+zn6Ya6$jYueOB4G#Lx+=R;oM4sqe*Sq0$ zQ2Nf{-BFQxlX@Dog;`l=SkyQh`W)n22F}BoCTQYYC=p8g*kiK(1`FEnD$cY`NZX8<>GJicU)2$Vj5iRl-7k*od z3K)m{Gsp@4JM)eDo7z=gtG;>hu{QvcXxLU8eD@D+$BKJ@RM`zyYKvG z-8a3ur|aAMt1Vr-yH|CEDauQLkO+_f002lzQdIf%fB4Ui0QY*V)U3(^0FZ<%L_`#& zL`1-fj&^1i)}{b}Bq%eIA9uoG!laCfFcwoR zb`OTl9xm%u?u}UK6Z+-0LfvF1uNzRlu;BSs+a-xXQEAzvn#Z125}lrEE$o@!cYog? z@lko^ANF`uyQDsu%o2*s(%P^-sbKEJ1>90;Svb?qHr@sbgo4>hFv21pO(baNe1U?G_am z$%uaYhJupCKc=2k-Lpftu1m0%A~@dHZKRf6W*s6Qm&D`7K|3 zP8#?(KABe7=AZNd-k*6CTcqHJ?f3yA6ws8mf*wHc;}7VpNW)zn=9RJ4PSI>0zxN+V zk#)jtw`7ILRrYRCqD>sB@)+LaZvtH~TpCmeT z5;T(}&;kNeCnT`+Is{plpj-ki?E!QC9#b�i5=5IxreNAbVsKKM4p@aIXvt)VjX~ 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 + + + + + + + + + + Cookiecutter Starter project for the Pyramid Web Framework + + + + + + + + + + + + + +
+
+
+
+ +
+
+ {% block content %} +

No content

+ {% endblock content %} +
+
+
+
+ +
+
+
+
+ Copyright © Pylons Project +
+
+
+
+ + + + + + + + diff --git a/docs/quick_tutorial/cookiecutters/cc_starter/templates/mytemplate.jinja2 b/docs/quick_tutorial/cookiecutters/cc_starter/templates/mytemplate.jinja2 new file mode 100644 index 0000000000..979ee5071e --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/cc_starter/templates/mytemplate.jinja2 @@ -0,0 +1,8 @@ +{% extends "layout.jinja2" %} + +{% block content %} +
+

Pyramid Starter project

+

Welcome to cc_starter, a Pyramid application generated by
Cookiecutter.

+
+{% endblock content %} diff --git a/docs/quick_tutorial/cookiecutters/cc_starter/tests.py b/docs/quick_tutorial/cookiecutters/cc_starter/tests.py new file mode 100644 index 0000000000..2f553bbb4a --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/cc_starter/tests.py @@ -0,0 +1,29 @@ +import unittest + +from pyramid import testing + + +class ViewTests(unittest.TestCase): + def setUp(self): + self.config = testing.setUp() + + def tearDown(self): + testing.tearDown() + + def test_my_view(self): + from .views import my_view + request = testing.DummyRequest() + info = my_view(request) + self.assertEqual(info['project'], 'cc_starter') + + +class FunctionalTests(unittest.TestCase): + def setUp(self): + from cc_starter import main + app = main({}) + from webtest import TestApp + self.testapp = TestApp(app) + + def test_root(self): + res = self.testapp.get('/', status=200) + self.assertTrue(b'Pyramid' in res.body) diff --git a/docs/quick_tutorial/cookiecutters/cc_starter/views.py b/docs/quick_tutorial/cookiecutters/cc_starter/views.py new file mode 100644 index 0000000000..deedd53b83 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/cc_starter/views.py @@ -0,0 +1,6 @@ +from pyramid.view import view_config + + +@view_config(route_name='home', renderer='templates/mytemplate.jinja2') +def my_view(request): + return {'project': 'cc_starter'} diff --git a/docs/quick_tutorial/scaffolds/development.ini b/docs/quick_tutorial/cookiecutters/development.ini similarity index 79% rename from docs/quick_tutorial/scaffolds/development.ini rename to docs/quick_tutorial/cookiecutters/development.ini index 0f562d0e1b..86b54b51d3 100644 --- a/docs/quick_tutorial/scaffolds/development.ini +++ b/docs/quick_tutorial/cookiecutters/development.ini @@ -4,14 +4,14 @@ ### [app:main] -use = egg:scaffolds +use = egg:cc_starter pyramid.reload_templates = true pyramid.debug_authorization = false pyramid.debug_notfound = false pyramid.debug_routematch = false pyramid.default_locale_name = en -pyramid.includes = +pyramid.includes = pyramid_debugtoolbar # By default, the toolbar only appears for clients from IP addresses @@ -24,7 +24,7 @@ pyramid.includes = [server:main] use = egg:waitress#main -listen = *:6543 +listen = 127.0.0.1:6543 [::1]:6543 ### # logging configuration @@ -32,7 +32,7 @@ listen = *:6543 ### [loggers] -keys = root, scaffolds +keys = root, cc_starter [handlers] keys = console @@ -44,10 +44,10 @@ keys = generic level = INFO handlers = console -[logger_scaffolds] +[logger_cc_starter] level = DEBUG handlers = -qualname = scaffolds +qualname = cc_starter [handler_console] class = StreamHandler @@ -56,4 +56,4 @@ level = NOTSET formatter = generic [formatter_generic] -format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s +format = %(asctime)s %(levelname)-5.5s [%(name)s:%(lineno)s][%(threadName)s] %(message)s diff --git a/docs/quick_tutorial/scaffolds/production.ini b/docs/quick_tutorial/cookiecutters/production.ini similarity index 80% rename from docs/quick_tutorial/scaffolds/production.ini rename to docs/quick_tutorial/cookiecutters/production.ini index bf0446a47a..e24a065b1e 100644 --- a/docs/quick_tutorial/scaffolds/production.ini +++ b/docs/quick_tutorial/cookiecutters/production.ini @@ -4,7 +4,7 @@ ### [app:main] -use = egg:scaffolds +use = egg:cc_starter pyramid.reload_templates = false pyramid.debug_authorization = false @@ -26,7 +26,7 @@ listen = *:6543 ### [loggers] -keys = root, scaffolds +keys = root, cc_starter [handlers] keys = console @@ -38,10 +38,10 @@ keys = generic level = WARN handlers = console -[logger_scaffolds] +[logger_cc_starter] level = WARN handlers = -qualname = scaffolds +qualname = cc_starter [handler_console] class = StreamHandler @@ -50,4 +50,4 @@ level = NOTSET formatter = generic [formatter_generic] -format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s +format = %(asctime)s %(levelname)-5.5s [%(name)s:%(lineno)s][%(threadName)s] %(message)s diff --git a/docs/quick_tutorial/cookiecutters/pytest.ini b/docs/quick_tutorial/cookiecutters/pytest.ini new file mode 100644 index 0000000000..a7bd797f04 --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/pytest.ini @@ -0,0 +1,3 @@ +[pytest] +testpaths = cc_starter +python_files = *.py diff --git a/docs/quick_tutorial/cookiecutters/setup.py b/docs/quick_tutorial/cookiecutters/setup.py new file mode 100644 index 0000000000..e47cdf8eac --- /dev/null +++ b/docs/quick_tutorial/cookiecutters/setup.py @@ -0,0 +1,51 @@ +import os + +from setuptools import setup, find_packages + +here = os.path.abspath(os.path.dirname(__file__)) +with open(os.path.join(here, 'README.txt')) as f: + README = f.read() +with open(os.path.join(here, 'CHANGES.txt')) as f: + CHANGES = f.read() + +requires = [ + 'pyramid', + 'pyramid_jinja2', + 'pyramid_debugtoolbar', + 'waitress', +] + +tests_require = [ + 'WebTest >= 1.3.1', # py3 compat + 'pytest', + 'pytest-cov', +] + +setup( + name='cc_starter', + version='0.0', + description='cc_starter', + long_description=README + '\n\n' + CHANGES, + classifiers=[ + 'Programming Language :: Python', + 'Framework :: Pyramid', + 'Topic :: Internet :: WWW/HTTP', + 'Topic :: Internet :: WWW/HTTP :: WSGI :: Application', + ], + author='', + author_email='', + url='', + keywords='web pyramid pylons', + packages=find_packages(), + include_package_data=True, + zip_safe=False, + extras_require={ + 'testing': tests_require, + }, + install_requires=requires, + entry_points={ + 'paste.app_factory': [ + 'main = cc_starter:main', + ], + }, +) diff --git a/docs/quick_tutorial/index.rst b/docs/quick_tutorial/index.rst index 29b4d8fb72..b5b7b33136 100644 --- a/docs/quick_tutorial/index.rst +++ b/docs/quick_tutorial/index.rst @@ -19,7 +19,7 @@ Contents requirements tutorial_approach - scaffolds + cookiecutters hello_world package ini diff --git a/docs/quick_tutorial/scaffolds.rst b/docs/quick_tutorial/scaffolds.rst deleted file mode 100644 index 8712d64e94..0000000000 --- a/docs/quick_tutorial/scaffolds.rst +++ /dev/null @@ -1,87 +0,0 @@ -.. _qtut_cookiecutters: - -============================================= -Prelude: Quick Project Startup with Scaffolds -============================================= - -To ease the process of getting started, Pyramid provides *scaffolds* that -generate sample projects from templates in Pyramid and Pyramid add-ons. - - -Background -========== - -We're going to cover a lot in this tutorial, focusing on one topic at a time -and writing everything from scratch. As a warm up, though, it sure would be -nice to see some pixels on a screen. - -Like other web development frameworks, Pyramid provides a number of "scaffolds" -that generate working Python, template, and CSS code for sample applications. -In this step we'll use a built-in scaffold to let us preview a Pyramid -application, before starting from scratch on Step 1. - - -Objectives -========== - -- Use Pyramid's ``pcreate`` command to list scaffolds and make a new project. - -- Start up a Pyramid application and visit it in a web browser. - - -Steps -===== - -#. Pyramid's ``pcreate`` command can list the available scaffolds: - - .. code-block:: bash - - $ $VENV/bin/pcreate --list - Available scaffolds: - alchemy: Pyramid project using SQLAlchemy, SQLite, URL dispatch, and Jinja2 - starter: Pyramid starter project using URL dispatch and Chameleon - zodb: Pyramid project using ZODB, traversal, and Chameleon - -#. Tell ``pcreate`` to use the ``starter`` scaffold to make our project: - - .. code-block:: bash - - $ $VENV/bin/pcreate --scaffold starter scaffolds - -#. Install our project in editable mode for development in the current - directory: - - .. code-block:: bash - - $ cd scaffolds - $ $VENV/bin/pip install -e . - -#. Start up the application by pointing Pyramid's ``pserve`` command at the - project's (generated) configuration file: - - .. code-block:: bash - - $ $VENV/bin/pserve development.ini --reload - - On start up, ``pserve`` logs some output: - - .. code-block:: bash - - Starting subprocess with file monitor - Starting server in PID 72213. - Starting HTTP server on http://0.0.0.0:6543 - -#. Open http://localhost:6543/ in your browser. - -Analysis -======== - -Rather than starting from scratch, ``pcreate`` can make getting a Python -project containing a Pyramid application a quick matter. Pyramid ships with a -few scaffolds. But installing a Pyramid add-on can give you new scaffolds from -that add-on. - -``pserve`` is Pyramid's application runner, separating operational details from -your code. When you install Pyramid, a small command program called ``pserve`` -is written to your ``bin`` directory. This program is an executable Python -module. It is passed a configuration file (in this case, ``development.ini``). diff --git a/docs/quick_tutorial/scaffolds/CHANGES.txt b/docs/quick_tutorial/scaffolds/CHANGES.txt deleted file mode 100644 index 35a34f3324..0000000000 --- a/docs/quick_tutorial/scaffolds/CHANGES.txt +++ /dev/null @@ -1,4 +0,0 @@ -0.0 ---- - -- Initial version diff --git a/docs/quick_tutorial/scaffolds/MANIFEST.in b/docs/quick_tutorial/scaffolds/MANIFEST.in deleted file mode 100644 index 91d3f763b1..0000000000 --- a/docs/quick_tutorial/scaffolds/MANIFEST.in +++ /dev/null @@ -1,2 +0,0 @@ -include *.txt *.ini *.cfg *.rst -recursive-include scaffolds *.ico *.png *.css *.gif *.jpg *.pt *.txt *.mak *.mako *.js *.html *.xml diff --git a/docs/quick_tutorial/scaffolds/README.txt b/docs/quick_tutorial/scaffolds/README.txt deleted file mode 100644 index 7776dd2d5c..0000000000 --- a/docs/quick_tutorial/scaffolds/README.txt +++ /dev/null @@ -1 +0,0 @@ -scaffolds README diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/favicon.ico b/docs/quick_tutorial/scaffolds/scaffolds/static/favicon.ico deleted file mode 100644 index 71f837c9e27a57cc290a775b8260241d456582e9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1406 zcmZQzU<5(|0R}M0U}azs1F|%L7$l?s#Ec9aKoZP=&}eKW1$hQXJ8K3_byWuK^4)pUzxN(#<8UmvsK;IDHKmiOqXh0GT$f5y8Mn(lr zPEIj#Ai)ddFf%g)`Eo2Q!azQdBPb}Sz$wKF1QMLQK#sJuG@G&_7$~s=Ib0wh3I<>% w6A18w0hlQO2J+n8d=Qop8c;z43^FJH7?vVPfPvuvGXp~dBk4g5(gV^90E$0CbN~PV diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/footerbg.png b/docs/quick_tutorial/scaffolds/scaffolds/static/footerbg.png deleted file mode 100644 index 1fbc873daa930207b3a5a07a4d34a9478241d67e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 333 zcmV-T0kZyyP)x;P*EWNYZUli+~q;(eTbfe*U$baTG!fAgG=`DK4DzIF9EWa~YA`tJ9_ z8KSNH@Hyb?@aX8R^MT1t_v-D!{?^ltv3)o9> f@a++B;w^4}o%yp?Jw|+(00000NkvXXu0mjfL|da= diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/headerbg.png b/docs/quick_tutorial/scaffolds/scaffolds/static/headerbg.png deleted file mode 100644 index 0596f2020327efd97a4467c3025691844bb703d5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 203 zcmV;+05t!JP)t-jh%+|_^FEwkAv~hm;c(PdXHHPSc-$gT+Ec53X`vdosFfm>3bJhR=002ovPDHLk FV1j%>T7Uom diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/ie6.css b/docs/quick_tutorial/scaffolds/scaffolds/static/ie6.css deleted file mode 100644 index b7c8493d8f..0000000000 --- a/docs/quick_tutorial/scaffolds/scaffolds/static/ie6.css +++ /dev/null @@ -1,8 +0,0 @@ -* html img, -* html .png{position:relative;behavior:expression((this.runtimeStyle.behavior="none")&&(this.pngSet?this.pngSet=true:(this.nodeName == "IMG" && this.src.toLowerCase().indexOf('.png')>-1?(this.runtimeStyle.backgroundImage = "none", -this.runtimeStyle.filter = "progid:DXImageTransform.Microsoft.AlphaImageLoader(src='" + this.src + "',sizingMethod='image')", -this.src = "static/transparent.gif"):(this.origBg = this.origBg? this.origBg :this.currentStyle.backgroundImage.toString().replace('url("','').replace('")',''), -this.runtimeStyle.filter = "progid:DXImageTransform.Microsoft.AlphaImageLoader(src='" + this.origBg + "',sizingMethod='crop')", -this.runtimeStyle.backgroundImage = "none")),this.pngSet=true) -);} -#wrap{display:table;height:100%} diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/middlebg.png b/docs/quick_tutorial/scaffolds/scaffolds/static/middlebg.png deleted file mode 100644 index 2369cfb7da3e5052c2ad4932a6d56240c92654c7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2797 zcmV4Tx0C)kNmUmQBSrfqTdoR7v5<-y@dJRoV0Fe@UkzPe5BmqJR7!t5oLbpCc6HqI?@={d8%D5al;0(=!Cz zYydD6nO!2_rJ!tuGDRE_#zA==00c_%EKZ!o62USwPXIWXSj`sE}8w<4jU*%sHzk2;U z$a?$5<7MdQoaVsz{O95^ejS$UX;36cb2fe1Y+3Y{{cC>d?Hh%b}~Geu0H=$|_LAH!zl zAj2Q0Uf9TEuaUC0Snjw2jC3cfEVxw!5{*}g2jLb zQa}a}gIur*tOxm^5bOYZKsl%aHJ}bOfD@nvoCX)bWpEwb1byH>7z88W8JGmG!3+dJ zc!&zoAT>xEGJwn=8;A|fhrFObC=7~)5};&A1WBP)&_<{bDu&9TgHRpxBXkP709}Q8 zpu5lzG!Fdvqf1r2MCzX|yZIz>xmnl~$ zpHUuUAPhr>A0wSn#5lp|XS`F#WweHcflJworSw_BrjROl77!Go4w=>|jpnXz2LrNOcbC zbnDFM8tF#rZqRMieW*v$W9ud9?bd78o7C6V57J+yU$1}9fM~!rNHN%J&}lGjXk-{| zxY@A9aLh>6$j@knQN7UvW2&*M@lxYz|7l}t!?UTdxjmOU*L&{Txvg_w*qYf2Z1>yVv7^}q*=@FKxBFo4U@x|B zupf8OcSvxkbQoaM*&*z0>?@8~M-Rufj;9^pI@vo(oK86X;mmSQb3W=kHqU6DU|!9< zVHaH&uFFA}!THSj3G)xkA9U4m<+@h8K6cY{%Av^?0i=GocG202Kesu9q`liwb@Yi zqU=@)9sQZ=k{U}lNr!Ug=Tzjp$&JcAxlD1HXj#{C)8$*2kFM}u@%>87O5V!$RXVHI zuNqqIzWU%AXiegp_O*Iz^VW{6^I3OfJ!yT~`d>C!Z7AOGYGd@qwmi+eb$P>^d^XkR z%jJvn2R1uzuG)gxBHYrwb?(-(tse{c1=k9#3QG##Z{uyd_MP>2rQdzpp0vHY$i8U* z4%`mWj{cplJC77A7OyBC-W9Z~c{g)+!R}Xkmh8D&Vp~$Rm$X;9cd#_Dw6#pXY)9Gq z@|5zv3Xh7$N{z~`mDBt9`+E1g?Qf{ktSYQ}cR+aH&Ox7p&DDn0C5Lc_at=MIiK^-R zp8b7Yt$J-??T5pn!-Ge{j&#&H)YTo;I9gN>*GucikHsIm`Ge;VtqrV(gN=;F!sFn$ z^!U>s6MpPJ5pbgYB>QB;PX<3#Hqn|2nxW?9&66!DErYGGtv#pwPqnu>w>AB2@$=!+ zI;ShnD4!`hOFEl(_S3l)=cdkQou9and||kKN&EeaF&A%lgm!da3b=ITviIeSo$j6I zuDDz|ebwpescYO08?84TZ?^T!>p9!&+I!)a=dH`P z{cd0HThQ0jAK8CrAbw!*4*$;B-SoRJ?&aK@xxelK_Cdizg@+}NG#*v|YVvF2p#9*P zAK5^Wa`oDjMp>M1#i^e9C^!r+xaf~-RMm2 zd;I&-4<;YlJ_dYz@G0Zdr@sILoAdna&gY5%000SaNLh0L01FcU01FcV0GgZ_0000` zNkl3M)`0?X^CI%pY5dZ)Ghq6c#BU2mL4m7>^xj0=#gtkGV1kD*#^bxk;#3qK# z1w@EpQ$noku{i^$7!@T*ax+fPAS4hh!X^U%5(tH;2fehL00000NkvXXu0mjf?v`T0 diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/pylons.css b/docs/quick_tutorial/scaffolds/scaffolds/static/pylons.css deleted file mode 100644 index 4b1c017cd0..0000000000 --- a/docs/quick_tutorial/scaffolds/scaffolds/static/pylons.css +++ /dev/null @@ -1,372 +0,0 @@ -html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, font, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td -{ - margin: 0; - padding: 0; - border: 0; - outline: 0; - font-size: 100%; /* 16px */ - vertical-align: baseline; - background: transparent; -} - -body -{ - line-height: 1; -} - -ol, ul -{ - list-style: none; -} - -blockquote, q -{ - quotes: none; -} - -blockquote:before, blockquote:after, q:before, q:after -{ - content: ''; - content: none; -} - -:focus -{ - outline: 0; -} - -ins -{ - text-decoration: none; -} - -del -{ - text-decoration: line-through; -} - -table -{ - border-collapse: collapse; - border-spacing: 0; -} - -sub -{ - vertical-align: sub; - font-size: smaller; - line-height: normal; -} - -sup -{ - vertical-align: super; - font-size: smaller; - line-height: normal; -} - -ul, menu, dir -{ - display: block; - list-style-type: disc; - margin: 1em 0; - padding-left: 40px; -} - -ol -{ - display: block; - list-style-type: decimal-leading-zero; - margin: 1em 0; - padding-left: 40px; -} - -li -{ - display: list-item; -} - -ul ul, ul ol, ul dir, ul menu, ul dl, ol ul, ol ol, ol dir, ol menu, ol dl, dir ul, dir ol, dir dir, dir menu, dir dl, menu ul, menu ol, menu dir, menu menu, menu dl, dl ul, dl ol, dl dir, dl menu, dl dl -{ - margin-top: 0; - margin-bottom: 0; -} - -ol ul, ul ul, menu ul, dir ul, ol menu, ul menu, menu menu, dir menu, ol dir, ul dir, menu dir, dir dir -{ - list-style-type: circle; -} - -ol ol ul, ol ul ul, ol menu ul, ol dir ul, ol ol menu, ol ul menu, ol menu menu, ol dir menu, ol ol dir, ol ul dir, ol menu dir, ol dir dir, ul ol ul, ul ul ul, ul menu ul, ul dir ul, ul ol menu, ul ul menu, ul menu menu, ul dir menu, ul ol dir, ul ul dir, ul menu dir, ul dir dir, menu ol ul, menu ul ul, menu menu ul, menu dir ul, menu ol menu, menu ul menu, menu menu menu, menu dir menu, menu ol dir, menu ul dir, menu menu dir, menu dir dir, dir ol ul, dir ul ul, dir menu ul, dir dir ul, dir ol menu, dir ul menu, dir menu menu, dir dir menu, dir ol dir, dir ul dir, dir menu dir, dir dir dir -{ - list-style-type: square; -} - -.hidden -{ - display: none; -} - -p -{ - line-height: 1.5em; -} - -h1 -{ - font-size: 1.75em; - line-height: 1.7em; - font-family: helvetica, verdana; -} - -h2 -{ - font-size: 1.5em; - line-height: 1.7em; - font-family: helvetica, verdana; -} - -h3 -{ - font-size: 1.25em; - line-height: 1.7em; - font-family: helvetica, verdana; -} - -h4 -{ - font-size: 1em; - line-height: 1.7em; - font-family: helvetica, verdana; -} - -html, body -{ - width: 100%; - height: 100%; -} - -body -{ - margin: 0; - padding: 0; - background-color: #fff; - position: relative; - font: 16px/24px NobileRegular, "Lucida Grande", Lucida, Verdana, sans-serif; -} - -a -{ - color: #1b61d6; - text-decoration: none; -} - -a:hover -{ - color: #e88f00; - text-decoration: underline; -} - -body h1, body h2, body h3, body h4, body h5, body h6 -{ - font-family: NeutonRegular, "Lucida Grande", Lucida, Verdana, sans-serif; - font-weight: 400; - color: #373839; - font-style: normal; -} - -#wrap -{ - min-height: 100%; -} - -#header, #footer -{ - width: 100%; - color: #fff; - height: 40px; - position: absolute; - text-align: center; - line-height: 40px; - overflow: hidden; - font-size: 12px; - vertical-align: middle; -} - -#header -{ - background: #000; - top: 0; - font-size: 14px; -} - -#footer -{ - bottom: 0; - background: #000 url(footerbg.png) repeat-x 0 top; - position: relative; - margin-top: -40px; - clear: both; -} - -.header, .footer -{ - width: 750px; - margin-right: auto; - margin-left: auto; -} - -.wrapper -{ - width: 100%; -} - -#top, #top-small, #bottom -{ - width: 100%; -} - -#top -{ - color: #000; - height: 230px; - background: #fff url(headerbg.png) repeat-x 0 top; - position: relative; -} - -#top-small -{ - color: #000; - height: 60px; - background: #fff url(headerbg.png) repeat-x 0 top; - position: relative; -} - -#bottom -{ - color: #222; - background-color: #fff; -} - -.top, .top-small, .middle, .bottom -{ - width: 750px; - margin-right: auto; - margin-left: auto; -} - -.top -{ - padding-top: 40px; -} - -.top-small -{ - padding-top: 10px; -} - -#middle -{ - width: 100%; - height: 100px; - background: url(middlebg.png) repeat-x; - border-top: 2px solid #fff; - border-bottom: 2px solid #b2b2b2; -} - -.app-welcome -{ - margin-top: 25px; -} - -.app-name -{ - color: #000; - font-weight: 700; -} - -.bottom -{ - padding-top: 50px; -} - -#left -{ - width: 350px; - float: left; - padding-right: 25px; -} - -#right -{ - width: 350px; - float: right; - padding-left: 25px; -} - -.align-left -{ - text-align: left; -} - -.align-right -{ - text-align: right; -} - -.align-center -{ - text-align: center; -} - -ul.links -{ - margin: 0; - padding: 0; -} - -ul.links li -{ - list-style-type: none; - font-size: 14px; -} - -form -{ - border-style: none; -} - -fieldset -{ - border-style: none; -} - -input -{ - color: #222; - border: 1px solid #ccc; - font-family: sans-serif; - font-size: 12px; - line-height: 16px; -} - -input[type=text], input[type=password] -{ - width: 205px; -} - -input[type=submit] -{ - background-color: #ddd; - font-weight: 700; -} - -/*Opera Fix*/ -body:before -{ - content: ""; - height: 100%; - float: left; - width: 0; - margin-top: -32767px; -} diff --git a/docs/quick_tutorial/scaffolds/scaffolds/static/pyramid-small.png b/docs/quick_tutorial/scaffolds/scaffolds/static/pyramid-small.png deleted file mode 100644 index a5bc0ade71d3da5eab67391e840ff20448c42cd6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7044 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 - - - The Pyramid Web Framework - - - - - - - - - - -
-
-
-
pyramid
-
-
-
-
-

- Welcome to ${project}, an application generated by
- the Pyramid Web Framework. -

-
-
-
-
-
-

Search documentation

-
- - -
-
- -
-
-
- - diff --git a/docs/quick_tutorial/scaffolds/scaffolds/tests.py b/docs/quick_tutorial/scaffolds/scaffolds/tests.py deleted file mode 100644 index 4f906ffa9d..0000000000 --- a/docs/quick_tutorial/scaffolds/scaffolds/tests.py +++ /dev/null @@ -1,17 +0,0 @@ -import unittest - -from pyramid import testing - - -class ViewTests(unittest.TestCase): - def setUp(self): - self.config = testing.setUp() - - def tearDown(self): - testing.tearDown() - - def test_my_view(self): - from .views import my_view - request = testing.DummyRequest() - info = my_view(request) - self.assertEqual(info['project'], 'scaffolds') diff --git a/docs/quick_tutorial/scaffolds/scaffolds/views.py b/docs/quick_tutorial/scaffolds/scaffolds/views.py deleted file mode 100644 index db90d83648..0000000000 --- a/docs/quick_tutorial/scaffolds/scaffolds/views.py +++ /dev/null @@ -1,6 +0,0 @@ -from pyramid.view import view_config - - -@view_config(route_name='home', renderer='templates/mytemplate.pt') -def my_view(request): - return {'project': 'scaffolds'} diff --git a/docs/quick_tutorial/scaffolds/setup.py b/docs/quick_tutorial/scaffolds/setup.py deleted file mode 100644 index ec95946a51..0000000000 --- a/docs/quick_tutorial/scaffolds/setup.py +++ /dev/null @@ -1,42 +0,0 @@ -import os - -from setuptools import setup, find_packages - -here = os.path.abspath(os.path.dirname(__file__)) -with open(os.path.join(here, 'README.txt')) as f: - README = f.read() -with open(os.path.join(here, 'CHANGES.txt')) as f: - CHANGES = f.read() - -requires = [ - 'pyramid', - 'pyramid_chameleon', - 'pyramid_debugtoolbar', - 'waitress', - ] - -setup(name='scaffolds', - version='0.0', - description='scaffolds', - long_description=README + '\n\n' + CHANGES, - classifiers=[ - "Programming Language :: Python", - "Framework :: Pyramid", - "Topic :: Internet :: WWW/HTTP", - "Topic :: Internet :: WWW/HTTP :: WSGI :: Application", - ], - author='', - author_email='', - url='', - keywords='web pyramid pylons', - packages=find_packages(), - include_package_data=True, - zip_safe=False, - install_requires=requires, - tests_require=requires, - test_suite="scaffolds", - entry_points="""\ - [paste.app_factory] - main = scaffolds:main - """, - ) From 99d45a935a4fe6a9e9d1df364e74f536a418e105 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Mon, 26 Dec 2016 23:16:49 -0800 Subject: [PATCH 05/29] quick_tutorial/hello_world - minor update for cd into current directory. - modernize "microframework" --- docs/quick_tutorial/hello_world.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/quick_tutorial/hello_world.rst b/docs/quick_tutorial/hello_world.rst index 56dccde585..2f2515fcde 100644 --- a/docs/quick_tutorial/hello_world.rst +++ b/docs/quick_tutorial/hello_world.rst @@ -11,7 +11,7 @@ Python packages, no ``pip install -e .``, no other machinery. Background ========== -Microframeworks are all the rage these days. "Microframework" is a marketing +Microframeworks were all the rage, until the next shiny thing came along. "Microframework" is a marketing term, not a technical one. They have a low mental overhead: they do so little, the only things you have to worry about are *your things*. @@ -49,7 +49,7 @@ Steps .. code-block:: bash - $ mkdir hello_world; cd hello_world + $ cd ~/projects/quick_tutorial; mkdir hello_world; cd hello_world #. Copy the following into ``hello_world/app.py``: From 6261ae4fbf73cb9e72aea2b8f67c6b04e5c474a6 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Mon, 26 Dec 2016 23:59:14 -0800 Subject: [PATCH 06/29] narr/cookiecutters - add narr/scaffolding - update index - add link to narr/cookiecutters --- docs/index.rst | 1 + docs/narr/cookiecutters.rst | 20 ++++++++++++++++++++ docs/narr/scaffolding.rst | 4 ++++ 3 files changed, 25 insertions(+) create mode 100644 docs/narr/cookiecutters.rst diff --git a/docs/index.rst b/docs/index.rst index 60dcdcc9c8..6683477445 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -145,6 +145,7 @@ Narrative documentation in chapter form explaining how to use :app:`Pyramid`. narr/extending narr/advconfig narr/extconfig + narr/cookiecutters narr/scaffolding narr/upgrading narr/threadlocals diff --git a/docs/narr/cookiecutters.rst b/docs/narr/cookiecutters.rst new file mode 100644 index 0000000000..bb4c61616f --- /dev/null +++ b/docs/narr/cookiecutters.rst @@ -0,0 +1,20 @@ +.. _cookiecutters: + +Pyramid cookiecutters +===================== + +.. versionadded:: 1.8 + +A :term:`cookiecutter` is a command-line utility that creates projects from :ref:`cookiecutters ` (project templates), e.g., creating a Python package project from a Python package project template. + +Pyramid cookiecutters have replaced the now deprecated Pyramid scaffolds, and should be used going forward. Pyramid cookiecutters released under the Pylons Project include: + +* `pyramid-cookiecutter-alchemy `_ +* `pyramid-cookiecutter-starter `_ +* `pyramid-cookiecutter-zodb `_ + +Development of cookiecutters is documented under `Learn the Basics of Cookiecutter by Creating a Cookiecutter `_. + +.. seealso:: See also `Cookiecutter Features `_. + +.. seealso:: See also :term:`scaffold`. diff --git a/docs/narr/scaffolding.rst b/docs/narr/scaffolding.rst index 164ceb3bf7..27239d34ee 100644 --- a/docs/narr/scaffolding.rst +++ b/docs/narr/scaffolding.rst @@ -3,6 +3,10 @@ Creating Pyramid Scaffolds ========================== +.. deprecated:: 1.8 + + Scaffolds and the ``pcreate`` script used to generate :app:`Pyramid` projects from scaffolds have been deprecated. Use :ref:`cookiecutters` instead. + You can extend Pyramid by creating a :term:`scaffold` template. A scaffold template is useful if you'd like to distribute a customizable configuration of Pyramid to other users. Once you've created a scaffold, and someone has From f698dd71af8af59d4a18e274189a58ba0f66a7b7 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:02:39 -0800 Subject: [PATCH 07/29] narr/assets - update --- docs/narr/assets.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/narr/assets.rst b/docs/narr/assets.rst index 58f547fc9a..f5a2f96849 100644 --- a/docs/narr/assets.rst +++ b/docs/narr/assets.rst @@ -28,7 +28,7 @@ asset: The use of assets is quite common in most web development projects. For example, when you create a :app:`Pyramid` application using one of the -available scaffolds, as described in :ref:`creating_a_project`, the directory +available :term:`cookiecutter`\ s, as described in :ref:`creating_a_project`, the directory representing the application contains a Python :term:`package`. Within that Python package, there are directories full of files which are static assets. For example, there's a ``static`` directory which contains ``.css``, ``.js``, From b0b2b0772a9e5b5767404a88f9d8da987f9afed4 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:03:26 -0800 Subject: [PATCH 08/29] narr/extending - update --- docs/narr/extending.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/narr/extending.rst b/docs/narr/extending.rst index 9dc0420241..bee30ec1a7 100644 --- a/docs/narr/extending.rst +++ b/docs/narr/extending.rst @@ -190,7 +190,7 @@ The general pattern for extending an existing application looks something like this: - Create a new Python package. The easiest way to do this is to create a new - :app:`Pyramid` application using the scaffold mechanism. See + :app:`Pyramid` application using a :term:`cookiecutter`. See :ref:`creating_a_project` for more information. - In the new package, create Python files containing views and other overridden From 6b3f9e5846879e7335c38eaf629500a1f6a97435 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:09:35 -0800 Subject: [PATCH 09/29] narr/install - update --- docs/narr/install.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/narr/install.rst b/docs/narr/install.rst index c3c2ba64ce..10173aec87 100644 --- a/docs/narr/install.rst +++ b/docs/narr/install.rst @@ -260,5 +260,5 @@ What Gets Installed When you install :app:`Pyramid`, various libraries such as WebOb, PasteDeploy, and others are installed. -Additionally, as chronicled in :ref:`project_narr`, scaffolds will be -registered, which make it easy to start a new :app:`Pyramid` project. +Additionally, as chronicled in :ref:`project_narr`, :term:`cookiecutter`\ s will be +used, which make it easy to start a new :app:`Pyramid` project. From 0ff74073d3efc787a6fde1818d05f4aa9227d243 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:11:15 -0800 Subject: [PATCH 10/29] narr/introduction - update --- docs/narr/introduction.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/narr/introduction.rst b/docs/narr/introduction.rst index adad196e47..7027d6601d 100644 --- a/docs/narr/introduction.rst +++ b/docs/narr/introduction.rst @@ -182,7 +182,7 @@ available. Pyramid can automatically utilize changed templates when rendering pages and automatically restart the application to incorporate changed Python code. Plain old ``print()`` calls used for debugging can display to a console. -Pyramid's debug toolbar comes activated when you use a Pyramid scaffold to +Pyramid's debug toolbar comes activated when you use a Pyramid :term:`cookiecutter` to render a project. This toolbar overlays your application in the browser, and allows you access to framework data, such as the routes configured, the last renderings performed, the current set of packages installed, SQLAlchemy queries @@ -494,7 +494,7 @@ Example: :ref:`view_configuration_parameters`. Transaction management ~~~~~~~~~~~~~~~~~~~~~~ -Pyramid's :term:`scaffold` system renders projects that include a *transaction +A couple of Pyramid's :term:`cookiecutter`\ s include a *transaction management* system, stolen from Zope. When you use this transaction management system, you cease being responsible for committing your data anymore. Instead Pyramid takes care of committing: it commits at the end of a request or aborts From 2d35e2fd2d893f580052e8c5840a9238edaecacd Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:25:55 -0800 Subject: [PATCH 11/29] narr/logging - update --- docs/narr/logging.rst | 106 +++++++----------------------------------- 1 file changed, 16 insertions(+), 90 deletions(-) diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst index c7b4b9d6fd..f2c9908615 100644 --- a/docs/narr/logging.rst +++ b/docs/narr/logging.rst @@ -9,11 +9,11 @@ to send log messages to loggers that you've configured. .. warning:: - This chapter assumes you've used a :term:`scaffold` to create a project + This chapter assumes you've used a :term:`cookiecutter` to create a project which contains ``development.ini`` and ``production.ini`` files which help - configure logging. All of the scaffolds which ship with :app:`Pyramid` do - this. If you're not using a scaffold, or if you've used a third-party - scaffold which does not create these files, the configuration information in + configure logging. All of the Pyramid cookiecutters provided by the Pylons Project do + this. If you're not using a cookiecutter, or if you've used a third-party + cookiecutter which does not create these files, the configuration information in this chapter may not be applicable. .. index: @@ -26,11 +26,11 @@ to send log messages to loggers that you've configured. Logging Configuration --------------------- -A :app:`Pyramid` project created from a :term:`scaffold` is configured to allow +A :app:`Pyramid` project created from a :term:`cookiecutter` is configured to allow you to send messages to :mod:`Python standard library logging package ` loggers from within your application. In particular, the :term:`PasteDeploy` ``development.ini`` and ``production.ini`` files created -when you use a scaffold include a basic configuration for the Python +when you use a cookiecutter include a basic configuration for the Python :mod:`logging` package. PasteDeploy ``.ini`` files use the Python standard library :mod:`ConfigParser @@ -43,94 +43,20 @@ from when you run ``pserve``. The ``pserve`` command calls the :func:`pyramid.paster.setup_logging` function, a thin wrapper around the :func:`logging.config.fileConfig` using the specified ``.ini`` file, if it contains a ``[loggers]`` section (all of the -scaffold-generated ``.ini`` files do). ``setup_logging`` reads the logging +cookiecutter-generated ``.ini`` files do). ``setup_logging`` reads the logging configuration from the ini file upon which ``pserve`` was invoked. Default logging configuration is provided in both the default -``development.ini`` and the ``production.ini`` file. The logging configuration +``development.ini`` and the ``production.ini`` files. If you use ``pyramid-cookiecutter-starter`` to generate a Pyramid project with the name of the package as ``hello_world``, then the logging configuration in the ``development.ini`` file is as follows: -.. code-block:: ini - :linenos: - - # Begin logging configuration - - [loggers] - keys = root, {{package_logger}} - - [handlers] - keys = console - - [formatters] - keys = generic - - [logger_root] - level = INFO - handlers = console - - [logger_{{package_logger}}] - level = DEBUG - handlers = - qualname = {{package}} - - [handler_console] - class = StreamHandler - args = (sys.stderr,) - level = NOTSET - formatter = generic - - [formatter_generic] - format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s - - # End logging configuration +.. literalinclude:: ../quick_tour/package/development.ini + :language: ini + :lineno-match: + :lines: 29- The ``production.ini`` file uses the ``WARN`` level in its logger -configuration, but it is otherwise identical. - -The name ``{{package_logger}}`` above will be replaced with the name of your -project's :term:`package`, which is derived from the name you provide to your -project. For instance, if you do: - -.. code-block:: text - :linenos: - - pcreate -s starter MyApp - -The logging configuration will literally be: - -.. code-block:: ini - :linenos: - - # Begin logging configuration - - [loggers] - keys = root, myapp - - [handlers] - keys = console - - [formatters] - keys = generic - - [logger_root] - level = INFO - handlers = console - - [logger_myapp] - level = DEBUG - handlers = - qualname = myapp - - [handler_console] - class = StreamHandler - args = (sys.stderr,) - level = NOTSET - formatter = generic - - [formatter_generic] - format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s - - # End logging configuration +configuration instead of ``DEBUG``, but it is otherwise identical. In this logging configuration: @@ -149,7 +75,7 @@ that ask for a logger (via ``logging.getLogger``) that has a name which begins with anything except your project's package name (e.g., ``myapp``). The logger with the same name as your package name is reserved for your own usage in your :app:`Pyramid` application. Its existence means that you can log to a known -logging location from any :app:`Pyramid` application generated via a scaffold. +logging location from any :app:`Pyramid` application generated via a cookiecutter. :app:`Pyramid` and many other libraries (such as Beaker, SQLAlchemy, Paste) log a number of messages to the root logger for debugging purposes. Switching the @@ -162,9 +88,9 @@ root logger level to ``DEBUG`` reveals them: level = DEBUG handlers = console -Some scaffolds configure additional loggers for additional subsystems they use +Some cookiecutters configure additional loggers for additional subsystems they use (such as SQLALchemy). Take a look at the ``production.ini`` and -``development.ini`` files rendered when you create a project from a scaffold. +``development.ini`` files rendered when you create a project from a cookiecutter. Sending Logging Messages ------------------------ From 0a11d04513d38f560d0e147eeb7d0c1d9d4ac261 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:27:29 -0800 Subject: [PATCH 12/29] narr/paste - update --- docs/narr/paste.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/narr/paste.rst b/docs/narr/paste.rst index 0a217e6e34..a3f1b866ee 100644 --- a/docs/narr/paste.rst +++ b/docs/narr/paste.rst @@ -3,7 +3,7 @@ PasteDeploy Configuration Files =============================== -Packages generated via a :term:`scaffold` make use of a system created by Ian +Packages generated via a :term:`cookiecutter` make use of a system created by Ian Bicking named :term:`PasteDeploy`. PasteDeploy defines a way to declare :term:`WSGI` application configuration in an ``.ini`` file. @@ -14,7 +14,7 @@ runner ``pserve``, as well as other commands such as ``pviews``, ``pshell``, PasteDeploy is not a particularly integral part of Pyramid. It's possible to create a Pyramid application which does not use PasteDeploy at all. We show a Pyramid application that doesn't use PasteDeploy in :ref:`firstapp_chapter`. -However, all Pyramid scaffolds render PasteDeploy configuration files, to +However, all Pyramid cookiecutters render PasteDeploy configuration files, to provide new developers with a standardized way of setting deployment values, and to provide new users with a standardized way of starting, stopping, and debugging an application. @@ -80,7 +80,7 @@ In English, this entry point can thus be referred to as a "PasteDeploy application factory in the ``MyProject`` project which has the entry point named ``main`` where the entry point refers to a ``main`` function in the ``mypackage`` module". Indeed, if you open up the ``__init__.py`` module -generated within any scaffold-generated package, you'll see a ``main`` +generated within any cookiecutter-generated package, you'll see a ``main`` function. This is the function called by :term:`PasteDeploy` when the ``pserve`` command is invoked against our application. It accepts a global configuration object and *returns* an instance of our application. From e2cda93d7422de50d014bcbacc2f4c31b95508bd Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 00:35:50 -0800 Subject: [PATCH 13/29] narr/cookiecutters - revise --- docs/narr/cookiecutters.rst | 8 +++++--- docs/narr/project.rst | 37 ++++++++++++++++++++++++------------- 2 files changed, 29 insertions(+), 16 deletions(-) diff --git a/docs/narr/cookiecutters.rst b/docs/narr/cookiecutters.rst index bb4c61616f..abedb25b91 100644 --- a/docs/narr/cookiecutters.rst +++ b/docs/narr/cookiecutters.rst @@ -13,8 +13,10 @@ Pyramid cookiecutters have replaced the now deprecated Pyramid scaffolds, and sh * `pyramid-cookiecutter-starter `_ * `pyramid-cookiecutter-zodb `_ -Development of cookiecutters is documented under `Learn the Basics of Cookiecutter by Creating a Cookiecutter `_. +.. seealso:: -.. seealso:: See also `Cookiecutter Features `_. + See also `Cookiecutter Installation `_ and `Cookiecutter Features `_. Development of cookiecutters is documented under `Learn the Basics of Cookiecutter by Creating a Cookiecutter `_. -.. seealso:: See also :term:`scaffold`. +.. seealso:: + + See also :term:`scaffold`. diff --git a/docs/narr/project.rst b/docs/narr/project.rst index 62c4723dff..118a9fa890 100644 --- a/docs/narr/project.rst +++ b/docs/narr/project.rst @@ -5,33 +5,44 @@ Creating a :app:`Pyramid` Project As we saw in :ref:`firstapp_chapter`, it's possible to create a :app:`Pyramid` application completely manually. However, it's usually more convenient to use -a :term:`scaffold` to generate a basic :app:`Pyramid` :term:`project`. +a :term:`cookiecutter` to generate a basic :app:`Pyramid` :term:`project`. A project is a directory that contains at least one Python :term:`package`. -You'll use a scaffold to create a project, and you'll create your application +You'll use a cookiecutter to create a project, and you'll create your application logic within a package that lives inside the project. Even if your application is extremely simple, it is useful to place code that drives the application within a package, because (1) a package is more easily extended with new code, and (2) an application that lives inside a package can also be distributed more easily than one which does not live within a package. -:app:`Pyramid` comes with a variety of scaffolds that you can use to generate a -project. Each scaffold makes different configuration assumptions about what +The Pylons Project provides several :app:`Pyramid` cookiecutters that you can use to generate a +project. Each cookiecutter makes different configuration assumptions about what type of application you're trying to construct. -These scaffolds are rendered using the ``pcreate`` command that is installed as -part of Pyramid. +These cookiecutters are rendered using the ``cookiecutter`` command that you may install. + +.. seealso:: + + + .. index:: - single: scaffolds - single: starter scaffold - single: zodb scaffold - single: alchemy scaffold + single: cookiecutters + single: pyramid-cookiecutter-starter + single: pyramid-cookiecutter-zodb + single: pyramid-cookiecutter-alchemy -.. _additional_paster_scaffolds: +.. _additional_cookiecutters: + +:app:`Pyramid` cookiecutters +---------------------------- + +Pyramid cookiecutters released under the Pylons Project include: + +* `pyramid-cookiecutter-alchemy `_ +* `pyramid-cookiecutter-starter `_ +* `pyramid-cookiecutter-zodb `_ -Scaffolds Included with :app:`Pyramid` --------------------------------------- The convenience scaffolds included with :app:`Pyramid` differ from each other on a number of axes: From e1b26edbb88ab51b1043ef82f093507d987cc2a4 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 27 Dec 2016 02:36:30 -0800 Subject: [PATCH 14/29] narr/project - update for cookiecutters - update source files - update project.png - fix literalinclude reference in logging --- docs/narr/MyProject/CHANGES.txt | 4 - docs/narr/MyProject/README.txt | 12 - docs/narr/MyProject/setup.py | 49 --- docs/narr/logging.rst | 2 +- docs/narr/myproject/.coveragerc | 3 + docs/narr/myproject/CHANGES.txt | 4 + .../narr/{MyProject => myproject}/MANIFEST.in | 2 +- docs/narr/myproject/README.txt | 29 ++ .../{MyProject => myproject}/development.ini | 6 +- .../myproject/__init__.py | 2 +- .../myproject/static/pyramid-16x16.png | Bin .../myproject/static/pyramid.png | Bin .../myproject/static/theme.css | 8 +- .../myproject/templates/layout.jinja2} | 21 +- .../myproject/templates/mytemplate.jinja2 | 8 + .../myproject/tests.py | 0 .../myproject/views.py | 2 +- .../{MyProject => myproject}/production.ini | 6 +- docs/narr/myproject/pytest.ini | 3 + docs/narr/myproject/setup.py | 51 +++ docs/narr/project.png | Bin 133242 -> 98989 bytes docs/narr/project.rst | 322 ++++++++++-------- 22 files changed, 308 insertions(+), 226 deletions(-) delete mode 100644 docs/narr/MyProject/CHANGES.txt delete mode 100644 docs/narr/MyProject/README.txt delete mode 100644 docs/narr/MyProject/setup.py create mode 100644 docs/narr/myproject/.coveragerc create mode 100644 docs/narr/myproject/CHANGES.txt rename docs/narr/{MyProject => myproject}/MANIFEST.in (68%) create mode 100644 docs/narr/myproject/README.txt rename docs/narr/{MyProject => myproject}/development.ini (83%) rename docs/narr/{MyProject => myproject}/myproject/__init__.py (89%) rename docs/narr/{MyProject => myproject}/myproject/static/pyramid-16x16.png (100%) rename docs/narr/{MyProject => myproject}/myproject/static/pyramid.png (100%) rename docs/narr/{MyProject => myproject}/myproject/static/theme.css (95%) rename docs/narr/{MyProject/myproject/templates/mytemplate.pt => myproject/myproject/templates/layout.jinja2} (64%) create mode 100644 docs/narr/myproject/myproject/templates/mytemplate.jinja2 rename docs/narr/{MyProject => myproject}/myproject/tests.py (100%) rename docs/narr/{MyProject => myproject}/myproject/views.py (57%) rename docs/narr/{MyProject => myproject}/production.ini (79%) create mode 100644 docs/narr/myproject/pytest.ini create mode 100644 docs/narr/myproject/setup.py diff --git a/docs/narr/MyProject/CHANGES.txt b/docs/narr/MyProject/CHANGES.txt deleted file mode 100644 index 35a34f3324..0000000000 --- a/docs/narr/MyProject/CHANGES.txt +++ /dev/null @@ -1,4 +0,0 @@ -0.0 ---- - -- Initial version diff --git a/docs/narr/MyProject/README.txt b/docs/narr/MyProject/README.txt deleted file mode 100644 index 70759eba15..0000000000 --- a/docs/narr/MyProject/README.txt +++ /dev/null @@ -1,12 +0,0 @@ -MyProject README -================== - -Getting Started ---------------- - -- cd - -- $VENV/bin/pip install -e . - -- $VENV/bin/pserve development.ini - diff --git a/docs/narr/MyProject/setup.py b/docs/narr/MyProject/setup.py deleted file mode 100644 index a911eff6dc..0000000000 --- a/docs/narr/MyProject/setup.py +++ /dev/null @@ -1,49 +0,0 @@ -import os - -from setuptools import setup, find_packages - -here = os.path.abspath(os.path.dirname(__file__)) -with open(os.path.join(here, 'README.txt')) as f: - README = f.read() -with open(os.path.join(here, 'CHANGES.txt')) as f: - CHANGES = f.read() - -requires = [ - 'pyramid', - 'pyramid_chameleon', - 'pyramid_debugtoolbar', - 'waitress', - ] - -tests_require = [ - 'WebTest >= 1.3.1', # py3 compat - 'pytest', # includes virtualenv - 'pytest-cov', - ] - -setup(name='MyProject', - version='0.0', - description='MyProject', - long_description=README + '\n\n' + CHANGES, - classifiers=[ - "Programming Language :: Python", - "Framework :: Pyramid", - "Topic :: Internet :: WWW/HTTP", - "Topic :: Internet :: WWW/HTTP :: WSGI :: Application", - ], - author='', - author_email='', - url='', - keywords='web pyramid pylons', - packages=find_packages(), - include_package_data=True, - zip_safe=False, - extras_require={ - 'testing': tests_require, - }, - install_requires=requires, - entry_points="""\ - [paste.app_factory] - main = myproject:main - """, - ) diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst index f2c9908615..ec3590e621 100644 --- a/docs/narr/logging.rst +++ b/docs/narr/logging.rst @@ -50,7 +50,7 @@ Default logging configuration is provided in both the default ``development.ini`` and the ``production.ini`` files. If you use ``pyramid-cookiecutter-starter`` to generate a Pyramid project with the name of the package as ``hello_world``, then the logging configuration in the ``development.ini`` file is as follows: -.. literalinclude:: ../quick_tour/package/development.ini +.. literalinclude:: MyProject/development.ini :language: ini :lineno-match: :lines: 29- diff --git a/docs/narr/myproject/.coveragerc b/docs/narr/myproject/.coveragerc new file mode 100644 index 0000000000..f0c31d6d7f --- /dev/null +++ b/docs/narr/myproject/.coveragerc @@ -0,0 +1,3 @@ +[run] +source = myproject +omit = myproject/test* diff --git a/docs/narr/myproject/CHANGES.txt b/docs/narr/myproject/CHANGES.txt new file mode 100644 index 0000000000..14b902fd10 --- /dev/null +++ b/docs/narr/myproject/CHANGES.txt @@ -0,0 +1,4 @@ +0.0 +--- + +- Initial version. diff --git a/docs/narr/MyProject/MANIFEST.in b/docs/narr/myproject/MANIFEST.in similarity index 68% rename from docs/narr/MyProject/MANIFEST.in rename to docs/narr/myproject/MANIFEST.in index fa1692163e..1c24b8c0cc 100644 --- a/docs/narr/MyProject/MANIFEST.in +++ b/docs/narr/myproject/MANIFEST.in @@ -1,2 +1,2 @@ include *.txt *.ini *.cfg *.rst -recursive-include myproject *.ico *.png *.css *.gif *.jpg *.pt *.txt *.mak *.mako *.js *.html *.xml +recursive-include myproject *.ico *.png *.css *.gif *.jpg *.pt *.txt *.mak *.mako *.js *.html *.xml *.jinja2 diff --git a/docs/narr/myproject/README.txt b/docs/narr/myproject/README.txt new file mode 100644 index 0000000000..41ef0ff910 --- /dev/null +++ b/docs/narr/myproject/README.txt @@ -0,0 +1,29 @@ +MyProject +=============================== + +Getting Started +--------------- + +- Change directory into your newly created project. + + cd MyProject + +- Create a Python virtual environment. + + python3 -m venv env + +- Upgrade packaging tools. + + env/bin/pip install --upgrade pip setuptools + +- Install the project in editable mode with its testing requirements. + + env/bin/pip install -e ".[testing]" + +- Run your project's tests. + + env/bin/pytest + +- Run your project. + + env/bin/pserve development.ini diff --git a/docs/narr/MyProject/development.ini b/docs/narr/myproject/development.ini similarity index 83% rename from docs/narr/MyProject/development.ini rename to docs/narr/myproject/development.ini index 3a83dcfac6..5d110805ab 100644 --- a/docs/narr/MyProject/development.ini +++ b/docs/narr/myproject/development.ini @@ -1,10 +1,10 @@ ### # app configuration -# http://docs.pylonsproject.org/projects/pyramid/en/1.7-branch/narr/environment.html +# http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/environment.html ### [app:main] -use = egg:MyProject +use = egg:myproject pyramid.reload_templates = true pyramid.debug_authorization = false @@ -28,7 +28,7 @@ listen = 127.0.0.1:6543 [::1]:6543 ### # logging configuration -# http://docs.pylonsproject.org/projects/pyramid/en/1.7-branch/narr/logging.html +# http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/logging.html ### [loggers] diff --git a/docs/narr/MyProject/myproject/__init__.py b/docs/narr/myproject/myproject/__init__.py similarity index 89% rename from docs/narr/MyProject/myproject/__init__.py rename to docs/narr/myproject/myproject/__init__.py index ad5ecbc6f1..49dde36d4d 100644 --- a/docs/narr/MyProject/myproject/__init__.py +++ b/docs/narr/myproject/myproject/__init__.py @@ -5,7 +5,7 @@ def main(global_config, **settings): """ This function returns a Pyramid WSGI application. """ config = Configurator(settings=settings) - config.include('pyramid_chameleon') + config.include('pyramid_jinja2') config.add_static_view('static', 'static', cache_max_age=3600) config.add_route('home', '/') config.scan() diff --git a/docs/narr/MyProject/myproject/static/pyramid-16x16.png b/docs/narr/myproject/myproject/static/pyramid-16x16.png similarity index 100% rename from docs/narr/MyProject/myproject/static/pyramid-16x16.png rename to docs/narr/myproject/myproject/static/pyramid-16x16.png diff --git a/docs/narr/MyProject/myproject/static/pyramid.png b/docs/narr/myproject/myproject/static/pyramid.png similarity index 100% rename from docs/narr/MyProject/myproject/static/pyramid.png rename to docs/narr/myproject/myproject/static/pyramid.png diff --git a/docs/narr/MyProject/myproject/static/theme.css b/docs/narr/myproject/myproject/static/theme.css similarity index 95% rename from docs/narr/MyProject/myproject/static/theme.css rename to docs/narr/myproject/myproject/static/theme.css index be50ad4209..0f4b1a4d41 100644 --- a/docs/narr/MyProject/myproject/static/theme.css +++ b/docs/narr/myproject/myproject/static/theme.css @@ -72,10 +72,12 @@ p { color: #f2b7bd; font-weight: 400; } -.starter-template .links ul li a { - color: #ffffff; +.starter-template .links ul li a, a { + color: #f2b7bd; + text-decoration: underline; } -.starter-template .links ul li a:hover { +.starter-template .links ul li a:hover, a:hover { + color: #ffffff; text-decoration: underline; } .starter-template .links ul li .icon-muted { diff --git a/docs/narr/MyProject/myproject/templates/mytemplate.pt b/docs/narr/myproject/myproject/templates/layout.jinja2 similarity index 64% rename from docs/narr/MyProject/myproject/templates/mytemplate.pt rename to docs/narr/myproject/myproject/templates/layout.jinja2 index 543663fe8f..bfac9e64e1 100644 --- a/docs/narr/MyProject/myproject/templates/mytemplate.pt +++ b/docs/narr/myproject/myproject/templates/layout.jinja2 @@ -1,20 +1,20 @@ - + - + - Starter Scaffold for The Pyramid Web Framework + Cookiecutter Starter project for the Pyramid Web Framework - +