lazy cleric

Прозрачный настраиваемый мост wifi-uart на esp8266, со встроенным эмулятором терминала

noreply@blogger.com (clericJ) — Tue, 26 Jan 2021 06:50:00 +0000

Предисловие

В бытность мою инженером связи, мне часто приходилось настраивать различное оборудование. Зоопарк из коммутаторов различных производителей, телефонные станции и прочее. Первоначальную настройку на коммутаторах удобнее делать подключившись через rs232, шнурком с преобразователем COM-USB к ноутбуку. Однако этот кабель не всегда удобен. Бывали ситуации когда ты в подвале (шкафы с оборудованием, в сетях ДРС которые я обслуживал, находились именно там), пытаешься стоя одной рукой держать ноутбук, а другой печатать, а короткий кабель соединённый с коммутатором не способствует удобству. Или зимой в минус 25 приходилось стоять возле базовой станции с ноутбуком в такой же позе. Вместо того чтобы сидеть в тёплой машине, припаркованной в 20 метрах. Предвидя упрёки в комментариях, о том что оборудование настраивать надо уделёно, скажу что эти случаи были аварийными (оборудование не в доступе) и оптимально было действовать именно так (сроки устранения повреждений не резиновые).

В общем тогда я прямо таки мечтал о беспроводном удлинителе 232-ого интерфейса. И на то время у китайцев существовали такие приблуды. Но, во первых дорого, во вторых громоздко и не автономно (был отдельный БП на 9-12В). И вот прошли годы, я работаю в другой области и с оборудованием связи имею мало общего. Но иногда с настройкой коммутаторов всё-же приходится сталкиваться. Тут заходя в очередной раз на mysku.ru вижу акцию на отладочную плату TTGO T-OI с микроконтроллером esp8266 за 1 доллар. Заказав такую халяву, я начал думать что бы с ней такого полезного сделать. Собирать очередную метеостанцию не особо хотелось. И тут мне вспомнилась идея беспроводного преобразователя, хотя сейчас полно аналогичных решений и алишке, и даже есть такие вещи как Air Console с впечатляющим функционалом и не менее впечатляющей ценой. Но было интересно реализовать самому, попрактиковаться, так сказать, ведь такое хобби приносит море удовольствия.

Аппаратная часть

Краткие характеристики модуля TTGO T-OI со страницы продавца:

Спецификации оборудования 

Чипсет:                 ESP8266EX
Флэш-память:            4 Мб 
Размер:                 43,96x25,63x20,80 мм
Вес:                    7,87 г.
Питание:                MicroUSB 5V/Батарея 16340 3,7V
Органы управления:      Кнопка reset, переключатель питания
Разьемы:                Micro USB, Grove, IPEX(внешняя антенна)

Живые фото: Распиновка модуля:
Данный модуль привлекателен тем что в нём встроена зарядка для лития и держатель для аккумуляторов формата 18340. Что без лишних телодвижений делает устройство автономным. Для включения отладочной платы служит переключатель в правом нижнем углу. Еще одним достоинством является совместимость по пинам с Wemos D1 Mini, что даёт возможность подключать к TTGO все шилды от Mini. Этим я и решил воспользоваться, накидав в Easy EDA шилд, преобразовывающий uart в rs232:
Так-как напряжение логических уровней на esp8266 3.3В, то в качестве преобразователя в/из интерфейса rs232, в место традиционного MAX232 использовал микросхему MAX3232 в корпусе SOIC-16, которая как раз работает с этим напряжением. Далее, мне понадобилось 5 конденсаторов на 100 нанофарад и резистор на 1 килоОм со светодиодом. Всё в SMD исполнении, типоразмера 0805. Еще понадобится разъем DRB- 9MA.
Компоненты списком:
С ЛУТом возиться не хотелось, поэтому заказал её изготавливание в Китае. Шилд занимает GPIO13, GPIO15 пины, для работы с uart'ом. Отладочная информация, сыпется в GPIO2. Особенностью esp8266 является то что она позволяет переназначать аппаратный uart с ножек GPIO1 и GPIO3 на GPIO15 (TX) и GPIO13 (RX), вызовом метода Serial.swap(). Преимуществом такого трюка является то, что подключение не мешает перепрошивке модуля, а так-же в порт не сыпется отладочный мусор. Однако я оставил возможность назначить стандартные GPIO для uart. Для этого необходимо перерезать старые дорожки и напаять перемычки на TX и RX на нижней стороне платы. Фото шилда, собранного "будерброда":

Программная часть

Я начал с изучения того что уже написано в данной области. Оказывается в пакете поставки с esp для Ардуино уже лежит пример кода для соединения устройства и хоста, (например телефона или ноутбука) через wifi по telnet. Пример так и называется WiFiTelnetToSerial. Взяв его за основу, я написал веб-интерфейс для настройки соединения и точки доступа. С сохранением настроек в во флеш-память. А так-же воспользовавшись библиотекой jQuery Terminal, реализовал эмулятор терминала, прямо в браузере. Общение web-терминала с преобразователем происходит через web-sockets. Сам код можно скачать на гитхабе, ссылки будут к конце статьи. Писался он с помощью PlatformIO . При компиляции нужно учитывать тот момент что для взаимодействия с файловой системой esp8266, я воспользовался библиотекой LittleFS в место привычной многим SPIFFS. Дело в том что SPIFFS признана устаревшей и рекомендуется переходить на LittleFS. В связи с этим у меня возникли некоторые проблемы с библиотекой FTP, пришлось пройтись по её исходникам и переписать все вызовы с SPIFFS на LittleFS. У обоих библиотек практически совместимый API, так что такой простой заменой всё и решилось. При подаче питания esp создаёт точку доступа WirelessTerminal с паролем 123456789. Так-же запускаются web-сервер на 80 порту. И ftp-сервер на 21 (нужен для доступа к флеш памяти контроллера, в основном для отладки). При заходе на ip-адрес 192.168.4.1 (по умолчанию) через браузер, появляется страница настроек:

Тут возможно настроить параметры соединения, и точки доступа. Для того чтобы подключится к устройству по 232 интерфейсу подойдёт любой эмулятор терминала (я по старинке пользуюсь HyperTerminal), либо воспользоваться web консолью, нажав на кнопку RUN TERMINAL в главном окне.

Примеры сессий

Для телефонов на андроид подойдёт бесплатный Serial WiFi Terminal из Google Market. Так-же оставлю несколько скриншотов того как выглядит интерфейс на телефоне:

Выводы

По моему мнению получилась хорошая тренировка для мозгов, а как-же полезная в хозяйстве сисадмина/инженера устройство, для желающих повторить оставляю ссылки на исходники:
Проект шилда в easyeda: https://easyeda.com/clericJ/wemos-d1mini-rs232shield
Программная часть: https://github.com/clericJ/wifi-terminal

Полезные плагины для Vim - взгляд из прошлого

noreply@blogger.com (clericJ) — Tue, 26 Jan 2021 06:36:00 +0000

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

vim-template - Шаблоны для различных типов файлов

Язык написания плагина: VimL

Зависимости: нет

Сегодня мы рассмотрим плагин добавляющий в vim шаблоны для типов файлов. Но сначала поговорим для чего нам всё это нужно. Во первых вас не утомляет писать по сути один и тот же код например при создании заголовочного (.h) файла? Писать include guards? Или другой пример, вы создаёте html страницу в vim, ищите откуда скопипастить начальную структуру документа (все эти html, head, body...) Не совсем удобно, правда? В любой IDE или маломальски приличном текстовом редакторе заготовки для различных типов файлом обычно идут из коробки стоит только перейти в меню File->New...

В vim так-же достаточно методов добавления вышеописанного функционала, начиная с abbreviations, заканчивая самописными функциями, стартующими при событии создания файла.

Однако для меня оказалось удобнее использовать плагин vim-template. Преимущества:

простой

легко расширяем

А теперь подробнее об использовании. После установки плагина, в директории $VIMRUNTIME создаём папку template, в ней и будут хранится наши заготовки для файлов. Вот структура моей директории template:

template:
|   template.c
|   template.cmd
|   template.cpp
|   template.h
|   template.htm
|   template.html
|   template.py
|   template.vnote
|   text.rst
|
+---plugin
|       template.vim
|
\---win32
        template.cpp

Для того чтобы плагин смог найти определённый темплейт, файлы должны называться template.*

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

С помощью события plugin-template-loaded плагин даёт нам понять, что пора раскрыть переменные находящаяся в темплейте, небольшой пример из моего vimrc:

augroup template-plugin
    autocmd User plugin-template-loaded call s:template_keywords()
augroup END

function! s:template_keywords()
    if search('<+FILE_NAME+>')
        silent %s/<+FILE_NAME+>/\=toupper(expand('%:t:r'))/g
    endif
    if search('<+CURSOR+>')
        execute 'normal! "_da>'
    endif
    silent %s/<+DATE+>/\=strftime('%Y-%m-%d')/g
endfunction

В функции s:template_keywords() мы определяем три переменные, думаю знатокам vim этот код предельно понятен, поэтому не буду останавливаться на нём подробнее. Вот таким нехитрым способом вы можете добавить свои переменные, а затем использовать их в шаблоне.

Так-как в вашей папке на данный момент пусто, пора добавить туда первую заготовку например для заголовочного файла языка C++:

template.h:

// created: <+DATE+>
#ifndef <+FILE_NAME+>_H_INCLUDED
#define <+FILE_NAME+>_H_INCLUDED

<+CURSOR+>

#endif // <+FILE_NAME+>_H_INCLUDED

Теперь, при открытии пустого .h файла, или создании через vim, командой :new, наш шаблон раскроется в такой код (для example.h):

// created: 2012-09-02
#ifndef EXAMPLE_H_INCLUDED
#define EXAMPLE_H_INCLUDED


#endif // EXAMPLE_H_INCLUDED

См. Также:

Справочный файл: :help template

Страница плагина на vim.org: http://www.vim.org/scripts/script.php?script_id=2834

Git-репозитарий: https://github.com/thinca/vim-template.git

CtrlP - нечёткий поиск по файлам, буферам, тегам, ...

Язык написания плагина: VimL

Зависимости: нет

Для vim существует огромное количество плагинов, как полезных так и не особо нужных. Но среди них есть и те, после использования которых, вы восклицаете - как я раньше жил без этого! Сегодня я познакомлю вас с одним из них, встречайте - CtrlP. Цель этого плагина сделать максимально удобным и быстрым поиск файлам, буферам, тегам, и т.д.

Основные возможности плагина:

Поиск по мере набора

Используется "нечёткий поиск" что позволяет найти цель вводом всего пары символов

Написан на чистом VimScript, одинаково хорошо работает для MacVim, gVim и Vim 7.0+

Полная поддержка регулярных выражений vim

Поддержка поиска по недавно открытым файлам (MRU) и по открытым буферам

Расширения, благодаря которым искать можно не только по файлам, но например, по тегам генерируемым ctags

Для начала немного о "нечётком поиске", предположим у нас есть директория вида:

kraken
|   buidldoc.cmd
|   kraken.py
|   readme.htm
|   readme.rst
|   tags
|   test.py
|
\---kraken_handlers
    |   base.py
    |   pdb_postmortem_loader.py
    |   pyqt4_error_reporter.py
    |   save_crash_info.py
    |   __init__.py

Для того чтобы открыть файл __init__.py в vim, вам придётся прописывать его полный путь: :o kraken/kraken_handlers/__init__.py это долго и утомительно. С помощью нечёткого поиска это делается вводом всего лишь части названия файла, например __ однозначно найдёт совпадение с файлом. Удобно так-же то, что по мере набора вы сразу видите результат.

Такой-же трюк можно проделывать и с директориями:

Используйте <c-p> или ``:CtrlP`` для вызова плагина

Это на самом деле очень удобно, думаю, мне не нужно будет вас убеждать, если вы пользовались данным функционалом в других приложениях, например в редакторе Sublime Text 2 эта возможность считается одной из ключевых.

Совет: для того чтобы после открытия файла, сразу перейти к нужному номеру строки введите :<номер строки> после имени, пример: >>__i:10.

Плагин CtrlP не ограничивается поиском только по файловой системе, с помощью команд :CtrlPBuffer и :CtrlPMRU он позволяет искать по открытым буферам и недавно закрытым файлам соответственно. Но это ещё не всё, с помощью расширений плагина, он даёт возможность поиска по тегам, директориям, истории изменений и много чему еще, но об этом мы поговорим позже.

Сравнение с аналогами

Помимо рассматриваемого, для vim существует еще, по крайней мере два плагина с похожим функционалом это command-t и FuzzyFinder. И последним из них, я достаточно долго пользовался, пока не узнал о CtrlP. Причиной перехода стало то что FuzzyFinder давно не обновлялся и скорее всего, заброшен автором.

Command-t вдохновлялся TextMate, его авторы хвалятся скоростью работы плагина. Благодаря использованию Ruby и C-extensions к нему. Сам я этот плагин не ставил. Из-за вышеописанных зависимостей (для меня важна портабельность). Возможно, Ruby-программистам Command-t подойдёт больше.

Расширения

С помощью команд-расширений плагин позволяет искать:

CtrlPTag - по тегам, сгенерированным ctags

CtrlPBufTag - тегам внутри буфера

CtrlPQuickfix - буферу qucckfix

CtrlPDir - директориям

CtrlPRTS - файлам в runtime vim (vim-скрипты, файлы справки, снипеты)

CtrlPUndo - истории отмен (Undo history)

CtrlPLine - номерам строк файла

CtrlPChange - списку последних изменений файла

CtrlPMixed - сразу по файлам, буферам и списку последних открытых файлов

Более подробно обо всех командах вы можете узнать из справочного файла плагина.

