Взаимодействие с Node.js | #2

В предыдущем посте мы подготовили необходимые инструменты для запуска роботов под Node.js

В качестве тестового примера, я немного модифицировал код @gemini. Он настроен на работу с одним или двумя аккаунтами.

Если у вас есть два аккаунта, то один будет выступать в качестве апвотящего робота, а другой в качестве инициатора вызова робота для апвоута. Если нет двух, то в качестве и робота, и инициатора будет один аккаунт - ваш. Так как возможно использование одного аккаунта, то в код добавлена временная задержка постинга ответного комментария робота (22 секунды). Это связано с тем, что в ГОЛОСе существует спам-защита в 20 секунд между комментариями одного пользователя. Робот проголосует сразу, как услышит ключевое слово, а разместит ответный комментарий только через 22 секунды.

Код шаблона я разместил в репозитории на github. Чтобы его оттуда скопировать (клонировать) необходимо установить утилиту GIT. (В дальнейшем, с помощью этой утилиты будем клонировать и других роботов размещённых на github.com)

Установка GIT

Заходим на сайт https://git-scm.com и кликаем Download

Выбираем операционную систему (кликаем по ссылке мышей)

В открывшейся странице выбираем вариант установочного пакета для своей операционной системы и скачиваем (в пример выбран пакет для Windows 64 бит)

После скачивания запускаем установку (кликаем на скаченном файле)

Проходим по всем шагам мастера установки, кликая клавишу Next (все параметры оставляем по-умолчанию, ничего не меняем).

Когда утилита установится (мастер завершит установку) начинаем работу с Node.js.

Командная строка Node.js

Все взаимодействия с Node.js осуществляются в командной строке. Она расположена в каталоге, где установлена Node.js.

Для запуска в Windows зайдите в меню Пуск > Все программы > Node.js > Node.js command promt (для удобства, при частом обращении к Node.js, можно отправить ярлык на рабочий стол или добавить в Панель быстрого запуска) 

откроется окно для работы в командной строке Node.js

В окне информация о версии Node и родительский путь (рабочий каталог Node) установленный по-умолчанию. У вас имена могут отличаться.

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

Ручками на клавиатуре набираем в окне коммандной строки Node следующую команду:

cd C:\robots\test

Жмём клавишу ввод (Enter)

В окне должен отобразиться путь в каталог test

• Теперь все установки будут производиться непосредственно в этот каталог.

Клонирование репозитория

Для клонирования файлов (репозитория) нашего кода примера из github в окне командной строки набираем ручками (или копируем мышей и вставляем в окно также мышей) текст:

git clone https://github.com/fxcomtrader/curator.git

Жмём ввод (Enter)

В окне отобразятся операции производимые Node и, по окончании, вернёмся в исходный каталог test

• После этой операции в каталоге test появится новый каталог. Его мы и скопировали с github. (Можно открыть проводник Windows и посмотреть)

Внутри папки curator находятся два файла

curator.js - это файл с кодом шаблона. Именно этот файл мы предварительно отредактируем и будем запускать в работу (файл робота)

README.md - файл описания (информационный для пользователя). Его можно прочитать любым текстовым редактором.

Установка модулей

Для выполнения кода в файле робота (curator.js) требуются дополнительные модули:

• steem
• bluebird
• lodash

Их надо установить в каталог с роботом (папка curator). Для этого нам надо перейти в окне командной строки в этот каталог. Набираем ручками (или копируем мышей):

cd C:\robots\test\curator

Жмём ввод (Enter)

В окне отобразится следующее:

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

Устанавливаем модуль steem. Набираем ручками:

npm install steem

Жмём ввод (Enter)

Node найдёт модуль и запустит его установку, по окончании вернётся в наш каталог (C:\robots\test\curator>)

В точности так же устанавливаем и другие. Модуль bluebird, набираем:

npm install bluebird

Жмём ввод (Enter)

Модуль lodash, набираем:

npm install lodash

Жмём ввод (Enter)

• Всё, все модули установлены. Осталось только отредактировать файл шаблона-примера и запустить робота.

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

Редактирование шаблона

Запускаем ранее установленную программу Notepad++. (Для удобства запуска программы можно её ярлык отправить на Рабочий стол или добавить в Панель быстрого запуска).

• В программном окне Notepad++ сразу же откроется новый файл new 1 для написания кода. Так как мы будем использовать уже готовый шаблон, надо открыть файл этого шаблона (curator.js).

Заходим в меню Файл > Открыть

• В открывшемся окне ищем скопированный нами файл curator.js (он находится в нашем каталоге C:\robots\test\curator) и жмём Открыть.

В окне редактора появится вкладка curator.js с кодом:

В секции "Данные робота (обязательно)" (с 9-й по 13 строки)

Меняем XХХХ на требуемые параметры:

В 10-й строке вписываем аккаунт который будет апвоутить

• аккаунт пишется без собачки (@) и обязательно внутри одинарных кавычек (пример синтаксиса: 'vasyapupkin')

В 11-й строке меняем иксы на Приватный постинг ключ аккаунта, который вписали выше (в 10-й строке). Постинг ключ также должен быть прописан внутри кавычек.

• В 12-й строке указана сила апвоута. 10000 соответствует 100%, 100 - это 1%. Можете изменить на требуемую вами.

Последняя правка в коде, в секции "Назначаем пользователя для отклика робота" (строки 46 - 48).

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

• Если у вас один аккаунт в ГОЛОСе, то пишите свой ник (или приятеля, для теста). Аккаунт пишется без собачки и внутри одинарных кавычек (пример синтаксиса: 'vasyapupkin')

Все изменения сделаны и файл надо сохранить. Меню Файл > Сохранить.

Запуск робота

Если вы не закрывали окно командной строки Node.js и находитесь в каталоге curator (C:\robots\test\curator>) то ручками набираем:

node curator.js

Жмём ввод (Enter)

Робот запущен. Об этом вас уведомляет мигающий курсор в начале строки (под путём к каталогу).

Если вы ранее закрывали окно командной строки, то вновь его откройте. В окне будет установлен путь по умолчанию. (Та же самая картинка, какая была при первом запуске  окна командной строки Node.js)

Для запуска робота отсюда, надо набрать команду запуска (node) и указать полный путь к файлу робота

node C:\robots\test\curator\curator.js

Жмём ввод (Enter

Внимание! Если вы закроете окно командной строки, то робот прекратит работу, т.е. вы отключите Node.js.

Тест

Заходим в ГОЛОС. Под любым постом оставляем комментарий (под постом, а не под чьим-нибудь комментарием!)  с ключевой фразой:

curator!

(всё латиницей, восклицательный знак в конце - обязателен)

• Робот услышит ключевую фразу, проголосует за пост и в окне командной строки отобразит отчет о голосовании

Спустя 22 секунды робот разместит ответный комментарий в ГОЛОСе о том, что он проголосовал, а в командной строке отобразит отчёт

• Когда в окне командной строки отобразился отчёт, можно обновить страницу на ГОЛОСе и увидеть ответный комментарий

Если у вас это получилось, то всё ок. Задача выполнена!

* * *

@investigator