Знаю, знаю, я уже два раза писал, что сделал эту библиотеку. Этот раз, надеюсь, последний :-)

На этот раз я решил сделать порт максимально приближенным к PHP версии: та же структура кода, те же имена переменных, те же форматы данных. Т.к. PHP версия забирает данные с сервера в том виде, как их сериализует PHP, то пришлось заюзать вот эту штуку для распаковки данных.

Итак, в абстрактном python-проекте (про джанго позже) библиотеку надо использовать следующим макаром:

sape = SapeClient(host='домен вашего сайта',
    request_uri='адрес запрашиваемой страницы (без домена)',
    user='ваш sape.ru идентификатор',
    db_file='путь к файлу, куда будет кешироваться информация')
links = sape.return links()

return_links — вернёт HTML, в котором будут все sape.ru ссылки для заданной страницы. Поддерживается также и выборка по кусочкам:

sape = SapeClient(...)
links = sape.return_links(3)
links = sape.return_links(2)
links = sape.return_links()

Только не забудьте в последний вызов return_links указать нулевой параметр, чтобы вернулись все оставшиеся ссылки.

Ещё у return_links есть параметр join. По умолчанию он False. Это значит, что возвращаемый HTML будет в виде ссылок, заключённых в LI тэги. Если передать join=True, то ссылки не будут помещаться в LI тэги и будут разделяться запятой или тем разделителем, который вы указали в свойствах проекта в веб-интерфейсе на sape.ru

А теперь самое вкусное. Библиотека предоставляет темплейт тэги для django сайтов. Главных тэга два: {% sape_links %} и {% sape_links_list %}, которые вызывают return_links соотвественно с join=True и join=False. Эти тэги принимают необязательный числовой параметр, которым можно регулировать количество ссылок — я писал про это выше.

Есть ещё один тэг: {% sape_debug %} — он выводит всяческую информацию. по которой можно попытаться понять, работает ли что-то вообще. Пример выводимой информации:

User: XXXXXXXXXXXXXXXXXXXXXXXXXXXX, host: it-omsk.com, error: , pages in cache: 343, uris in cache: 793, cache time: 2008-10-12 20:52:38, cache updated: False

cache updated означает, обновился ли кэш-файл во время вызова данной страницы, остальное и так, думаю, понятно.

Когда я делал эти темлейт тэги я столкнулся с одной неприятностью. Когда нужно выводить все ссылки за раз, то всё легко: конструируем объект SapeClient и выдаём ссылки. Но когда мы хотим разбить вывод ссылок на несколько мест, то ситуация осложняется тем, что мы должны запоминать где-то созданный объект (SapeClient), иначе ссылки будут выводиться каждый раз “с начала”. Я решил при каждом вызове тэга проверять существование объекта, который я храню в контексте шаблона, и если такого объекта нет, то создавать его. Реализацию этого безобразия можно поглядеть здесь.

Напоследок напишу, как устанавливать библиотеку в django-проект.

• скачиваем исходный код, кладём куда надо
• в INSTALLED_APPS добавляем “sape”
• в settings.py добавляем две настройки SAPE_USER и SAPE_DB_FILE. Что это такое я писал выше в примере констрирования SapeClient объекта. Не забудьте настроить права для доступа к файлу SAPE_DB_FILE.
• можно ещё SAPE_VERBOSE = True в настройки добавить. Тогда в случае какой-либо ошибки она отобразится в шаблонах (по умолчанию ошибки ”замалчиваются”)
• в нужном шаблоне написать {% load sape_extras %} и дале воспользоваться тэгами, описанными выше.

Код библиотеки доступен здесь: http://bitbucket.org/lorien/sape/

О багах пишите, пожалуйста, в комментарии или на мыло: lizendir@gmail.com