Neutron

Neutron
Информация
Сайт:	ejabberd.jabber.ru/neutron
Язык:	Python
Библиотека:	xmpppy
Лицензия:	GPL
Разработчик:	Майк Минтц (Mike Mintz)
Характеристики
Мультиязычность:	нет
Расширяемость:	да
Discovery:	нет
Ad-hoc команды:	нет

Neutron - бот на Python, умеющий проводить опросы, показывать RSS-фиды, а также ряд других действий. Удобен для быстрого создания других ботов с нужной функциональностью. Функциональность может быть легко расширена плагинами.

Разделение прав

В управлении ботом принят следующий метод разделения прав. Каждая команда имеет свой минимальный уровень доступа для запуска команды. Это число от 0 до 100. JID владельца получает уровень доступа 100, неизвестные JID-ы получают уровень доступа 0. Владелец может выставить любой уровень доступа для JID-а с помощью команды !set_access, он запоминается и будет сохраняться после перезапуска бота.

Минимальный уровень доступа команд меняется через редактирование кода плагинов.

Команда !commands использует установленный уровень доступа для JID-а и не показывает команды, которые пользователь не сможет запустить.

Плагины

Располaгаются в каталоге plugins. Каждый файл — это отдельный плагин. Чтобы запретить подгрузку какого-нибудь плагина, нужно изменить в нём первую строчку, она является индикатором, что его можно подгружать.

Официальные

Плагины access_plugin.py, admin.py, help_plugin.py обеспечивают минимальную функциональность (права, администрирование, справка). Без плагина presence_plugin.py не будет работать подписка. Остальные плагины можно удалять по необходимости.

Имя файла	Использует Интернет	Описание
access_plugin.py	нет	Системный плагин. Управляет уровнем доступа пользователей.
admin_plugin.py	нет	Функции администратора бота.
babel_plugin.py	да	Переводчик между языками. Использует внешние ресурсы для перевода.
chat_plugin.py	нет	Простой чат с пользователем, если он обращается к боту, но не передает команду. По умолчанию выключен.
dict_plugin.py	да	Дает определение слову используя www.dict.org
dns_plugin.py	да	Запрос в DNS
domain_plugin.py	да	Запрос в базу данных WHOIS
eliza_plugin.py	нет	Чат-бот Элиза
fact_plugin.py	нет	Расшифровка кода страны и кода химического элемента
freshmeat_plugin.py	да	Информация о программе на freshmeat.net
google_plugin.py	да	Поиск слова, XEP-а и проверка орфографии через google.com
help_plugin.py	нет	Справка по командам
log_plugin.py	нет	Записывает все сообщения в лог файлы в формате HTML
presence_plugin.py	нет	Отвечает на запросы подписки и отправляет свои
python_plugin.py	нет	Выполнение Python и Shell команд
query_plugin.py	нет	Запросы и заполнение локальной базы определений
quote_plugin.py	да	Возвращает случайную цитату или фортунку
rss_plugin.py	да	Работа с RSS-фидами
sg_plugin.py	нет	Собирает статистику с Jabber-серверов по протоколу определенному в XEP-0039
stock_plugin.py	да	Информация об акциях с finance.yahoo.com
temperature_plugin.py	нет	Конвертирует температуру между шкалой Цельсия и шкалой Фаренгейта
time_plugin.py	нет	Возвращает текущее время на компьютере, на котором запущен бот
userinfo_plugin.py	нет	Возвращает vCard пользователя и ответы на различные iq-запросы
vote_plugin.py	нет	Голосование
weather_plugin.py	да	Погода

Команды

Каждая команда зависит от своего плагина, удаление плагина соответственно удаляет команду. Чтобы удалить избранную команду, не удаляя плагин целиком, откройте файл с плагином, найдите в конце строчку, которая её регистрирует в боте и закомментируйте её или повысьте минимальный уровень доступа до 100.

Команда	Уровень доступа	Плагин	Описание
!login <password>	0	access_plugin.py	Войти с паролем администратора (уровень доступа станет = 100)
!logout	0	access_plugin.py	Выйти (уровень доступа = 0)
!view_access	0	access_plugin.py	Посмотреть свой уровень доступа
!set_access <jid> <level>	100	access_plugin.py	Установить уровень доступа для указанного JID-а
!join <groupchat> [nick]	100	admin_plugin.py.py	Войти в конференцию
!leave [groupchat]	100	admin_plugin.py.py	Покинуть конференцию
!msg <jid> <message>	100	admin_plugin.py.py	Послать сообщение на указанный JID
!say <message>	100	admin_plugin.py.py	Послать сообщение в текущий чат/конференцию
!restart	100	admin_plugin.py.py	Перезапуск
!exit	100	admin_plugin.py.py	Выход
!babel <from> <to> <phrase>	0	babel_plugin.py.py	Перевод используя Altavista BabelFish
!translate <from> <to> <phrase>	0	babel_plugin.py.py	Перевод используя Translate.ru
!esperanto <phrase>	0	babel_plugin.py.py	Перевод фразы с эсперанто на английский используя lingvo.org
!babelize <from> <trought> <phrase>	0	babel_plugin.py.py	Перевод фразы туда обратно.
!define <word>	0	dict_plugin.py	Дает определение слову используя www.dict.org
!dns <host/IP>	0	dns_plugin.py	Отправляет запрос на DNS-сервер и возвращает результат.
!domain <domain>	0	domain_plugin.py	Отправляет запрос в базу данных WHOIS и возвращает результат.
!element	0	fact_plugin.py	Дает расшифровку коду химического элемента
!tld <location/TLD>	0	fact_plugin.py	Возвращает код страны или страну соответствующую коду

ToDo: список сделан не до конца

Зависимости

• Интерпретатор языка Python
• Библиотека xmpppy

Ответвления

На основе этого бота было сделано:

• FtpSpider — бот, который сообщает об изменениях на FTP сервере.