Включить расширения можно, перечислив их в переменной g:ctrlp_extensions:

let g:ctrlp_extensions = ['tag', 'buffertag', 'quickfix', 'dir', 'rtscript',
                        \ 'undo', 'line', 'changes', 'mixed', 'bookmarkdir']

См. Также:

Справочный файл: :h CtrlP

Страница на vim.org: https://github.com/kien/ctrlp.vim.git

Домашняя страница плагина: http://kien.github.com/ctrlp.vim/

Git-репозитарий:

FencView - открыть файл в нужной кодировке, легко!

Язык написания плагина: VimL

При работе в разных операционных системах и окружениях, возникает необходимость открывать файлы в различных кодикорвах (например cp1251 для Windows). Для задания кодировки файла в Vim существует команда fileencoding={enc}. Однако не всегда мы знаем исходную кодировку файла. В таком случае бывает удобнее попробовать несколько вероятных кандидатов из списка.

Планин fencview предоставляет нам эту возможность, добавляя в меню GVim пункт Tools->Encoding

Если-же вы пользуетесь консольной версией, то введите команду FencView

Команда FencAutoDetect пробует определить кодировку файла самостоятельно. К сожалению она заточена на определение языков восточной письменности (Chinese Simplified, Chinese Traditional, Japanese, Korean) и в наших краях не сильно полезна. По этой причине я бы советовал отключить автоопределение кодировки при открытии файла, опцией:

g:fencview_autodetect = 0

Зависимости

Плагин требует опцию +iconv для своей работы (проверить можно так :echo has('iconv')), а так-же библиотеку iconv.dll (если вы работаете в Windows), расположенную в %PATH% или рядом с исполняемым файлом Vim, как у меня.

Совет: с помощью встроенной опции Vim - fileencodings вы можете задать список кодировок, с помощью которых Vim будет пробовать открыть файл пример:

set fileencodings=ucs-bom,utf-8,cp1251

так-же для задания кодировки файлов по умолчанию используется опция fileencoding пример:

set fileencoding=utf-8

См. Также:

Страница плагина на vim.org: http://www.vim.org/scripts/script.php?script_id=1708

pyflakes - подсветка ошибок в коде python на лету

Язык написания плагина: VimL, python

Зависимости: +python

Часто ли вы делаете опечатки? Вот я частенько, бывает, даже когда я пишу в код. Это не так страшно, если вы пишете на языках со статической типизацией, например на C++ или Java, компилятор просто тыкает вас в место ошибки, при несоответствии типов или забытом параметре функции. А как быть при работе с интерпретируемыми ЯП?

Я много кода пишу на python и уже не представляю себе жизни без подсветки ошибок в редакторе на лету. В vim эту функцию выполняет плагин pyflakes-vim, основанный на утилите для проверки ошибок .. _pyflakes: https://github.com/kevinw/pyflakes Вся прелесть этой утилиты в том, что она не просто выявляет синтаксические ошибки, которые и так можно посмотреть, запустив скрипт. Но и показывает:

неиспользуемые импорты и переменные

использование переменной до её определения

переопределение функции/метода в локальной области видимости

Совет: Все найденные ошибки так-же отображаются в стандартном окне quickfix. Открыть которое можно командой ``:cwin``.

pyflakes vs Syntastic

Хотя сам автор плагина пишет что он deprecated и рекомендует переходить всем на .. _Syntastic: http://www.vim.org/scripts/script.php?script_id=2736 , так-как в этот плагин подсвечивает, в том числе и ошибки python'а. Я досих пор пользуюсь именно pyflakes-vim для python, просто потому что он для меня более удобен:

Подсвечивает ошибки сразу, а не при сохранении как Syntastic.

Сама подсветка реализована более правильно, вместо sings используется подсветка а-ля spellcheck.

Портабельность, всё необходимое для работы плагина лежит в его директории (кроме интерпретатора python разумеется)

Однако для других языков я использую Syntastic, в виду того что он поддерживает большое количество ЯП.

Для тех кому интересен Sytastic: http://habrahabr.ru/post/108564/

Замечание: плагин не поддерживает python 3+

См. Также:

Страница на vim.org: http://www.vim.org/scripts/script.php?script_id=2441

Git-репозитарий: https://github.com/kevinw/pyflakes-vim.git

tagbar - удобная навигация по всем функциям и классам

Язык написания плагина: VimL

Зависимости: ctags

Думаю, ни для кого не будет секретом, что когда кода становится много, искать что-либо в нём бывает затруднительно. Продвинутые редакторы кода и интегрированные среды разработки научились решать эту проблему с помощью так называемых outline`ов. Данный функционал представляет собой окно, со списком всех сущностей в коде (макросов, классов, функции и тд). Что позволяет сразу перейти к определению кликнув на нужный элемент.

В vim с давних пор для этого использовался плагин taglist, формировавший outline окно с помощью внешней утилиты ctags. Большим недостатком этого плагина было то что он структурировал сущности в виде списка, в то время как более привычным и наглядным является древовидное представление.

Какое то время назад мне на глаза попался плагин исправляющий недостатки taglist, имя ему tagbar:

Плагин отлично выполняет свою основную задачу, наглядно показывая сущности в коде. Так-же как и taglist, плагин использует утилиту ctags для получения информации из кода.

В завершение я хочу показать несколько полезных настроек плагина:

" Показывать окно слева
let g:tagbar_left = 1

" Ширина окна
let g:tagbar_width = 30

" Показывать стрелки вместо +/-
let g:tagbar_iconchars = ['▶', '◢']

" Не сортировать
let g:tagbar_sort = 0

См. Также:

Справочный файл: :help tagbar

Страница плагина на vim.org: http://www.vim.org/scripts/script.php?script_id=3465

Git-репозитарий: https://github.com/majutsushi/tagbar.git

vim-fswitch - быстрое переключение между заголовочным файлом и реализацией

Используемые языки при написании плагина: VimL

Зависимости: нет

Если вы пишете что-либо на С/С++ с используя Vim, то наверняка вам не хватает быстрого способа перейти от заголовочного файла к реализации (напр от foo.h к foo.cpp). Если вы задавались вопросом, почему нельзя реализовать такой простой функционал в самом редакторе, то ответом по моему мнению будет идеология. Vim != IDE, Vim это просто отличный текстовый редактор, ничего не знающий о семантике кода и системе сборки вашего проекта. Т.е. если упрощённо, откуда ему знать что заголовочные файлы вы держите в папке ./foo/include проекта? Но иногда удобство важнее идеологии и человек написавший плагин vim-fswitch со мной согласен.

a.vim VS vim-fswitch

Долгое время я писал на С++ простенькие утилиты для себя, чтобы быстро переключатся от заголовка к реализации использовался плагин a.vim. Но большой минус этого плагина в том что он не даёт возможности настроить пути для поиска файлов. Т.е. если .h файл не лежит рядом с .cpp файлом, он его просто не найдёт. Поискав на vim.org более функциональные альтернативы я наткнулся на vim-fswitch. Больше всего меня привлекла возможность гибкой настройки поиска файлов, на основе регулярных выражений.

Пример из моего vimrc:

augroup fswitch-autocommands
    au BufEnter *.cpp let b:fswitchdst  = 'h,hpp'
    au BufEnter *.cpp let b:fswitchlocs = './,./include/,../include,./inc'

    au BufEnter *.h let b:fswitchdst  = 'c,cpp'
    au BufEnter *.h let b:fswitchlocs = '../src,../,./'
augroup END

Тут мы ищем заголовочные (.h, .hpp) файлы в директориях ./include/, ../include, ./inc относительно нашего текущего буфера, а так-же в самой директории с файлом. Соответственно файлы реализации (.c, .cpp) в директориях ../src, ../ и текущей.

Из возможностей, так-же стоит отметить:

Создание пустого файла, если поиск ничего не дал, используя предпочитаемое расположение

Гибкость настройки путей для каждого буфера

Основные команды

Для простого переключения служит команда FSHere. Если вы предпочитаете видеть заголовочный файл и реализацию в одном окне, то для этого существует семейство команд которые открывают альтернативный файл, с рездлением текущего окна: FSSplitLeft (отобразить горизонтально слева), FSSplitRight (справа), FSSplitAbove (вертикально сверху), FSSplitBelow (снизу).

Совет:

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

Для того чтобы этот пункт отображался только для определённых типов файлов (С/C++) используется функция ToggleFTContextMenu:

function! ToggleFTContextMenu(languages, modifiers, menuitem, action)
    for lang_ in a:languages
        if &filetype != lang_
            execute 'silent! aunmenu ' . a:menuitem
            continue
        endif
        for modifier in a:modifiers
            let esc = ''
            if modifier == 'i'
                let esc = '<esc>'
            endif
            let command =  modifier . 'menu <silent> ' . a:menuitem . ' ' . esc .':call ' . a:action . '<cr>'
            execute command
        endfor
        return
    endfor
endfunction

Теперь осталось зарегистрировать наше меню хитрым способом:

augroup user-contextmenu
    au MenuPopup * call ToggleFTContextMenu(["cpp", "c"],["i","n"],
                \"PopUp.-Usrsep5-", ":")

    au MenuPopup * call ToggleFTContextMenu(["cpp", "c"],["i","n"],
                \"PopUp.Swtich\\ Header/Source", "FSwitch('%', '')")
augroup END

См. Также:

Справочный файл: :help fswitch

Страница плагина на vim.org: http://www.vim.org/scripts/script.php?script_id=2590

Git-репозитарий: https://github.com/derekwyatt/vim-fswitch.git

SNMP Scanner

noreply@blogger.com (clericJ) — Thu, 19 Apr 2018 17:13:00 +0000

Simple network discovery tool

Windows Installation:

Download lastest version

Install program

System Requrements: Windows Vista, 7, 10 (not working on Windows XP!)

Linux Installation:

Download sources

Run snmp_scanner_app.py

System Requrements: python-3.5+, PyQt5, pysnmp-4.4+

SmartQ ZWatch watch faces

noreply@blogger.com (clericJ) — Thu, 17 Apr 2014 15:16:00 +0000

Installation:
- download
- install
- reboot!
- wait 2-3 minutes after booting

Clean

LED

Metro 2034
Source

Thanks Mefesto11

Metro 2034v2

Thanks RaySpark

PipBoy
Source

Elektronika 5

Thanks Mefesto11

Transparency

KeyLimePie

Text (Russian lang only)
Source

Neon

Недостатки Python

noreply@blogger.com (clericJ) — Sun, 02 Sep 2012 12:08:00 +0000

В этой статье я хочу поделится своим субъективным мнением по поводу одного из моих любимых инструментов, языка программирования python.
Для начала, я пробегусь по тем "изъянам", за которые критикуют язык, люди на нём не писавшие/писавшие мало и выступлю в роли адвоката.

Явное указание self

Многим кажется дикостью, всё время ставить self первым аргументом любого метода (за исключением staticmethod и classmetod). А затем писать эти ненавистные четыре буквы перед каждым обращением к внутренностям класса. Ведь мы привыкли что этого нет ни в C++, ни в Java. Там мы пишем this, только тогда, когда захотим этого сами.
Но эти же люди забывают, что python динамический язык, компилятор или IDE вам не подскажет что произошёл конфликт имён. Представьте, вы пишете код в методе foo и завели локальную переменную bar, но в классе от которого вы отнаследовались (он к тому же может быть определён в другом модуле) уже есть атрибут с таким же именем. Думаю, долгие часы весёлой отладки, вам гарантированны. Так-же, напомню. что до того как IDE стали "умными" была популярна венгерская нотация и, для того чтобы не перепутать атрибуты метода, применялась такая запись:
m_foo
Это говорит о том, что проблема существует, но для языков со статической типизацией она решается с помощью предупреждений, выдаваемых IDE или компилятором языка.

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

Куцие lambda выражения

Что с ними не так? Спросите вы. Мне вот тоже этого не понять, но люди любящие писать большие лямбда функции ругают python, из-за того, что при написании лямбд нельзя использовать операторы (statement) такие как if, for (хотя это ограничение можно обойти используя списковые выражения и тернальный if) и даже print. Чтож, если вы программист на erlang или lisp, то я вас пойму, вы знаете всю мощь и простоту написания лямбда выражений. Но это другой язык с другой философией. И одной из главных вещей в python, является читаемость кода. Именно поэтому блоки кода отделяются отступами на уровне синтаксиса. И да, это затрудняет писать большие лямбда выражения. Но ведь всегда можно завести полноценную локальную функцию.
Например, нам нужно отсортировать список по нужным нам атрибутам, для этого мы будем использовать метод sort с собственной функцией сравнения. Для начала, напишем всё это в виде лямбда выражения:

def foo():
    self._names.sort(cmp=lambda x, y: 
                1 if self._card_data[x].level > self._card_data[y].level else 
                    -1 if self._card_data[x].level < self._card_data[y].level else 0)

Теперь запишем наш код в локальную функцию:

def foo():
    def compare(x,y):
        if self._card_data[x].level > self._card_data[y].level:
            return 1
        elif self._card_data[x].level < self._card_data[y].level
            return -1

        return 0
    self._names.sort(cmp=compare)

Изменилось не так много, оба варианта хорошо работают, но второй более читаем. Это будет особенно заметно если усложнить пример.
Лямбда функции в python используются для простых случаев и функционала тернального if и списочных выражений (list expressions) хватает для написания простой логики, если же задача требует написания большой лямбда-лапши, пишите локальную функцию. И уж поверьте, вы сами себе скажете спасибо, когда будете читать код.
В завершение приведу еще две цитаты из Zen of Python:
Простота лучше сложности.
Читаемость ценится высоко.

Форматирование кода на уровне синтаксиса

Это просто бесконечный источник для холиваров. Кому то это кажется гениальным, кто-то просто ненавидит. Думаю, это зависит от отношения человека к прекрасному, ведь идея о том что отформатированная программа - рабочая программа, хороша. Хотя для людей, привыкших выдавать море спагетти, кода она кажется дикой. Да, во всех современных IDE есть функция авто-форматирования кода, но я привык писать код сразу отформатированным и никогда не прибегал к этой функции для С++ в Visual Studio, исключая случаи работы с чужим кодом. Потому что в голове, так-же как и в коде всё должно быть структурировано и разложено по полочкам.

Многие программисты перешедшие с Perl жалуются что не могут написать однострочник и язык им навязывает делать отступы, но ведь это прекрасно! И не дай бог вам дадут поддерживать код, написанный таким человеком на языке "со скобочками"!

Язык приучает человека писать сразу отформатированный код, а не надеяться на помощь IDE.

Расхождений со стилем именования и форматирования, так же не должно быть , по одной простой причине, есть PEP8 в котором описаны все эти моменты.

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

Продолжение следует...

Pyinstaller или забудьте от таскании с собой интерпретатора

noreply@blogger.com (clericJ) — Fri, 20 Jul 2012 13:17:00 +0000

В последнее время мне часто приходится писать небольшие утилитарные приложения, которые я потом передаю другим людям для работы с ними. Соответственно python на этих машинах не установлен. А заставлять людей его ставить, тоже не очень хочется. Тут-то и возникает проблема с портабельностью приложения.

Для начала было решено писать всё на С++ (тем более я использую Qt), но мне очень не хватало батареек python`а. Поэтому я начал смотреть в сторону программ сборщиков в исполняемый файл для python.

