ALLDev

Десять правил спокойной разработки

artkil — Sat, 10 Nov 2012 09:10:52 GMT

Введение

Современный темп разработки ПО просто поражает своей скоростью. Функционал всегда «нужен вчера». Зачем? Конкуренция — обойдут, обгонят. Времени тестировать нет, надо отгружать функционал, надо, надо, надо.

На помощь командам разработки приходят практики, методологии, подходы и четкие регламенты. Попробую сформулировать в виде десяти правил концепцию «спокойной» разработки. А она то вынудит использовать современные методологии разработки ПО. И заказчик спокоен, и нервы свои целы. Profit!

Проблема

В фильме «Пираты силиконовой долины» хорошо показаны замученные длительным марафоном разработчики Apple. А код уставшего разработчика часто не приятен даже ему самому на следующий день. Вывод — не писать уставший код. Да и производительность оставляет желать лучшего.

Но требования постоянно меняются, горизонты продукта размыты, заказчик не может внятно объяснить, что хочет. Для таких случаев и придумали Agile. Все родственные методологии позволяют гибко подстраиваться под изменяющиеся требования заказчика и выдерживать должный темп разработки без ущерба здоровью команды.

Перейдем к правилам «спокойной» разработки.

Правила

Срочных задач не бывает, бывают приоритеты
Если задача имеет фатальный приоритет, то о ней надо было думать еще неделю назад. Явная ошибка планирования. Либо был проигнорирован пункт 9 и «хомяк» грозится откусить пол руки;
Приступай к задаче после полного ее понимания
Типичная ошибка в больших системах. Что-то сделал, как-то проверил, получил нечто;
Наладь диалог с заказчиком
В любом проекте приходится искать компромиссы, расставлять приоритеты. Найти общий язык с заказчиком дорогого стоит;
Руководствуйся ТЗ
ТЗ будет идеальным при использовании пункта 3, поэтому проблем быть не должно. А если функционального элемента нет, то и делать его не надо;
Используй только проверенный код
Любой код должен проходить серьезный цикл проверки перед поставкой заказчику. Любые сторонние модули должны быть покрыты тестовым кодом и хорошо проверены. Свой код надо проверять в обязательном порядке, без исключений;
Рабочий день 8 часов
Очень полезный пункт. Порой надо себе об этом напоминать. Семья тоже требует внимания, да и здоровье свое надо беречь. Если не хватает времени, то смотри пункт 1.
Пиши документацию
Без документации нет функционала. К тому же, она экономит уйму времени, потому что достаточно дать ссылку интересующемуся. Если документация не понятна, устарела или имеет двойственную трактовку, то ее надо актуализировать;
Держи код в порядке
Ужасный код должен переписываться, а не врастать в систему. Нет времени? Поставь TODO и исправь в ближайшую свободную минуту;
Заказчик не лабораторный хомячок для экспериментов
Есть такой подход «стрельба трассирующими». Его можно использовать только в молодых и еще мало-функциональных продуктах. Как только продукт переходит в фазу зрелости, заказчик перестает мириться даже с самыми маленькими ошибками. Продукт должен быть идеален. Иначе будет снижаться лояльность, а значит и уровень оплаты работ;
Тестируй
Очень важный пункт. Если функция не имеет теста, то вообще ничего нельзя сказать о ее работоспособности. ПО нестабильно. Яркий пример SQLite. Вот почему эта БД успешно работает в самых разных системах.

Заключение

Берегите здоровье, пишите качественный код, получайте удовольствие от работы. Будьте спокойны! Какие еще на Ваш взгляд правила стоит упомянуть?

Домашний датацентр или как начать не именя за душой ни гроша

artkil — Sat, 25 Sep 2010 21:58:42 GMT

Вы молоды, амбициозны, полны сил и идей, и готовы перевернуть весь Мир! Но как правило, все хорошие начинания всегда заканчивается на самом банальном — нет средств для их реализации. Инвесторы готовы вложить в Ваш проект средства, но им нужно доказать «как Вашу состоятельность, так и состоятельность Вашего проекта». А, имея мешок идей и ничего за плечами — есть большая вероятность, что в «Вас Не Поверят». Как начать, не имея стартового капитала?$CUT$

Концепция проекта

Прежде всего должна быть разработана концепция: Что из себя представляет проект, Основные задачи, Целевая аудитория, Методы монетизации.
Пример моего проекта. Введение связанное с названием и изюминку проекта я опускаю.
Далее идет приблизительное описание: проект представляет комплекс сервисов для домохозяек. Целевая аудитория: Женщины 20-45 лет, как правило сидят дома с детьми. Что им нужно? Их интересы:
Во первых дать комплекс средств по предоставлению свежей информации по интересам, как правило это могут быть RSS каналы с других сайтов.
Во вторых им нужно общение между собой: чат, форум, мессенжер, блоги.
В третьих им нужно средство для выражения самореализации: блоги, фото-альбомы.

Необходимо охватить информацию по рубрикам: Дом и семья, Красота и здоровье, Покупки, Разводы и как пережить одиночество, Деловая женщина.

