Django 1.4 alpha release

На днях писал о кастомных фильтрах в админке: http://readability-counts.blogspot.com/2011/12/django-admin-listfilter.html. Все оказалось не совсем так - я смотрел trunk репозитория. И вот вышла Django 1.4 alpha с новой фичей, описанной в моем предыдущем посте. Там еще много всего интересного - изучайте!

Django Admin и кастомный фильтр для list_filter

Это только набросок - нужно все опробовать на живом коде.

"Вдруг" родилась задача выводить кастомный список значений для фильтра в админке. Поясню, имеем следующую модель:

class NewsPost(models.Model):
    """Новость"""

    authors = models.ManyToManyField(User, blank = True, null = True)

В админке она представлена так:

class NewsPostAdmin(admin.ModelAdmin):
    """Представление Новости в админке"""

    # фильтрация новостей по автору
    list_filter = ('authors',)

    def formfield_for_manytomany(self, db_field, request, **kwargs):
        """Специальная фильтрация для списка допустимых авторов

        Данная фильтрация распространяется только на поле authors в
        форме редактирования новости в админке
        """

        if db_field.name == 'authors':
            kwargs['queryset'] = User.objects.filter(is_staff=True)
        return super(PostAdmin, self).formfield_for_manytomany(
            db_field, request, **kwargs)

В итоге в форме редактирования новости в админке в качестве автора можно будет указать только пользователя со статусом Персонал (Staff), но для фильтра списка новостей будут выведены все пользователи системы.

Из документации по админке Django сказано, что в list_filter можно указывать только название поля:

Set list_filter to activate filters in the right sidebar of the change list page of the admin. This should be a list of field names, and each specified field should be either a BooleanField, CharField, DateField, DateTimeField, IntegerField or ForeignKey.
Fields in list_filter can also span relations using the __ lookup:

Но если посмотреть код в django.contrib.admin.views.main.ChangeList, метод get_filters() то увидим следующее:

...
filter_specs = []
if self.list_filter:
    for list_filter in self.list_filter:
        if callable(list_filter):
            # This is simply a custom list filter class.
            spec = list_filter(request, lookup_params,
                self.model, self.model_admin)
        else:
            ...

Оказывается в list_filter можно указать "какой-то" класс, экземпляр, которого будет создан для фильтрации. Классы эти можно увидеть вот тут:  django.contrib.admin.filters.

To be continued...

Скрипт-лоттерея

Для чего его использовать - ваша воля. Мы же его использовали для распределения смен технической поддержки на НГ.

# coding: utf-8
import random
import readline


def get_random_workers():
    """Start lottery"""

    # Список людей
    people = []

    # Заполним список участников
    while 1 == 1:
        name = raw_input("Введите имя сотрудника (пустая строка для завершения): ")
        name = name.strip()
        if name == '':
            break
        people.append(name)

    # проверим, что участники введены
    if not people:
        print("Нет участников для нашей лоттереи :( жаль.")
        sys.exit()

    # Случайный выбор из списка
    print("\nА сейчас... победители!")
    print("Нажмите Enter для получения следующего \"счастливчика\" или q для завершения")
    while 1 == 1:
        s = raw_input()
        if s == 'q':
            break
        random.seed()
        print(random.choice(people))

    # конец
    print("\nДо встречи перед следующими праздниками!")

if __name__ == '__main__':
    get_random_workers()

Баги:

1. raw_input() отказывается читать кирилицу, хотя везде все UTF-8. можно переопределить sys.stdin - экземпляр StreamReader.

Утечка памяти в Django

Взято от сюда: http://stackoverflow.com/questions/1339293/python-memory-leak-debugging

Если вы пишите скрипт или management command для обслуживания сайта на Django, то можете наткнуться на то, что у вас "утекает" память. На самом деле это не совсем так - добавляется debug информация и логируются запросы. Чтобы этого избежать, сделайте следующее:

1. выключите DEBUG в настройках;
2. где-то в коде делайте db.reset_queries().

Если это не помогло, тогда да, ищите утечку.

Поиск в Django (Haystack)

В большинстве проектов так или иначе требуется поиск. И тут, на мой взгляд, есть варианта действий:

• написать свой поиск;
• скормить сайт какой-нибудь поисковой системе;
• воспользоваться готовым решением.

Первый вариант я бы отмел сразу - относительно просто до тех пор пока трафик на вашем ресурсе не пойдет вверх, тогда вам придется думать о хешировании, кешировании и прочих прелестях.

Скормить сайт поисковику, на мой взгляд, самый правильный вариант, но что делать если вы пишите внутреннее приложение без доступа извне?

Немного погуглив на эту тему, наткнулся на весьма интересный проект для Django: Haystack. То, что меня сразу "зацепило" а.к.а. возможности из коробки:

• индексирование;
• настраиваемые поисковые формы;
• настраиваемые поисковые представления.

