[Python-modules-commits] [aiohttp-jinja2] 01/03: import aiohttp-jinja2_0.8.0.orig.tar.gz
Piotr Ożarowski
piotr at moszumanska.debian.org
Sat Jul 30 14:23:20 UTC 2016
This is an automated email from the git hooks/post-receive script.
piotr pushed a commit to branch master
in repository aiohttp-jinja2.
commit 5fb62e5ea91d91ca0a7c9b3e5111f953c35cce22
Author: Piotr Ożarowski <ozarow at gmail.com>
Date: Sat Jul 30 16:17:47 2016 +0200
import aiohttp-jinja2_0.8.0.orig.tar.gz
---
CHANGES.txt | 89 ++++++++
LICENSE | 202 +++++++++++++++++
MANIFEST.in | 9 +
Makefile | 31 +++
PKG-INFO | 195 +++++++++++++++++
README.rst | 89 ++++++++
aiohttp_jinja2.egg-info/PKG-INFO | 195 +++++++++++++++++
aiohttp_jinja2.egg-info/SOURCES.txt | 23 ++
aiohttp_jinja2.egg-info/dependency_links.txt | 1 +
aiohttp_jinja2.egg-info/requires.txt | 2 +
aiohttp_jinja2.egg-info/top_level.txt | 1 +
aiohttp_jinja2/__init__.py | 120 +++++++++++
docs/Makefile | 177 +++++++++++++++
docs/_static/aiohttp-icon-128x128.png | Bin 0 -> 23595 bytes
docs/aiohttp-icon.ico | Bin 0 -> 3262 bytes
docs/conf.py | 309 +++++++++++++++++++++++++++
docs/index.rst | 257 ++++++++++++++++++++++
docs/make.bat | 242 +++++++++++++++++++++
setup.cfg | 5 +
setup.py | 41 ++++
tests/conftest.py | 229 ++++++++++++++++++++
tests/test_context_processors.py | 81 +++++++
tests/test_jinja_globals.py | 43 ++++
tests/test_simple_renderer.py | 280 ++++++++++++++++++++++++
24 files changed, 2621 insertions(+)
diff --git a/CHANGES.txt b/CHANGES.txt
new file mode 100644
index 0000000..cd5a965
--- /dev/null
+++ b/CHANGES.txt
@@ -0,0 +1,89 @@
+CHANGES
+=======
+
+0.8.0 (2016-07-12)
+------------------
+
+- Add ability to render template without context #28
+
+0.7.0 (2015-12-30)
+------------------
+
+- Add ability to decorate class based views (available in aiohttp 0.20) #18
+
+- Upgrade aiohttp requirement to version 0.20.0+
+
+0.6.2 (2015-11-22)
+------------------
+
+- Make app_key parameter from render_string coroutine optional
+
+0.6.0 (2015-10-29)
+------------------
+
+- Fix a bug in middleware (missed coroutine decorator) #16
+
+- Drop Python 3.3 support (switched to aiohttp version v0.18.0)
+
+- Simplify context processors initialization by adding parameter to `setup()`
+
+0.5.0 (2015-07-09)
+------------------
+
+- Introduce context processors #14
+
+- Bypass StreamResponse #15
+
+0.4.3 (2015-06-01)
+------------------
+
+- Fix distribution building: add manifest file
+
+0.4.2 (2015-05-21)
+------------------
+
+- Make HTTPInternalServerError exceptions more verbose on console
+ output
+
+0.4.1 (2015-04-05)
+------------------
+
+- Documentation update
+
+0.4.0 (2015-04-02)
+------------------
+
+- Add `render_string` method
+
+0.3.1 (2015-04-01)
+------------------
+
+- Don't allow non-mapping context
+
+- Fix tiny documentation issues
+
+- Change the library logo
+
+0.3.0 (2015-03-15)
+------------------
+
+- Documentation release
+
+0.2.1 (2015-02-15)
+------------------
+
+- Fix `render_template` function
+
+0.2.0 (2015-02-05)
+------------------
+
+- Migrate to aiohttp 0.14
+
+- Add `status` parameter to template decorator
+
+- Drop optional `response` parameter
+
+0.1.0 (2015-01-08)
+------------------
+
+- Initial release
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..c53c88c
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,202 @@
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "{}"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright 2015-2016 Andrew Svetlov
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
diff --git a/MANIFEST.in b/MANIFEST.in
new file mode 100644
index 0000000..9615da6
--- /dev/null
+++ b/MANIFEST.in
@@ -0,0 +1,9 @@
+include CHANGES.txt
+include LICENSE
+include README.rst
+include Makefile
+graft aiohttp_jinja2
+graft docs
+graft examples
+graft tests
+global-exclude *.pyc
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..055aacb
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,31 @@
+# Some simple testing tasks (sorry, UNIX only).
+
+flake:
+ flake8 aiohttp_jinja2 tests
+
+test: flake
+ py.test -s ./tests/
+
+cov cover coverage:
+ py.test --cov=aiohttp_jinja2 --cov-report=html --cov-report=term ./tests/
+ @echo "open file://`pwd`/htmlcov/index.html"
+
+clean:
+ rm -rf `find . -name __pycache__`
+ rm -f `find . -type f -name '*.py[co]' `
+ rm -f `find . -type f -name '*~' `
+ rm -f `find . -type f -name '.*~' `
+ rm -f `find . -type f -name '@*' `
+ rm -f `find . -type f -name '#*#' `
+ rm -f `find . -type f -name '*.orig' `
+ rm -f `find . -type f -name '*.rej' `
+ rm -f .coverage
+ rm -rf coverage
+ rm -rf build
+ rm -rf cover
+
+doc:
+ make -C docs html
+ @echo "open file://`pwd`/docs/_build/html/index.html"
+
+.PHONY: all build venv flake test vtest testloop cov clean doc
diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..cb37ce4
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,195 @@
+Metadata-Version: 1.1
+Name: aiohttp_jinja2
+Version: 0.8.0
+Summary: jinja2 template renderer for aiohttp.web (http server for asyncio)
+Home-page: https://github.com/aio-libs/aiohttp_jinja2/
+Author: Andrew Svetlov
+Author-email: andrew.svetlov at gmail.com
+License: Apache 2
+Description: aiohttp_jinja2
+ ==============
+
+ jinja2_ template renderer for `aiohttp.web`__.
+
+
+ .. _jinja2: http://jinja.pocoo.org
+
+ .. _aiohttp_web: https://aiohttp.readthedocs.io/en/latest/web.html
+
+ __ aiohttp_web_
+
+ Installation
+ ------------
+ Install from PyPI::
+
+ pip install aiohttp-jinja2
+
+
+ Developing
+ ----------
+
+ Install requirement and launch tests::
+
+ pip install -r requirements-dev.txt
+ py.test tests
+
+
+ Usage
+ -----
+
+ Before template rendering you have to setup *jinja2 environment* first::
+
+ app = web.Application()
+ aiohttp_jinja2.setup(app,
+ loader=jinja2.FileSystemLoader('/path/to/templates/folder'))
+
+
+ After that you may to use template engine in your *web-handlers*. The
+ most convenient way is to decorate a *web-handler*.
+
+ Using the function based web handlers::
+
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ def handler(request):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+ Or for `Class Based Views
+ <https://aiohttp.readthedocs.io/en/stable/web.html#class-based-views>`::
+
+ class Handler(web.View):
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ async def get(self):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+
+ On handler call the ``aiohttp_jinja2.template`` decorator will pass
+ returned dictionary ``{'name': 'Andrew', 'surname': 'Svetlov'}`` into
+ template named ``tmpl.jinja2`` for getting resulting HTML text.
+
+ If you need more complex processing (set response headers for example)
+ you may call ``render_template`` function.
+
+ Using a function based web handler::
+
+ async def handler(request):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+ Or, again, a class based view::
+
+ class Handler(web.View):
+ async def get(self):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ self.request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+
+ License
+ -------
+
+ ``aiohttp_jinja2`` is offered under the Apache 2 license.
+
+ CHANGES
+ =======
+
+ 0.8.0 (2016-07-12)
+ ------------------
+
+ - Add ability to render template without context #28
+
+ 0.7.0 (2015-12-30)
+ ------------------
+
+ - Add ability to decorate class based views (available in aiohttp 0.20) #18
+
+ - Upgrade aiohttp requirement to version 0.20.0+
+
+ 0.6.2 (2015-11-22)
+ ------------------
+
+ - Make app_key parameter from render_string coroutine optional
+
+ 0.6.0 (2015-10-29)
+ ------------------
+
+ - Fix a bug in middleware (missed coroutine decorator) #16
+
+ - Drop Python 3.3 support (switched to aiohttp version v0.18.0)
+
+ - Simplify context processors initialization by adding parameter to `setup()`
+
+ 0.5.0 (2015-07-09)
+ ------------------
+
+ - Introduce context processors #14
+
+ - Bypass StreamResponse #15
+
+ 0.4.3 (2015-06-01)
+ ------------------
+
+ - Fix distribution building: add manifest file
+
+ 0.4.2 (2015-05-21)
+ ------------------
+
+ - Make HTTPInternalServerError exceptions more verbose on console
+ output
+
+ 0.4.1 (2015-04-05)
+ ------------------
+
+ - Documentation update
+
+ 0.4.0 (2015-04-02)
+ ------------------
+
+ - Add `render_string` method
+
+ 0.3.1 (2015-04-01)
+ ------------------
+
+ - Don't allow non-mapping context
+
+ - Fix tiny documentation issues
+
+ - Change the library logo
+
+ 0.3.0 (2015-03-15)
+ ------------------
+
+ - Documentation release
+
+ 0.2.1 (2015-02-15)
+ ------------------
+
+ - Fix `render_template` function
+
+ 0.2.0 (2015-02-05)
+ ------------------
+
+ - Migrate to aiohttp 0.14
+
+ - Add `status` parameter to template decorator
+
+ - Drop optional `response` parameter
+
+ 0.1.0 (2015-01-08)
+ ------------------
+
+ - Initial release
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Topic :: Internet :: WWW/HTTP
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..75d59c4
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,89 @@
+aiohttp_jinja2
+==============
+
+jinja2_ template renderer for `aiohttp.web`__.
+
+
+.. _jinja2: http://jinja.pocoo.org
+
+.. _aiohttp_web: https://aiohttp.readthedocs.io/en/latest/web.html
+
+__ aiohttp_web_
+
+Installation
+------------
+Install from PyPI::
+
+ pip install aiohttp-jinja2
+
+
+Developing
+----------
+
+Install requirement and launch tests::
+
+ pip install -r requirements-dev.txt
+ py.test tests
+
+
+Usage
+-----
+
+Before template rendering you have to setup *jinja2 environment* first::
+
+ app = web.Application()
+ aiohttp_jinja2.setup(app,
+ loader=jinja2.FileSystemLoader('/path/to/templates/folder'))
+
+
+After that you may to use template engine in your *web-handlers*. The
+most convenient way is to decorate a *web-handler*.
+
+Using the function based web handlers::
+
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ def handler(request):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+Or for `Class Based Views
+<https://aiohttp.readthedocs.io/en/stable/web.html#class-based-views>`::
+
+ class Handler(web.View):
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ async def get(self):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+
+On handler call the ``aiohttp_jinja2.template`` decorator will pass
+returned dictionary ``{'name': 'Andrew', 'surname': 'Svetlov'}`` into
+template named ``tmpl.jinja2`` for getting resulting HTML text.
+
+If you need more complex processing (set response headers for example)
+you may call ``render_template`` function.
+
+Using a function based web handler::
+
+ async def handler(request):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+Or, again, a class based view::
+
+ class Handler(web.View):
+ async def get(self):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ self.request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+
+License
+-------
+
+``aiohttp_jinja2`` is offered under the Apache 2 license.
diff --git a/aiohttp_jinja2.egg-info/PKG-INFO b/aiohttp_jinja2.egg-info/PKG-INFO
new file mode 100644
index 0000000..0d248f0
--- /dev/null
+++ b/aiohttp_jinja2.egg-info/PKG-INFO
@@ -0,0 +1,195 @@
+Metadata-Version: 1.1
+Name: aiohttp-jinja2
+Version: 0.8.0
+Summary: jinja2 template renderer for aiohttp.web (http server for asyncio)
+Home-page: https://github.com/aio-libs/aiohttp_jinja2/
+Author: Andrew Svetlov
+Author-email: andrew.svetlov at gmail.com
+License: Apache 2
+Description: aiohttp_jinja2
+ ==============
+
+ jinja2_ template renderer for `aiohttp.web`__.
+
+
+ .. _jinja2: http://jinja.pocoo.org
+
+ .. _aiohttp_web: https://aiohttp.readthedocs.io/en/latest/web.html
+
+ __ aiohttp_web_
+
+ Installation
+ ------------
+ Install from PyPI::
+
+ pip install aiohttp-jinja2
+
+
+ Developing
+ ----------
+
+ Install requirement and launch tests::
+
+ pip install -r requirements-dev.txt
+ py.test tests
+
+
+ Usage
+ -----
+
+ Before template rendering you have to setup *jinja2 environment* first::
+
+ app = web.Application()
+ aiohttp_jinja2.setup(app,
+ loader=jinja2.FileSystemLoader('/path/to/templates/folder'))
+
+
+ After that you may to use template engine in your *web-handlers*. The
+ most convenient way is to decorate a *web-handler*.
+
+ Using the function based web handlers::
+
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ def handler(request):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+ Or for `Class Based Views
+ <https://aiohttp.readthedocs.io/en/stable/web.html#class-based-views>`::
+
+ class Handler(web.View):
+ @aiohttp_jinja2.template('tmpl.jinja2')
+ async def get(self):
+ return {'name': 'Andrew', 'surname': 'Svetlov'}
+
+
+ On handler call the ``aiohttp_jinja2.template`` decorator will pass
+ returned dictionary ``{'name': 'Andrew', 'surname': 'Svetlov'}`` into
+ template named ``tmpl.jinja2`` for getting resulting HTML text.
+
+ If you need more complex processing (set response headers for example)
+ you may call ``render_template`` function.
+
+ Using a function based web handler::
+
+ async def handler(request):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+ Or, again, a class based view::
+
+ class Handler(web.View):
+ async def get(self):
+ context = {'name': 'Andrew', 'surname': 'Svetlov'}
+ response = aiohttp_jinja2.render_template('tmpl.jinja2',
+ self.request,
+ context)
+ response.headers['Content-Language'] = 'ru'
+ return response
+
+
+ License
+ -------
+
+ ``aiohttp_jinja2`` is offered under the Apache 2 license.
+
+ CHANGES
+ =======
+
+ 0.8.0 (2016-07-12)
+ ------------------
+
+ - Add ability to render template without context #28
+
+ 0.7.0 (2015-12-30)
+ ------------------
+
+ - Add ability to decorate class based views (available in aiohttp 0.20) #18
+
+ - Upgrade aiohttp requirement to version 0.20.0+
+
+ 0.6.2 (2015-11-22)
+ ------------------
+
+ - Make app_key parameter from render_string coroutine optional
+
+ 0.6.0 (2015-10-29)
+ ------------------
+
+ - Fix a bug in middleware (missed coroutine decorator) #16
+
+ - Drop Python 3.3 support (switched to aiohttp version v0.18.0)
+
+ - Simplify context processors initialization by adding parameter to `setup()`
+
+ 0.5.0 (2015-07-09)
+ ------------------
+
+ - Introduce context processors #14
+
+ - Bypass StreamResponse #15
+
+ 0.4.3 (2015-06-01)
+ ------------------
+
+ - Fix distribution building: add manifest file
+
+ 0.4.2 (2015-05-21)
+ ------------------
+
+ - Make HTTPInternalServerError exceptions more verbose on console
+ output
+
+ 0.4.1 (2015-04-05)
+ ------------------
+
+ - Documentation update
+
+ 0.4.0 (2015-04-02)
+ ------------------
+
+ - Add `render_string` method
+
+ 0.3.1 (2015-04-01)
+ ------------------
+
+ - Don't allow non-mapping context
+
+ - Fix tiny documentation issues
+
+ - Change the library logo
+
+ 0.3.0 (2015-03-15)
+ ------------------
+
+ - Documentation release
+
+ 0.2.1 (2015-02-15)
+ ------------------
+
+ - Fix `render_template` function
+
+ 0.2.0 (2015-02-05)
+ ------------------
+
+ - Migrate to aiohttp 0.14
+
+ - Add `status` parameter to template decorator
+
+ - Drop optional `response` parameter
+
+ 0.1.0 (2015-01-08)
+ ------------------
+
+ - Initial release
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Topic :: Internet :: WWW/HTTP
diff --git a/aiohttp_jinja2.egg-info/SOURCES.txt b/aiohttp_jinja2.egg-info/SOURCES.txt
new file mode 100644
index 0000000..5676b30
--- /dev/null
+++ b/aiohttp_jinja2.egg-info/SOURCES.txt
@@ -0,0 +1,23 @@
+CHANGES.txt
+LICENSE
+MANIFEST.in
+Makefile
+README.rst
+setup.cfg
+setup.py
+aiohttp_jinja2/__init__.py
+aiohttp_jinja2.egg-info/PKG-INFO
+aiohttp_jinja2.egg-info/SOURCES.txt
+aiohttp_jinja2.egg-info/dependency_links.txt
+aiohttp_jinja2.egg-info/requires.txt
+aiohttp_jinja2.egg-info/top_level.txt
+docs/Makefile
+docs/aiohttp-icon.ico
+docs/conf.py
+docs/index.rst
+docs/make.bat
+docs/_static/aiohttp-icon-128x128.png
+tests/conftest.py
+tests/test_context_processors.py
+tests/test_jinja_globals.py
+tests/test_simple_renderer.py
\ No newline at end of file
diff --git a/aiohttp_jinja2.egg-info/dependency_links.txt b/aiohttp_jinja2.egg-info/dependency_links.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/aiohttp_jinja2.egg-info/dependency_links.txt
@@ -0,0 +1 @@
+
diff --git a/aiohttp_jinja2.egg-info/requires.txt b/aiohttp_jinja2.egg-info/requires.txt
new file mode 100644
index 0000000..7873f87
--- /dev/null
+++ b/aiohttp_jinja2.egg-info/requires.txt
@@ -0,0 +1,2 @@
+aiohttp>=0.20
+jinja2>=2.7
diff --git a/aiohttp_jinja2.egg-info/top_level.txt b/aiohttp_jinja2.egg-info/top_level.txt
new file mode 100644
index 0000000..f256658
--- /dev/null
+++ b/aiohttp_jinja2.egg-info/top_level.txt
@@ -0,0 +1 @@
+aiohttp_jinja2
diff --git a/aiohttp_jinja2/__init__.py b/aiohttp_jinja2/__init__.py
new file mode 100644
index 0000000..a8b449c
--- /dev/null
+++ b/aiohttp_jinja2/__init__.py
@@ -0,0 +1,120 @@
+import asyncio
+import functools
+import jinja2
+from collections import Mapping
+from aiohttp import web
+from aiohttp.abc import AbstractView
+
+
+__version__ = '0.8.0'
+
+__all__ = ('setup', 'get_env', 'render_template', 'template')
+
+
+APP_KEY = 'aiohttp_jinja2_environment'
+REQUEST_CONTEXT_KEY = 'aiohttp_jinja2_context'
+APP_CONTEXT_PROCESSORS_KEY = 'aiohttp_jinja2_context_processors'
+
+
+def setup(app, *args, app_key=APP_KEY, context_processors=(), **kwargs):
+ env = jinja2.Environment(*args, **kwargs)
+ app[app_key] = env
+ if context_processors:
+ app[APP_CONTEXT_PROCESSORS_KEY] = context_processors
+ app.middlewares.append(context_processors_middleware)
+
+ def url(__aiohttp_jinja2_route_name, **kwargs):
+ return app.router[__aiohttp_jinja2_route_name].url(**kwargs)
+
+ env.globals['url'] = url
+ env.globals['app'] = app
+
+ return env
+
+
+def get_env(app, *, app_key=APP_KEY):
+ return app.get(app_key)
+
+
+def render_string(template_name, request, context, *, app_key=APP_KEY):
+ env = request.app.get(app_key)
+ if env is None:
+ text = ("Template engine is not initialized, "
+ "call aiohttp_jinja2.setup(..., app_key={}) first"
+ "".format(app_key))
+ # in order to see meaningful exception message both: on console
+ # output and rendered page we add same message to *reason* and
+ # *text* arguments.
+ raise web.HTTPInternalServerError(reason=text, text=text)
+ try:
+ template = env.get_template(template_name)
+ except jinja2.TemplateNotFound as e:
+ raise web.HTTPInternalServerError(
+ text="Template '{}' not found".format(template_name)) from e
+ if not isinstance(context, Mapping):
+ text = "context should be mapping, not {}".format(type(context))
+ # same reason as above
+ raise web.HTTPInternalServerError(reason=text, text=text)
+ if REQUEST_CONTEXT_KEY in request:
... 1794 lines suppressed ...
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/aiohttp-jinja2.git
More information about the Python-modules-commits
mailing list