Editing Neutron

{{Bot
|            name=Neutron
|             url=http://ejabberd.jabber.ru/neutron
|        language=[[Python]]
|         library=[[xmpppy]]
|         license=[[GPL]]
|            i18n=нет
|           disco=нет
|         plugins=да
|           adhoc=нет
}}

Хороший бот на [[Python]], умеющий проводить опросы, показывать [[RSS]]-фиды, и много других интересных вещей. Бот очень удобен для быстрого создания других ботов с нужной функциональностью. Можно легко расширить возможности плагинами. 

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

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

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

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

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

{| class="standard"
! Имя файла || Использует<br/>Интернет || Описание 
|-
| 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  || да || Поиск слова, [[Jabber Extension Protocol|JEP]]-а и проверка орфографии через 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-серверов по протоколу определенному в [http://www.xmpp.org/extensions/xep-0039.html XEP-0039]
|-
| stock_plugin.py || да || Информация об акциях с finance.yahoo.com
|-
| temperature_plugin.py || нет || Конвертирует температуру между шкалой Цельсия и шкалой Фаренгейта
|-
| time_plugin.py || нет || Возвращает текущее время на компьютере, на котором запущен бот
|-
| userinfo_plugin.py || нет || Возвращает [[vCard]] пользователя и ответы на различные [[iq|iq-запросы]]
|-
| vote_plugin.py || нет || Голосование
|-
| weather_plugin.py || да || Погода
|}

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

{| class="standard"
! Команда || Уровень доступа || Плагин || Описание 
|-
| !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 <code> || 0 || fact_plugin.py || Дает расшифровку коду химического элемента
|-
| !tld <location/TLD> || 0 || fact_plugin.py ||Возвращает код страны или страну соответствующую коду
|}
{{todo|список сделан не до конца}}
== Зависимости ==
* Интерпретатор языка [[Python]]
* Библиотека [[xmpppy]]

== Ответвления ==
На основе этого бота было сделано: 
* [[FtpSpider]] &mdash; бот, который сообщает об изменениях на FTP сервере.



[[Category:Python]]
[[Category:Bot]]
[[Category:xmpppy]]
[[Category:GPL]]
@@ Line 1: / Line 1: @@
 {{Bot
-|             name = Neutron <!-- название -->
+|            name=Neutron
-|             logo = <!-- логотип -->
+|             url=http://ejabberd.jabber.ru/neutron
-<!--       Общая информация          -->
+|        language=[[Python]]
-|              url = [http://ejabberd.jabber.ru/neutron ejabberd.jabber.ru/neutron] <!-- адрес -->
+|         library=[[xmpppy]]
-|         language = {{Lang|b|Python}} <!-- язык -->
+|         license=[[GPL]]
-|          library = {{Lib|xmpppy}} <!-- jabber-библиотека -->
+|            i18n=нет
-|          license = {{GPL}} <!-- лицензия -->
+|           disco=нет
-|        developer = [http://mikemintz.com/ Майк&nbsp;Минтц (Mike&nbsp;Mintz)] <!-- разработчик -->
+|         plugins=да
-<!--        Характеристики   -->
+|           adhoc=нет
-|             i18n = нет <!-- мультиязычность -->
-|            disco = нет <!-- информация в диско -->
-|            adhoc = нет <!-- Ad-Hoc команды -->
-|          plugins = да <!-- расширяется ли он плагинами -->
 }}
-'''Neutron''' - бот на [[Python]], умеющий проводить опросы, показывать [[RSS]]-фиды, а также ряд других действий. Удобен для быстрого создания других ботов с нужной функциональностью. Функциональность может быть легко расширена плагинами.
+Хороший бот на [[Python]], умеющий проводить опросы, показывать [[RSS]]-фиды, и много других интересных вещей. Бот очень удобен для быстрого создания других ботов с нужной функциональностью. Можно легко расширить возможности плагинами.
 == Разделение прав ==
-В управлении ботом принят следующий метод разделения прав. Каждая команда имеет свой минимальный уровень доступа для запуска команды. Это число от 0 до 100. [[JID]] владельца получает уровень доступа 100, неизвестные JID-ы получают уровень доступа 0. Владелец может выставить любой уровень доступа для JID-а с помощью команды <tt>!set_access</tt>, он запоминается и будет сохраняться после перезапуска бота.
+В управлении ботом принят следующий метод разделения прав. Каждая команда имеет свой минимальный уровень доступа для запуска команды. Это число от 0 до 100. [[JID]] владельца получает уровень доступа 100, неизвестные JID-ы получают уровень доступа 0. Владелец может выставить любой уровень доступа для JID-а с помощью команды <tt>!set_access</tt>, он запоминтся и будет сохранятся через перезапуски.
 Минимальный уровень доступа команд меняется через редактирование кода плагинов.
@@ Line 24: / Line 21: @@
 == Плагины ==
-Располaгаются в каталоге <tt>plugins</tt>. Каждый файл — это отдельный плагин. Чтобы запретить подгрузку какого-нибудь плагина, нужно изменить в нём первую строчку, она является индикатором, что его можно подгружать.
+Распологаются в каталоге <tt>plugins</tt>. Каждый файл — это отдельный плагин. Чтобы запретить подгрузку какого-нибудь плагина, нужно изменить в нём первую строчку, она является индикатором, что его можно подгружать.
 === Официальные ===
@@ Line 38: / Line 35: @@
 | babel_plugin.py || да || Переводчик между языками. Использует внешние ресурсы для перевода.
 |-
-| chat_plugin.py || нет || Простой чат с пользователем, если он обращается к боту, но не передает команду. По умолчанию выключен.
+| chat_plugin.py || нет || Простой чат с пользователем, если он обращается к боту но не передает команду. По-умолчанию выключен.
 |-
 | dict_plugin.py || да || Дает определение слову используя www.dict.org
@@ Line 52: / Line 49: @@
 | freshmeat_plugin.py || да || Информация о программе на freshmeat.net
 |-
-| google_plugin.py  || да || Поиск слова, [[XEP]]-а и проверка орфографии через google.com
+| google_plugin.py  || да || Поиск слова, [[Jabber Extension Protocol|JEP]]-а и проверка орфографии через google.com
 |-
 | help_plugin.py || нет || Справка по командам
@@ Line 135: / Line 132: @@
 На основе этого бота было сделано:
 * [[FtpSpider]] &mdash; бот, который сообщает об изменениях на FTP сервере.
+[[Category:Python]]
+[[Category:Bot]]
+[[Category:xmpppy]]
+[[Category:GPL]]