LXF108:Django

Материал из Linuxformat.

(Различия между версиями)

Перейти к: навигация, поиск

Версия 08:02, 20 июля 2011

Cycle Шаблон:/ Django == == The final touches

PART 4 Lessons Django comes to an end, there comes a time for exams - if not for you, for applications for sure. Nikita Shultays (http://shultais.ru) will deal with testing and go over other features of this framework.

Newsline is ready - but whether it will meet expectations users? The answer to this question can be tested, the best - in the real world, but some basic things you can check at the stage of development thesis writers. If you time to look at the tutorial Rails, you already know about the methodology of TDD. However, we'll go the other way, and will test application not to write, and after.

The point is - a serious and complex, as we need to consider interaction with the database, a compilation of templates, processes and GET- POST-requests and other system components: a failure in any of They can cause disrupt the entire site. Go to this problem can be approached from two sides:

Testing in your browser. We are talking about programs Twill (http://twill.idyll.org) and Selenium (http://selenium.openqa.org): they "remember" the sequence of your actions for each page, and then reproduce it on demand. For example, you can type in form fields obviously incorrect data, get the expected error and repeat the test whenever a major change in the code of your application.
Testing on the server. And then Django does not leave us to fend for themselves, offering just two options: doctest (tested via documentation) and unittest (unit testing), plus a special client to send a GET-and POST-requests.

If you've been programming in Python, then you probably will be closer doctest, and migrants from the Java world have more in taste unittest. There are no restrictions on their use is imposed: you can choose one system or use both at once. We also discuss the doctest.

Document it!

Line documentation in Python - it is plain text that you place after the definition of a function or class directly in the source code. It also provides content for the attribute __doc__. As Typically, it is placed in triple quotes ("""), that allows you to enter complex structures with line breaks, indentation, the same quotes and ... tests. That's what we use.

Tests can be found in the model files (models.py) - to check the latest - and in special files tests.py, located in the application directory. For example, create a news / tests.py to the following:

# -*- Coding: utf-8 -*-
 
"" "
>>> From news.models import News
>>> From datetime import datetime
>>> News = News (title = "Title", description = "Description", pub_date = datetime.now (), text = "text")
>>> News.save ()
>>> News = News.objects.get (pk = 1)
>>> Print news.title.encode ('utf-8')
 Title
"" "
</ Source>
In line 1 encoding, but since the third is very
test. Note that each line begins with three characters "more" (>>>), in the interactive mode, Python. Line 10
These characters do not, because it contains the expected output
print from line 9.
 
[[Image: LXF108 85 1.png | thumb | 200px | Fig. 1. Test passed successfully!]]
Before running the test, you need to add in settings.py
line
 TEST_DATABASE_CHARSET = "UTF8"
to file encoding and the database match. Before performing the test, Django will create a special auxiliary databases, so
the user specified in settings.DATABASE_USER, must have
the appropriate authority. To begin testing, type:
 python manage.py test news
after which you will see something that shows
Fig. 1.
 
Messages similar to appear during the creation of tables
when you first install, but now it happens in a test database. In
end shows the number of tests performed, their results and
notified about the destruction of a test material. We checked our
application (news), but, as you know, Django provides a few
own applications and representations (eg, "admin") -
and they also supplied with their tests. To perform them all,
must enter the command:
 python manage.py test
adding previously in the main file the following URL-card
lines:
<source lang="python"> urlpatterns + = patterns ('django.contrib.auth.views',
url (r '^ auth / password_reset /$',' password_reset'),
) </ Source>
Here we include one of the built-in views, designed to recover your password. This is necessary since
testing of the entire project is being accessed at the specified URL,
and if the view is not specified, the test will fail. By the way, you
also can try password_reset in (Fig. 2).
[[Image: LXF108 85 2.png | frame | center | Fig. 2. Forgot your password? This problem Django!]]
 
=== === Network Simulator
The number of tests has already reached six, but in addition to creating and
retrieve objects from the database, we need to test the response to
GET-and POST-requests. As you know, for these purposes there
special client: it emulates the query and returns the variables that are passed to the template for this URL. Add the
tests.py file after line 10 the following code:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS" line start="11">
>>> From django.contrib.auth.models import User
>>> User = User.objects.create_user ('django_guru', 'user@example.com', 'password')
>>> User.save ()
>>> From django.test.client import Client
>>> C = Client ()
>>> C.login (username = 'django_guru', password = "password")
True
>>> Response = c.get ('/ news / 1 /')
>>> Response.status_code
200
>>> Print response.context [0] ['user']. Username
django_guru
>>> Response = c.post ('/ news / 1 /',{' username': "testuser", 'text':»»})
>>> Response.status_code
200
>>> Response = c.post ('/ news / 1 /',{' username': "testuser", 'text': »Comment text»})
>>> Response.status_code
302
>>> From news.models import Comment
>>> Comment = Comment.objects.get (news = news)
>>> Print comment.text
Comment text </ source>
See what is happening here. In lines 11-13 we create
New User (django_guru), and in 14-15 - the test client. In
line 16 django_guru authenticated, and now all of the system
will be performed by [http://www.mycaal.com loan modification] in his name. On line 18 we went to our first news page, passing the client means GET-request.
To check that we have succeeded, we study the server response code
(Line 19) - it should be 200, or test will fail.
Then (lines 21-22), the reading of additional response data, we
verify that the request is made a registered user
django_guru. Now it's time to leave a comment - not in vain
We logged in? Line 23 is generated POST-request (second
argument to post () - dictionary data sent to the server).
Note that the value of the key text is blank, and
hence, the comment is not added, but the server still must return code 200 (line 25). But in line 26 we pass
all necessary data, and because after the comment we
redirected to the news page, the response code should be equal
302 (The requested URL moved). Lines 29-32 verify that
comment was actually added, we compare the text
with an initial value. Whew ... test passed.
 
Real Simple Syndication === ===
What is a news site without the tape? RSS and / or Atom feeds are everywhere - will be
and here, and Django us help you. Open the main file URL-cards and add to the end of the following lines:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from feeds import LatestNews
 
feeds = {
'Latest': LatestNews,
}
urlpatterns + = patterns ('',
(R '^ feeds / (? P <url> .*)/$',' django.contrib.syndication.views.feed ',
{'Feed_dict': feeds}),
)
</ Source>
Next you need to prepare a tape LatestNews, which we import at row 1. Create the root directory of the project feeds the file
__init__.py as follows:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
# -*- Coding: utf-8 -*-
 
from django.contrib.syndication.feeds import Feed
from news.models import News
from django.contrib.syndication.feeds import FeedDoesNotExist
 
class LatestNews (Feed):
title = "Latest news from our site"
description = "Recent developments on the site mysite.com"
link = "http://127.0.0.1:8000/news/"
 
def items (self):
return News.objects.order_by ("-pub_date") [: 5]
 
def item_link (self, obj):
from django.core.urlresolvers import reverse
return 'http://127.0.0.1:8000% s'% reverse ('news.news_detail', kwargs = {"news_id": obj.pk})
</ Source>
[[Image: LXF108 86 1.png | thumb | 250px | Fig. 3. Firefox offers to subscribe to our news website updated - now hold on!]]
Fields title, description and link class LatestNews are required and are responsible for elements of the same name RSS. The method items ()
passes the required objects in the tape, and item_link () is responsible for the link
to the site. Now create a directory of feeds media / templates, and add
in it two files, latest_description.html and latest_title.html: they will
responsible for the news column form. In lates_description.html write:
 <nowiki> {{obj.description}} </ nowiki>
and latest_title.html:
 <nowiki> [{{obj.pub_date | date: "dmY"}}] {{obj.title}} </ nowiki>
Obj is a record of the sample, we
return in line 13, file feeds / __init__.py. Having at
http://127.0.0.1:8000/feeds/latest/, we shall offer Firefox
save feed. Members KDE, is likely to prefer
Akregator - with him, too, there is no problem (Fig. 3, 4)
 
=== === Understanding
To make life easier for web-developer, Django has included a large
number of representations to solve standard problems. For example, adding
in the main file URL-mapping the following code:
<source lang="python">
from django.views.generic.list_detail import object_list
from news.models import News
urlpatterns + = patterns ('',
('^ Lastnews / $', object_list, {
'Queryset': News.objects.all (). Order_by ('-pub_date') [: 10]
'Template_name': 'news / last_news.html',
'Template_object_name': 'last_news'})
) </ Source>
as well as replacing the file in news / templates / news / last_news.html
 {% For news in last_news%}
on
 {% For news in last_news_list%}
we will be able to view the latest news at
http://127.0.0.1:8000/lastnews/, causing no idea news.last_news. To make available both options must be found in presenting the line news.last_news
 "Last_news": news,
and replace it with
 "Last_news_list": news,
As you may have guessed, the general idea object_list designed to work with a list of objects. Still there is a submission for
O objects, depending on the date (django.views.generic.date_based .*), which makes it very easy to create backups of records:
* Archive_index - withdrawal of the last object added to the database;
* Archive_ {year, month, week, day, today} - the output of all the objects in a given year, month, week, day or today;
* Object_detail - the output of one object for a particular day.
General ideas are available for creating, updating and
deleting objects. They all work a little faster than by hand, but can solve only the most basic tasks. If the data in your application are selected from several
tables and is accompanied by the calculations, the overall presentation
will not help - then, they are common.
 
=== Add === variables on the fly
In the depths of the global context Django hide processors, the main task - to supply the template variables
and objects. Learn which ones are connected, you can in a tuple
TEMPLATE_CONTEXT_PROCESSORS in your settings.py. For example,
We are now working the following processors:
* Auth - information about the user: the object user, his rights of access and the messages that were sent to him;
* I18n - information about the current language of the site and the client;
* Request - information on request.
Besides them, there is a processor debug, sending in
pattern data of the executed SQL-queries, plus we can
write your own! To do this we create in the root of our
project directory and add the processors in it two files: __init__.py
and context_processors.py. The latter should contain the following code:
<source lang="python">
import settings
def site_settings (request):
return {'SETTINGS': settings} </ source>
To connect the processor, just list it in the tuple
TEMPLATE_CONTEXT_PROCESSORS. We check availability:
add a template news.html following:
 <nowiki> {{SETTINGS.TIME_ZONE}} </ nowiki>
Of course, TIME_ZONE can be replaced by any other variable that is defined in settings.py.
 
=== === Sam himself filter
With filters we met in [[LXF105: Django | LXF105]], but often there are situations when supplied with Django options are not enough. To write your own filter, create a radically
project directory templatetags / and add the files __init__.py
and filters.py. In filters.py write:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django import template
 
register = template.Library ()
 
@ Register.filter
def exp (value, arg):
if value.isdigit () and arg.isdigit ():
return int (value) ** int (arg)
else:
return '<span style="color:red"> Error </ span>'
exp.is_safe = True </ source>
We have created a filter exp, which will have a value and an exponent and raises one another, if the arguments are not numbers, an error is generated. In line 5 we register
filter in the system with the help of a decorator. Line 11 indicates
that exp can return HTML-code. Because (for security), it automatically screened (<and> are replaced by &lt; and
&gt; etc.), then, wanting to see pure HTML, we should prohibit
this behavior manually. The next step is loading of
library of filters to the template, which you need to add the
the following line:
 {% Load filters%}
In fact, Django looks for templates created by the library in the application root, so our filter still will not be available. It
not very convenient, especially if we want to use the
the same filter in many applications. The solution - to create a project
single library, and put in applications merely symbolic
references to it.
<source lang="bash"> ln-s / var / www / myproject / templatetags / / var / www / myproject / news / </ source>
Now test the filter by adding any template
line.
 <nowiki> {{"4" | exp: "4"}} </ nowiki>
At compile time, it will be replaced by 256. If we
write
 <nowiki> {{"a" | exp: "4"}} </ nowiki>
we see the word «Error», in red.
By the way, if we did not specify a filter in line 11 exp.is_safe = True, you could simply apply the filter directly into the safe
template:
 <nowiki> {{"a" | exp: "4" | safe}} </ nowiki>
After registering a filter in the system, information about it becomes available at http://127.0.0.1:8000/admin/doc/filters/
(Fig. 4)
[[Image: LXF108 87 1.png | frame | center | Fig. 4. The system politely tells you how to use the filter you created.]]
 
=== === The components of
If we have to perform any action before or after
as would be caused by representation, or if an error occurs, you can create your own components (middleware), or use
supplied with Django. We've already done this, when studied caching ([[LXF107: Django | LXF107]]). I recall that in the settings.py file is a tuple
MIDDLEWARE_CLASSES, which lists the components involved in the project. We are:
* Django.middleware.common.CommonMiddleware solve common problems: normalizes the URL (adds a www and the trailing /), prohibits access to the site specific robot interacts with Etag.
* Django.contrib.sessions.middleware.SessionMiddleware this session.
* Django.contrib.auth.middleware.AuthenticationMiddleware And this - authorization.
* Django.middleware.doc.XViewMiddleware used for automatic documentation Django.
* Django.middleware.locale.LocaleMiddleware Internationalization.
In addition to the above, the following are available in Django
components (django.middleware .*):
* Gzip.GZipMiddleware compression sends the page to save bandwidth.
* Http.ConditionalGetMiddleware Support for conditional GET-requests to work with the Last-Modified and Etag.
* Http.SetRemoteAddrFromForwardedFor reverse proxying.
* Cache.CacheMiddleware The same cache, which we encountered in the previous lesson.
* Transaction.TransactionMiddleware component for inclusion in SQL-queries of transaction structures: COMMIT, ROLLBACK.
Note that not all databases support transactions.
 
And finally, django.contrib.csrf.middleware.CsrfMiddleware, protecting against CSRF-attacks.
 
It has become a tradition, consider how to write your
own components. From a programmer's standpoint, it's just
Class Python, having a number of methods called Django at some point in time. The first is the constructor
__init__ (self), registering the components in the system. Next are the methods of determining the order of the code:
* Process_request () - runs after the request, but before Django will look for the requested address in the URL-maps;
* Process_view () - work out when the concrete representation is defined, but not yet started;
* Process_response () - runs after the presentation.
Used to compress the generated HTML.
process_exception () - called when something goes wrong or
were instituted an unhandled exception.
 
That is, in essence, that's all. But no - look at the sidebar and
away, away, away, read the documentation or the free
a book about Django - Django Book (http://www.djangobook.com); if you
prefer Russian, I advise you to look at http://cargo.caml.ru/djangobook. Finally, apply the acquired knowledge into practice - and let us know if you have something really worthwhile!
 
{{Box | center |
| Title =, etc., etc., other ...
| Table of Contents = Over four lessons, we had to consider almost all possible
Django, but something is left out ...
*, E-mail
Django offers a high-level API to send a message to
one action:
<source lang="python"> from django.core.mail import send_mail
send_mail ('Subject', 'message.', 'from@example.com', ['to@example.com'], fail_silently = False) </ source>
In addition, there is a function of mass communications, alerts, site administrators and managers, as well as working with
different content (HTML, text, graphics, etc.)
*; CSV and PDF
Django makes it easy to create data files, Comma Separated Values ​​(CSV), as well as PDF-documents using
Library ReportLab (http://www.reportlab.org/rl_toolkit.html).
*, Paged
When the number of objects is so large that one page is enough, have the support of a special class
Paginator, who helps organize paged:
<source lang="python">>>> from django.core.paginator import Paginator
>>> Objects = ['django', 'python', 'mysql', 'apache']
>>> P = Paginator (objects, 2)
>>> Page1 = p.page (1)
>>> Page1.object_list
['Django', 'python'] </ source>
Since most of our objects are stored in the database,
Django also offers class QuerySetPaginator, which takes no list, and many objects from the database.
*; Sitemaps
Want to have your site properly indexed by search
machines? You need to create his map! Django will help
here, and the function django.contrib.sitemaps.ping_google «cause»
Google to update the index for your website.
; * Managing multiple sites
One of the problems with which copes Django, is
control of several similar sites on the subject of a
installation. The project was originally designed as a platform for news portals, news, and one could appear
on multiple resources.
*; To help designers
Load the module templates to help designers:
 {% Load webdesign%}
you get at your disposal tag {% lorem%}, with
which you can display certain Latin phrase «lorem
ipsum ... »to fill the template" fish. "
; * And more
Django has a lot of other "goodies" that are very
well described in the accompanying documentation in English
language.
| Width =}}

Получено с http://wiki2.linuxformat.ru/index.php/LXF108:Django

LXF108:Django

Материал из Linuxformat.

Версия 08:02, 20 июля 2011

Document it!

Просмотры

Личные инструменты

Навигация

Поиск

Инструменты

@@ Строка 1: / Строка 1: @@
-{{Цикл/Django}}
+Cycle {{/ Django}}
-== Финальные штрихи ==
+== == The final touches
-: ''ЧАСТЬ 4 Уроки Django подходят к концу, наступает пора экзаменов – если не для вас, то для приложений уж точно. '''Никита Шультайс''' (http://shultais.ru) разберется с тестированием и пробежится по другим возможностям этого каркаса.''
+:''PART 4 Lessons Django comes to an end, there comes a time for exams - if not for you, for applications for sure. '''Nikita Shultays''' (http://shultais.ru) will deal with testing and go over other features of this framework.''
-Новостная лента готова – но оправдает ли она ожидания
+Newsline is ready - but whether it will meet expectations
-пользователей? Ответ на этот вопрос может дать тестирование, лучше всего – в реальных условиях; но какие-то
+users? The answer to this question can be tested, the best - in the real world, but some
-основные вещи можно проверить еще на этапе разработки [http://www.thesiswritingservice.com/ thesis writers]. Если вы
+basic things you can check at the stage of development [http://www.thesiswritingservice.com/ thesis writers]. If you
-успели заглянуть в учебник [[LXF108:Rails|Rails]], то уже знаете о методологии TDD. Мы, однако, пойдем другим путем, и будем тестировать
+time to look at the tutorial [[LXF108: Rails | Rails]], you already know about the methodology of TDD. However, we'll go the other way, and will test
-приложение не до написания, а после.
+application not to write, and after.
-Дело это – серьезное и сложное, так как нам нужно учитывать
+The point is - a serious and complex, as we need to consider
-взаимодействие с БД, компиляцию шаблонов, обработку GET- и
+interaction with the database, a compilation of templates, processes and GET-
-POST-запросов и прочие компоненты системы: сбой в любом из
+POST-requests and other system components: a failure in any of
-них может вызвать нарушить работу всего сайта. К данной задаче
+They can cause disrupt the entire site. Go to this problem
-можно подойти с двух сторон:
+can be approached from two sides:
-* Тестирование в браузере. Речь идет о программах Twill (http://twill.idyll.org) и Selenium (http://selenium.openqa.org): они «запоминают» последовательность ваших действий для каждой страницы, а затем воспроизводят ее по запросу. Например, можно ввести в поля формы заведомо неверные данные, получить ожидаемую ошибку и повторять этот тест при каждом серьезном изменении в коде вашего приложения.
+* Testing in your browser. We are talking about programs Twill (http://twill.idyll.org) and Selenium (http://selenium.openqa.org): they "remember" the sequence of your actions for each page, and then reproduce it on demand. For example, you can type in form fields obviously incorrect data, get the expected error and repeat the test whenever a major change in the code of your application.
-* Тестирование на сервере. И тут Django не оставляет нас на произвол судьбы, предлагая сразу два варианта: doctest (тестирование через документацию) и unittest (модульное тестирование), плюс специальный клиент для отправки GET- и POST-запросов.
+* Testing on the server. And then Django does not leave us to fend for themselves, offering just two options: doctest (tested via documentation) and unittest (unit testing), plus a special client to send a GET-and POST-requests.
-Если вы давно программируете на Python, то вам, наверное,
+If you've been programming in Python, then you probably
-будет ближе doctest, а мигрантам из мира Java скорее придется по
+will be closer doctest, and migrants from the Java world have more in
-вкусу unittest. Никаких ограничений на их использование не накладывается: вы можете выбрать одну систему или применять обе сразу. Мы же остановимся на doctest.
+taste unittest. There are no restrictions on their use is imposed: you can choose one system or use both at once. We also discuss the doctest.
-=== Документируй это! ===
+=== Document it! ===
-Строка документации в Python – это обычный текст, размещаемый
+Line documentation in Python - it is plain text that you place
-после определения функции или класса непосредственно в исходном
+after the definition of a function or class directly in the source
-коде. Она же предоставляет содержимое для атрибута __doc__. Как
+code. It also provides content for the attribute __doc__. As
-правило, ее помещают в тройные кавычки ("""), что позволяет вводить
+Typically, it is placed in triple quotes ("""), that allows you to enter
-сложные конструкции с переносами строк, отступами, теми же кавычками и... тестами. Этим мы и воспользуемся.
+complex structures with line breaks, indentation, the same quotes and ... tests. That's what we use.
-Тесты могут находится в файлах моделей (models.py) – для проверки последних – и в специальных файлах tests.py, расположенных
+Tests can be found in the model files (models.py) - to check the latest - and in special files tests.py, located
-в директории приложения. К примеру, создайте файл news/tests.py
+in the application directory. For example, create a news / tests.py
-такого содержания:
+to the following:
 <source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
-# -*- coding: utf-8 -*-
+# -*- Coding: utf-8 -*-
-"""
+"" "
->>> from news.models import News
+>>> From news.models import News
->>> from datetime import datetime
+>>> From datetime import datetime
->>> news = News(title="Заголовок",description="Описание",pub_date=datetime.now(), text="Текст")
+>>> News = News (title = "Title", description = "Description", pub_date = datetime.now (), text = "text")
->>> news.save()
+>>> News.save ()
->>> news = News.objects.get(pk=1)
+>>> News = News.objects.get (pk = 1)
->>> print news.title.encode('utf-8')
+>>> Print news.title.encode ('utf-8')
- Заголовок
+ Title
-"""
+"" "
-</source>
+</ Source>
-В строке 1 задается кодировка, а начиная с третьей идет сам
+In line 1 encoding, but since the third is very
-тест. Заметьте, что каждая строка начинается с трех знаков «больше» (>>>), как в интерактивном режиме работы Python. В строке 10
+test. Note that each line begins with three characters "more" (>>>), in the interactive mode, Python. Line 10
-этих знаков нет, так как она содержит ожидаемый вывод команды
+These characters do not, because it contains the expected output
-print со строки 9.
+print from line 9.
-[[Изображение:LXF108 85 1.png|thumb|200px|Рис. 1. Тест пройден удачно!]]
+[[Image: LXF108 85 1.png | thumb | 200px | Fig. 1. Test passed successfully!]]
-Перед тем, как запустить тест, в settings.py нужно добавить
+Before running the test, you need to add in settings.py
-строку
+line
- TEST_DATABASE_CHARSET="UTF8"
+ TEST_DATABASE_CHARSET = "UTF8"
-чтобы кодировки файла и базы данных совпадали. Перед выполнением теста Django создаст специальную вспомогательную БД, поэтому
+to file encoding and the database match. Before performing the test, Django will create a special auxiliary databases, so
-пользователь, указанный в settings.DATABASE_USER, должен иметь
+the user specified in settings.DATABASE_USER, must have
-соответствующие права. Для начала тестирования введите команду:
+the appropriate authority. To begin testing, type:
- python manage.py test news
+ python manage.py test news
-после выполнения которой вы увидите примерно то, что показано
+after which you will see something that shows
-на рис. 1.
+Fig. 1.
-Сообщения похожи на появляющиеся во время создания таблиц
+Messages similar to appear during the creation of tables
-при первой установке, но теперь все происходит в тестовой БД. В
+when you first install, but now it happens in a test database. In
-конце отображается число выполненных тестов, их результаты и
+end shows the number of tests performed, their results and
-уведомление об уничтожении тестовой базы. Мы проверяли наше
+notified about the destruction of a test material. We checked our
-приложение (news), но, как вы помните, Django содержит несколько
+application (news), but, as you know, Django provides a few
-собственных приложений и представлений (например, «админку») –
+own applications and representations (eg, "admin") -
-и они тоже снабжаются своими тестами. Чтобы выполнить их все,
+and they also supplied with their tests. To perform them all,
-нужно ввести команду:
+must enter the command:
- python manage.py test
+ python manage.py test
-добавив предварительно в главный файл URL-карт следующие
+adding previously in the main file the following URL-card
-строки:
+lines:
-<source lang="python">urlpatterns += patterns('django.contrib.auth.views',
+<source lang="python"> urlpatterns + = patterns ('django.contrib.auth.views',
-url(r'^auth/password_reset/$','password_reset'),
+url (r '^ auth / password_reset /$',' password_reset'),
-)</source>
+) </ Source>
-Здесь мы подключаем одно из встроенных представлений, предназначенное для восстановления пароля. Это необходимо, так как при
+Here we include one of the built-in views, designed to recover your password. This is necessary since
-тестировании всего проекта происходит обращение по указанному URL,
+testing of the entire project is being accessed at the specified URL,
-и если представление не определено, тест будет провален. Кстати, вы
+and if the view is not specified, the test will fail. By the way, you
-тоже можете попробовать password_reset в работе (рис. 2).
+also can try password_reset in (Fig. 2).
-[[Изображение:LXF108 85 2.png|frame|center|Рис. 2. Забыли пароль? Это проблемы Django!]]
+[[Image: LXF108 85 2.png | frame | center | Fig. 2. Forgot your password? This problem Django!]]
-=== Имитатор Сети ===
+=== === Network Simulator
-Количество тестов уже достигло шести, но помимо создания и
+The number of tests has already reached six, but in addition to creating and
-извлечения объектов из базы, нам нужно проверить реакцию на
+retrieve objects from the database, we need to test the response to
-GET- и POST-запросы. Как вы знаете, для этих целей существует
+GET-and POST-requests. As you know, for these purposes there
-специальный клиент: он эмулирует запрос и возвращает переменные, которые передаются в шаблон для данного URL. Добавьте в
+special client: it emulates the query and returns the variables that are passed to the template for this URL. Add the
-файл tests.py после строки 10 следующий код:
+tests.py file after line 10 the following code:
 <source lang="python" line="GESHI_NORMAL_LINE_NUMBERS" line start="11">
->>> from django.contrib.auth.models import User
+>>> From django.contrib.auth.models import User
->>> user = User.objects.create_user('django_guru', 'user@example.com', 'password')
+>>> User = User.objects.create_user ('django_guru', 'user@example.com', 'password')
->>> user.save()
+>>> User.save ()
->>> from django.test.client import Client
+>>> From django.test.client import Client
->>> c = Client()
+>>> C = Client ()
->>> c.login(username='django_guru',password=“password”)
+>>> C.login (username = 'django_guru', password = "password")
 True
->>> response = c.get('/news/1/')
+>>> Response = c.get ('/ news / 1 /')
->>> response.status_code
+>>> Response.status_code
->>> print response.context[0]['user'].username
+>>> Print response.context [0] ['user']. Username
 django_guru
->>> response = c.post('/news/1/',{'username':“testuser”,'text':»»})
+>>> Response = c.post ('/ news / 1 /',{' username': "testuser", 'text':»»})
->>> response.status_code
+>>> Response.status_code
->>> response = c.post('/news/1/',{'username':“testuser”,'text':»Comment text»})
+>>> Response = c.post ('/ news / 1 /',{' username': "testuser", 'text': »Comment text»})
->>> response.status_code
+>>> Response.status_code
->>> from news.models import Comment
+>>> From news.models import Comment
->>> comment = Comment.objects.get(news=news)
+>>> Comment = Comment.objects.get (news = news)
->>> print comment.text
+>>> Print comment.text
-Comment text</source>
+Comment text </ source>
-Разберемся, что здесь происходит. В строках 11–13 мы создаем
+See what is happening here. In lines 11-13 we create
-нового пользователя (django_guru), а в 14–15 – тестовый клиент. В
+New User (django_guru), and in 14-15 - the test client. In
-строке 16 django_guru авторизуется, и отныне все действия в системе
+line 16 django_guru authenticated, and now all of the system
-будут совершаться от его имени. В строке 18 мы переходим на страницу нашей первой новости, передав средствами клиента GET-запрос.
+will be performed by [http://www.mycaal.com loan modification] in his name. On line 18 we went to our first news page, passing the client means GET-request.
-Для проверки, что нам это удалось, мы изучаем код ответа сервера
+To check that we have succeeded, we study the server response code
-(строка 19) – он должен равняться 200, или тест будет провален.
+(Line 19) - it should be 200, or test will fail.
-Затем (строки 21–22), чтением дополнительных данных ответа, мы
+Then (lines 21-22), the reading of additional response data, we
-убеждаемся, что запрос сделал зарегистрированный пользователь
+verify that the request is made a registered user
-django_guru. Теперь самое время оставить комментарий – не зря же
+django_guru. Now it's time to leave a comment - not in vain
-мы авторизовались? В строке 23 генерируется POST-запрос (второй
+We logged in? Line 23 is generated POST-request (second
-аргумент метода post() – словарь отсылаемых на сервер данных).
+argument to post () - dictionary data sent to the server).
-Обратите внимание, что значение ключа text оставлено пустым, а
+Note that the value of the key text is blank, and
-значит, комментарий не добавится, однако сервер по-прежнему должен возвращать код 200 (строка 25). А вот в строке 26 мы передаем
+hence, the comment is not added, but the server still must return code 200 (line 25). But in line 26 we pass
-все необходимые данные, и так как после создания комментария нас
+all necessary data, and because after the comment we
-перенаправляют на страницу новости, код ответа должен быть равен
+redirected to the news page, the response code should be equal
-(Требуемый URL перемещен). В строках 29–32 проверяется, что
+(The requested URL moved). Lines 29-32 verify that
-комментарий был действительно добавлен: мы сравниваем его текст
+comment was actually added, we compare the text
-с исходным значением. Уфф... тест пройден.
+with an initial value. Whew ... test passed.
-=== Действительно простая синдикация ===
+Real Simple Syndication === ===
-Какой новостной сайт без ленты? RSS и/или Atom есть везде – будут
+What is a news site without the tape? RSS and / or Atom feeds are everywhere - will be
-и у нас, а Django нам в этом поможет. Откройте главный файл URL-карт и добавьте в его конец следующие строки:
+and here, and Django us help you. Open the main file URL-cards and add to the end of the following lines:
 <source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
 from feeds import LatestNews
 feeds = {
-'latest': LatestNews,
+'Latest': LatestNews,
 }
-urlpatterns += patterns('',
+urlpatterns + = patterns ('',
-(r'^feeds/(?P<url>.*)/$', 'django.contrib.syndication.views.feed',
+(R '^ feeds / (? P <url> .*)/$',' django.contrib.syndication.views.feed ',
-{'feed_dict': feeds}),
+{'Feed_dict': feeds}),
 )
-</source>
+</ Source>
-Далее нужно приготовить ленту LatestNews, которую мы импортируем в строке 1. Создайте в корне проекта каталог feeds с файлом
+Next you need to prepare a tape LatestNews, which we import at row 1. Create the root directory of the project feeds the file
-__init__.py следующего содержания:
+__init__.py as follows:
 <source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
-# -*- coding: utf-8 -*-
+# -*- Coding: utf-8 -*-
 from django.contrib.syndication.feeds import Feed
@@ Строка 151: / Строка 151: @@
 from django.contrib.syndication.feeds import FeedDoesNotExist
-class LatestNews(Feed):
+class LatestNews (Feed):
-title = "Последние новости нашего сайта"
+title = "Latest news from our site"
-description = "Последние события на сайте mysite.com"
+description = "Recent developments on the site mysite.com"
 link = "http://127.0.0.1:8000/news/"
-def items(self):
+def items (self):
-return News.objects.order_by("-pub_date")[:5]
+return News.objects.order_by ("-pub_date") [: 5]
-def item_link(self, obj):
+def item_link (self, obj):
 from django.core.urlresolvers import reverse
-return 'http://127.0.0.1:8000%s' % reverse('news.news_detail',kwargs={"news_id":obj.pk})
+return 'http://127.0.0.1:8000% s'% reverse ('news.news_detail', kwargs = {"news_id": obj.pk})
-</source>
+</ Source>
-[[Изображение:LXF108 86 1.png|thumb|250px|Рис. 3. Firefox предлагает подписаться на обновления нашего новостного сайта – теперь держитесь!]]
+[[Image: LXF108 86 1.png | thumb | 250px | Fig. 3. Firefox offers to subscribe to our news website updated - now hold on!]]
-Поля title, description и link класса LatestNews являются обязательными и отвечают за одноименные элементы RSS. Метод items()
+Fields title, description and link class LatestNews are required and are responsible for elements of the same name RSS. The method items ()
-передает в ленту требуемые объекты, а item_link() отвечает за ссылку
+passes the required objects in the tape, and item_link () is responsible for the link
-на сайт. Теперь создайте каталог feeds в media/templates и добавьте
+to the site. Now create a directory of feeds media / templates, and add
-в него два файла, latest_description.html и latest_title.html: они будут
+in it two files, latest_description.html and latest_title.html: they will
-отвечать за вид новостной ленты. В lates_description.html напишите:
+responsible for the news column form. In lates_description.html write:
- <nowiki>{{ obj.description }}</nowiki>
+ <nowiki> {{obj.description}} </ nowiki>
-а в latest_title.html:
+and latest_title.html:
- <nowiki>[{{ obj.pub_date|date:"d.m.Y" }}] {{ obj.title }}</nowiki>
+ <nowiki> [{{obj.pub_date | date: "dmY"}}] {{obj.title}} </ nowiki>
-Объект obj представляет собой запись из выборки, которую мы
+Obj is a record of the sample, we
-возвращаем в строке 13 файла feeds/__init__.py. Пройдя по адресу
+return in line 13, file feeds / __init__.py. Having at
-http://127.0.0.1:8000/feeds/latest/, мы увидим предложение Firefox
+http://127.0.0.1:8000/feeds/latest/, we shall offer Firefox
-сохранить ленту новостей. Пользователи KDE, вероятно, предпочтут
+save feed. Members KDE, is likely to prefer
-Akregator – с ним тоже нет никаких проблем (рис. 3, 4)
+Akregator - with him, too, there is no problem (Fig. 3, 4)
-=== Общие представления ===
+=== === Understanding
-Чтобы облегчить жизнь web-разработчика, Django включил большое
+To make life easier for web-developer, Django has included a large
-число представлений для решения стандартных задач. Так, добавив
+number of representations to solve standard problems. For example, adding
-в главный файл URL-карт следующий код:
+in the main file URL-mapping the following code:
 <source lang="python">
 from django.views.generic.list_detail import object_list
 from news.models import News
-urlpatterns += patterns('',
+urlpatterns + = patterns ('',
-('^lastnews/$', object_list, {
+('^ Lastnews / $', object_list, {
-'queryset': News.objects.all().order_by('-pub_date')[:10],
+'Queryset': News.objects.all (). Order_by ('-pub_date') [: 10]
-'template_name':'news/last_news.html',
+'Template_name': 'news / last_news.html',
-'template_object_name':'last_news'})
+'Template_object_name': 'last_news'})
-)</source>
+) </ Source>
-а также заменив в файле news/templates/news/last_news.html
+as well as replacing the file in news / templates / news / last_news.html
- {% for news in last_news %}
+ {% For news in last_news%}
-на
+on
- {% for news in last_news_list %}
+ {% For news in last_news_list%}
-мы сможем просматривать последние новости по адресу
+we will be able to view the latest news at
-http://127.0.0.1:8000/lastnews/, не вызывая представление news.last_news. Чтобы сделать доступными оба варианта, нужно найти в представлении news.last_news строку
+http://127.0.0.1:8000/lastnews/, causing no idea news.last_news. To make available both options must be found in presenting the line news.last_news
- "last_news":news,
+ "Last_news": news,
-и заменить ее на
+and replace it with
- "last_news_list":news,
+ "Last_news_list": news,
-Как вы уже догадались, общее представление object_list предназначено для работы со списком объектов. Еще есть представления для
+As you may have guessed, the general idea object_list designed to work with a list of objects. Still there is a submission for
-вывода объектов в зависимости от даты (django.views.generic.date_based.*), что позволяет очень просто создавать архивы записей:
+O objects, depending on the date (django.views.generic.date_based .*), which makes it very easy to create backups of records:
-* archive_index – вывод последних объектов, добавленных в базу данных;
+* Archive_index - withdrawal of the last object added to the database;
-* archive_{year,month,week,day,today} – вывод всех объектов за определенный год, месяц, неделю, день или за сегодня;
+* Archive_ {year, month, week, day, today} - the output of all the objects in a given year, month, week, day or today;
-* object_detail – вывод одного объекта за определенный день.
+* Object_detail - the output of one object for a particular day.
-Доступны общие представления для создания, обновления и
+General ideas are available for creating, updating and
-удаления объектов. Все они работают немного быстрее, чем созданные вручную, но позволяют решать лишь самые элементарные задачи. Если данные в вашем приложении выбираются из нескольких
+deleting objects. They all work a little faster than by hand, but can solve only the most basic tasks. If the data in your application are selected from several
-таблиц и это сопровождается расчетами, то общие представления
+tables and is accompanied by the calculations, the overall presentation
-не помогут – на то они и общие.
+will not help - then, they are common.
-=== Добавляем переменные на лету ===
+=== Add === variables on the fly
-В глубинах Django скрываются глобальные контекстные процессоры, основная задача которых – снабжать шаблоны переменными
+In the depths of the global context Django hide processors, the main task - to supply the template variables
-и объектами. Узнать, какие из них подключены, можно в кортеже
+and objects. Learn which ones are connected, you can in a tuple
-TEMPLATE_CONTEXT_PROCESSORS в файле settings.py. Например, у
+TEMPLATE_CONTEXT_PROCESSORS in your settings.py. For example,
-нас сейчас работают следующие процессоры:
+We are now working the following processors:
-* auth – информация о пользователе: объект user, его права доступа и сообщения, которые были ему отправлены;
+* Auth - information about the user: the object user, his rights of access and the messages that were sent to him;
-* i18n – сведения о текущем языке сайта и клиента;
+* I18n - information about the current language of the site and the client;
-* request – данные о запросе.
+* Request - information on request.
-Кроме них, существует еще процессор debug, передающий в
+Besides them, there is a processor debug, sending in
-шаблон данные о выполненных SQL-запросах, плюс мы можем
+pattern data of the executed SQL-queries, plus we can
-написать свой собственный! Для этого создадим в корне нашего
+write your own! To do this we create in the root of our
-проекта каталог processors и добавим в него два файла: __init__.py
+project directory and add the processors in it two files: __init__.py
-и context_processors.py. Последний должен содержать такой код:
+and context_processors.py. The latter should contain the following code:
 <source lang="python">
 import settings
-def site_settings(request):
+def site_settings (request):
-return {'SETTINGS': settings}</source>
+return {'SETTINGS': settings} </ source>
-Чтобы подключить процессор, просто перечислите его в кортеже
+To connect the processor, just list it in the tuple
-TEMPLATE_CONTEXT_PROCESSORS. Проверим работоспособность:
+TEMPLATE_CONTEXT_PROCESSORS. We check availability:
-добавим в шаблон news.html следующее:
+add a template news.html following:
- <nowiki>{{ SETTINGS.TIME_ZONE }}</nowiki>
+ <nowiki> {{SETTINGS.TIME_ZONE}} </ nowiki>
-Конечно, TIME_ZONE можно заменить на любую другую переменную, определенную в settings.py.
+Of course, TIME_ZONE can be replaced by any other variable that is defined in settings.py.
-=== Сам себе фильтр ===
+=== === Sam himself filter
-С фильтрами мы познакомились еще в [[LXF105:Django|LXF105]], однако часто возникают ситуации, когда поставляемых с Django вариантов недостаточно. Чтобы написать свой собственный фильтр, создайте в корне
+With filters we met in [[LXF105: Django | LXF105]], but often there are situations when supplied with Django options are not enough. To write your own filter, create a radically
-проекта каталог templatetags/ и добавьте в него файлы __init__.py
+project directory templatetags / and add the files __init__.py
-и filters.py. В filters.py напишите:
+and filters.py. In filters.py write:
 <source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
 from django import template
-register = template.Library()
+register = template.Library ()
-@register.filter
+@ Register.filter
-def exp(value, arg):
+def exp (value, arg):
-if value.isdigit() and arg.isdigit():
+if value.isdigit () and arg.isdigit ():
-return int(value)**int(arg)
+return int (value) ** int (arg)
 else:
-return '<span style=“color:red”>Error</span>'
+return '<span style="color:red"> Error </ span>'
-exp.is_safe = True</source >
+exp.is_safe = True </ source>
-Мы создали фильтр exp, который получает значение и показатель степени и возводит одно в другое; если аргументы не являются числами, генерируется ошибка. В строке 5 мы регистрируем
+We have created a filter exp, which will have a value and an exponent and raises one another, if the arguments are not numbers, an error is generated. In line 5 we register
-фильтр в системе с помощью декоратора. Строка 11 указывает,
+filter in the system with the help of a decorator. Line 11 indicates
-что exp может возвращать HTML-код. Поскольку (в целях безопасности) он автоматически экранируется (< и > заменяются на &amp;lt; и
+that exp can return HTML-code. Because (for security), it automatically screened (<and> are replaced by &lt; and
-&amp;gt; и т.д.), то, желая видеть чистый HTML, мы должны запретить
+&gt; etc.), then, wanting to see pure HTML, we should prohibit
-такое поведение вручную. Следующим шагом является подгрузка
+this behavior manually. The next step is loading of
-библиотеки фильтров в шаблон, для чего нужно добавить в него
+library of filters to the template, which you need to add the
-следующую строку:
+the following line:
- {% load filters %}
+ {% Load filters%}
-Вообще-то Django ищет созданные библиотеки шаблонов в корне приложения, поэтому наш фильтр пока не будет доступен. Это
+In fact, Django looks for templates created by the library in the application root, so our filter still will not be available. It
-не очень удобно, особенно если мы хотим использовать один и тот
+not very convenient, especially if we want to use the
-же фильтр во многих приложениях. Решение – создать для проекта
+the same filter in many applications. The solution - to create a project
-единую библиотеку, а в приложения помещать лишь символьные
+single library, and put in applications merely symbolic
-ссылки на нее.
+references to it.
-<source lang="bash">ln -s /var/www/myproject/templatetags/ /var/www/myproject/news/</source>
+<source lang="bash"> ln-s / var / www / myproject / templatetags / / var / www / myproject / news / </ source>
-Теперь проверим работу фильтра, добавив в какой-нибудь шаблон
+Now test the filter by adding any template
-строку.
+line.
- <nowiki>{{ "4"|exp:"4" }}</nowiki>
+ <nowiki> {{"4" | exp: "4"}} </ nowiki>
-Во время компиляции она будет заменена на 256. Если же мы
+At compile time, it will be replaced by 256. If we
-напишем
+write
- <nowiki>{{ "a"|exp:"4" }}</nowiki>
+ <nowiki> {{"a" | exp: "4"}} </ nowiki>
-то увидим слово «Error», выделенное красным цветом.
+we see the word «Error», in red.
-Кстати, если бы мы не указали в строке 11 фильтра exp.is_safe= True, можно было бы просто применить фильтр safe прямо в
+By the way, if we did not specify a filter in line 11 exp.is_safe = True, you could simply apply the filter directly into the safe
-шаблоне:
+template:
- <nowiki>{{ "a"|exp:"4"|safe }}</nowiki>
+ <nowiki> {{"a" | exp: "4" | safe}} </ nowiki>
-После регистрации фильтра в системе, информация о нем становится доступной по адресу http://127.0.0.1:8000/admin/doc/filters/
+After registering a filter in the system, information about it becomes available at http://127.0.0.1:8000/admin/doc/filters/
-(рис. 4)
+(Fig. 4)
-[[Изображение:LXF108 87 1.png|frame|center|Рис. 4. Система любезно подскажет, как использовать созданный вами фильтр.]]
+[[Image: LXF108 87 1.png | frame | center | Fig. 4. The system politely tells you how to use the filter you created.]]
-=== Компоненты ===
+=== === The components of
-Если нам надо выполнить какие-либо действия до или после того,
+If we have to perform any action before or after
-как будет вызвано представление, либо в случае ошибки, можно создать свой компонент (middleware) или воспользоваться
+as would be caused by representation, or if an error occurs, you can create your own components (middleware), or use
-поставляемым с Django. Мы уже делали это, когда изучали кэширование ([[LXF107:Django|LXF107]]). Напомню, что в файле settings.py есть кортеж
+supplied with Django. We've already done this, when studied caching ([[LXF107: Django | LXF107]]). I recall that in the settings.py file is a tuple
-MIDDLEWARE_CLASSES, который перечисляет компоненты, задействованные в проекте. У нас это:
+MIDDLEWARE_CLASSES, which lists the components involved in the project. We are:
-* django.middleware.common.CommonMiddleware Решает общие задачи: нормализует URL (добавляет префикс www и завершающий /), запрещает доступ к сайту определенным роботам, взаимодействует с Etag.
+* Django.middleware.common.CommonMiddleware solve common problems: normalizes the URL (adds a www and the trailing /), prohibits access to the site specific robot interacts with Etag.
-* django.contrib.sessions.middleware.SessionMiddleware Это сессии.
+* Django.contrib.sessions.middleware.SessionMiddleware this session.
-* django.contrib.auth.middleware.AuthenticationMiddleware А это – авторизация.
+* Django.contrib.auth.middleware.AuthenticationMiddleware And this - authorization.
-* django.middleware.doc.XViewMiddleware Используется для автоматического документирования Django.
+* Django.middleware.doc.XViewMiddleware used for automatic documentation Django.
-* django.middleware.locale.LocaleMiddleware Интернационализация.
+* Django.middleware.locale.LocaleMiddleware Internationalization.
-Помимо перечисленных выше, в Django доступны следующие
+In addition to the above, the following are available in Django
-компоненты (django.middleware.*):
+components (django.middleware .*):
-* gzip.GZipMiddleware Сжатие отправляемой страницы для экономии трафика.
+* Gzip.GZipMiddleware compression sends the page to save bandwidth.
-* http.ConditionalGetMiddleware Поддержка условных GET-запросов для работы с Last-Modified и Etag.
+* Http.ConditionalGetMiddleware Support for conditional GET-requests to work with the Last-Modified and Etag.
-* http.SetRemoteAddrFromForwardedFor Обратное проксирование.
+* Http.SetRemoteAddrFromForwardedFor reverse proxying.
-* cache.CacheMiddleware Тот самый кэш, с которым мы сталкивались на прошлом уроке.
+* Cache.CacheMiddleware The same cache, which we encountered in the previous lesson.
-* transaction.TransactionMiddleware Компонент для включения в SQL-запросы транзакционных конструкций: COMMIT, ROLLBACK.
+* Transaction.TransactionMiddleware component for inclusion in SQL-queries of transaction structures: COMMIT, ROLLBACK.
-Заметьте, что не все базы данных поддерживают транзакции.
+Note that not all databases support transactions.
-И, наконец, django.contrib.csrf.middleware.CsrfMiddleware, защищающее от CSRF-атак.
+And finally, django.contrib.csrf.middleware.CsrfMiddleware, protecting against CSRF-attacks.
-По сложившейся уже традиции, рассмотрим, как написать свой
+It has become a tradition, consider how to write your
-собственный компонент. С точки зрения программиста, это просто
+own components. From a programmer's standpoint, it's just
-класс Python, имеющий ряд методов, вызываемых Django в определенные моменты времени. Первым из них является конструктор
+Class Python, having a number of methods called Django at some point in time. The first is the constructor
-__init__(self), регистрирующий компонент в системе. Дальше следуют методы, определяющие порядок выполнения кода:
+__init__ (self), registering the components in the system. Next are the methods of determining the order of the code:
-* process_request() – запускается после того, как поступил запрос,но перед тем как Django начнет искать запрашиваемый адрес в URL-картах;
+* Process_request () - runs after the request, but before Django will look for the requested address in the URL-maps;
-* process_view() – отрабатывает, когда конкретное представление уже определено, но еще не запущено;
+* Process_view () - work out when the concrete representation is defined, but not yet started;
-* process_response() – выполняется после представления.
+* Process_response () - runs after the presentation.
-Используется для сжатия сгенерированного HTML.
+Used to compress the generated HTML.
-process_exception() – вызывается, если что-то пошло не так или
+process_exception () - called when something goes wrong or
-было возбуждено необработанное исключение.
+were instituted an unhandled exception.
-Вот, в сущности, и все. Впрочем, нет – взгляните на врезку И
+That is, in essence, that's all. But no - look at the sidebar and
-прочая, прочая, прочая, почитайте документацию или свободную
+away, away, away, read the documentation or the free
-книгу о Django – Django Book (http://www.djangobook.com); если же вам
+a book about Django - Django Book (http://www.djangobook.com); if you
-больше по душе русский, советую заглянуть на http://cargo.caml.ru/djangobook. Наконец, примените полученные знания на практике – и дайте нам знать, если у вас получится что-то действительно стоящее!
+prefer Russian, I advise you to look at http://cargo.caml.ru/djangobook. Finally, apply the acquired knowledge into practice - and let us know if you have something really worthwhile!
-{{Врезка|center|
+{{Box | center |
-|Заголовок=И прочая, прочая, прочая...
+| Title =, etc., etc., other ...
-|Содержание=За четыре урока мы успели рассмотреть почти все возможности
+| Table of Contents = Over four lessons, we had to consider almost all possible
-Django, но кое-что осталось неохваченным...
+Django, but something is left out ...
-*; Электронная почта
+*, E-mail
-Django предлагает высокоуровневый API для отправки письма в
+Django offers a high-level API to send a message to
-одно действие:
+one action:
-<source lang="python">from django.core.mail import send_mail
+<source lang="python"> from django.core.mail import send_mail
-send_mail('Тема', 'сообщение.', 'from@example.com', ['to@example.com'], fail_silently=False)</source>
+send_mail ('Subject', 'message.', 'from@example.com', ['to@example.com'], fail_silently = False) </ source>
-Кроме того, есть функции массовой рассылки сообщений, оповещения администраторов и менеджеров сайта, а также работы с
+In addition, there is a function of mass communications, alerts, site administrators and managers, as well as working with
-различным содержимым (HTML, текст, графика и т.п.)
+different content (HTML, text, graphics, etc.)
-*; CSV и PDF
+*; CSV and PDF
-Django позволяет легко формировать файлы с данными, разделенными запятыми (CSV), а также PDF-документы, используя
+Django makes it easy to create data files, Comma Separated Values (CSV), as well as PDF-documents using
-библиотеку ReportLab (http://www.reportlab.org/rl_toolkit.html).
+Library ReportLab (http://www.reportlab.org/rl_toolkit.html).
-*; Постраничный вывод
+*, Paged
-Когда количество объектов настолько велико, что одной страницы становится мало, на помощь приходит специальный класс
+When the number of objects is so large that one page is enough, have the support of a special class
-Paginator, который помогает организовать постраничный вывод:
+Paginator, who helps organize paged:
 <source lang="python">>>> from django.core.paginator import Paginator
->>> objects = ['django', 'python', 'mysql', 'apache']
+>>> Objects = ['django', 'python', 'mysql', 'apache']
->>> p = Paginator(objects, 2)
+>>> P = Paginator (objects, 2)
->>> page1 = p.page(1)
+>>> Page1 = p.page (1)
->>> page1.object_list
+>>> Page1.object_list
-['django', 'python']</source>
+['Django', 'python'] </ source>
-Поскольку большинство наших объектов хранятся в базе данных,
+Since most of our objects are stored in the database,
-Django также предлагает класс QuerySetPaginator, который принимает не список, а множество объектов из СУБД.
+Django also offers class QuerySetPaginator, which takes no list, and many objects from the database.
-*; Карты сайта
+*; Sitemaps
-Хотите, чтобы ваш сайт правильно индексировался поисковыми
+Want to have your site properly indexed by search
-машинами? Необходимо создать его карту! Django поможет и
+machines? You need to create his map! Django will help
-здесь, а функция django.contrib.sitemaps.ping_google «заставит»
+here, and the function django.contrib.sitemaps.ping_google «cause»
-Google обновить индексы для вашего сайта.
+Google to update the index for your website.
-*; Управление несколькими сайтами
+; * Managing multiple sites
-Одной из задач, с которой успешно справляется Django, является
+One of the problems with which copes Django, is
-управление несколькими схожими по тематике сайтами из одной
+control of several similar sites on the subject of a
-инсталляции. Проект первоначально разрабатывался как платформа для новостных порталов, и одна новость могла появиться
+installation. The project was originally designed as a platform for news portals, news, and one could appear
-сразу на нескольких ресурсах.
+on multiple resources.
-*; В помощь дизайнерам
+*; To help designers
-Подгрузив к шаблонам модуль помощи дизайнерам:
+Load the module templates to help designers:
- {% load webdesign %}
+ {% Load webdesign%}
-вы получите в свое распоряжение тэг {% lorem %}, с помощью
+you get at your disposal tag {% lorem%}, with
-которого можно выводить известную латинскую фразу «lorem
+which you can display certain Latin phrase «lorem
-ipsum ...» для заполнения шаблонов «рыбой».
+ipsum ... »to fill the template" fish. "
-*; И более того
+; * And more
-Django содержит много других «вкусностей», которые очень
+Django has a lot of other "goodies" that are very
-хорошо описаны в прилагающейся документации на английском
+well described in the accompanying documentation in English
-языке.
+language.
-|Ширина=}}
+| Width =}}