Skip to content

Commit 965704d

Browse files
committed
Updating sections and change log.
2 parents 7d90c8d + 1ca4aa1 commit 965704d

File tree

4 files changed

+50
-19
lines changed

4 files changed

+50
-19
lines changed

feeds/all.atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2013-06-23T11:07:11Z</updated></feed>
2+
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2013-06-23T11:08:06Z</updated></feed>

index.html

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -347,17 +347,17 @@ <h1>Web Framework</h1>
347347
common operations include:</p>
348348
<ol class="arabic simple">
349349
<li>URL routing</li>
350-
<li>HTML, XML, JSON, and other output templating</li>
350+
<li>HTML, XML, JSON, and other output format templating</li>
351351
<li>Database manipulation</li>
352-
<li>Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection</li>
352+
<li>Security against Cross-site request forgery (CSRF) and other attacks</li>
353353
</ol>
354354
<p>Not all web frameworks include functionality for all of the above
355-
functionality. Frameworks must balance between &quot;being all things to all
356-
people but very complicated&quot; or doing only certain things well without
357-
prescription for how to do other functions.</p>
355+
functionality. Frameworks fall somewhere between simply executing a
356+
single use case and attempting to be everything to every developer with
357+
increased complexity.</p>
358358
<p>For example, the Django web application framework includes an
359359
Object-Relational Mapping (ORM) layer that abstracts relational database
360-
read, write, query, and delete operations. However, the ORM layer in Django
360+
read, write, query, and delete operations. However, Django's ORM
361361
does not work (without modification) on non-relational databases such
362362
<a class="reference external" href="http://www.mongodb.org/">MongoDB</a> and <a class="reference external" href="http://docs.basho.com/">Riak</a>.
363363
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -376,6 +376,16 @@ <h2>Web Framework Monitoring</h2>
376376
<li>Warning</li>
377377
<li>Error</li>
378378
</ol>
379+
<p>Logging errors that occur while a web framework is running is crucial to
380+
understanding how your application is performing.
381+
<a class="reference external" href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
382+
<a class="reference external" href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
383+
aggregation application. Raven provides the way to send exceptions to
384+
Sentry, which should be deployed on a separate server from your production
385+
infrastructure. Raven can also be used by Python scripts to send other
386+
log data to Sentry for aggregation. Sentry provides a clean web application
387+
interface for viewing the exceptions. Sentry can also be configured with a
388+
mail plugin to send emails when exceptions occur.</p>
379389
</div>
380390
<div class="section" id="web-framework-resources">
381391
<h2>Web Framework Resources</h2>

pages/web-framework.html

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -53,17 +53,17 @@ <h1>Web Framework</h1>
5353
common operations include:</p>
5454
<ol class="arabic simple">
5555
<li>URL routing</li>
56-
<li>HTML, XML, JSON, and other output templating</li>
56+
<li>HTML, XML, JSON, and other output format templating</li>
5757
<li>Database manipulation</li>
58-
<li>Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection</li>
58+
<li>Security against Cross-site request forgery (CSRF) and other attacks</li>
5959
</ol>
6060
<p>Not all web frameworks include functionality for all of the above
61-
functionality. Frameworks must balance between &quot;being all things to all
62-
people but very complicated&quot; or doing only certain things well without
63-
prescription for how to do other functions.</p>
61+
functionality. Frameworks fall somewhere between simply executing a
62+
single use case and attempting to be everything to every developer with
63+
increased complexity.</p>
6464
<p>For example, the Django web application framework includes an
6565
Object-Relational Mapping (ORM) layer that abstracts relational database
66-
read, write, query, and delete operations. However, the ORM layer in Django
66+
read, write, query, and delete operations. However, Django's ORM
6767
does not work (without modification) on non-relational databases such
6868
<a class="reference external" href="http://www.mongodb.org/">MongoDB</a> and <a class="reference external" href="http://docs.basho.com/">Riak</a>.
6969
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -82,6 +82,16 @@ <h2>Web Framework Monitoring</h2>
8282
<li>Warning</li>
8383
<li>Error</li>
8484
</ol>
85+
<p>Logging errors that occur while a web framework is running is crucial to
86+
understanding how your application is performing.
87+
<a class="reference external" href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
88+
<a class="reference external" href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
89+
aggregation application. Raven provides the way to send exceptions to
90+
Sentry, which should be deployed on a separate server from your production
91+
infrastructure. Raven can also be used by Python scripts to send other
92+
log data to Sentry for aggregation. Sentry provides a clean web application
93+
interface for viewing the exceptions. Sentry can also be configured with a
94+
mail plugin to send emails when exceptions occur.</p>
8595
</div>
8696
<div class="section" id="web-framework-resources">
8797
<h2>Web Framework Resources</h2>

source/content/pages/web-framework.rst

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,18 @@ provide functionality to accomplish common operations for the web. These
1010
common operations include:
1111

1212
1. URL routing
13-
2. HTML, XML, JSON, and other output templating
13+
2. HTML, XML, JSON, and other output format templating
1414
3. Database manipulation
15-
4. Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection
15+
4. Security against Cross-site request forgery (CSRF) and other attacks
1616

1717
Not all web frameworks include functionality for all of the above
18-
functionality. Frameworks must balance between "being all things to all
19-
people but very complicated" or doing only certain things well without
20-
prescription for how to do other functions.
18+
functionality. Frameworks fall somewhere between simply executing a
19+
single use case and attempting to be everything to every developer with
20+
increased complexity.
2121

2222
For example, the Django web application framework includes an
2323
Object-Relational Mapping (ORM) layer that abstracts relational database
24-
read, write, query, and delete operations. However, the ORM layer in Django
24+
read, write, query, and delete operations. However, Django's ORM
2525
does not work (without modification) on non-relational databases such
2626
`MongoDB <http://www.mongodb.org/>`_ and `Riak <http://docs.basho.com/>`_.
2727
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -43,6 +43,17 @@ Logging is often grouped into several categories:
4343
3. Warning
4444
4. Error
4545

46+
Logging errors that occur while a web framework is running is crucial to
47+
understanding how your application is performing.
48+
`Raven <http://raven.readthedocs.org/en/latest/>`_ is a Python client for the
49+
`Sentry <https://github.com/getsentry/sentry>`_ exception logging and
50+
aggregation application. Raven provides the way to send exceptions to
51+
Sentry, which should be deployed on a separate server from your production
52+
infrastructure. Raven can also be used by Python scripts to send other
53+
log data to Sentry for aggregation. Sentry provides a clean web application
54+
interface for viewing the exceptions. Sentry can also be configured with a
55+
mail plugin to send emails when exceptions occur.
56+
4657

4758
Web Framework Resources
4859
-----------------------

0 commit comments

Comments
 (0)