Tamashii Common

Tamashii Common is a collection of some commonly used features in Tamashii, including recorded, setting, packet encapsulation, etc.

Add the following code to your Gemfile:

gem 'tamashii-common'

And then execute:

$ bundle install

Or install it yourself with:

$ gem install tamashii-common

Used to handle with different types of packets in Tamashii.

Tamashii::Resolver.handle Tamashii::AUTH_TOKEN, Tamashii::Manager::Authorization

In the absence of a specified processing mode, we can specify the way the default processing.

Tamashii::Resolver.default_handler Tamashii::Manager::Handler::Broadcaster

This is a mechanism similar to Rack Middleware, which can intercept or process packets before the Handler executes.

Tamashii::Resolver.hook TamashiiRailsHook

When there are lots of items need to be setting, we can write the following way instead.

Tamashii::Resolver.config do
  handler Tamashii::Manager::Authorization
  # ...

  hook MyRailsHook
  # ...
end

IoT devices need some information about the data when transferring, so define a simple format to encapsulate the data in Tamashii.

We can use Tamashii::Packet to encapsulate different types of information, e.g., String, JSON,and Binary.

packet = Tamashii::Packet.new(Tamashii::Type::AUTH_TOKEN, 0, '1234')

When we transfer data, we will translate the data into a Binary format before the transmission. If you want to convert, then we can use dump and load these two methods.

buffer = packet.dump
recv_packet = Tamashii::Packet.load(buffer)

To get the original content of the data, you can use type and body to determine what information you want to access.

if packet.type == Tamashii::Type::AUTH_TOKEN
  puts packet.body # AUTH_TOKEN is a string
end

There are a wide variety of types data exchange in Tamashii. In order to access these packet easily, we define a series of settings to assist in accessing these types.

# System Action
Tamashii::Type::POWEROFF
Tamashii::Type::REBOOT
# ...

To get the source code

$ git clone git@github.com:tamashii-io/tamashii-common.git

Initialize the development environment

$ ./bin/setup

Run the spec

$ rspec

Installation the version of development on localhost

$ bundle exec rake install

Please report to us on Github if there is any bug or suggested modified.

The project was developed by 5xruby Inc.