Archived
1
0
Fork 0
Tox adapter for the Lita chat bot http://lita.io
This repository has been archived on 2023-03-27. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
2017-07-20 19:48:49 +00:00
bin Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
ext/tox Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
lib Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
locales Initialize Lita adapter 2015-07-25 12:10:34 +05:00
spec Fix coverage 2017-07-20 19:48:49 +00:00
vendor Add submodules 2017-07-20 19:22:56 +00:00
.gitignore Build submodules in Travis CI 2017-07-20 19:19:51 +00:00
.gitmodules Add submodules 2017-07-20 19:22:56 +00:00
.rspec Configure testing 2015-07-25 12:31:14 +05:00
.rubocop.yml Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
.simplecov Fix coverage 2017-07-20 19:48:49 +00:00
.travis.yml Build submodules in Travis CI 2017-07-20 19:19:51 +00:00
.yardopts Use YARD 2015-07-25 13:02:30 +05:00
CHANGELOG.md Generate changelog 2015-09-15 20:14:33 +00:00
Gemfile Fix coverage 2017-07-20 19:48:49 +00:00
LICENSE Change license text 2017-07-20 19:00:52 +00:00
lita-tox.gemspec Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
Rakefile Configure RuboCop and fix code style 2017-07-20 19:33:29 +00:00
README.md Fix badges 2017-07-20 19:36:36 +00:00

Lita::Adapters::Tox

Gem Version Build Status Coverage Status

Tox adapter for the Lita chat bot.

WARNING

Still in development. Read the README carefully.

TODO

Current development version have some limitations which should be fixed in first release:

  • [issue #16] libtoxcore is not included in the gem. It should be compiled manually to build the gem native extension successfully. Follow the instructions in that file

  • [issue #17] JRuby is not supported. Only C extension for Tox is implemented

  • [issue #18] Message length is limited to value of TOX_MAX_MESSAGE_LENGTH (see source code of libtoxcore)

  • Adapter has incomplete API for Lita. Only basic methods are implemented

Usage

At first, see the documentation for Lita: http://docs.lita.io/

Installation

libtoxcore should be compiled manually at your computer or server. Follow the instructions in that file

When libtoxcore is installed, add lita-tox to your Lita instance's Gemfile:

gem 'lita-tox', '~> 0.3.0'

Configuration

config.robot.name will be used as Tox user name

Mentions in Tox usually use user name, Tox clients usually allow mentioning by writing first letters of user name and pressing <Tab>, so don't use config.robot.mention_name

Optional attributes

  • savedata_filename (String) - Path to file where Tox state will be stored (if provided)
  • status (String) - Tox user status

Example

This is an example lita_config.rb file:

Lita.configure do |config|
  config.robot.name = 'Lita chat bot'

  config.robot.adapter = :tox

  config.adapters.tox.savedata_filename = 'savedata'
  config.adapters.tox.status = "Send me \"#{config.robot.name}: help\""
end