Amazon Byteﬂow

Управление проектами в Емаксе

2010-03-28T00:00:00Z

У Емакса какое-то подобие проектов из коробки появилось только в 23 версии, и то очень простое - только переменные директорий (directory variables, что-то типа file variables, только хранящиеся в отдельном файле - .dir-locals.el). По большей части потому, что über-решения нету, и разным людям нравятся разные решения. Вот я и решил вкратце рассказать о том, что нравится мне.

Пару лет назад я прочитал статью в каком-то блоге об одном из подобных решений и попробовал его использовать. Как-то это решение (это был eproject, что ли) не прижилось и я пошëл искать альтернативы. Перепробовав какое-то количество, я взял project-root, прикрутив к нему несколько понравившихся фич от других проектов. Теперь можно сказать, что мне действительно удобно - использую эту штуку уже больше года и доволен. :)

Вся идея заключается в том, что вручную указывать путь к проекту (как это сделано в большинстве - если не всех - IDE) - не очень удобно. У большинства проектов есть какой-то характерный файл (или набор файлов) в корне. К примеру, manage.py у джанговых проектов, или директория .hg у проекта, который лежит в репозитории меркуриала. В результате можно определять проект по наличию таких файлов; моя текущая конфигурация выглядит примерно таким образом:

(setq project-roots
      `(("Django project"
         :root-contains-files ("manage.py")
         :filename-regex ,(regexify-ext-list '(py html css js sh))
         :exclude-paths '("contrib"))
        ("Sphinx documentation"
         :root-contains-files ("Makefile" "conf.py")
         :filename-regex ,(regexify-ext-list '(py rst))
         :exclude-paths '("_build"))
        ("Python project with buildout"
         :root-contains-files ("../../buildout.cfg")
         :filename-regex ,(regexify-ext-list '(py)))
        ("Generic Python project"
         :root-contains-files ("setup.py")
         :filename-regex ,(regexify-ext-list '(py)))
        ("Generic Mercurial project"
         :root-contains-files (".hg"))
        ("Generic git project"
         :root-contains-files (".git"))))

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

proj/
    buildout.cfg
    src/
        proj/

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

Что это даëт? Это даëт возможность project-root'у определить, что он находится в проекте, и включает работу клëвого макроса with-project-root. В принципе он практически ничем не занимается, кроме как изменением текущей директории на корень проекта - но этого хватает, чтоб заработали предопределëнные команды, которые я повесил на кнопки вот так:

(global-set-key (kbd "C-c p f") 'project-root-find-file)
(global-set-key (kbd "C-c p g") 'project-root-grep)
(global-set-key (kbd "C-c p a") 'project-root-ack)
(global-set-key (kbd "C-c p d") 'project-root-goto-root)
(global-set-key (kbd "C-c p l") 'project-root-browse-seen-projects)

Наиболее часто используемая из них - find-file, которая показывает в минибуфере список файлов (в виде file\parentdir\parentdir - обратный путь к корню проекта), давая выбрать один из них с помощью ido-mode - т.е. вся вкуснотища типа flex matching'а работает¹. :)

Отступлю от темы и вкратце расскажу, что такое ido. Это такой клëвый пакет в емаксе, который позволяет сильно облегчить работу в минибуфере своим автодополнением и удобным переходом между соседними значениями (он показывает сразу все возможные значения одновременно - и это удобно). Я его использую вместо обычного открытия файла, для перехода между буферами, и вот с той же целью он используется в project-root.

Не думаю, что нужно описывать grep или ack, которые просто запускают соответствующую программу от корня проекта - результаты запуска, как обычно, показываются в буфере со ссылками на найденные значения (так что можно легко перейти к нужному файлу/строке). goto-root тоже не делает ничего особенного, просто открывает dired в корне проекта.

А вот browse-seen-projects - очень интересная штука. Дело в том, что project-root-find-file при первом открытия проекта добавляет его в список проектов в файле ~/.emacs.d/.project-roots и сохраняет этот файл. А browse-seen-projects создаëт новый буфер в режиме org-mode и добавляет туда все проекты - в виде ссылок на их директории, конечно. ;) Так что можно довольно быстро и удобно прыгнуть к нужному проекту.

В основном функциональность этого кусочка кода я описал, еще информацию можно почерпнуть на страничке project-root'a и в его исходниках. Естественно, что до идеального состояния его можно точить и точить, так что патчи - велкам. :)

надо только не забыть установить ido-enable-flex-matching в t. ↩

Google Maps API vs API Яндекс.Карт

2010-03-15T15:37:25Z

Описанный в прошлом посте сервис Дислокации использовал с самого начала Яндекс.Карты как движок карт. Причин на то было несколько - я думал, что они будут распознавать адреса лучше, чем гуглевские; у них значительно лучше документация, чем у Мапии; нет вопросов с получением ключика к АПИ, в отличии от Визикома.

В результате я написал всë с их использованием, и в основном был доволен - в документации описано всë подробно, с кучей примеров. Всë работало, я был доволен. :)

Но мне предложили перейти на карты от гугля - у них значительно больше охват по территориям (геокодер знает о моëм родном Кривом Роге, в отличии от яндексового :), плюс они лучше распознают адреса (которые встречаются, как оказалось, в довольно стрëмном виде). Почему сервис не перешëл - я в принципе всë сделал и оно заработало - это отдельный вопрос: гугль ограничивает количество запросов к геокодеру в 15000 в день (это мало, текст со страницы адресов отделений ВТБ24 - 1500 строк) плюс ограничивает частоту запросов - 5 запросов в секунду уже перебор, два - обычно всë ок, но бывают траблы. Это по-моему неприемлемо, ждать пару минут, пока оно раздуплится. :)

Но в посте я хотел затронуть совсем другой вопрос - о разнице в АПИ. В некоторых местах логичнее гугль: функция обработы результатов поиска адреса в виде коллбека к геокодеру это явно более стандартный подход, чем использование событий; в некоторых - яндекс: мне кажется более логичным на карту добавлять оверлей (map.addOverlay(mark)), а не обратное (mark.setMap(map)).

Но проблема лежит глубже. Во-первых, документация АПИ у гугла значительно хуже - хуже структурирована, в некоторых местах приходилось догадываться экспериментально (не могу вспомнить, где), примеров меньше. Базовых возможностей (всякие крутые штуки типа прокладывания маршрутов я не щупал, но у яндекса они только для Москвы - минус серьëзный) тоже меньше - к примеру, внешний вид карты надо предопределять до создания карты. После того уже изменить ничего невозможно, в отличии от яндексовых карт - там всë на лету меняется без проблем.

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

С другой стороны, центр Киева (на счëт других городов лень смотреть :) у Яндекса явно смещëн на юг - можно зайти на сайт и полюбоваться отрезанным севером. :) Но улица Мазепы у гугла отсутствует и это настораживает - не Путин ли покопался? :D

В общем и целом должен сказать, что бекенд у Google Maps лучше - у него куда более обширная база и (в большинстве случаев) лучше работающий геокодер. Зато у Яндекса лучше фронтенд - кроме всего прочего, увеличение региона, выделенного правой кнопкой мышки, меня просто прëт. :) А учитывая нечеловечность ограничителя геокодера у гугла, остаëтся ждать улучшений сервиса Яндекса. ;)

UPD. Надо, правда, сказать, что я совсем пропустил мимо глаз то, что я пользовался 3 версией API, которая еще находится в бета-тестировании, что несколько извиняет гугль. :)

Дислокации

2010-03-14T00:00:00Z

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

Иногда у меня в голове появлялась мысль, что было бы хорошо это как-то поправить. :) И вот последний раз, как мне пришлось срочно искать отделение своего банка, я вернулся к ноуту и за пару часов набросал страничку, где можно ввести десяток адресов и получить картинку их размещения на карте - и увидеть визуально, куда податься. Встречайте - locations.in.ua.

Что клëво - оно совсем не требует работы мозга (или рук). Просто вставляете в поле ввода кусок текста, в котором встречаются строки с адресами, сервис немного зачищает их и пытается найти на карте. Те, что получилось найти, показывает на карте и помечает зелëным маркером; те, что не получилось - помечает красным маркером. Всë просто. :)

Для еще большего упрощения на страничке about можно найти букмарклет, который помогает даже не париться с копированием.

В общем-то это и всë, welcome. :) На сайте есть кнопка Feedback, где можно написать отзыв или оставить идею, если таковые появятся.

Перезагрузка блога

2010-03-07T00:00:00Z

Ну что, привет, в очередной раз на новый лад - я опять сменил себе движок блога. :) И на этот раз уже не очень важно, что это - потому что он просто генерирует статический сайт. ;)

Я даже пошëл на столь экстремальный шаг, как отсутствие комментариев - обдумав ситуацию, я понял, что пишу не ради комментариев, а ради того, чтоб поделиться с читателями мнением, новостью и т.п.

Надеюсь, что дизайн вам понравится, как нравится он мне - он достаточно ненапряжный и чистый. Единственное, что мне не нравится - это иконка, которая является ссылкой на блог в заголовке (третья справа). Заодно я планирую писать почаще (3 поста за последние полгода - это не очень клëво, да?), потому что это теперь сделать проще - все посты являются файлами в репозитории, которые без проблем можно обновлять в редакторе, не открывая никакого сайта.

В любом случае, как говорит Джереми Кларксон - hello and welcome! И прошу прощения, если старые посты вдруг оказались новыми в ваших фидридерах. :)

Mercurial 1.4.1

2009-12-02T00:00:00Z

Хочу похвастаться - вышел Меркуриал 1.4.1, замечательный тем, что в него включили моë расширение - schemes. Это аналог алиасов, но только для адресов. После его включения и добавления в ~/.hgrc таких строчек:

[schemes]
p = ssh://piranha.org.ua/hg/

можно писать hg push p://byteflow/ вместо полного адреса. В расширении уже есть предопределëнные ссылки:

py = http://hg.python.org/
bb = https://bitbucket.org/
bb+ssh = ssh://hg@bitbucket.org/
gcode = https://{1}.googlecode.com/hg/

{1} в gcode означает, что первая часть урла (если считать их так: gcode://первая/вторая/етц/) будет вставлена в начало адреса, а не в конец.

Остальные изменения - в основном мелкие фиксы для 1.4 (который, кстати, вышел две недели назад).