Когда-то давно, для этих целей я пользовался zxFreeze, это безусловно отличный проект, но посмотрев документацию, я так и не нашёл способ запихать все используемые библиотеки в один единственный исполняемый файл, да и размер результатов не впечатлил. У библиотеки есть один безусловный плюс, она умеет работать с версиями python`а >= 3.0
Есть так-же проект py2exe умеющий всё что мне нужно, но, посмотрев дату последнего релиза (2008 год), я решил оставить старичка в покое.

И, наконец, герой сегодняшнего повествования, на котором я и остановил свой выбор, pyinstaller.
Важные для меня достоинства библиотеки:

Способен собрать проект под все популярные платформы (Linux, Windows, MacOS)
А так-же под 32/64 архитектуры процессора (исключение MacOS, под неё только 32bit)
Работает с версиями python от 2.2 по 2.7 включительно (для тех кому нужна работа с python 3.0, рекомендую zxFreeze)
Умеет собирать все зависимости (библиотеки python, DLL\SO файлы) в один исполняемый файл
Сжатие с помощью upx

Обо всех достоинствах вы можете прочитать на странице проекта.

Установка и настройка

Первым делом скачиваем дистрибутив пакета со страницы проекта.

Последней версией на данный момент является 1.5.1 прямая ссылка.

После скачивания и распаковки архива, пакет следует сконфигурировать, для этого переходим в директорию пакета и запускаем Configure.py

Всё, теперь мы можем им пользоваться для своих нужд.

Сборка проекта

Сборка проходит в два этапа, первым делом с помощью Makespec.py создаётся файл .spec , включающий в себя все настройки, необходимые для сборки. Следующим этапом идёт сама сборка в исполняемый файл, производимая скриптом Build.py.

Для упрощения жизни, я написал простой батник под Windows, автоматизирующий сборку:

@echo off

set progname=CardEditor
set pyinstaller_dir=D:\bin\apps\pyinstaller

%pyinstaller_dir%\Makespec.py --onefile --icon=icon.ico --name=%progname% main.py -X -c 
%pyinstaller_dir%\Build.py %progname%.spec

rd build /s /q
del warn%progname%.txt
del logdict2.6.6.final.0-1.log
del %progname%.spec
copy dist\%progname%.exe %progname%.exe
rd dist /s /q
echo.
pause

В переменные progname и pyinstaller_dir следует вписать имя проекта и путь к директории pyinstaller. Подробнее с синтаксисом команды Makespec можно ознакомится здесь.

Результирующие исполняемые файлы для небольших утилит, получились следующих размеров:
С PyQt4 - 8.35 Mb
Без Qt - 3.50 Mb

Что как я считаю, весьма недурно.

Сравнение Sublime Text 2 и Vim

noreply@blogger.com (clericJ) — Thu, 28 Jun 2012 20:47:00 +0000

На днях вышла финальная версия редактора Sublime text 2. Почитав обзоры и попробовав его в деле, я решил написать сравнительный обзор моего текущего редактора (Vim) и Sublime.

Небольшое пояснение, под Vim, я тут подразумеваю GVim/MacVim, так-как лично мне удобнее пользоваться именно GUI версиями vim`a.

Порог вхождения

Начнём с Vim`а, здесь порог вхождения несколько выше, для продуктивной работы вам понадобится изучение режимов редактора, полезных команд и сочетаний клавиш. Не обязательно учить их все, но что такое режимы и шорткаты для перехода в режим редактирования или в командный режим (я про Command Mode, а не Normal Mode), знать надо. Это я еще не затронул тему настройки vim, тут по хорошему нужно учить VimScript для написания более-менее годного конфига. Мой vimrc перевалил отметку 42кб и это не считая настроек для плагинов.
С Sublime напротив, ситуация куда лучше, все кто когда либо редактировал текст в gedit/notepad++ и т.д. освоятся быстро, сочетаний клавиш не так много, настройка осуществляется путём правки конфига на JSON.

Редактирование текста

В vim заложена концепция модульности. И уж поверьте, все его режимы придуманы не для того чтобы вы постоянно тянулись к клавише Esc, в них скрыта реальная мощь. В качестве доказательств приведу пару статей эффективное использование vim и Эффективное использование Vim, не удивляйтесь что у них одно название.
Что же нам может предложить Sublime text 2? Во первых очень удобная вещь под названием Multiple Selection, даёт возможность выбрать и редактировать одновременно несколько мест в тексте. Так-же из коробки есть авто-закрытие скобок, авто-отступы, авто-завершение кода. Еще из плюсов хочется отметить подсветку всех вхождений слова под курсором (для этого в Vim надо устанавливать плагин). Пару слов о поиске, в обоих редакторах он выполнен на отлично. Присутствует всё, что должно быть у продуктов такого класса: поиск с помощью регулярок, поиск по мере набора, поиск в файлах и так далее.

Расширяемость

Возможности обоих редакторов могут быть расширены с помощью скриптовых языков, в случае Sublime это python. Vim же даёт на выбор больше языков (python, ruby, perl) но основным является VimScript.
Однако именно в Vim интеграция более тесная, скриптовый язык это просто продолжение редактора. Любая команда или клавиатурная привязка доступна из VS. Приведу пример. В Sublime вы пишете плагины, а в Vim c помощью VimScript вы можете писать всё что угодно: файлы подсветки синтаксиса, цветовые схемы, макросы, интеграцию с компиляторами, тот же файл настроек по сути является файлом VimScript. Можно сказать что значительная часть функционала Vim написана на VimScript, и только ядро редактора это код на С.

Плагины

Естественным продолжением предыдущей темы является плагиновая система редакторов. Sublime достаточно молод и еще не обзавёлся таким количеством плагинов, которым обладает Vim. Посмотреть большинство можно здесь. На данный момент в репозитории насчитывается 440 пакета. Есть как платные, так и бесплатные. Функционал некоторых плагинов действительно впечатляет. Но я не увидел чего либо, чего нету в многотысячном репозитории плагинов для Vim. Для последнего же существует куда больше мощных плагинов, значительно расширяющих функционал редактора (используемые мной плагины описаны здесь)
Тут безусловным победителем выступает Vim. Однако с ростом популярности Sublime, ситуация может изменится.

Выводы

Sublime Text 2 Отличный текстовый редактор для программистов, сочетающий в себе приятный интерфейс (чего только стоит один minimap) и мощный функционал. Он прост в освоении и хорошо расширяем.

Vim же, со своими режимами и командами мощнейший инструмент редактирования кода. Так же к нему написана не одна сотня отличных плагинов. Но для того чтобы научится им пользоваться, может потребоваться некоторое время. Тут на любителя, если вам нравится настраивать всё под себя и учить новые методы работы с текстом, то Vim станет для вас отличным решением. Если же вам просто нужен превосходный редактор исходного кода с хорошими плагинами, то попробуйте Sublime Text 2.

P.S.

Есть еще один критерий, платность/бесплатность продукта, Vim бесплатен и открыт, Sublime напротив проприетарен и стоит 59$. Однако моё мнение такого, если вы пользуетесь инструментом каждый день и при этом он помогает вам зарабатывать себе на хлеб. То нет ничего криминального в том чтобы купить Sublime. Труд должен оплачиваться.

P.P.S.

Vim и Sublime это текстовые редакторы, я не сравниваю их с IDE, потому что это разные инструменты, призванные решать каждый свои задачи. Думаю никто в здравом уме, не сядет писать большой проект на Java, вооружившись одним перечисленных текстовых редакторов. А вот подправить код или написать небольшую утилиту на python или C++, то вполне.

CallMeNotifications - уведомления о просьбе перезвонить

noreply@blogger.com (clericJ) — Tue, 26 Jun 2012 12:55:00 +0000

Вступление

Наверное многие знают об услуге "перезвони мне" мобильных операторов (в простонародье также называемые "попрошайками" или "бомжами"). Меня всегда раздражало то, что такие СМСки копятся во входящих, мешая искать более информативные сообщения. И в один прекрасный день я решил чуточку упростить себе жизнь, а попутно познакомится с программированием под Android.

Основные цели

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

В статье мало теории, и если будет что-либо непонятно, советую почитать документацию или заглянуть на хабр.

И так, приступим, создадим в Eclipse новый проект под Android, назовём его CallMeNotifications. Соответственно, главная Activity у нас будет называться CallMeNotificationsActivity. Её мы трогать не будем, так как пользовательского интерфейса в нашем приложении практически не будет. (Я лишь добавил туда описание приложения). Теперь нам нужно отловить все СМС, которые приходят на наш мобильный.

Получение входящих СМС

В Android события, например включение Wi-Fi или входящий звонок, порождают широковещательные сообщения, таким образом, подписавшись на одно из них, мы можем среагировать на событие. В нашем случае - это входящее СМС. Для этого нам понадобится класс, наследующийся от BroadcastReceiver. Его задачей будет прослушивать широковещательные сообщения и реагировать на них в методе onReceive.

// Эти импорты понадобятся нам в будущем
import android.content.BroadcastReceiver;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.BroadcastReceiver;
import android.content.ContentResolver;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.media.Ringtone;
import android.media.RingtoneManager;
import android.net.Uri;
import android.os.Bundle;
import android.provider.BaseColumns;
import android.provider.ContactsContract;
import android.telephony.SmsMessage;
public class SmsReceiver extends BroadcastReceiver {

    // Идентификатор уведомления, понадобится нам позже
    public static int NOTIFY_ID = 0;

    @Override
    public void onReceive(Context context, Intent intent) {

    }
}

context - Представляет контекст выполнения нашего приложения, через него мы будем получать доступ к необходимым нам методам.
Объект indent хранит в себе информацию о перехваченном широковещательном сообщении.

Теперь важный момент, для того чтобы наш Receiver вызывался, нужно его где-то зарегистрировать. Есть два пути сделать это, первый прямо в коде нашего Activity:

    IntentFilter filter = new IntentFilter(
        "android.provider.Telephony.SMS_RECEIVED");

    filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
    registerReceiver(new SmsReceiver(), filter);

И второй, зарегистрировать его в AndroidManifest.xml проекта, добавив следующие строки:

    <receiver android:name=".SmsReceiver" android:exported="true" >
        <intent-filter android:priority="1000"> 
            <action android:name="android.provider.Telephony.SMS_RECEIVED" />
        </intent-filter>
    </receiver>

Последний способ более предпочтителен, потому что в этом случае наш Receiver будет срабатывать даже тогда, когда наше приложение выгружено из памяти.
Еще один важный момент, приоритет Receiver`у выставляется максимальный (1000), это нужно для того чтобы получать СМС раньше системного приложения менеджмента СМС.

Теперь нам нужно получить само СМС сообщение:

    Bundle extras = intent.getExtras();

    if (extras != null) {
        Object[] smsExtra = (Object[]) extras.get("pdus");

        // Берём только первую СМС
        SmsMessage sms = SmsMessage.createFromPdu((byte[]) smsExtra[0]);
    }

Как вы, думаю, знаете, одна СМС в Android, может состоят из нескольких физических, с помощью конструкции smsExtra[0] мы получаем лишь первую, так как больше нам и не нужно. Если вы пишете похожий код, но хотите получить полный текст СМС, то вы можете организовать здесь цикл.

Разрешения

При установке Android приложений, вы наверняка, замечали, что снизу выводятся какие разрешения просят приложения, например, доступ к личной информации или доступ в сеть. Нашему приложению для нормальной работы, так же будут нужны разрешения. Их декларации хранятся в файле AndroidManifest.xml, в корне вашего проекта. Теперь прикинем, какие нам из них понадобятся:

WRITE_SMS, READ_SMS Работа с СМС
RECEIVE_SMS приём СМС
CALL_PHONE вызов абонента
READ_CONTACTS чтение имени контакта

    <uses-permission android:name="android.permission.WRITE_SMS" />
    <uses-permission android:name="android.permission.READ_SMS" />
    <uses-permission android:name="android.permission.RECEIVE_SMS" />
    <uses-permission android:name="android.permission.CALL_PHONE"/>
    <uses-permission android:name="android.permission.READ_CONTACTS"/>