Финансовая составляющая проекта

Это самый главный раздел для инвесторов. Должно быть два раздела: Расходы и Доходы.
Расходная часть имеет две составляющей, единовременые расходы: (покупка серверов)
и постоянные: аренда серверов и каналов( хостинг или колокейшен), з/п персонала (контент-менеджеров, поддержка проекта, модератеров)

Доходная часть: Возможные доходы (в зависимости от посещаемости)

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

Прототип проекта

Самое главное — это предоставить инвестору прототип рабочего проекта. Если проект не большой и умещается в рамках шаринг-хостинга, это не проблема. Если проект амбициозный, расчитан на высокую нагрузку и представляет распределенный кластер серверов, то как вариант — это организация собственного домашнего Дата-центра. Проект должен «задышать» в ваших руках и «ожить» в глазах инвесторов.

Несомненно прежде чем реализовывать проект, необходимо оговорить с провайдером тариф, узнать полосу пропускания как входящего, так и исходящего трафика, и конечно должен быть выделенный IP адрес. Пока мой трариф 15 Mbit трафика.

Архитектура проекта разработана таким образом, что в случае «взлета» проекта, его можно было безболезненно разнести на несколько серверов. Каждая функциональная единица имеет свой поддомен. Впрочем, архитектура проекта — это отдельная тема другого блога.

Одна из возможных схем расположения серверов проекта представлена на рис 1.
Сервер 1 является прокси сервером и WEB. Сервер 2 является сервером БД, который должен быть в одной локальной сети с Сервером 1 (черный цвет). Сервер 3 — это скриптовый сервер, на нем запускаются разные бэдграундовские скрипты, которые осуществляют поиск информации в интернете и обрабатывают пользовательский контент. В идеале, Срвер 3 должен иметь отдельный доступ в интернет, но «на безрыбье и рак рыба». Сервер 3 подключается через домашний роутер, ну и конечно через этот же роутер подключается мой ноут, как сервер разработчика, так и компьютер жены.

Издержки и железо

Будите смеяться, но сервера почти с помойки, однако свою функцию они выполняют.

Сервер 1 — P-IV/2200MHz/2Gb (одноядерный) — подарил друг,
Сервер 2, P-III/800MHz/512Мb — в свое время пожалел выкинуть.
Сервер 3, P-III/800MHz/512Мb — отдали в дар на работе (собирались тоже выкинуть).

На сегодняшний день издержки составляют:
разовые:
регистрация домена 650 руб,
две сетевых карты 220 х 2 = 440 руб
апгрейд памяти — 1500 руб

Переменные:
удорожание тарифа + 500 руб

Как видите, такие издержки может вполне позволить даже начинающий ~~программист~~ бизнесмен.

Состояние дел и возможный исход событий

продаться за миллион баксов (шутка, рублей но тогда уж пару). Вполне возможно, но для этого проект должен быть на 100% завершен и уже собирать какие-то деньги.
найти соинвестора, что наиболее вероятно. Варианты рассматриваются. Особенно надо будет хорошенько вливать финансы на первом этапе после запуска в промоушен (даже и не знаю сколько).
Допиливать проект самостоятельно по вечерам, не лучший но вполне возможный вариант. Вся прибыль твоя, но есть большой риск «не взлететь» вообще.

На сегодняшний день есть дышащий прототип с 35% реализованного функционала. После доработки дизайна, проект в принципе можно будет открывать.

и так: Не ошибается тот, кто ничего не делает
и Кто не рискует, тот не пьет шампанского

Изучаем английский с Anki

artkil — Fri, 17 Sep 2010 11:34:55 GMT

Anki — это программа для запоминания иностранных слов. Список её преимуществ перед аналогами впечатляет!
Судите сами:

Широкие возможности по настройке вида карточек
Поддержка мультимедиа
Большое количество плагинов
Настройка алгоритма обучения
Подробная статистика
Поддержка большинства современных платформ (Linux, Windows, Mac, iPhone, Android, список можно продолжить!)
Синхронизация данных

И всё бы хорошо, да вот только благодаря таким обширным возможностям, в Anki может быть не так просто разобраться. Надеюсь, мой скринкаст вам в этом поможет.

Официальный сайт — ichi2.net/anki/
Программу можно найти в Центре приложений Ubuntu.

Пресс-релиз по итогам съезда Пиратской Партии России

artkil — Fri, 17 Sep 2010 11:33:45 GMT

В России скоро появится новая политическая партия. Такое решение было принято делегатами первого съезда Пиратской Партии России, который прошел 10-12 сентября 2010 в подмосковной Малаховке.
В съезде участвовали представители Москвы, Питера, Нижнего Новгорода, Воронежа, Новосибирска, Ростова-на-Дону и других регионов России. Присутствовал международный координатор Пиратской партии Германии и сопредседатель Pirate Parties International — Gregory Engels.