Еще одна вещь мне была поначалу непонятна: настраиваемые шаблоны для поиска. Как оказалось именно в этих шаблонах вся "фишка" haystack. Эти шаблоны никому никогда не показываются, но именно они индексируются.

Итак, давайте поподробнее посмотрим как это работает. Пусть имеется приложение blogs и следующие модели:

class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()

    def __unicode__(self):
        return self.name

class Author(models.Model):
    name = models.CharField(max_length=50)
    email = models.EmailField()

    def __unicode__(self):
        return self.name

class Entry(models.Model):
    blog = models.ForeignKey(Blog)
    headline = models.CharField(max_length=255)
    body_text = models.TextField()
    pub_date = models.DateTimeField()
    mod_date = models.DateTimeField()
    author = models.ForeignKey(Author)
    n_comments = models.IntegerField()
    n_pingbacks = models.IntegerField()
    rating = models.IntegerField()

    def __unicode__(self):
        return self.headline

Искать надо, скажем, записи (Entry), но пусть также находятся записи где поисковый запрос соответствует имени или email'у автора, а также названию или тегу блога. Т.е. поиск должен происходить не только по модели Entry, но и по Blog и Author. Вот тут нам и помогут те самые настраиваемые шаблоны для поиска.

Для этого создаем файл search_indexes.py в папке с приложением следующего содержания:

from haystack.indexes import *
from haystack import site

from blogs import models

class EntryIndex(RealTimeSearchIndex):
    # специальное поле - должно быть только одно в модели
    text = CharField(document=True, use_template=True)
    
    # поля из модели Entry
    headline = CharField(model_attr='headline')
    body_text = TextField(model_attr='body_text')  

    # поля модели Blog
    blog_name = CharField(model_attr='blog__name')
    blog_tagline = CharField(model_attr='blog__tagline')

    # поля модели Author
    author_name = CharField(model_attr='author__name')
    author_email = CharField(model_attr='author__email')

site.register(models.Entry, EntryIndex)

Теперь необходимо создать сам шаблон

Upd: Ajax отправка формы с файлом на jQuery

Вчерашний пост по поводу отправки формы с файлом через AJAX не завелся с IE. Беглый взгляд в консоль разработчика показал, что IE отправляет форму не через POST, а через GET. Не долго думая решил попробовать 2ю версию работы с jQuery Form.

Итак, форма:

<form id="ajax_form" method="post" action="/path/to/form/processing/" enctype="multipart/form-data">
<input type="text" name="some_text" />
<input type="file" name="some_file" />
<input type="submit" value="Post" />
</form>

Форма как форма. Отправка будет происходить, как с обычной формой, по нажатию на кнопку Post, которая теперь обычный submit. Для того, чтобы обернуть ее в iframe, надо в $(document).ready() инициализировать ajaxForm:

$(document).ready(function(){
    
    $('#ajax_form').ajaxForm({
        success: function(data) {
            alert(data);
        }
    });
});

Программно отправить форму можно так: $('#ajax_form').submit().

Проблема решена, но осталось 2 вопроса из-за чего не работает первый вариант в IE:

1. неправильно работает плагин?
2. проблемы с IE и какие? (в других браузерах все на ура)

Если глючит код плагина - невелика беда. Если же дело в IE, то может быть кто-нибудь уже с этим сталкивался и осознал в чем тут дело?

Ajax отправка формы с файлом на jQuery

Не все так хорошо, как казалось - данный код не работает в IE! К сожалению, своего IE у меня нет - обычно "отбираю" ноут у кого-нибудь из родственников, но я таки переписал код по-другому (и не раз), и форма заработала. Новый пост тут.

Ни для кого не секрет, что через AJAX (XMLHttpRequest) нельзя отправить форму с файлом... в том смысле в каком все привыкли это делать обычным POST'ом. Весьма распространенный ход в этом случае - создать iframe, в нем форму, и отправить ее.

Безусловно это не так сложно, как кажется на первый взгляд, однако, зачем изобретать велосипед? Погуглив вчера нашел весьма удобный в обращении плагин jQuery Form.

Допустим, вы создаете динамически (в оверлее) форму следующего содержания:

<form id="ajax_form" enctype="multipart/form-data" onsubmit="return false;">
<input type="text" name="some_text" /><br />
<input type="file" name="some_file" /><br />
<button onclick="ajaxPostForm()">Post</button>
</form>

и хотите, чтобы по нажатию на Post форма отправлялась через AJAX. Используя jQuery Form это можно сделать несколькими способами, я покажу наиболее близкий к $.post():

function ajaxPostForm() {
    // получим форму
    var form = $('#ajax_form');
    // обернем ее в IFrame - поступаем как при использовании практически любого jQuery плагина
    form.ajaxForm();
    // отправим форму - большинство параметров как у $.ajax()
    form.ajaxSubmit({
        url: '/path/to/form/processing/',
        success: function(data) {
            alert(data);
        }
    });
}

И some_text и some_file ушли на сервер. Ура!