Прописываем разрешения в manifest, после строки

<uses-sdk android:minsdkversion="10"/>

Парсер

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

Мегафон:
Абонент +9370000000 просит Вас ему перезвонить
Билайн:
Этот абонент просит Вас перезвонить ему

Здесь видно, что у каждого оператора свои способы передачи номера абонента. Например, у Билайна СМС приходят от номера самого абонента, а у Мегафона номер передаётся в тексте СМС. Это нужно учитывать при написании регулярок.
Так же хранить регулярки в самом коде, не очень то и удобно, затрудняется их редактирование, плюс, после любого изменения, приходится пересобирать проект. Так что хранить регулярки мы будем в xml файле, в директории raw/res, нашего проекта. Содержимое parsersettings.xml:

<?xml version="1.0" encoding="UTF-8"?>
<settings>
    <operator name="Megafon">
        <match-pattern>(?:Абонент )((:?(:?8|\+7)[\- ]?)?(?:\(?\d{3}\)?[\- ]?)?[\d\- ]{7,10})(:? просит Вас ему перезвонить).*</match-pattern>
        <use-sender-number>0</use-sender-number>
    </operator>
    <operator name="MTS">
        <match-pattern>Перезвоните мне, пожалуйста.*Отправлено.*</match-pattern>
        <use-sender-number>1</use-sender-number>
    </operator>
    <operator name="Beeline">
        <match-pattern>Этот абонент просит Вас перезвонить ему.*</match-pattern>
        <use-sender-number>1</use-sender-number>
    </operator>
    <operator name="TELE2">
        <match-pattern>(?:Вас срочно просит перезвонить абонент )(:?(8|\+7)? ?\(?(\d{3})\)? ?(\d{3})[ -]?(\d{2})[ -]?(\d{2,3})).*</match-pattern>
        <use-sender-number>0</use-sender-number>
    </operator>
    <operator name="NSS">
        <match-pattern>Пожалуйста, перезвоните мне.*</match-pattern>
        <use-sender-number>1</use-sender-number>
    </operator>
</settings>

Элемент use-sender-number используется для указания парсеру не искать номер телефона в СМС, вместо этого воспользовавшись номером отправителя.
Добавляем класс SmsParser в проект. Его код достаточно очевиден для людей знакомых с Java.

import java.io.InputStream;

import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

import android.telephony.SmsMessage;

import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;

import java.util.regex.Pattern;
import java.util.regex.Matcher;

public class SmsParser {

    private SmsMessage message = null;
    private InputStream settings = null;
    private Boolean isCallMeSmsFlag = false;
    private String subscriberPhoneNumber = null;

    public SmsParser(SmsMessage message, InputStream settings) {
        this.message = message;
        this.settings = settings;
        parse();
    }
    private String xmlGetItem(Element element, String name) {
        return element.getElementsByTagName(name).item(0).getChildNodes()
                .item(0).getNodeValue();
    }
    private void parse() {
        try {
            DocumentBuilderFactory factory=DocumentBuilderFactory.newInstance();
            DocumentBuilder builder = factory.newDocumentBuilder();
            Document doc = builder.parse(this.settings);
            doc.getDocumentElement().normalize();

            // Старайтесь закрывать всё что открыли, во избежание утечек памяти
            this.settings.close();

            NodeList nodes = doc.getElementsByTagName(doc.getDocumentElement()
                    .getChildNodes().item(1).getNodeName());

            for (int i = 0; i &lt; nodes.getLength(); i++) {
                Node node = nodes.item(i);

                if (node.getNodeType() == Node.ELEMENT_NODE) {

                    Element element = (Element) node;
                    Pattern pattern = Pattern.compile(xmlGetItem(element,
                            "match-pattern"));

                    Integer useSenderNumber = new Integer(xmlGetItem(element,
                            "use-sender-number"));

                    // Получаем тело сообщения и номер телефона отправителя
                    String smsBody = message.getMessageBody().toString();
                    String fromNumber = message.getOriginatingAddress();

                    Matcher match = pattern.matcher(smsBody);

                    if (match.find()) {
                        isCallMeSmsFlag = true;

                        if (useSenderNumber != 0) {
                            subscriberPhoneNumber = fromNumber;
                        } else {
                            // При составлении регулярного выражения, для
                            // определения номера телефона используется группа 1
                            subscriberPhoneNumber = match.group(1);
                        }
                        return;
                    }
                }
            }
        } catch (Exception e) {
            throw new RuntimeException(e.getLocalizedMessage());
        }

    }
    public String getPhoneNumber() {
        if (subscriberPhoneNumber != null) {
            return subscriberPhoneNumber.replace(" ", "");
        } else {
            return null;
        }
    }
    public boolean isCallMeSms() {
        return isCallMeSmsFlag;
    }
}

Оповещение пользователя

Для того чтобы информировать пользователя о приходе сообщения с просьбой перезвонить, мы будем использовать оповещения в области уведомлений. Данное действие в Android реализует класс Notification.
В класс SmsReceiver добавим метод выводящий уведомления

    
    private void sendNotification(Context context, String number, String text) {

        Notification notify = new Notification(R.drawable.ic_launcher, text,
                System.currentTimeMillis());

        NotificationManager notifier = (NotificationManager) context
                .getSystemService(Context.NOTIFICATION_SERVICE);

        // Регистрируем ответное событие на нажатие
        // им у нас будет вызов абонента
        Intent toLaunch = new Intent(Intent.ACTION_CALL, Uri.parse("tel:"
                + number));
        PendingIntent intentBack = PendingIntent.getActivity(context, 0,
                toLaunch, 0);

        // Флаг закрытия уведомления, после того как на него нажали
        notify.flags |= Notification.FLAG_AUTO_CANCEL;
        // Проигрываем стандартную мелодию для оповещений
        notify.defaults |= Notification.DEFAULT_SOUND;
        notify.defaults |= Notification.DEFAULT_VIBRATE;
        notify.setLatestEventInfo(context, text,
              "Нажмите чтобы перезвонить" + number), intentBack);

        notifier.notify(NOTIFY_ID, notify);

        // Увеличиваем идентификатор, для того чтобы каждое уведомление
        // было уникальным, а не перезаписывалось предыдущим с таким же ID
        NOTIFY_ID += 1;
    }

Нам понадобится еще один вспомогательный метод для поиска абонента в телефонной книге по его номеру

    private String getContactDisplayNameByNumber(Context context, String number) {
        Uri uri = Uri.withAppendedPath(
                ContactsContract.PhoneLookup.CONTENT_FILTER_URI,
                Uri.encode(number));

        String name = "";
        ContentResolver resolver = context.getContentResolver();
        Cursor lookup = resolver.query(uri, new String[] { BaseColumns._ID,
                ContactsContract.PhoneLookup.DISPLAY_NAME }, null, null, null);

        try {
            if (lookup != null && lookup.getCount() > 0) {
                lookup.moveToNext();
                name = lookup.getString(lookup
                        .getColumnIndex(ContactsContract.Data.DISPLAY_NAME));
            }
        } finally {
            if (lookup != null) {
                lookup.close();
            }
        }
        return name;
    }

Собираем всё вместе