Организационный съезд принял программу действий на год, ключевым пунктом в которой является регистрация Пиратской партии, как политической партии.
Для участия в выборах партией создана «Школа кандидата».
Также съезд поддержал первого кандидата в депутаты города Шумерля Чувашской Республики от Пиратской партии России Иванькова Александра.
За основу внутренней организации партии принята прямая электронная демократия.

Была принята резолюция под ироническим названием «Малаховский протокол».

Публикация о съезде в Частном Корреспонденте.

Почему хороший игрок в Starcraft — идеальный работник для стартапа?

artkil — Fri, 17 Sep 2010 11:32:38 GMT

В последнее время мы как-то особенно углубились в тему стартапов (это и понятно, ведь новые проекты занимают все наши мысли и свободное время), поэтому активно читаем все, что пишут по этой теме у нас и в англоязычных источниках.
И вот наткнулись на забавную статью. Автор написал ее, размышляя о турнире StartupCraft (турнир по Starcraft для IT-компаний), пытаясь понять, является ли выигрыш в этом турнире свидетельством успеха компании в работе или инвесторы должны дать денег в первую очередь тем, кто проиграл (ведь они еще что-то кроме Starcraftа умеют). Без сомнения, автор склоняется к первому варианту:)

Под катом перевод этой самой статьи $CUT$

Почему хороший игрок в Starcraft — идеальный работник для стартапа?

Хорошие игроки в Starcraft помешаны на совершенстве
Если бы мне предложили выбрать единственное обязательное качество для людей, которые со мной работают, я бы выбрал стремление становиться лучше. Наивно думать, что люди изначально делают всё хорошо. Таких сотрудников вы не найдете. А вот сотрудники, которые постоянно учатся и профессионально совершенствуются — это то, что нужно.

Хорошие игроки в Starcraft смотрят реплеи, чтобы понять — где они поступили неправильно и, самое главное, почему кому-то удалось победить. Раз за разом они повышают свой скилл, чтобы быть ближе к победе в каждой следующей игре.

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

Хорошие игроки в Starcraft хороши во всём
В стартапе, особенно в небольшом, сотрудники должны уметь всё. Например, когда я работал в EduFire, я никогда не занимался тем, что было написано в моей должностной инструкции. Мы все были готовы выполнять самые разнообразные задания, подменять друг друга в трудных ситуациях и делать не то, что можешь, а то что нужно.

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

Хорошие игроки в Starcraft знают, как нужно развиваться
Есть такие игроки, которые предпочитают не уходить далеко от базы и внезапно обнаруживают себя «запертыми», привязанными к своим минералам. Есть те, которые, наоборот, захватывают слишком много территории и проигрывают из-за нехватки ресурсов. Но хорошие игроки в Starcraft знают когда и куда можно расширяться.

Стартапу не нужны работники, которые распыляют себя во всех возможных направлениях (и поэтому менее эффективны во всем, что делают) и не нужны те, кто все время сидит на одном месте (и никогда не делают ничего, кроме того, что великолепно умеют). Команде нужны люди, знающие, куда можно расти и развиваться, и умеющие выбрать для этого правильное время.

Хорошие игроки в Starcraft говорят GLHF
GLHF = Good Luck Have Fun — пожелание удачи в игре. Это правило хорошего тона — говорить так. Ни одна компания не откажется от сотрудника с хорошими манерами, который ведет себя с окружающими так, как им бы того хотелось. Если в команде стартапа есть люди, которые не могут ладить друг с другом, — ждите проблем.

Хорошие игроки в Starcraft знают, что такое микро
Микро-контроль — очень важная часть игры в Starcraft. Это значит, нужно использовать минимальное количество ресурсов настолько эффективно, чтобы победить даже тогда, когда это кажется невозможным. Вы просто не представляете, что хороший игрок в Starcraft может выжать всего из нескольких юнитов. В стартапах обычно не хватает денег… и вообще с ресурсами — напряженно. Сотрудники должны уметь сделать многое из ничего. Хорошие стракрафтеры — настоящие эксперты в этом.

У хороших игроков в Starcraft высокий рейтинг
Да, так и есть. Рейтинг – это самый быстрый и простой способ показать, чего ты добился в прошлом. Чаще всего (и слава богу), выбирая сотрудников для стартапа, не обращают внимания на резюме. Обращают внимание на то, чего человек добился. Рейтинг это самое то. Каждая победа – это победа, а каждое поражение – поражение, и уже неважно как именно ты победил (так и в резюме, если написано «увеличил продажи на 25% в 2009», то кому интересно как конкретно?). На основе рейтинга игрока и лиги, в которой он состоит, можно многое сказать о нем, и так же можно понять главное о претенденте на работу, изучив то, чего он добился и что он создал.

Хорошие игроки в Starcraft принимают быстрые, правильные решения
Если вы, играя в Starcraft, не можете принимать правильные решение быстро (например, когда идти вперед, когда применить пси-шторм или когда отозвать ворона), то вы долго не продержитесь. Хорошие игроки принимают решения и действуют прямо сейчас, несмотря на все атаки, здания и юниты, которые используют против них враги. Мгновенная реакция и решительные действия в верном направлении – это именно те качества, которые я бы хотел видеть в коллеге или сотруднике, особенно в стартапе.

