Steve Piercy
2017-06-27 7b16126c85c466be09868c26ea67e09bfa18a446
Update all external links per `make linkcheck`
- Most are changing http to https, or readthedocs.org to readthedocs.io,
and some for Python packaging reorganizing some docs into tutorials,
as well as miscellaneous changes.

(cherry picked from commit a816a88)
16 files modified
58 ■■■■ changed files
docs/copyright.rst 2 ●●● patch | view | raw | blame | history
docs/glossary.rst 20 ●●●● patch | view | raw | blame | history
docs/narr/firstapp.rst 2 ●●● patch | view | raw | blame | history
docs/narr/i18n.rst 2 ●●● patch | view | raw | blame | history
docs/narr/install.rst 4 ●●●● patch | view | raw | blame | history
docs/narr/introduction.rst 4 ●●●● patch | view | raw | blame | history
docs/narr/project.rst 2 ●●● patch | view | raw | blame | history
docs/narr/scaffolding.rst 2 ●●● patch | view | raw | blame | history
docs/narr/sessions.rst 4 ●●●● patch | view | raw | blame | history
docs/narr/templates.rst 2 ●●● patch | view | raw | blame | history
docs/narr/webob.rst 4 ●●●● patch | view | raw | blame | history
docs/quick_tutorial/package.rst 2 ●●● patch | view | raw | blame | history
docs/tutorials/wiki/installation.rst 2 ●●● patch | view | raw | blame | history
docs/tutorials/wiki2/installation.rst 2 ●●● patch | view | raw | blame | history
docs/typographical-conventions.rst 2 ●●● patch | view | raw | blame | history
pyramid/request.py 2 ●●● patch | view | raw | blame | history
docs/copyright.rst
@@ -18,7 +18,7 @@
All rights reserved.  This material may be copied or distributed only
subject to the terms and conditions set forth in the `Creative Commons
Attribution-Noncommercial-Share Alike 3.0 United States License
<http://creativecommons.org/licenses/by-nc-sa/3.0/us/>`_.  You must
<https://creativecommons.org/licenses/by-nc-sa/3.0/us/>`_.  You must
give the original author credit.  You may not use this work for
commercial purposes.  If you alter, transform, or build upon this
work, you may distribute the resulting work only under the same or
docs/glossary.rst
@@ -321,7 +321,7 @@
     :term:`principal` (or principals) associated with a request.
   WSGI
     `Web Server Gateway Interface <http://wsgi.readthedocs.org/en/latest/>`_.
     `Web Server Gateway Interface <https://wsgi.readthedocs.io/en/latest/>`_.
     This is a Python standard for connecting web applications to web servers,
     similar to the concept of Java Servlets.  :app:`Pyramid` requires that
     your application be served as a WSGI application.
@@ -330,8 +330,8 @@
     *Middleware* is a :term:`WSGI` concept.  It is a WSGI component
     that acts both as a server and an application.  Interesting uses
     for middleware exist, such as caching, content-transport
     encoding, and other functions.  See `WSGI.org
     <http://wsgi.readthedocs.org/en/latest/>`_ or `PyPI
     encoding, and other functions.  See `WSGI documentation
     <https://wsgi.readthedocs.io/en/latest/>`_ or `PyPI
     <https://pypi.python.org/pypi>`_ to find middleware for your application.
   pipeline
@@ -339,7 +339,7 @@
     server, a WSGI application, with a set of :term:`middleware` in-between.
   Zope
     `The Z Object Publishing Framework <http://zope.org>`_, a
     `The Z Object Publishing Framework <http://www.zope.org/en/latest/>`_, a
     full-featured Python web framework.
   Grok
@@ -357,7 +357,7 @@
      Python object store.
   WebOb
     `WebOb <http://webob.org>`_ is a WSGI request/response
     `WebOb <https://webob.org>`_ is a WSGI request/response
     library created by Ian Bicking.
   PasteDeploy
@@ -375,7 +375,7 @@
     integrated support for loading a :term:`PasteDeploy` INI file.
   Chameleon
     `chameleon <https://chameleon.readthedocs.org/en/latest/>`_ is an
     `chameleon <https://chameleon.readthedocs.io/en/latest/>`_ is an
     attribute language template compiler which supports the :term:`ZPT`
     templating specification. It is written and maintained by Malthe Borch. It
     has several extensions, such as the ability to use bracketed (Mako-style)
@@ -401,7 +401,7 @@
     A `text templating language <http://jinja.pocoo.org/>`_ by Armin Ronacher.
   Routes
     A `system by Ben Bangert <http://routes.readthedocs.org/en/latest/>`_
     A `system by Ben Bangert <https://routes.readthedocs.io/en/latest/>`_
     which parses URLs and compares them against a number of user defined
     mappings. The URL pattern matching syntax in :app:`Pyramid` is inspired by
     the Routes syntax (which was inspired by Ruby On Rails pattern syntax).
