2015-07-25 03:34:17 -04:00
|
|
|
Lita::Adapters::Tox
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
[](http://badge.fury.io/rb/lita-tox)
|
|
|
|
|
[](https://travis-ci.org/braiden-vasco/lita-tox)
|
|
|
|
|
[](https://coveralls.io/r/braiden-vasco/lita-tox)
|
|
|
|
|
|
2015-09-13 16:12:41 -04:00
|
|
|
[Tox](https://tox.chat) adapter for the [Lita](http://lita.io) chat bot.
|
|
|
|
|
|
2015-09-13 16:18:55 -04:00
|
|
|
**WARNING**
|
|
|
|
|
|
|
|
|
|
Still in development. Read the README carefully.
|
|
|
|
|
|
|
|
|
|
|
2015-09-13 16:12:41 -04:00
|
|
|
TODO
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
Current development version have some limitations
|
|
|
|
|
which should be fixed in first release:
|
|
|
|
|
|
|
|
|
|
* Adapter doesn't save Tox state, so you have to send friendship
|
|
|
|
|
request again after each run. Current Tox ID is shown at start
|
|
|
|
|
as Lita's information message
|
|
|
|
|
|
|
|
|
|
* Only private chats are supported. Adapter will not respond to group invite
|
|
|
|
|
|
|
|
|
|
* **libtoxcore** is not included in the gem. It should be compiled manually
|
|
|
|
|
to build the gem native extension successfully (see the instructions below)
|
|
|
|
|
|
|
|
|
|
* JRuby is not supported. Only C extension for Tox is implemented
|
|
|
|
|
|
|
|
|
|
* Message length is limited to value of `TOX_MAX_MESSAGE_LENGTH`
|
|
|
|
|
(see [source code of **libtoxcore**](https://github.com/irungentoo/toxcore/blob/2ab3b14731061cc04d3ccc50a35093c11d018298/toxcore/tox.h#L252-L255))
|
|
|
|
|
|
|
|
|
|
* Adapter has incomplete API for Lita. Only basic methods are implemented
|
2015-09-13 16:29:40 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
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 at
|
|
|
|
|
[that file](https://github.com/irungentoo/toxcore/blob/2ab3b14731061cc04d3ccc50a35093c11d018298/INSTALL.md)
|
|
|
|
|
|
|
|
|
|
When **libtoxcore** is installed, add **lita-tox**
|
|
|
|
|
to your Lita instance's Gemfile:
|
|
|
|
|
|
|
|
|
|
```ruby
|
|
|
|
|
gem 'lita-tox', '~> 0.0.0'
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Configuration
|
|
|
|
|
|
|
|
|
|
No configuration is needed. You only have to specify adapter as `:tox`
|
|
|
|
|
|
|
|
|
|
#### Example
|
|
|
|
|
|
|
|
|
|
This is an example `lita_config.rb` file:
|
|
|
|
|
|
|
|
|
|
```ruby
|
|
|
|
|
Lita.configure do |config|
|
|
|
|
|
config.robot.name = 'Lita'
|
|
|
|
|
config.robot.mention_name = 'lita'
|
|
|
|
|
|
|
|
|
|
config.robot.adapter = :tox
|
|
|
|
|
end
|
|
|
|
|
```
|