Хорошие игроки в Starcraft не забывают про разведку
В Starcrafte важно узнать максимум возможной информации о противнике. Но хитрость в том, чтобы не заниматься только этим. Если вы уделяете всё внимание изучению врага, то у вас уже не останется сил (армии, ресурсов, времени и пр.), чтобы с ним бороться. Стартапам нужны сотрудники, которые изучают конкурентов, но тратят большую часть времени на развитие своего собственного проекта.

Хорошие игроки в Starcraft знают, когда нужно уйти
Иногда, вы ведете бой, в котором не можете победить. Хорошие старкрафтеры знают, когда приходит время сказать GG и уйти, вместо того, чтобы дожидаться конца игры, которая все равно закончится поражением. Нет ничего плохого в том, чтобы уйти или оставить какое-то занятие, если сделать это осознанно. Это дает тебе больше времени для вещей, которые действительно важны и могут привести к успеху. Не все, что мы делаем, оказывается правильным, поэтому нужно хотя бы понимать, когда приходит время остановиться и обратить взгляд на что-то другое.

У хороших игроков в Starcraft высокий АРМ
АРМ – количество действий в минуту. Чем опытней игрок, тем выше его АРМ (это значит, он может следить за большим числом вещей одновременно). Несмотря на то, что мне больше нравится фокусироваться на одной задаче, в работе нужно стремиться к максимальной эффективности. Люди с высоким АРМ обычно знают все хоткеи и отлично ориентируются в меню игры.

Скорее всего, такие сотрудники смогут использовать все возможные средства, чтобы повысить эффективность своей работы: они быстро печатают, знают горячие клавиши, находят специальные приложения для оптимизации рабочего процесса и пр. Конечно, каждая из этих деталей экономит всего лишь пару секунд, но задумайтесь, сколько это времени в неделю, месяц или год. Да, такие сотрудники экономят массу времени и поэтому полезны.

Хорошие игроки в Starcraft интересуются еще чем-то кроме работы
Это уж точно… по крайней мере их интересует Starcraft. Никому не нужны сотрудники, которые работают по 18 часов в сутки и способны думать только о работе (ну мне точно не нужны). Мне нравятся люди, с которыми можно заняться чем-то еще, например поиграть в Starcraft:)

Алгоритм определения пола

artkil — Fri, 17 Sep 2010 11:30:51 GMT

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

Введение

На просторах интернета нашел два проекта наработки из которых мне помогли в решении задачи.

Программа для твиттера – Twidum
Библиотека морфоанализа macrocosm.narod.ru

Из первой программы нам потребуется аккуратно собранные разработчиками базы русских и английских имен. Скачиваем программу, устанавливаем, забираем файлы с говорящими именами girls_ru.txt girls_en.txt boys_ru.txt boys_en.txt (я не стал выкладывать файлы отдельно, возможно это нарушает лицензию разработчика, поэтому каждому придется скачать программу самостоятельно). Во всех четырех файлах имена отсортированные в алфавитном порядке, так что организовать быстрый поиск труда не составит.

Итого имеем:
12217 русских женских имен, 11033 русских мужских имен, 5915 английских женских имен, 1533 английских мужских имен. На лицо дискриминация мужских имен :). Обратите внимание, что все имена написаны с маленькой буквы. Видимо для чегото разработчикам это потребовалось, а нам нужно будет просто это учитывать.