Осталось реализовать всю логику в методе OnReceive нашего SmsReceiver

    @Override
    public void onReceive(Context context, Intent intent) {
        Bundle extras = intent.getExtras();

        if (extras != null) {
            Object[] smsExtra = (Object[]) extras.get("pdus");

            // Берём только первую СМС
            SmsMessage sms = SmsMessage.createFromPdu((byte[]) smsExtra[0]);
            // Открываем файл с регулярными выражениями
            InputStream settings = context.getResources().openRawResource(
                    R.raw.parsersettings);

            SmsParser parser = new SmsParser(sms, settings);
            if (parser.isCallMeSms()) {

                String phoneNumber = parser.getPhoneNumber();
                String who = getContactDisplayNameByNumber(context, phoneNumber);
                if (who.isEmpty()) {
                    who = phoneNumber;
                }
                String text = who + "просит перезвонить";
                sendNotification(context, phoneNumber, text);
                this.abortBroadcast();

                playNotificationSound(context);
            }
        }

Важный момент, вызывая this.abortBroadcast(), мы отменяем широковещятельное сообщение, а значит, оно не дойдёт до системного менеджера СМС и вам не придёт уведомление о получении. В общем, всё будет так, как будто этого сообщения не было вообще.

Код на github.

Плагин pyinteractive-vim

noreply@blogger.com (clericJ) — Tue, 19 Jun 2012 20:08:00 +0000

Удобно ли вам работать во встроенном интерпретаторе python в vim`e? (для тех кто не в курсе команда :python) Не думаю. Ведь там нет многого, к чему мы привыкли в нормальных интерактивных консолях, например авто-завершения или авто-отступов. Так же всё время писать :py для ввода кода, несколько утомляет. Тут мне могут возразить, мол лучше пользоваться полноценными шелами вроде ipython. Но тогда вы не получите доступа к внутренностям vim с помощью одноимённого модуля, да и переключать всё время окошки тоже занятие не из весёлых.
Руководствуясь всеми этими причинами, я решил упростить себе жизнь и написать плагин к vim, для более комфортной работы со встроенным интерпретатором.

И так что же умеет мой плагин:

авто-завершение кода
авто-отступы при написании многострочного кода
расширенный синтаксис (похожий на ipython, например max? выведет справку)
сохранение истории сессии

Для того чтобы вызвать интерпретатор, нужно выполнить команду PyInteractiveREPL.

После чего появится стандартное приветствие python ( '>>>' ). Всё, теперь командное окно vim переключилось в режим python шелла. Для того чтобы закончить сеанс жмём <ESC>.

Важное примечание, всё что вы вводили в сеансах, сохраняется между ними.

Для авто-завершения используется <TAB>.
Совет, если вы ходите чтобы вывод вариантов авто-завершения был более информативным, советую прописать в vimrc следующее:

set wildmode=list:longest,full

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

Пример работы с pyinteractive:

:PyInteractiveREPL
>>> def inc_10(x):
...     return x+10
...
>>> inc_10(7)
17
>>> import sys
>>> sys.ex<tab> # (see pyinteractive-autocompletion)
<built-in function exit>

<ESC>

:PyInteractiveEval inc_10(11) +1
22
:PyInteractiveHistory
 in[1]: def inc_10(x):
 in[2]:     return x+10
 in[3]:
 in[4]: inc_10(7)
out[1]: 17
 in[5]: import sys
 in[6]: sys.exit
out[2]: <built-in function exit>
 in[7]: inc_10(11) +1
out[3]: 22

Видео, демонстрирующее работу плагина (старая версия)

Документация на русском

Репозиторий плагина на github

vimrc 2.0

noreply@blogger.com (clericJ) — Tue, 19 Jun 2012 11:07:00 +0000

Года два назад я уже постил свой vimrc, думаю пришло время сказать что в нём изменилось за это время. Собственно вот актуальный vimrc.

И так, что в нём нового?

Пару слов о VIM

Моя основная платформа Windows, соответственно пользуюсь я графической версией vim`а, а именно gvim`ом. Думаю это и так будет заметно при просмотре конфига. Познакомился я с этим редактором, около пяти лет назад. С тех пор постоянно дописываю в конфиг что-либо новое и удаляю устаревшее, с плагинами та-же история. Я никогда не пытался сделать из vim`а IDE, как бы он не был наворочен, это всё же текстовый редактор. Он проектировался для редактирования текста и НЕ понимает контекст программы. Те кто пишет на java работая в netbeans или eclipse думаю меня поймут. Есть конечно исключения в виде плагинов, например ropevim заставляет vim понимать контекст python`а. Но это выглядит скорее как "костыль" (хоть и очень хороший) а не глубоко интегрированная возможность. Всё это нужно понимать при использовании и не пытаться сделать из скальпеля, швейцарский нож.

Организация плагинов

Во первых теперь я пользуюсь vundle (аналог pathogen, написанный на vimscript), очень удобная штука для структурирования всех плагинов, те кто еще держит плагины в plugin/autoload/ftplugin очень советую, реально избавляет от бардака в директориях и от головной боли при удалении плагинов. Про pathogen на русском можно почитать на хабре, но советую выбрать всё же vundle, как лучший из аналогов.

Настройки для плагинов

Все настройки плагинов я перенёс из _vimrc в отдельные файлы, которые лежат в папке plugin для каждого плагина. Например есть у нас пакет (bundle в терминологии vundle) tagbar, для того чтобы посмотреть/изменить настройки этого плагина идём в $VIM/bundle/tagbar/_vimrc.vim. Теперь пару слов для чего всё это нужно, во первых чтобы не захламлять основной vimrc(он у меня и так под 40кб), и во вторых такая локализация настроек очень удобна, тут нужно просто попробовать и вы поймёте что к чему.

Один нюанс: файл с настройками должен загружаться первее самого плагина (например для того чтобы определить глобальные переменные). Для того чтобы это было так, я начинаю имя файла со знака _.

А теперь, что умеет мой vim:

Общее

навигация по коду для многих языков (tagbar) (лучшая замена taglist)
навигация по файлам проекта (nerdtree)
нечёткий поиск по файлам и буферам (ctrlp)
удобные Textmate-like сниппеты (neocomplcache-snippets-complete)
улучшенное авто-завершение (neocomplcache)
визуальные маркеры для слов и строк (visualmark, markword)
интеграция с системами контроля версий (vcscommand)
комментирование/раскомментирование всего и вся (nerdcommenter)
автозакрытие скобок (delimitMate)
подсветка ошибок на JavaScript (jsflakes)
шаблоны для новых файлов (vim-template)
проверка правописания одновременно для русского и английского языка
много чего еще по мелочи

Для python

"умное" авто-завершение кода (ropevim)
рефакторинг кода (ropevim)
шелл питона с авто-завершением и прочими плюшками (pyinteractive)
подсветка ошибок, неиспользуемых переменных и пр. в коде (pyflakes)
визуальный показ уровней отступов (vim-indent-guides)

Для C/C++

"умное" авто-завершение кода (neocomplcache-clang)
переключение от заголовочного файла к реализации и обратно (FSwitch)
проверка ошибок в коде (syntastic)
компиляция и запуск (SingleCompile)

Репозиротий на github.

Дистрибутив для Windows
(Лучший способ попробовать всё это. Требует наличия в системе установленного python 2.7)

Плюс несколько скриншотов:

Учим змею разговаривать

noreply@blogger.com (clericJ) — Thu, 10 Nov 2011 12:38:00 +0000

Читая хабр, наткнулся на интересную статью, рассказывающую о том, как научить PowerShell разговаривать с помощью Microsoft`овского Speech API (там же есть ссылка на отличную замену старому доброму Сэму). Так как ставить и осваивать PowerShell только для того чтобы побаловаться, было лениво, я занялся поисками модулей с нужным мне функционалом, под python. В итоге наткнулся на отличную библиотеку под названием pyTTS. И так приступим. Для работы нам так же понадобится: Microsoft SAPI 5.0 or 5.1 redistributable win32all Python Extensions Советую так-же скачать голос Алёна, фирмы Acapela, распространяющийся по 30-ти дневной триал лицензии Начнём с простого:

import pyTTS
tts = pyTTS.Create() 
tts.Speak("Hello World")

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

print tts.voices

Вот например, что напечаталось у меня:

{u'Alyona22k': <win32com.gen_py.Microsoft Speech Object Library.ISpeechObjectToken instance at 0x15286320>,
u'MSSam': <win32com.gen_py.Microsoft Speech Object Library.ISpeechObjectToken instance at 0x15286224>}

Видно что tts.voices это просто словарь, ключами к которому являются названия голосов. Попробуем сменить железного Сэма, на кого то с более приятным голосом:

tts.SetVoiceByName(u"Alyona22k")
tts.Speak(u"Привет мир")

Так же с помощью методов SetVolume и SetRate можно изменять громкость и скорость произношения. Поковырявшись в библиотеке, я решил написать что то, хоть мало мальски полезное, а именно, скрипт произносящий заголовки новостных лент. За основу был взят этот код. Вот что в итоге получилось:

# -*- coding: utf-8 -*-

from urllib2 import urlopen
from xml.sax import make_parser, ContentHandler
import sys
import pyTTS


class RSSHandler(ContentHandler):

    def __init__(self, tts):
        ContentHandler.__init__(self)
        self._tts = tts
        self.__initem_flag = False
        self.__intitle_flag = False


    def characters(self, data):
        if self.__intitle_flag:
            self._tts.Speak(data)
            sys.stdout.write(data.encode(sys.stdout.encoding))


    def startElement(self, tag, attrs):
        if tag == "item":
            self.__initem_flag = True

        if tag == "title" and self.__initem_flag:
            self.__intitle_flag = True


    def endElement(self, tag):
        if tag == "title" and self.__intitle_flag:
            sys.stdout.write("\n")
            self.__intitle_flag = False

        if tag == "item":
            self.__initem_flag = False


def readFeedTitle(url, tts):
    infile = urlopen(url)
    parser = make_parser()

    parser.setContentHandler(RSSHandler(tts))
    parser.parse(infile)


def main():
    tts = pyTTS.Create()

    # Если установлен голос Алёна, используем его
    # если в вашей системе есть другие русские голоса, просто поменяйте имя
    if u"Alyona22k" in tts.voices:
        tts.SetVoiceByName(u"Alyona22k")

        # прочитаем заголовки новостей с python.su на русском
        readFeedTitle("http://python.su/feeds/blog/", tts)

    # или новости с python.org голосом утстановленным по умолчанию в системе
    else:
        readFeedTitle("http://python.su/feeds/blog/", tts)


if(__name__ == '__main__'):
    main()

Tesla theme for gvim

noreply@blogger.com (clericJ) — Mon, 29 Mar 2010 19:20:00 +0000

Не так давно я делился своим конфигом для vim. Сейчас же я решил показать, тему которой пользуюсь. Подбирая цвета, я прежде всего думал о комфорте глаз.
Скачать можно отсюда.

С++ tagbar:

C++, autocomplete window:

Python, nerdtree:

Html:

О Ruby и блоках кода

noreply@blogger.com (clericJ) — Tue, 09 Mar 2010 23:45:00 +0000

Нашёл сегодня любопытную статью на хабре. Прочитав её, лишний раз убедился что для объективного сравнения двух языков, знать нужно оба...

Пример исключительности блоков кода Ruby был такой:

class Example
  @@lock = Mutex.new
 
  def example
    @@lock.synchronize do
      # разные опасные штуки
    end
  end
end

Цитата:
"Важно отметить, что synchronize — это нормальный Ruby-метод. Оригинальная версия, написанная на чистом Ruby, выглядит следующим образом:"

def synchronize
  lock
  begin
    yield
  ensure
    unlock
  end
end

Тут же утверждалось что:
"Аналогично, Python требовал использование try/finally до версии Python 2.5, когда была добавлена специальная языковая функция для обработки идиомы try/finally. В случае 2.5, объект, переданный в with, должен реализовать специальный протокол (включая методы __enter__ и __exit__), поэтому выражение with не может быть использовано как общецелевые и легковесные блоки Ruby."

Вот тут то и сказывается неосведомлённость автора о библиотеке contextmanagerlib, входящей stdlib Python'а. С её помощью synchronize будет выглядеть как обычная функция:

@contextmanager
def synchronize():
    lock()
    try:
        yield
    finally:
        unlock()

Использование тривиально:

with synchronize():
    # some code

К чему я всё это? Python и Ruby два отличных языка, с своими достоинствами и недостатками, однако незнание некоторых вещей о языке при сравнении, не должно быть его недостатком.

Мой vimrc

noreply@blogger.com (clericJ) — Thu, 05 Nov 2009 00:50:00 +0000

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


" ==============================================================================
" vim: fdm=marker fdc=2 foldlevelstart=0 sts=4 sw=4 tw=64 fileencoding=utf-8:
" Файл пользовательских настроек vim (7.3)
" Maintrainer: clericJ

"Text/Code Navigation
"    F1  Help
"    F2  Code Explorer
"    F3  Find Next
"    F4  

"Explore Buffers and Files
"    F5  Execute buffer
"    F6  Buffer Explorer
"    F7  List of Files in Directory
"    F8  File Explorer

"Manipulate Windows and Buffers
"    F9  Restore Last Session
"    F10 Toggle Fullscreen
"    F11 Close Current Window
"    F12 Delete Current Buffer

" ==============================================================================
" Установленные плагины и их зависимости {{{1
" "taglist"           просмотр списка тегов/навигатор по коду
" ( http://www.vim.org/scripts/script.php?script_id=273 )
"   util: ctags.exe
"
" "themes"
" дополнительные темы
"
" "matrix"
" для входа в матрицу ввести команду :Matrix
" ( http://www.vim.org/scripts/script.php?script_id=1189 )
"
" "fencview"
" работа с кодировками/авто-определение кодировок
" ( http://www.vim.org/scripts/script.php?script_id=1708 )
"   util: iconv.dll
"
" "NERD_commenter"
" работа с комментариями в коде
" ( http://www.vim.org/scripts/script.php?script_id=1218 )
"
" "NERD_Tree"
" просмотр файловой системы
" ( http://www.vim.org/scripts/script.php?script_id=1658 )
"
" "matchit"
" расширенная команда % для HTML, LaTX, ...
" ( http://www.vim.org/scripts/script.php?script_id=39 )
"
" "mru"
" показ последних открытых файлов
" ( http://www.vim.org/scripts/script.php?script_id=521 )
"
" "sessionman"
" удобное управление сессиями
" ( http://www.vim.org/scripts/script.php?script_id=2010 )
"
" "pyflakes"
" подсветка ошибок в коде на python на 'лету'
" ( http://www.vim.org/scripts/script.php?script_id=2441 )
" requires: python+
"
" "calendar"
" удобный календарь
" ( http://www.vim.org/scripts/script.php?script_id=52 )
"
" "fuzzyfinder"
" быстрый доступ к многим возможностям
" ( http://www.vim.org/scripts/script.php?script_id=1984 )
"
" "neocomplcache"
" улучшенное авто-завершение,
" авто-открытие списка авто-завершения, TextMate-like сниппеты
" ( http://www.vim.org/scripts/script.php?script_id=2620 )
"   util: ctags.exe 
"
" "ropevim"
" утилита для рефакторинга кода на python
" так-же включающая функции Code assist
" ( http://rope.sourceforge.net/ropevim.html )
" requires: python+
"
" "vcscommand"
" интеграция с системами контроля версий
" ( http://www.vim.org/scripts/script.php?script_id=90 )
"
" "css_color"
" Предпросмотр цветов в css файлах
" ( http://www.vim.org/scripts/script.php?script_id=2150 )
"
" "Mark"
" Подсветка всех слов в файле, которые совпадают с словом под курсором
" ( http://www.vim.org/scripts/script.php?script_id=2666 )
"
" "visualmark"
" Визуальная подсветка отметок в файле
" ( http://www.vim.org/scripts/script.php?script_id=1026 )
"
" "prettyprint"
" Печать переменных vim в более презентативном виде
" ( http://www.vim.org/scripts/script.php?script_id=2860 )
"
" "easytags"
" Автоматическая генерация и поддержание в актуальном состоянии
" файла с тэгами для ctags
" ( http://www.vim.org/scripts/script.php?script_id=3114 )
"
" "vimshell"
" Лучшая интеграция vim с системой (полноэкранный режим,
" открытие URL, фоновое выполнение системных команд)
" ( http://www.vim.org/scripts/script.php?script_id=3123 )
" }}}
" Замены стандартных файлов {{{
" syntax/python.vim     заменен
"}}}
" Изменения стандартных файлов {{{
" "plugin/sourceExplorer.vim"
" - В нескольких местах в функции SrcExpl_UpdateTags изменён формат команды exe,
"   вызывающий g:SrcExpl_updateTagsCmd:
"   было
"       exe "!" . g:SrcExpl_updateTagsCmd
"   стало
"       exe "silent!" . g:SrcExpl_updateTagsCmd
"   Изменение нужно для того чтобы команда выполнялась без
"   открытия окна терминала и не требовала нажатий Enter после
"   выполнения, т.е. выполнялась в silent режиме
" - В функции SrcExpl_ColorExpr заменена строка:
"       hi link SrcExpl_HighLight term=bold guifg=Black guibg=Magenta ctermfg=Black ctermbg=Magenta
"   на
"       hi link SrcExpl_HighLight Search
"   замена нужна для нормального отображения подсвечиваемого
"   слова в окне SourceExplorer
"
" "syntax/css.vim"
" В файл добавлен код плагина css_color
" ( http://www.vim.org/scripts/script.php?script_id=2150 )
" ==============================================================================
" "Primary"                 Приоритетные настройки {{{1
" ==============================================================================

let s:iswin = has('win32') || has('win64')
let s:lastsession_file = '~/lastsession.vim'

" Отключение совместимости с vi
set nocompatible

" Использовать англоязычное меню
set langmenu=en

if !has('python')
" Не загружать плагин, если в системе не установлен python
python << EOF
import vim
try:
    import os
except ImportError:
    vim.command('let let g:loaded_PyInteractive = 1')
EOF
endif

" ==============================================================================
" "Quick"                   Быстрые настройки {{{1
" ==============================================================================
" (0 - откл. 1 - вкл.)

" us - USer option
let s:us_folding        = 0     " Свертывание участков кода
let s:us_autosaveses    = 1     " Авто-сохранение сессий (загрузка посл. F6)
let s:us_linewrap       = 1     " Перенос длинных строк
let s:us_scratch_buffer = 0     " Сделать из безымянного буфера scratch буфер

" ==============================================================================
" "Includes"                Подключение доп.файлов настроек {{{1
" ==============================================================================

source $VIMRUNTIME/mswin.vim            " Windows-like настройки
behave mswin

" ==============================================================================
" "Basic"                   Базовые настройки {{{1
" ==============================================================================

" Включение подсветки синтаксиса
syntax on

" Включение определения типов файлов
filetype on
filetype plugin on
filetype indent on

" Отключение оповещения морганием и звуком
set novisualbell
set t_vb=

set helplang=en,ru

" Переход на предыдущую/следующую строку
set backspace=indent,eol,start

" Перемещать курсор на следующую строку при нажатии на клавиши вправо-влево и пр.
set whichwrap+=<,>,[,]

" История команд
set history=150

" Максимальное количество изменений, которые могут быть отменены
set undolevels=5000

" Не создавать резервные копии файлов
set nobackup

" Кодировка по умолчанию
set encoding=utf-8
set fileencoding=utf-8

set fileencodings=utf-8,cp1251,cp866,koi8-r

set fileformat=unix          " Формат файла по умолчанию
set fileformats=unix,dos,mac

" Не выгружать буфер, при переключении на другой
" Это позволяет редактировать несколько файлов в один и тот же момент без
" необходимости сохранения каждый раз когда переключаешься между ними
set hidden

set autoread            " Включение автоматического перечтения файла при изменении
set autochdir           " Автоматически устанавливать текущей, директорию отрытого файла
set browsedir=buffer    " Начинать обзор с каталога текущего буфера
set confirm             " Включение диалогов с запросами

" Опции авто-дополнения
set completeopt=longest,menuone

" Показывать все возможные кандидаты при авто-завершении команд
"set nowildmenu
set wildmode=list:longest,full

" Включение проверки орфографии, для русского и английского
set spelllang=ru_yo,en_us
"set spell

" Раскладка по умолчанию - английская
set iminsert=0

" Не перерисовывать окно при работе макросов
set lazyredraw

" ==============================================================================
" "View"                    Вид {{{1
" ==============================================================================

set ruler       " Включение отображения позиции курсора (всё время)

set mouse=a     " Подключение мыши
set mousehide   " Прятать указатель во время набора текста
set cursorline  " Включить подсветку текущей позиции курсора
set mousemodel=popup

if has('gui_running')

    " Шрифт по умолчанию
    if s:iswin
    set gfn=DejaVu_Sans_Mono:h10:cRUSSIAN,consolas:h11

    elseif has("gui_gtk2")
        set gfn=DejaVu\ Sans\ Mono\ 10
    endif

    " Цветовая схема по умолчанию
    colorscheme lucius

elseif s:iswin
    colorscheme desert
else
    colorscheme wombat256
endif

if s:iswin
    " Установка высоты и ширины окна
    winsize 90 30
endif

set guioptions+=b   " Включение горизонтального скролл-бара
set guioptions-=T   " Убрать toolbar
"set guioptions+=c   " Отключение графических диалогов
"set guioptions-=e   " Замена графических табов, текстовыми

set number          " Включение отображения номеров строк
set shortmess+=I    " Отключение приветственного сообщения
set showtabline=2   " Показывать по умлочанию строку со вкладками
set wildmenu        " Показывать меню в командной строке
                    " для выбора вариантов авто-дополнения
set showmatch       " Довсвечивать совпадающую скобку
set list            " Подсвечивать некоторые символы

" Установка символов для подсветки
set list listchars=tab:▹·,trail:·,extends:»,precedes:«,nbsp:×

" ==============================================================================
" "Statusline"               Статусная строка {{{1
" ==============================================================================

" Включение отображения незавершенных команд в статусной строке
set showcmd

" Всегда отображать статусную строку
set laststatus=2

hi StatusLineBufferNumber guifg=fg guibg=bg gui=bold

" Формат статусной строки
set stl+=\ %#StatusLineBufferNumber#
set stl+=[%n]    " Номер буфера
set stl+=%*\
set stl+=%<
set stl+=%f      " Имя файла загруженного в буфер
set stl+=%*\
set stl+=[%{&ft} " Тип файла, загруженного в буфер, например [cpp]
set stl+=\ \|\
set stl+=%{&fileencoding} " Кодировка файла
set stl+=\ \|\
set stl+=%{&ff}] " Формат файла
set stl+=%=      " Выравнивание по правому краю
set stl+=\
set stl+=Line:
set stl+=\ %l/   " Номер строки
set stl+=%L      " Количество строк в буфере
set stl+=\
set stl+=Col:
set stl+=\ %3v   " Номер колонки
set stl+=\
set stl+=[%P]    " Позиция текста, отображаемого в окне
                 " по отношению к началу файла в процентах
set stl+=%#error#%m%*       " Флаг состояния несохранённых изменений
set stl+=%#warningmsg#%r%*  " Флаг состояния 'только для чтения

" Показ нескольких типов предупреждений связанных с некорректной работой с
" отступами:
" "[mixed-indenting]" - В случае если в файле для задания отступов совместно
" используются пробелы и символы табуляции
" "[expandtab-disabled]" - Если опция expandtab отключена, но в файле для
" задания отступов применяются пробелы
" "[expandtab-enabled]" - Если опция expandtab активна, но для задания
" отступов используются символы табуляции
set statusline+=%#error#
set statusline+=%{StatuslineTabWarning()}
set statusline+=%*

" ==============================================================================
" "Indent"                  Отступы и табуляция {{{1
" ==============================================================================

set autoindent                          " Наследовать отступы предыдущей строки
"set smartindent                         " Включить 'умные' отступы
set expandtab                           " Преобразование таба в пробелы
set shiftwidth=4                        " Размер табуляции по умолчанию
set softtabstop=4
set tabstop=4

" ==============================================================================
" "Search"                  Поиск текста {{{1
" ==============================================================================

set hlsearch        " Включение подсветки слов при поиске
set incsearch       " Использовать поиск по мере набора

" Использовать регистра-зависимый поиск (для 
" регистра-независимого использовать \с в конце строки шаблона)
set noignorecase

" В режиме поиска используется раскладка, заданная по умолчанию
set imsearch=-1

" ==============================================================================
" "Folding"                 Свертывание блоков текста {{{1
" ==============================================================================

if s:us_folding
    " Включение складок
    set foldenable

    " Ширина колонки
    "set foldcolumn=4

    " Опция задаёт значение опции 'foldlevel' в начале редактирования нового
    " буфера в окне. Её полезно использовать для закрытия всех складок в
    " файле в начале редактирования (при значении 0), закрытия некоторых
    " складок (при значении от 1) или открывания всех складок (при значении 99)
    set foldlevelstart=99

    " Опция задаёт метод образования складок для текущего окна.
    " Список возможных значений:
    "   manual  Складки создаются вручную.
    "   indent  Складка формируется строками с одинаковыми отступами.
    "   expr    Уровень складки для строки задаётся значением опции 'foldexpr'.
    "   marker  Складки задаются с использованием маркеров.
    "   syntax  Складки задаются в соответствии с правилами подсветки синтаксиса.
    "   diff    В складки помещаются неизменённые фрагменты текста
    set foldmethod=indent

    " Опция назначает максимальное количество вложений складок для методов
    " "indent" и "syntax". Опция позволяет избежать создания слишком
    " большого количества складок. Использование значения, большего, чем 20,
    " не работает, поскольку встроенное ограничение количества вложений в
    " складках соответствует 20
    set foldnestmax=3

else
    set foldmethod=manual

endif

" ==============================================================================
" "Sessions"                Сессии {{{1
" ==============================================================================

" Опции сессий
set sessionoptions=curdir,buffers,folds,tabpages,winpos,help

" Опции помогают переносить файлы сессий с *nix`ов в ms-windows и наоборот
set sessionoptions+=unix,slash

if s:us_autosaveses
    " Авто-сохранение сессии при закрытии vim`a (загрузка F6 в норм. режиме)
    exec 'autocmd VimLeavePre * silent mksession!' . s:lastsession_file
endif

" ==============================================================================
" "LineWrap"                Перенос длинных строк {{{1
" ==============================================================================

if s:us_linewrap
    " Задать ширину строки
    "set textwidth=79

    if v:version >= 703
        " Подсвечивать границы
        set colorcolumn=80
    endif
    " Перенос по словам
    set linebreak
else
    " Запретить перенос строк
    set nowrap

    " показывать символы > или < если есть, что слева/справа строки
    set listchars+=precedes:<,extends:>

endif

" ==============================================================================
" "User Shortcuts"          Горячие клавиши {{{1
" ==============================================================================

" Открытие командной строки помощи (plugin-FuzzyFinder)
map <C-F1> :FufHelp<cr>
vmap <C-F1> <esc>:FufHelp<cr>
imap <C-F1> <esc>:FufHelp<cr>

" Список тегов (plugin-taglist)
nmap <F2> <Esc>:TlistToggle<cr>
vmap <F2> <esc>:TlistToggle<cr>
imap <F2> <esc><esc>:TlistToggle<cr>

" Найти следующее соответствие, все остальные так же подсвечиваются 
nmap <F3> :set hlsearch<CR>n
vmap <F3> <esc> :set hlsearch<CR>n i
imap <F3> <esc> :set hlsearch<CR>n i

" Отключение подсведки найденных выражений
nmap <C-F3> :nohlsearch<CR>
imap <C-F3> <Esc>:nohlsearch<CR>
vmap <C-F3> <Esc>:nohlsearchi<CR>gv

" Выполнение/Открытие файла
nmap <F5> <esc>:call <SID>OpenFileInDefaultApp()<cr>
vmap <F5> <esc>:call <SID>OpenFileInDefaultApp()<cr>i
imap <F5> <esc><esc>:call <SID>OpenFileInDefaultApp()<cr>i

" Просмотр списка буферов (plugin-fuzzyfinder)
map <F6> :FufBuffer<cr>
vmap <F6> <esc>:FufBuffer<cr>
imap <F6> <esc>:FufBuffer<cr>


" Список файлов в текущей директории (plugin-fuzzyfinder)
nmap <F7> <esc>:FufFile<cr>
vmap <F7> <esc>:FufFile<cr>
imap <F7> <esc>:FufFile<cr>

"" Навигатор по коду (plugin-sourceExplorer)
"map <F8> :SrcExplToggle<cr>
"vmap <F8> <esc>:SrcExplToggle<cr>
"imap <F8> <esc>:SrcExplToggle<cr>

"" Обновление файла тегов для CodeExplorer (plugin-sourceExplorer)
"map <C-F8> :call g:SrcExpl_UpdateTags()<cr>
"vmap <C-F8> <esc>:call g:SrcExpl_UpdateTags()<cr>i
"imap <C-F8> <esc>:call g:SrcExpl_UpdateTags()<cr>i

" Обозреватель файлов (plugin-NERD_Tree)
map <F8> :NERDTreeToggle<cr>
vmap <F8> <esc>:NERDTreeToggle<cr>
imap <F8> <esc>:NERDTreeToggle<cr>

" Загрузка последней сессии (работает если в
" секции "Сессии" определена команда авто-сохранения)
if s:us_autosaveses
    exec 'nmap <F9> <esc>:source ' . s:lastsession_file . '<cr>'
    exec 'vmap <F9> <esc>:source ' . s:lastsession_file . '<cr>'
    exec 'imap <F9> <esc>:source ' . s:lastsession_file . '<cr>i'
endif

" Полноэкранный режим (plugin-vimshell)
inoremap <F10> <C-o>:Fullscreen<CR>
nnoremap <F10> :Fullscreen<CR>

" Закрыть окно
map <F11> :close<cr>
vmap <F11> <esc>:close<cr>i
imap <F11> <esc>:close<cr>i

" Удалить буфер
map <F12> :bdelete<cr>
vmap <F12> <esc>:bdelete<cr>
imap <F12> <esc>:bdelete<cr>


" Создать базу данных для файлов в текущей директории
map <C-F12> :!ctags -R --c++-kinds=+p --fields=+iaS --extra=+q .<CR>

" CTRL+Space для автозавершения (plugin-neocomplcache)
imap <C-Space> <C-X><C-U>

" Использование rope code assist, вместо omni completion
" для файлов python при нажатии CTRL+Space
" (plugin-ropevim)
""au FileType python imap <buffer> <C-space> <C-R>=RopeCodeAssistInsertMode()<cr>


" Добавление(Ctrl+Tab)/удаление(Ctrl+Shift+Tab) отступов
" работает только если выделить текст
map  ]v          [[V]]
"map  <C-S-tab>   [[V]]<
vmap <C-S-tab>   <
"map  <C-tab>     [[V]]>
vmap <C-tab>     >