@@ -500,7 +500,7 @@
     information.
   repoze.who
     `Authentication middleware <http://repozewho.readthedocs.org/en/latest/>`_
     `Authentication middleware <https://repozewho.readthedocs.io/en/latest/>`_
     for :term:`WSGI` applications.  It can be used by :app:`Pyramid` to
     provide authentication information.
@@ -576,7 +576,7 @@
     :ref:`adding_and_overriding_renderers` for more information.
   mod_wsgi
     `mod_wsgi <https://modwsgi.readthedocs.io>`_ is an Apache
     `mod_wsgi <https://modwsgi.readthedocs.io/en/develop/>`_ is an Apache
     module developed by Graham Dumpleton.  It allows :term:`WSGI` applications
     (such as applications developed using :app:`Pyramid`) to be served using
     the Apache web server.
@@ -1130,7 +1130,7 @@
      The :term:`Python Packaging Authority` formerly recommended using the
      ``pyvenv`` command for `creating virtual environments on Python 3.4 and
      3.5
      <https://packaging.python.org/en/latest/installing/#creating-virtual-environments>`_,
      <https://packaging.python.org/tutorials/installing-packages/#creating-virtual-environments>`_,
      but it was deprecated in 3.6 in favor of ``python3 -m venv`` on UNIX or
      ``python -m venv`` on Windows, which is backward compatible on Python
      3.3 and greater.
docs/narr/firstapp.rst
@@ -197,7 +197,7 @@
server to present an application to a requestor. :term:`WSGI` is a protocol
that allows servers to talk to Python applications.  We don't discuss
:term:`WSGI` in any depth within this book, but you can learn more about it by
reading its `documentation <http://wsgi.readthedocs.org/en/latest/>`_.
reading its `documentation <https://wsgi.readthedocs.io/en/latest/>`_.
The :app:`Pyramid` application object, in particular, is an instance of a class
representing a :app:`Pyramid` :term:`router`.  It has a reference to the
docs/narr/i18n.rst
@@ -647,7 +647,7 @@
The features represented by attributes of the ``i18n`` namespace of Chameleon
will also consult the :app:`Pyramid` translations. See
http://chameleon.readthedocs.org/en/latest/reference.html#translation-i18n.
https://chameleon.readthedocs.io/en/latest/reference.html#translation-i18n.
.. note::
docs/narr/install.rst
@@ -54,7 +54,7 @@
You can install the latest verion of Python for Mac OS X from the binaries on
`python.org <https://www.python.org/downloads/mac-osx/>`_.
Alternatively, you can use the `homebrew <http://brew.sh/>`_ package manager.
Alternatively, you can use the `homebrew <https://brew.sh/>`_ package manager.
.. code-block:: text
@@ -157,7 +157,7 @@
.. seealso:: See the Python Packaging Authority's (PyPA) documention
   `Requirements for Installing Packages
   <https://packaging.python.org/en/latest/installing/#requirements-for-installing-packages>`_
   <https://packaging.python.org/tutorials/installing-packages/#requirements-for-installing-packages>`_
   for full details.
docs/narr/introduction.rst
@@ -52,7 +52,7 @@
Tested
~~~~~~
Untested code is broken by design. The :app:`Pyramid` community has a strong testing culture and our framework reflects that. Every release of :app:`Pyramid` has 100% statement coverage (as measured by `coverage <https://coverage.readthedocs.io>`_) and 95% decision/condition coverage. (as measured by `instrumental <http://instrumental.readthedocs.io/en/latest/intro.html>`_) It is automatically tested using `Travis <https://travis-ci.org/Pylons/pyramid>`_ and `Jenkins <http://jenkins.pylonsproject.org/job/pyramid/>`_ on supported versions of Python after each commit to its GitHub repository. `Official Pyramid add-ons <https://trypyramid.com/resources-extending-pyramid.html>`_ are held to a similar testing standard.
Untested code is broken by design. The :app:`Pyramid` community has a strong testing culture and our framework reflects that. Every release of :app:`Pyramid` has 100% statement coverage (as measured by `coverage <http://coverage.readthedocs.io/en/latest/>`_) and 95% decision/condition coverage. (as measured by `instrumental <http://instrumental.readthedocs.io/en/latest/intro.html>`_) It is automatically tested using `Travis <https://travis-ci.org/Pylons/pyramid>`_ and `Jenkins <http://jenkins.pylonsproject.org/job/pyramid/>`_ on supported versions of Python after each commit to its GitHub repository. `Official Pyramid add-ons <https://trypyramid.com/resources-extending-pyramid.html>`_ are held to a similar testing standard.
We still find bugs in :app:`Pyramid`, but we've noticed we find a lot fewer of them while working on projects with a solid testing regime.
@@ -324,7 +324,7 @@
The :app:`Pyramid` core is fast. It has been engineered from the ground up for speed. It only does as much work as absolutely necessary when you ask it to get a job done. If you need speed from your application, :app:`Pyramid` is the right choice for you.
Example: http://blog.curiasolutions.com/pages/the-great-web-framework-shootout.html
Example: https://blog.curiasolutions.com/pages/the-great-web-framework-shootout.html
Store session data
~~~~~~~~~~~~~~~~~~
docs/narr/project.rst
@@ -740,7 +740,7 @@
   ``setup.py`` is the de facto standard which Python developers use to
   distribute their reusable code.  You can read more about ``setup.py`` files
   and their usage in the `Python Packaging User Guide
   <https://packaging.python.org/en/latest/>`_ and `Setuptools documentation
   <https://packaging.python.org/>`_ and `Setuptools documentation
   <http://pythonhosted.org/setuptools/>`_.