На счет морфоанализа. Он важен только для русского языка т.к. у меня в базе не все имена встречались в именительном падеже. Качаем mcd.dll отсюда: macrocosm.narod.ru/madown.html и не забываем скачать файл rus_morphology.mcr (он должен лежать в одной папке с dll`кой).

Алгоритм

Если имя написано латиницей делаем перебор по английским именам, если кириллицой, то сначала ищем имя как есть, если не находим, включаем морфологический модуль. В архиве с dll есть примеры на Delphi, С++ и C#, без них только по докам с сайта разобраться будет трудно. Основная мысль – морфологический модуль приводит имя поданное на вход к словарной форме (единственное число, именительный падеж) ну, а дальше нам остается только поискать слово в базе имен.

Надеюсь эта небольшая зарисовка поможет кому-нибудь решить подобную задачу.

Ubuntu начинает формировать список сертифицированного оборудования

artkil — Fri, 17 Sep 2010 11:29:37 GMT

Проект Ubuntu формирует список сертифицированного оборудования, которое совместимо с последними версиями дистрибутивов. На специально отведенной веб страничке можно посмотреть, например, поддерживается ли Ваш недавно купленный ноутбук, каких проприетарных драйверов может не хватать, а также пути решения некоторых проблем с устройствами.
Поддержка устройств отличается "статусом": Certified, Enabled, либо Ready. Первый означает, что производители сами предоставили свое оборудование для тестирования инженерами Canonical и все тесты пройдены успешно. Во-втором случае Canonical самостоятельно настраивает Ubuntu для работы на данном оборудовании и следит за должной производительностью. Последний же статус означает, что оборудование тестировалось самим производителем с помощью специального тестового пакета, результаты были направлены на проверку в Canonical.
>>> Подробности

Создаем Web-приложение, умеющее работать с Twitter

artkil — Fri, 17 Sep 2010 11:28:52 GMT

Похоже, что в наши дни Twiiter можно обнаружить где угодно. Политики, актеры, наши родители – все пользуются ресурсами социальных сетей. Клиенты требуют приложений, которые не только позволяют пользоваться Twitter, но и имеют глянцевый вид в стиле Web 2.0, которого можно добиться только с помощью Ajax. Нам в этом помогут Django и jQuery. $CUT$

Рисунок 1. Панель Twitter, показывающая последние записи

Зависимости

Часто используемые сокращения

Ajax: Асинхронный JavaScript + XML
API: Интерфейс программирования приложений (Application programming interface)
CSS: Каскадные таблицы стилей (Cascading style sheet)
FAQ: Часто задаваемые вопросы (Frequently asked questions)
HTML: Язык разметки гипертекста (Hypertext Markup Language)
HTTP: Протокол передачи гипертекста (Hypertext Transfer Protocol)
REST: Передача состояния представления (Representational State Transfer)
UI: Пользовательский интерфейс (User interface)

Прежде чем приступать к работе с этой статьей, я настоятельно рекомендую вам проработать учебное руководство по Django. Также вы должны иметь уверенные знания JavaScript. Разумеется, у вас должна быть учетная запись Twitter, и вы должны знать его жаргон, например, что такое твит. В арсенале ваших инструментов должны быть Python, Django, jQuery и библиотека pyhon-twitter. В разделе Ресурсы приведены ссылки, по которым их можно загрузить.
Также нам понадобится включенная в Python база данных sqlite3 для хранения данных о сеансах, а о сохранении остальных данных позаботится инфраструктура Twitter. Конечно же, в дальнейшем для улучшения приложения можно будет интегрировать более сложную структуру базы данных для хранения на вашем сервере статистики, копий твитов и любой другой информации, связанной с вашей учетной записью Twitter. Также в этой статье предполагается, что вы работаете на Linux®.
Я проверял данное приложение с Python 2.5.2. По умолчанию Python установлен на большинстве Linux-машин, однако если Python у вас все же отсутствует, то в разделе Ресурсы можно найти информацию по его загрузке и установке.
Twitter позволяет получать данные с помощью двух API-интерфейсов: API поиска и REST API. (На сайте Twitter в разделе FAQ упоминается о планах по созданию единого API). REST Web-сервисом называется Web-сервис, реализованный на протоколе http и следующий принципам архитектуры REST (см. информацию в разделе Ресурсы).
Устанавливаем библиотеку python-twitter
Последний компонент, который нам нужен - это библиотека python-twitter. Согласно сайту проекта, она представляет собой "оберточную библиотеку python, основанную на API Twitter и модели данных twitter". Существует несколько библиотек, позволяющих взаимодействовать с сервисами Twitter во множестве языков - от Ruby до Eiffel. В настоящий момент в Python имеется 5 библиотек для взаимодействия с Twitter: Python-twitter Де Витта Клинтона (DeWitt Clinton), python-twyt Эндрю Прайса (Andrew Price), twitty-twister Дастина Сэллингса (Dustin Sallings), twython Райана Макграта (Ryan McGrath) и Tweepy Джоша Росслейна (Josh Roesslein).
Библиотеке python-twitter для работы нужен пакет simplejson (см. Ресурсы). Загрузите этот пакет и установите его, выполнив команды, показанные в листинге 1.

Листинг 1. Команды для установки simplejson

tar -zxvf simplejson-2.0.9.tar.gz
cd simplejson-2.0.9
sudo python setup.py build
sudo python setup.py install

Если вы предпочитаете работать с egg-пакетами, используйте команду sudo easy_install simplejson-2.0.9-py2.5-win32.egg.
Теперь можно установить и python-twitter. Загрузите пакет и выполните команды, показанные в листинге 2.

Листинг 2. Команды для установки python-twitter

tar -zxvf python-twitter-0.6.tar.gz
cd python-twitter-0.6
sudo python setup.py build
sudo python setup.py install

Устанавливаем Django
Теперь пришло время установить Django - мощную инфраструктуру разработки Web-приложений на Python. В описываемом в данной статье приложении я работал с Django версии 1.1.1. Установка Django так же проста, как установка simplejson и python-twitter. Загрузите пакет и выполните в терминале команды, показанные в листинге 3.

Листинг 3. Команды для установки Django

tar -zxvf Django-1.1.1.tar.gz
cd Django-1.1.1
sudo python setup.py build
sudo python setup.py install

Проверьте, что путь к Django есть в вашей переменной path, для чего выполните команду $ django-admin --version. Если все прошло как ожидалось, то можно взяться за написание кода.

В начало

Библиотека python-twitter
Установив библиотеку python-twitter, можно приступить к изучению ее возможностей. Чтобы получить доступ к библиотеке, выполните команду import twitter. Модуль twitter предоставляет обертки для модели данных Twitter и его API. В нем имеется три класса моделей данных: twitter.Status, twitter.User и twitter.DirectMessage. Все вызовы API возвращают объект одного из этих классов. Для работы с API следует создать экземпляр класса twitter.Api() (обратите внимание, что первая буква - заглавная). Если создать экземпляр этого класса, не передавая в конструктор никаких параметров, то можно будет вызывать только методы, которые не требуют входа в систему. Чтобы войти в систему и получить полный доступ к API, используйте следующий синтаксис:

import twitter
api = twitter.Api(username='yourUserName', password='yourPassword')

Имея экземпляр класса Api, можно запрашивать ваших фолловеров (пользователей, которые читают ваши твиты), пользователей, твиты которых читаете вы, получать статусы (твиты), можно посылать твиты и т.д. Например, чтобы получить список твитов пользователя, сделайте вызов statuses = api.GetUserTimeline(), который вернет список объектов twitter.Status. Чтобы создать список с текстом (строками) ваших твитов, можно использовать следующее выражение: >>>print [s.text for s in statuses].
В таблице 1 перечислены классы и методы, которые мы будем использовать в нашем Web-приложении. С полной документацией можно ознакомиться через pydoc, например — $ pydoc twitter.Api, или на web-странице документации python-twitter (см. Ресурсы).

Таблица 1. Некоторые полезные методы API, доступные в python-twitter

Метод	Возвращаемое значение	Описание
`GetUserTimeline()`	Список объектов `twitter.Status`	Запрашивает все твиты пользователя
`GetFriends()`	Список объектов `twitter.User`	Запрашивает список фолловеров (пользователей, читающих ваши твиты)
`PostUpdate()`	Объект класса `twitter.Status`	Публикует твит

В начало

Добавляем в коктейль jQuery
Следует уточнить, что мы будем использовать не только ядро jQuery, но и библиотеку jQuery UI, предоставляющую виджеты, темы и анимацию. Посетите страницу ThemeRoller и на панели слева нажмите на вкладку Gallery (Галерея). Выберите тему, которая вам нравится (я в этом приложении использовал тему Cupertino) и перейдите по ссылке Download, находящейся под именем темы. Вы попадете на страницу загрузки. Выберите на ней текущую (стабильную) версию. На момент написания статьи это была версия 1.7.2 для jQuery 1.3+.
Процесса установки как такового нет, просто извлеките файл ThemeRoller и поместите нужные директории/файлы в нужное место. Также при желании можно создать новую тему, но я в этом примере ограничился использованием одной из готовых тем.

В начало

Создаем проект Django
Теперь нужно создать новый проект Django. Это делается с помощью команды django-admin startproject pytweetproj, где pytweetproj – это имя проекта, используемое в этой статье. Вы можете указать любое другое имя, однако в таком случае следите за тем, чтобы везде дальше по ходу статьи использовать именно его. Перейдите в директорию pytweetproj. Чтобы запустить web-сервер Django, выполните в терминале команду python manage.py runserver, запустите Web-браузер и перейдите по адресу http://127.0.0.1:8000. Вы увидите страницу с надписью «It worked!». Если вы в какой-либо момент захотите остановить или перезапустить сервер, нажмите Ctrl+C, чтобы завершить его процесс. Не используйте сервер разработки в рабочей среде. Завершив разработку проекта, перенесите его на надежный и безопасный сервер, например, Apache.
Создайте в корневой директории проекта поддиректорию с именем resources, в которой мы будем хранить CSS-файлы, сценарии JavaScript и прочие медиа-файлы. Скопируйте сюда директории css и js, извлеченные из ZIP-архива ThemeRoller, а также ядро jQuery.
Откройте в своем любимом текстовом редакторе файл settings.py и поменяйте его согласно листингу 4.

Листинг 4. Настройки проекта Django

# Настройки Django для проекта pytweetproj.
import os
APPLICATION_DIR = os.path.dirname( globals()[ '__file__' ] )

DEBUG = True
TEMPLATE_DEBUG = DEBUG

ADMINS = (
)

MANAGERS = ADMINS

# для кэширования мы будем использовать базу данных sqlite3
DATABASE_ENGINE = 'sqlite3' 
DATABASE_NAME = 'session.db' 
DATABASE_USER = '' 
DATABASE_PASSWORD = '' 
DATABASE_HOST = '' 
DATABASE_PORT = '' 

TIME_ZONE = 'America/Chicago'
LANGUAGE_CODE = 'en-us'

SITE_ID = 1

# если вы не будете пользоваться возможностями интернационализации, то для скорости
# работы лучше оставить этому параметру значение false
USE_I18N = False

MEDIA_ROOT = os.path.join( APPLICATION_DIR, 'resources' )
MEDIA_URL = 'http://localhost:8000/resources/'
ADMIN_MEDIA_PREFIX = '/media/'

# Сделайте этот ключ уникальным и никому его не показывайте.
SECRET_KEY = '=y^moj$+yfgwy2kc7^oexnl-f6(b#rkvvhq6c-ckks9_c#$35'

# Список загрузчиков шаблонов, которые могут импортировать шаблоны из различных 
# источников.
TEMPLATE_LOADERS = (
 'django.template.loaders.filesystem.load_template_source',
 'django.template.loaders.app_directories.load_template_source',
# 'django.template.loaders.eggs.load_template_source',
)

MIDDLEWARE_CLASSES = (
 'django.middleware.common.CommonMiddleware',
 'django.contrib.sessions.middleware.SessionMiddleware', 
 'django.contrib.auth.middleware.AuthenticationMiddleware',
) 

ROOT_URLCONF = 'pytweetproj.urls'

TEMPLATE_DIRS = (
 os.path.join( APPLICATION_DIR, 'templates' ), 
)

INSTALLED_APPS = (
 'django.contrib.auth',
 'django.contrib.contenttypes',
 'django.contrib.sessions',
 'django.contrib.sites',
 'twitterPanel',
)

# добавим это для сессий
SESSION_ENGINE = 'django.contrib.sessions.backends.cached_db'

При задании директории приложения используйте вызов os.path.dirname( globals()[ '__file__' ] ), который возвращает путь к текущей рабочей директории и работает на всех операционных системах. С помощью этого вызова задайте путь к директории ресурсов, а также TEMPLATE_DIR. Также необходимо задать переменной MEDIA_URL значение http://localhost:8000/resources/.
Мы будем использовать базу данных sqlite3, по умолчанию включенную в Python. Также необходимо задать переменные DATABASE_ENGINE, DATABASE_NAME и ROOT_URLCONF. Обратите внимание, что в переменной INSTALLED_APPS, в которой перечисляются установленные приложения, указано еще не созданное приложение twitterPanel. Мы создадим это приложение чуть позже. А пока выполним команду python manage.py syncdb чтобы создать базу данных для session.db.
Выполните команду django-admin startapp twitterPanel чтобы создать приложение twitterPanel, после чего перейдите в только что созданную директорию twitterPanel. В директории twitterPanel создайте директорию с именем templates, в которой мы будем хранить шаблоны Django.

В начало

Создаем адреса URL
Откройте в своем любимом текстовом редакторе файл url.py, находящийся в корневой директории проекта и поменяйте код в соответствии с листингом 5. В этом файле шаблонам адресов URL ставятся в соответствие функции обратного вызова.

Листинг 5. Настраиваем корневые адреса URL

from django.conf.urls.defaults import *
from django.conf import settings

urlpatterns = patterns('',
 ( r'^resources/(?P

Регулярные выражения

Согласно Википедии, регулярные выражения "предоставляют лаконичные и гибкие средства для идентификации текста, представляющего интерес, например, содержащего определенные символы, слова или шаблоны символов". Если у вас нет опыта работы с регулярными выражениями, я рекомендую вам книгу Mastering Regular Expressions, написанную Джеффри Фридлом (Jeffrey Friedl) или Text Processing in Python, написанную Дэвидом Мерцем (David Mertz). Также можно начать с HOWTO-руководства по регулярным выражениям, размещенного на странице документации Python.

Первый элемент urlpatterns определяет, как будут обрабатываться статические ресурсы или медиа-файлы – например изображения. Поскольку мы используем сервер разработки Django, для обслуживания статических данных мы будем использовать представление django.views.static.serve(). Второй элемент urlpatterns подключает шаблоны URL, найденные в приложении twitterPanel. Откройте файл url.py, находящийся в директории twitterPanel (не путайте его с файлом url.py, находящимся в корне проекта) и добавьте в него код, показанный в листинге 6.

Листинг 6. URL адреса приложения twitterPanel

from django.conf.urls.defaults import *
from twitterPanel.views import *

urlpatterns = patterns( '',
 url( r'^$', index, name = 'twitterPanel_index' ),
 url( r'^panel/$', panel, name = 'twitterPanel_panel' ),
 url( r'^update/$', update, name = 'twitterPanel_update' ),
)

В начало

Представления
Мы создадим только три представления: index, panel и update. Обратите внимание, что мы будем добавлять представления не в корень проекта, а в приложение twitterPanel. Откройте файл views.py, находящийся в директории twitterPanel, и добавьте в начало файла инструкции импорта, указанные в листинге 7:

Листинг 7. Инструкции импорта в файле представлений приложения twitterPanel

from django.shortcuts import render_to_response
from django.template.context import RequestContext
import twitter

Метод Django render_to_response() отображает шаблон с определенным контекстом и возвращает объект класса HttpResponse. RequestContext - это контекст Django, немного отличающийся от обычного контекста django.template.Context, а именно, он принимает объект класса HttpRequest и автоматически заполняет контекст переменными, найденными в параметре TEMPLATE_CONTEXT_PROCESSORS.
Первый метод представления – index() - должен выглядеть так, как показано в листинге 8.

Листинг 8. Представление index

def index(request):
 template = 'index.html'
 userName = request.POST.get( 'userTxt' )
 password = request.POST.get( 'passwordTxt' )

 if userName is not None and password is not None: 
 try:
 api = twitter.Api( username = userName, password = password) 
 # запрашиваем 5 первых твитов
 statuses = api.GetUserTimeline()[0:5] 
 # получаем 120 первых друзей
 following = api.GetFriends()[0:120] 
 except NameError, e:
 print "unable to login"

 else:
 statuses = {}
 following = False 

 # помещаем данные в сессию
 request.session['statuses'] = statuses
 request.session['following'] = following
 request.session['userName'] = userName
 request.session['password'] = password
 
 data = {
 'statuses' : statuses,
 'following' : following,
 }

 return render_to_response(template, data, 
 context_instance = RequestContext(request))

Шаблон index.html еще не написан. Сейчас мы пока просто запомним, что у нас есть два HTML-элемента: поля для ввода имени пользователя и пароля. Данные посылаются в представление с помощью метода POST. Если имя пользователя и пароль введены, мы создаем объект класса twitter.Api и извлекаем для этого пользователя первые 5 твитов и первых 120 пользователей, за твитами которых он следит. Статусы, друзья, имя пользователя и пароль сохраняются в сеансе, чтобы к ним можно было обратиться в других частях нашей программы.
Второй метод представления - panel() - намного короче. Он показан в листинге 9.

Листинг 9. Представление panel

def panel(request):
 template = 'panel.html'
 data = {
 'statuses' : request.session['statuses'],
 'following' : request.session['following']
 }
 return render_to_response(template, data,
 context_instance = RequestContext(request))

Здесь мы используем шаблон panel.html, которого также еще нет. После входа пользователя все действия происходят именно в этом представлении. Именно здесь отображаются твиты, друзья и выполняются обновления. Чуть позже мы расскажем об этом подробнее. В настоящий момент все, что мы здесь делаем - это получаем из сеанса некоторые данные и вызываем метод render_and_response. Третий метод представления - update - напротив, немного сложнее. Взгляните на листинг 10:

Листинг 10. Представление update

def update(request):
 template = 'panel.html'
 
 userName = request.session['userName']
 password = request.session['password']
 
 try:
 api = twitter.Api( username = request.session['userName'], 
 password = request.session['password']) 
 api.PostUpdate(request.POST.get('updateTextArea'))
 updated = True
 statuses = api.GetUserTimeline()[0:5] # перезагружаем статусы
 except NameError, e:
 print "unable to login"
 updated = False

 data = {
 'userName' : request.session['userName'],
 'password' : request.session['password'],
 'updated' : updated,
 'statuses' : statuses
 }
 return render_to_response(template, data,
 context_instance = RequestContext(request))

Имя пользователя и пароль извлекаются из сеанса и используются для создания еще одного объекта twitter.Api, который используется для отправки обновления. После этого производится перезагрузка статусов.

В начало

Шаблоны
В директории twitterPanel/templates создайте файл index.html. Откройте этот файл и поместите в него код, показанный в листинге 11.

Листинг 11. Шаблон index

На рисунке 2 показан вид нашего приложения при запуске: кнопка jQuery UI

Рисунок 2. кнопка jQuery UI

Эта кнопка вызывает окно Login, показанное на рисунке 3.

Рисунок 3. Окно Login

Давайте изучим код, показанный в листинге 11. Сначала мы с помощью переменной {{MEDIA_URL}} сообщаем браузеру о том, где находятся файлы CSS, JavaScript и jQuery. При отображении шаблона Django подставляет вместо {{MEDIA_URL}} фактический путь к файлам.
Внутри заголовка добавим свой код JavaScript. Знак доллара ($) – это сокращение, с помощью которого можно обратиться к экземпляру jQuery. В jQuery краткая форма записи для document.getElementById('name') выглядит так: $('#name'). Например, мы определяем элемент dialog из jQuery UI с помощью тега

, а затем вызываем метод .dialog() для создания окна jQuery. Внутри этого окна мы помещаем кнопки OK и Cancel. Кнопка Cancel закрывает окно, а OK
 не просто закрывает окно, но и посылает данные на сервер. Если 
данные, полученные представлением index, являются корректными именем 
пользователя и паролем, приложение вернет данные о твитах и о 
читателях твитов данного пользователя. После этого окно с кнопками 
исчезает и вместо него появляется панель Twitter. 

Вся магия здесь заключена в строке $( '#panel' ).html( '&nbsp;' ).load( '{% url twitterPanel_panel %}' ),
 в которой загружается внешний шаблон Django с именем panel.html. 
Панель Twitter представляет собой виджет accordion, входящий в 
библиотеку jQuery UI. В листинге 12 показан код шаблона panel. 
Сохраните его в файле panel.html в директории twitterPanel/templates. 



Листинг 12. Шаблон panel