" Раскрыть сниппет/переход по сниппету (plugin-neocomplcache)
imap <silent><C-j> <Plug>(neocomplcache_snippets_expand)
smap <silent><C-j> <Plug>(neocomplcache_snippets_expand)

" Поставить/убрать отметку перейти к следующей/предыдущей
" отметке (plugin-visualmark)
nmap mm <Plug>Vm_toggle_sign
nmap mn <Plug>Vm_goto_next_sign
nmap mp <Plug>Vm_goto_prev_sign

" Пометить/убрать все слова совподающие со словом под курсором (plugin-Mark)
nmap <silent>mw :call mark#MarkCurrentWord()<CR>

" Установка быстрой помощи по K для слова под курсором с помощью pydoc
" для файлов python (plugin-ropevim)
au FileType python nmap <buffer> <S-K> :call RopeShowDoc()<CR>

" Переход к определению для файлов python по gd выполняется с
" помощью rope (Plugin-ropevim)
au FileType python nmap <buffer> gd :call RopeGotoDefinition()<CR>

" Комбинации оставленные по умолчанию:
"
"vis \cc    комментирование выделенного участка кода (plugin-NERD_commenter)
"vis \cu    разкомментирование выделенного участка кода (plugin-NERD_commenter)

" ==============================================================================
" "Menu"                    Меню {{{1
" ==============================================================================

" Работа с макросами
menu Tools.Macro.Record<tab>qm qm
imenu Tools.Macro.Record<tab>qm <esc>qm

menu Tools.Macro.Stop<tab>q q
imenu Tools.Macro.Stop<tab>q <esc>q

menu Tools.Macro.Run\ Last<tab>@m <esc>@m
imenu Tools.Macro.Run\ Last<tab>@m <esc>@m

" Открытие файла программой связанной с файлом
menu <silent> Run.Run<tab>\<F5> :call <SID>OpenFileInDefaultApp()<cr>
imenu <silent> Run.Run<tab>\<F5> <esc>:call <SID>OpenFileInDefaultApp()<cr>i

" Получение командной строки
menu <silent> Run.Command\ Line\ Parameters\ \.\.\. :call <SID>GetCmdline()<cr>
imenu <silent> Run.Command\ Line\ Parameters\ \.\.\. <ESC>:call <SID>GetCmdline()<cr>i

"Открытие/закрытие окна taglist (plugin-taglist)
menu <silent> Plugin.Tag\ List<tab><F2> :TlistToggle<cr>
imenu <silent> Plugin.Tag\ List<tab><F2> <ESC>:TlistToggle<cr>i