Our generated ``setup.py`` looks like this:
docs/narr/scaffolding.rst
@@ -27,7 +27,7 @@
To create a scaffold template, create a Python :term:`distribution` to house
the scaffold which includes a ``setup.py`` that relies on the ``setuptools``
package.  See `Packaging and Distributing Projects
<https://packaging.python.org/en/latest/distributing/>`_ for more information
<https://packaging.python.org/tutorials/distributing-packages/>`_ for more information
about how to do this.  For example, we'll pretend the distribution you create
is named ``CoolExtension``, and it has a package directory within it named
``coolextension``.
docs/narr/sessions.rst
@@ -174,10 +174,10 @@
.. _PyNaCl: https://pynacl.readthedocs.io/en/latest/secret/
.. _pyramid_redis_sessions: https://pypi.python.org/pypi/pyramid_redis_sessions
.. _Redis: http://redis.io/
.. _Redis: https://redis.io/
.. _pyramid_beaker: https://pypi.python.org/pypi/pyramid_beaker
.. _Beaker: http://beaker.readthedocs.org/en/latest/
.. _Beaker: https://beaker.readthedocs.io/en/latest/
.. index::
   single: session factory (custom)
docs/narr/templates.rst
@@ -448,7 +448,7 @@
| Mako_                     | pyramid_mako_              | .mak, .mako        |
+---------------------------+----------------------------+--------------------+
.. _Chameleon: http://chameleon.readthedocs.org/en/latest/
.. _Chameleon: https://chameleon.readthedocs.io/en/latest/
.. _pyramid_chameleon:
   https://docs.pylonsproject.org/projects/pyramid-chameleon/en/latest/
docs/narr/webob.rst
@@ -27,7 +27,7 @@
:ref:`request_module` API documentation.
WebOb provides objects for HTTP requests and responses.  Specifically it does
this by wrapping the `WSGI <http://wsgi.readthedocs.org/en/latest/>`_ request
this by wrapping the `WSGI <https://wsgi.readthedocs.io/en/latest/>`_ request
environment and response status, header list, and app_iter (body) values.
WebOb request and response objects provide many conveniences for parsing WSGI
@@ -88,7 +88,7 @@
``req.urlvars`` and ``req.urlargs``
    ``req.urlvars`` are the keyword parameters associated with the request URL.
    ``req.urlargs`` are the positional parameters. These are set by products
    like `Routes <http://routes.readthedocs.org/en/latest/>`_ and `Selector
    like `Routes <https://routes.readthedocs.io/en/latest/>`_ and `Selector
    <https://github.com/lukearno/selector>`_.
Also for standard HTTP request headers, there are usually attributes such as
docs/quick_tutorial/package.rst
@@ -108,4 +108,4 @@
.. seealso:: :ref:`Python Packages <python:tut-packages>` and `Working in
   "Development Mode"
   <https://packaging.python.org/en/latest/distributing/#working-in-development-mode>`_.
   <https://packaging.python.org/tutorials/distributing-packages/#working-in-development-mode>`_.
docs/tutorials/wiki/installation.rst
@@ -388,4 +388,4 @@
   https://docs.pylonsproject.org/projects/pyramid-zodbconn/en/latest/
.. _transaction:
   http://zodb.readthedocs.org/en/latest/transactions.html
   https://zodb.readthedocs.io/en/latest/transactions.html
docs/tutorials/wiki2/installation.rst
@@ -471,4 +471,4 @@
   https://pypi.python.org/pypi/zope.sqlalchemy
.. _transaction:
   http://zodb.readthedocs.org/en/latest/transactions.html
   https://zodb.readthedocs.io/en/latest/transactions.html
docs/typographical-conventions.rst
@@ -35,7 +35,7 @@
Links are presented as follows, and may be clickable.
`TryPyramid <https://TryPyramid.com>`_
`TryPyramid <https://trypyramid.com>`_
.. seealso:: See also :ref:`typographical-conventions-cross-references` for other links within the documentation.
pyramid/request.py
@@ -175,7 +175,7 @@
    version number from which this documentation is autogenerated, but
    it will be the 'prevailing WebOb version' at the time of the
    release of this :app:`Pyramid` version.  See
    http://webob.org/ for further information.
    https://webob.org/ for further information.
    """
    exception = None
    exc_info = None