" Открытие/закрытие окна NERD_Tree (plugin-NERD_Tree)
menu <silent> Plugin.File\ Explorer<tab><F8> :NERDTreeToggle<cr>
imenu <silent> Plugin.File\ Explorer<tab><F8> <ESC>:NERDTreeToggle<cr>

" Меню плагина Fuzzy Finder (plugin-fuzzyFinder)
menu <silent> Plugin.Fuzzy\ Finder.Buffer<tab><F6> <ESC>:FufBuffer<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Buffer<tab><F6> <ESC>:FufBuffer<cr>

menu <silent> Plugin.Fuzzy\ Finder.File<tab><F7> <ESC>:FufFile<cr>
imenu <silent> Plugin.Fuzzy\ Finder.File<tab><F7> <ESC>:FufFile<cr>

menu <silent> Plugin.Fuzzy\ Finder.Dir  <esc>:FufDir<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Dir <esc>:FufDir<cr>

menu <silent> Plugin.Fuzzy\ Finder.MRU-File <esc>:FufMruFile<cr>
imenu <silent> Plugin.Fuzzy\ Finder.MRU-File <esc>:FufMruFile<cr>

menu <silent> Plugin.Fuzzy\ Finder.MRU-Command <esc>:FufMruCmd<cr>
imenu <silent> Plugin.Fuzzy\ Finder.MRU-Command <esc>:FufMruCmd<cr>

menu <silent> Plugin.Fuzzy\ Finder.Bookmark <esc>:FufBookmark<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Bookmark <esc>:FufBookmark<cr>

menu <silent> Plugin.Fuzzy\ Finder.Tag <esc>:FufTag<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Tag <esc>:FufTag<cr>

menu <silent> Plugin.Fuzzy\ Finder.Tagged\ File <esc>:FufTaggedFile<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Tagged\ File <esc>:FufTaggedFile<cr>

menu <silent> Plugin.Fuzzy\ Finder.Jump\ List <esc>: FufJumpList<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Jump\ List <esc>: FufJumpList<cr>

menu <silent> Plugin.Fuzzy\ Finder.Change\ List <esc>: FufChangeList<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Change\ List <esc>: FufChangeList<cr>

menu <silent> Plugin.Fuzzy\ Finder.Quickfix <esc>: FufQuickfix<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Quickfix <esc>: FufQuickfix<cr>

menu <silent> Plugin.Fuzzy\ Finder.Line <esc>: FufLine<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Line <esc>: FufLine<cr>

menu <silent> Plugin.Fuzzy\ Finder.Help<tab><Ctrl-F1> <ESC>: FufHelp<cr>
imenu <silent> Plugin.Fuzzy\ Finder.Help<tab><Ctrl-F1> <ESC>: FufHelp<cr>

" Загрузка последней сессии
" (работает если в секции "Сессии" определена команда авто-сохранения)
if s:us_autosaveses
    exec 'menu File.Load\ Last\ Session<tab><F6> :source'.s:lastsession_file.'<cr>'
    exec 'imenu File.Load\ Last\ Session<tab><F6> :source'.s:lastsession_file.'<cr>'
endif

" Переключение окна календаря (plugin-calendar)
menu .990 Plugin.Calendar <esc>:Calendar<cr>
imenu .990 Plugin.Calendar <esc>:Calendar<cr>

menu .998 Plugin.-usrsep99- :

" Обновление плагинов (plugin-getscript)
amenu .999 Plugin.Check\ Updates <esc>:GetLatestVimScripts<cr>

" Полноэкранный режим (plugin-vimshell)
amenu .998 Window.-usrsep99- :
amenu .999 Window.Toggle\ Fullscreen<tab><F10> <esc>:Fullscreen<cr>


" ==============================================================================
" "Popup-menu"              Всплывающее меню {{{1
" ==============================================================================

" ( plugin-vimshell )
vmenu .1 PopUp.Open <esc> :call xolox#shell#open_cmd(GetSelection())<cr>
vmenu .1 PopUp.-Usrsep1- :

amenu PopUp.-Usrsep1- :

" Работа с метками (plugin-visualmark)
nmenu PopUp.Mark.Set\ Mark<tab>mm <esc>mm

" Перемещение по меткам (plugin-visualmark)
nmenu PopUp.Mark.Next\ Mark<tab>mn <esc>mn
nmenu PopUp.Mark.Prev\ Mark<tab>mp <esc>mp

amenu PopUp.Mark.-Usrsep1- :

" Пометить/убрать все слова совподающие со словом под курсором (plugin-Mark)
imenu PopUp.Mark.Mark\ Words<tab>mw <esc>mw
nmenu PopUp.Mark.Mark\ Words<tab>mw <esc>mw

" Перемещение по меткам (plugin-Mark)
nmenu PopUp.Mark.Next\ Word<tab>\\* <esc>\*
imenu PopUp.Mark.Next\ Word<tab>\\* <esc>\*

" Переключение всплывающего меню neocomplcache
" (plugin-neocomplcache)
"nmenu PopUp.Toggle\ Neo\ PopUp\ menu :NeoComplCacheToggle<cr>
"imenu PopUp.Toggle\ Neo\ PopUp\ menu <esc>:NeoComplCacheToggle<cr>i

" Комментирование/раз комментирование участков текста
" (plugin-NERDCommenter)
nmenu PopUp.Source\ Code.Comment :call NERDComment(0,  "alignLeft")<CR>
vmenu PopUp.Source\ Code.Comment <ESC>:call NERDComment(1, "alignLeft")<CR>

nmenu PopUp.Source\ Code.Uncomment :call NERDComment(0, "uncomment")<CR>
vmenu PopUp.Source\ Code.Uncomment <ESC>:call NERDComment(1,  "uncomment")<CR>

nmenu PopUp.Source\ Code.Toggle :call NERDComment(0, "toggle")<CR>
vmenu PopUp.Source\ Code.Toggle <ESC>:call NERDComment(1,  "toggle")<CR>

vmenu PopUp.Source\ Code.-Usrsep1- :

" Добавление/удаление отступов к участкам кода
" (соотв. горячие клавиши клавиши должны быть определенны)
"nmenu <silent> PopUp.Source\ Code.Indent\ Block<tab><Ctrl-Tab> <C-tab>
vmenu <silent> PopUp.Source\ Code.Indent\ Block<tab><C-Tab> <C-tab>

"nmenu <silent>  PopUp.Source\ Code.Dedent\ Block<tab><C-S-Tab> <C-S-tab>
vmenu <silent>  PopUp.Source\ Code.Dedent\ Block<tab><C-S-Tab> <C-S-tab>

nmenu PopUp.Util.Context\ Help<tab><S-k> <S-k>
vmenu PopUp.Util.Context\ Help<tab><S-k> <esc><S-k>

" Открыть файл, в качестве имени используется слово под курсором
nmenu PopUp.Util.Open\ File\ Under\ Cursor<tab>gf gf
vmenu PopUp.Util.Open\ File\ Under\ Cursor<tab>gf gf

nmenu PopUp.Util.Jump\ Tag\ Under\ Cursor<tab><C-]> g<C-]>
vmenu PopUp.Util.Jump\ Tag\ Under\ Cursor<tab><C-]> g<C-]>

" Удалить лишние пробельные символы
nmenu <silent>  PopUp.Util.Clean\ Extra\ Spaces :call <SID>TrimWhiteSpace()<CR>

vmenu PopUp.Util.-Usrsep3- :

" Изменение регистра символов
vmenu PopUp.Util.Upper\ Case<tab>U U
vmenu PopUp.Util.Lower\ Case<tab>u u
vmenu PopUp.Util.Swap\ Case<tab>~ ~

au MenuPopup * call ToggleFTContextMenu("python","menu","PopUp.-Usrsep4-",":")

" Показ документации по объекту python над которым находится курсор
" (plugin-ropevim)
au MenuPopup * call ToggleFTContextMenu("python","nmenu","PopUp.Show\\ Documentation<tab><S-k>","RopeShowDoc()")
au MenuPopup * call ToggleFTContextMenu("python","imenu","PopUp.Show\\ Documentation><S-k>","RopeShowDoc()")

" Поиск места определения объекта под курсором (plugin-ropevim)
au MenuPopup * call ToggleFTContextMenu("python","imenu","PopUp.Goto\\ Definition<tab>gd","RopeGotoDefinition()")
au MenuPopup * call ToggleFTContextMenu("python","nmenu","PopUp.Goto\\ Definition<tab>gd","RopeGotoDefinition()")

" Поиск всех мест где используется объект, находящийся под
" курсором (plugin-ropevim)
au MenuPopup * call ToggleFTContextMenu("python","imenu","PopUp.Find\\ Occurrences","RopeFindOccurrences()")
au MenuPopup * call ToggleFTContextMenu("python","nmenu","PopUp.Find\\ Occurrences","RopeFindOccurrences()")

" Выполнить выделенный код (plugin-pyinteractive)
au MenuPopup * call ToggleFTContextMenu("python","vmenu","PopUp.Evaluate", "pyinteractive#EvaluateSelected(visualmode())")

" ==============================================================================
" "Plugin.TList"            {{{1
" ==============================================================================

let g:Tlist_Show_Menu = 0           " Показывать меню (0-выкл/1-вкл)
let g:Tlist_Show_One_File = 1       " Показывать список тегов только из текущего файла
let g:Tlist_Enable_Fold_Column = 0  " Показывать колонку свёртки (folding)

" ==============================================================================
" "Plugin.NERDTree"         {{{1
" ==============================================================================

" Установить положение окна NERDTree, "left" или "right"
let NERDTreeWinPos = 'right'

let NERDTreeShowBookmarks = 1
let NERDTreeIgnore = ['\~$', '*.pyc', '*.pyo']
let NERDChristmasTree = 0

" ==============================================================================
" "Plugin.SourceExplorer"   {{{1
" ==============================================================================

" Установка ширины окна SourceExplorer
let g:SrcExpl_winHeight = 8

" Интервал в миллисекундах (ms) для следующего обновления окна
let g:SrcExpl_refreshTime = 100

" Установка клавиши отвечающей за переход
" определению, по умолчанию "Enter"
let g:SrcExpl_jumpKey = "<ENTER>"

" Установка клавиши отвечающий за обратный переход от
" определения, назад к коду, по умолчанию "Space"
let g:SrcExpl_gobackKey = "<SPACE>"

" // In order to Avoid conflicts, the Source Explorer should know what plugins
" // are using buffers. And you need add their bufname into the list below
" // according to the command ":buffers!"
let g:SrcExpl_pluginList = [
        \ "__Tag_List__",
        \ "_NERD_tree_",
        \ "Source_Explorer"
    \ ]
" // Enable/Disable the local definition searching, and note that this is not
" // guaranteed to work, the Source Explorer doesn't check the syntax for now.
" // It only searches for a match with the keyword according to command 'gd'
let g:SrcExpl_searchLocalDef = 1

" Включение опции обновления файла тегов во время открытия окна
" Source Explorer
let g:SrcExpl_isUpdateTags = 1

" Параметры вызова ctags
let g:SrcExpl_updateTagsCmd = "ctags --sort=foldcase -R ."

" Автоматическое обновление файла тегов, после сохранения текущего файла
autocmd BufWritePost * :execute "silent!" . g:SrcExpl_updateTagsCmd

" ==============================================================================
" "Plugin.MRU" {{{1
" ==============================================================================

" Задание количества отображаемых в меню файлов
let g:MRU_Max_Entries = 10

" ==============================================================================
" "Plugin.GetLastestVimScripts" {{{1
" ==============================================================================

" Отключение авто-инсталляции скачанных скриптов
let g:GetLatestVimScripts_allowautoinstall= 0

" ==============================================================================
" "Plugin.neocomplcache" {{{1
" ==============================================================================

let g:neocomplcache_enable_at_startup = 1
let g:neocomplcache_min_syntax_length = 3
let g:neocomplcache_enable_ignore_case = 0

" Если не выставить эту опцию то вырезание а затем вставка (в insert mode)
" через виндовые хоткеи страшно глючит
let g:neocomplcache_disable_select_mode_mappings = 1

" Включение/отключение автоматики Активация по Ctrl+Space
let g:neocomplcache_disable_auto_complete = 0

" ==============================================================================
" "Plugin.ropevim" {{{1
" ==============================================================================

let g:ropevim_vim_completion = 1

" ==============================================================================
" "Plugin.pythoncyntax" {{{1
" ==============================================================================

" Настройка подсветки синтаксиса для python (работает для
" расширенного syntax файла python)
let g:python_highlight_all = 1
let g:python_highlight_indent_errors = 0
let g:python_highlight_space_errors = 0
let g:python_highlight_doctests = 0

" ==============================================================================
" "Plugin.tohtml" {{{1
" ==============================================================================

let g:html_use_css = 1      " Использовать CSS1
let g:html_number_lines = 0 " При генерации не добавлять номера строк
let g:use_xhtml = 1         " Использовать XHTML

" ==============================================================================
" "Plugin.Calendar" {{{1
" ==============================================================================

let g:calendar_monday = 1   " Неделя начинается с понедельника

" ==============================================================================
" "Plugin.vimshell" {{{1
" ==============================================================================

" Отключение клавиатурных привязок плагина
let g:shell_mappings_enabled = 0

" ==============================================================================
" "Functions"               Пользовательские функции {{{1
" ==============================================================================

let s:cmdline = ""

" Открытие файла приложением определённым по умолчанию
function! s:OpenFileInDefaultApp()
    if s:cmdline == ""
        execute '!"%"'
        "execute 'call system(shellescape(expand("<cfile>") ' . s:cmdline . '))'
    else
        execute '!"% ' . s:cmdline . '"'
    endif
endfunction

" Получение от пользователя командной строки с которой будет запускаться
" скрипт
function! <SID>GetCmdline()
    let s:cmdline=inputdialog("Enter command line parameters:", s:cmdline, s:cmdline)
endfunction

" Регистрация\удаление контекстного меню для конкретного типа файла
" lang (str)            - тип файла (например xml)
" menucommand (str)     - команда меню (например imenu)
" menuitem (str)        - название пункта меню
" action (str)          - функция выполняющая действие при
"                         активации пункта меню
function! ToggleFTContextMenu(lang, menucommand, menuitem, action)
    let command = a:menucommand . " " . a:menuitem . " <ESC>:call " . a:action . "<CR>"
    if &filetype == a:lang
        execute command
    else
        execute "silent! aunmenu " . a:menuitem
    endif
endfunction

" Удаление лишних пробелов в файле
function! <SID>TrimWhiteSpace()
    normal ma
    :retab
    :%s/\s\+$//eg
    normal 'a
endfunction

" Функция возвращает выделенный текст
function! GetSelection()
    " "unused"
        let l:line = getline("'<")
        let l:line = strpart(l:line, col("'<") - 1, col("'>") - col("'<") + 1)
        return l:line
endfunction

"recalculate the tab warning flag when idle and after writing
autocmd cursorhold,bufwritepost * unlet! b:statusline_tab_warning

" Функция возвращает "[mixed-indenting]" если для отступов в
" файле совместно используются пробелы и символы табуляции.
" Если же выставлена опция "expandtab" и в файле присутствуют
" символы табуляции то возвращаемое значение будет "[expandtab-enabled]".
" Так же в противоположном случае: если опция "expandtab" не задана
" но в файле для отступов используются пробелы возвращаемым
" значением будет "[expandtab-disabled]". В остальных случаях
" результатом функции будет пустая строка
function! StatuslineTabWarning()
    if !exists("b:statusline_tab_warning")
        let b:statusline_tab_warning = ''

        if !&modifiable
            return b:statusline_tab_warning
        endif

        let tabs = search('^\t', 'nw') != 0

        "find spaces that arent used as alignment in the first indent column
        let spaces = search('^ \{' . &ts . ',}[^\t]', 'nw') != 0

        if tabs && spaces
            let b:statusline_tab_warning = '[mixed-indenting]'
        elseif (spaces && !&expandtab)
            let b:statusline_tab_warning = '[expandtab-disabled]'
        elseif (tabs && &expandtab)
            let b:statusline_tab_warning = '[expandtab-enabled]'
        else
            let b:statusline_tab_warning = ''
        endif
    endif
    return b:statusline_tab_warning
endfunction

" Сделать из безымянного буфера scratch буфер
if s:us_scratch_buffer
    augroup vimrc-scratch-buffer
        autocmd!
        autocmd BufEnter * call s:scratch_buffer()
        autocmd FileType qfreplace autocmd! vimrc-scratch * <buffer>

        function! s:scratch_buffer()
            if exists('b:scratch_buffer') || bufname('%') != '' || &l:buftype != ''
                return
            endif
            let b:scratch_buffer = 1
            setlocal buftype=nofile nobuflisted noswapfile bufhidden=hide

            augroup vimrc-scratch
                autocmd! * <buffer>
                autocmd BufWriteCmd <buffer> call s:scratch_on_BufWriteCmd()
            augroup END
        endfunction

        function! s:scratch_on_BufWriteCmd()
            silent! setl buftype< buflisted< swapfile< bufhidden< nomodified
            autocmd! vimrc-scratch * <buffer>
            unlet! b:scratch_buffer
            execute 'saveas' . (v:cmdbang ? '!' : '') ' <afile>'
            filetype detect
        endfunction
    augroup END
endif
"function! PythonVarInfoBalloonExpr()
"    if &filetype!="python"
"        return ""
"    endif
"    v:beval_text
"endfunction

"set bexpr=PythonVarInfoBalloonExpr()
"set ballooneval

" ==============================================================================
" "Fix"                     Способы устранения непоняток с настройками {{{1
"
" Узнать из какого файла переменная была установлена посл. раз
"   :verbose set переменная
"
" Список всех переменных
"   :let
"
" Список всех пользовательских функций
"   :function
"
" Список всех привязок
"   :map
"
" Показывает значения всех опций, которые отличаются от настроек по умолчанию.
"   :set
" ==============================================================================
"}}}

Vim-SnippetsEmu автоматический выбор файла со сниппетами

noreply@blogger.com (clericJ) — Fri, 12 Jun 2009 08:53:00 +0000

Работая в Vim, я активно пользуюсь замечательным плагином SnippetsEmu позволяющим вставлять шаблоны кода. Но одно меня всегда раздражало, файл со сниппетами для определённого языка, приходиться выбирать вручную, делается это командой :source <путь к файлу со сниппетами> или из меню.
Те кто пользуется этим редактором, знают на сколько он расширяем, поэтому данная проблема решается кодом в .vimrc:

" Автоматический выбор подходящего файла со сниппетами (plugin-snippetsEmu)
function LoadFileTypeSnippets(ftype)
    for def_file in split(globpath(&rtp, "after/ftplugin/*_snippets.vim"), '\n')
        let snip = substitute(def_file, '.*[\\/]\(.*\)_snippets.vim', '\1', '')
        if a:ftype == snip
            exec ":source ".def_file
            break
        endif
    endfor
endfunction

" Регистрация вызова функции при смене типа файла
autocmd FileType * :call LoadFileTypeSnippets(expand(""))

Перегрузка функций в python

noreply@blogger.com (clericJ) — Tue, 19 May 2009 08:54:00 +0000

Так уж случилось что пришел я к python'у из мира С++, Как и многие "эмигранты" в начале своего изучения языка, я пытался писать на нем как на С++. Именно тогда мне не хватало перегрузки функций, особенно это чувствовалось в конструкторах. Позже, освоившись с дизайном языка, в таких случаях я стал использовать именованные параметры (keyword parameters) или просто начал давать разные имена функциям. Разберёмся с ситуацией на примере.

Задача - нам нужно написать функцию inspect_object, которая бы печатала различные данные об объекте переданном ей в первом аргументе. Например, если мы знаем, что аргументом является функция, дополнительно мы можем вывести её сигнатуру. У нас есть 2 очевидных варианта реализации, засунуть проверку на тип внутрь функции (куча if`ов) или же написать по функции на объект.

1-вый вариант:

import types, inspect

def inspect_object(obj):
   print "repr:", repr(obj)

   if isinstance(obj, types.FunctionType):
       print "sign:", (obj.__name__ + inspect.formatargspec(
                       *inspect.getargspec(obj)))

   elif isinstance(obj, types.ModuleType):
       print "file:", obj.__file__

И 2-ой:

import inspect

def inspect_object(obj):
   print "repr:", repr(obj)

def inspect_func(obj):
   print "repr:", repr(obj)
   print "sign:", (obj.__name__ + inspect.formatargspec(
                   *inspect.getargspec(obj)))

def inspect_module(obj):
   print "repr:", repr(obj)
   print "file:", obj.__file__

Сразу скажу, оба они ужасны. Но первый хоть и плохо расширяем, но всё же более предпочтителен, так как не требует знания типа объекта при вызове функции.
Вот тут то и не хватает перегрузки функций, которая элегантным образом решила бы проблему. В Python 3.0 собирались ввести стандартный модуль overloading но дело не заладилось (подробности). Судя по PEP`у, в модуле должно было быть реализовано много вкусностей (обобщенные функции, перегрузка, интерфейсы и т.д.). Библиотека должна была использовать аннотации функций появившиеся в новой версии python'а, а смотрелось бы это на нашем примере так:

import types, inspect
from overloading import overload

# обобщенная функция
def inspect_object(obj):
   print "repr:", repr(obj)

@overload
def inspect_object(module: types.ModuleType):
   print "repr:", repr(module)
   print "file:", module.__file__

@overload
def inspect_object(function: types.FunctionType):
   print "repr:", repr(function)
   print "sign:", (function.__name__ + inspect.formatargspec(
       *inspect.getargspec(function)))

Этот код понятен и легко расширяем, ведь легче написать новую специализированную функцию чем рыться во всех этих if`ах. (более аргументированные объяснения, чем подход с специализированными функциями лучше, ручного выбора с помощью if`ов, можно почитать в любой хорошей книжке по C++ или в том же PEP-3107)
Но к сожалению библиотеку так и не реализовали до базового функционала.

Мне давно была интересна эта тема и после того как я узнал что PEP всё таки отложили на неопределённое время, я решился на написание собственного ~~велосипеда~~ реализации. В ней нет и половины возможностей и расширяемости первоисточника, но я писал её скорее для фана. В моём представлении она должна выполнять свою основную задачу, добавлять в язык перегрузку функций, основанную на типах аргументов, максимально близкую к реализации оной из C++. Т.е. от идеи включения в библиотеку реализации интерфейсов и прочего функционала, я отказался, сосредоточившись на перегрузке. Так как писал я библиотеку на чистом python`е и поиск функций происходит в runtime, то старался максимально сократить время поиска среди кандидатов, подходящей функции (Phillip J. Eby, автор PEP`а и библиотеки PEAK для оптимизации использовал Bytecode Assembler, а это сильная магия:)). Всё таки Python 3.0 еще будущее, а настоящим сейчас является ветка 2.x, в которой нет аннотаций для функций. Так что синтаксис немного видоизменился, тип аргумента передаётся декоратору overload в качестве параметра, первый тип ассоциируется с первым параметром декорируемой функции, второй со вторым, и т.д.
Наш пример, использующий библиотеку, выглядит так:

import types, inspect
from overloading import overload

# обобщенная функция
def inspect_object(obj):
    print "repr:", repr(obj)

@overload(types.ModuleType)
def inspect_object(module):
    print "repr:", repr(module)
    print "file:", module.__file__

@overload(types.FunctionType)
def inspect_object(function):
    print "repr:", repr(function)
    print "sign:", (function.__name__ + inspect.formatargspec(
        *inspect.getargspec(function)))

В случае если вы не хотите типизировать один из параметров функции, можно поставить в место типа object, ведь библиотека поддерживает полиморфизм.

Не буду пересказывать все достоинства и недостатки библиотеки, так как всё это разжевано в документации, для заинтересовавшихся ссылка на страницу проекта

А что если не было бы таких вещей как instancemethod...

noreply@blogger.com (clericJ) — Wed, 22 Apr 2009 13:03:00 +0000

Иногда мне в голову приходят бредовые идеи, которые однако помогают мне отдыхать от реальных задач, и одна из таких идей - а что если в python`е не было бы таких вещей как instancemethod? И пришлось бы писать примерно в таком духе:

class A(object):

  def hello(self):
       print self, "hello"

a=A()
a.hello(a)

Я понимаю что всемогущий Гвидо может покарать меня молнией за богохульство:), но всё же, это интересная практика (оговорюсь, на конструкторы и дескрипторы сие ужасающее правило не действует).

Шаг первый, напишем дескриптор method, по семантике схожий с instancemethod, который будет оборачивать все методы, объявленные в классе.

import functools

class method(object):

   def __init__(self, func):
       self.func =  func

   def __get__(self, instance, owner):
       return functools.partial(self.func, instance)

тут в методе __get__, мы используем реализацию карринга, из модуля functools (по другому это можно записать так, lambda *args, **kwargs: instance, *args, **kwargs) для связывания первого аргумента с экземпляром класса (тот самый self), и возвращаем уже связанную функцию.

Второе, нам нужна тестовая функция, давайте же напишем её:

def hello(self):
     print self, "hello"

Шаг третий, определить класс в котором с помощью дескриптора объявить наш новый метод:

class A(object):

   hm = method(hello)

попробуем:

>> a=A()
>> a.hello() # и вауля, работает!
<__main__.A object at 0x00......> hello

однако с помощью декораторов можно сделать так чтобы метод определялся на месте, а не заворачивался потом:

class A(object):
   @method
   def hello(self):
       print self, "hello"

тут важно понять что method не декоратор в привычном его понимании, в качестве декораторов часто служат функции или классы с методом __call__. Однако python динамический язык, поэтому декоратором может быть всё что отвечает простому требованию - это что-то можно вызвать (для method, это конструктор в который и передаётся функция hello), при декорировании и оно должно вернуть некий результат при вызове - тут происходит вот что, hello заворачивается в дескриптор method, а когда происходит вызов hello срабатывает метод __get__ дескриптора, который в свою очередь возвращает функцию, первый параметр которой уже предопределен. Кстати декораторы classmethod и staticmethod тоже являются дескрипторами.

И так, этот вариант почти идеален, однако нет предела совершенству, для того чтобы всё смотрелось как в настоящем python`е, а не в том что я себе выдумал, осталось только избавится от декоратора, и запись станет привычной. Добиться этого можно с помощью метакласса, который автоматически будет заворачивать все функции определенные в классе в дескриптор method, реализация тривиальна:

import types

class NewObjectMeta(type):

   def __init__(cls, clsname, bases, namespace):
       for name, attr in namespace.iteritems():
           if not issubclass(type(name), types.FunctionType):
               continue
     
           setattr(cls, name, method(attr))

# Для удобства определим класс с уже определенным метаклассом
class NewObject(object):
     __metaclass__ = NewObjectMeta

проверим:

class A(NewObject):

   def hello(self):
       print self, "hello"


>> a=A()
>> a.hello()
<__main__.A object hello at 0x00......>

всё работает как и ожидалось, хотя если вы замените NewObject, на стандартный object, в своём нормальном питоне, вывод на консоль будет одним и тем же

p.s: Задача разумеется бредовая, но с её помощью можно показать такие вещи как дескритпоры, декораторы и метаклассы, да и практиковатся нужно, как можно чаще :)