slack-bot-manager 0.1.0pre2 → 0.1.0pre3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e99eff3580607b9be5f2a6693e549ec0f4e8b111
-  data.tar.gz: f70a660184a3dc53ebcf2f8c575854d29813a615
+  metadata.gz: 26bbd6ac7e458ce8eb9c13d0240c1c12c3e20a4c
+  data.tar.gz: 4aca7114fa130ed10f3c8e24aaf3fc071eb2a0c9
 SHA512:
-  metadata.gz: 926df5bbfeee60eaf86a51baff44679ea524f27f9b85cde4ff6078fea5f986556cb3c9ea714db877c57cef434d4b32564e337ce380bd7996aef750d0c561083d
-  data.tar.gz: 7165e5e5dc98dbf1745cdeec70257252c41f8f478bb0403a43bbb6012de02708e07a1deda7370a2b592cd9ac2eb5892c382624171330075ccad4339d3d591f30
+  metadata.gz: e806d0b5f35997dfc9e2380e32eee0202c4bb60594baab464ba87221dc0a861f6bd0ce1cf189abd5b7be173a3a41911d37d590f0f9acc298600be2f07de58b67
+  data.tar.gz: 8d766dd7907f032619a6673e8f4aaef2f5bc2bbdf45735da7fed18cded5fa2fa8209157d1b11fd17e888062f6d06a5703f1bdd57cef1c7a3e14e8c0cf1e3bf6d

data/.gitignore

@@ -4,4 +4,5 @@
 pkg
 Gemfile.lock
 tokens.yml
-slack-bot-manager-*.gem
+slack-bot-manager-*.gem
+.gitignore

data/.gitmodules

@@ -1,9 +0,0 @@
-[submodule "examples/emoji-art-bot"]
-	path = examples/emoji-art-bot
-	url = git@github.com:goosey/emoji-art-bot.git
-[submodule "examples/downforeveryone-bot"]
-	path = examples/downforeveryone-bot
-	url = https://github.com/goosey/downforeveryone-bot
-[submodule "examples/botspotting"]
-	path = examples/botspotting
-	url = git@github.com:goosey/botspotting.git

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2016-02-07 01:40:37 -0500 using RuboCop version 0.36.0.
+# on 2016-02-07 14:23:26 -0500 using RuboCop version 0.36.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -15,22 +15,27 @@ Lint/UselessAssignment:
 Metrics/AbcSize:
   Max: 90
 
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 108
+
 # Offense count: 2
 Metrics/CyclomaticComplexity:
   Max: 13
 
-# Offense count: 13
+# Offense count: 17
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes.
 # URISchemes: http, https
 Metrics/LineLength:
   Max: 120
 
-# Offense count: 6
+# Offense count: 9
 # Configuration parameters: CountComments.
 Metrics/MethodLength:
   Max: 43
 
-# Offense count: 1
+# Offense count: 2
 # Configuration parameters: CountComments.
 Metrics/ModuleLength:
   Max: 113
@@ -52,10 +57,10 @@ Style/Documentation:
     - 'lib/slack-bot-manager/logger.rb'
     - 'lib/slack-bot-manager/manager/base.rb'
     - 'lib/slack-bot-manager/manager/connection.rb'
-    - 'lib/slack-bot-manager/manager/storage.rb'
-    - 'lib/slack-bot-manager/manager/storage/dalli.rb'
-    - 'lib/slack-bot-manager/manager/storage/redis.rb'
     - 'lib/slack-bot-manager/manager/tokens.rb'
+    - 'lib/slack-bot-manager/storage.rb'
+    - 'lib/slack-bot-manager/storage/dalli.rb'
+    - 'lib/slack-bot-manager/storage/redis.rb'
 
 # Offense count: 1
 # Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts.
@@ -68,7 +73,7 @@ Style/ModuleFunction:
   Exclude:
     - 'lib/slack-bot-manager/config.rb'
 
-# Offense count: 3
+# Offense count: 4
 # Cop supports --auto-correct.
 Style/RedundantSelf:
   Exclude:

data/CHANGELOG.md

@@ -1,7 +1,7 @@
 
 ### Version 0.1.0 (20 Jan 2016)
 
-__**Pre-release at 0.1.0pre2**__
+__**Pre-release at 0.1.0pre3**__
 
 This is the first version of Slack Bot Manager, and includes
 

data/README.md

@@ -69,7 +69,7 @@ methods     | description
 
 ### Token Management Methods
 
-Tokens are managed using key storage, currently only supporting Redis. SlackBotManager will manage and monitor these  keys for additions, updates, and removals. New connections will be added into the key `teams_key`, like so:
+Tokens are managed using the defined storage adapter (Redis or Dalli). SlackBotManager will manage and monitor these  keys for additions, updates, and removals. New connections will be added into the key `teams_key`, like so:
 
 ```
 botmanager = SlackBotManager::Manager.new
@@ -99,6 +99,20 @@ variable      | description
 `id`          | Team's Slack ID (ex. `T123ABC`) _(set after successful connection)_
 `token`       | Team's Slack access token (ex. `xoxb-123abc456def`)
 `status`      | Known connection status. (`connected`, `disconnected`, `rate_limited`, `token_revoked`)
+`storage`     | Storage adapter from Config.
+
+
+### Client Methods
+
+These are some common client methods you can use to manage incoming events and interact with Slack.
+
+methods                      | description
+-----------------------------|----------------------------------------------------------------------------------------
+`message(channel, text, {})` | Send a message to channel. Handles both simple RTM message or chat.postMessage if additional options are present.
+`typing(channel, {})`        | Send typing notification.
+`ping({})`                   | Send a manual ping to Slack.
+`on(event, &block)`          | Add an event listener. (Same as extending with `on_*` methods.)
+`off(event, &block)`         | Remove an event listener. (Does not remove defined `on_*` methods.)
 
 
 ### Adding Event Listeners
@@ -115,7 +129,7 @@ module SlackBotManager
     end
 
     def on_team_join(data)
-      puts "New team member joined: %s" % data['user']['username']
+      message(data['channel'], "Welcome: %s" % data['user']['username'])
     end
   end
 end
@@ -127,14 +141,11 @@ end
 
 ## Configuration
 
-### Manager configuration options
+### Global configuration options
 
 setting           | description
 ------------------|-----------------------------------------------------------------------------------
-`tokens_key`      | Redis key name for where tokens' status are stored. _(default: tokens:statuses)_
-`teams_key`       | Redis key name for where teams' tokens are stored. _(default: tokens:teams)_
-`check_interval`  | Interval (in seconds) for checking connections and tokens status. _(default: 5)_
-`storage_method`  | Token storage method. _(default: nil)_
+`storage_adapter` | Token storage method. _(default: nil)_
 `storage_options` | Token storage method options. _(default: {})_
 `logger`          | Define the logger to use. _(default: Rails.logger or ::Logger.new(STDOUT))_
 `log_level`       | Explicity define the logger level. _(default: ::Logger::WARN)_
@@ -142,9 +153,29 @@ setting           | description
 
 You can define these configuration options as:
 
+```
+SlackBotManager.configure do |config|
+  config.storage_adapter = SlackBotManager::Storage::Redis
+  config.storage_options = {host: '0.0.0.0', port: 6379}
+end
+```
+
+### Manager configuration options
+
+Manager configuration options include the global options (`storage_adapter`, `storage_options`, `logger`, `log_level`, & `verbose`), in addition to:
+
+
+setting           | description
+------------------|-----------------------------------------------------------------------------------
+`tokens_key`      | Redis key name for where tokens' status are stored. _(default: tokens:statuses)_
+`teams_key`       | Redis key name for where teams' tokens are stored. _(default: tokens:teams)_
+`check_interval`  | Interval (in seconds) for checking connections and tokens status. _(default: 5)_
+
+You can define these configuration options as:
+
 ```
 SlackBotManager::Manager.configure do |config|
-  config.storage_method = SlackBotManager::Storage::Redis
+  config.storage_adapter = SlackBotManager::Storage::Redis
   config.storage_options = {host: '0.0.0.0', port: 6379}
   config.check_interval = 10 # in seconds
 end
@@ -153,24 +184,20 @@ end
 You can additionally send an existing storage method as the `storage_option`, such as:
 
 ```
+$redis = Redis.new
 SlackBotManager::Manager.configure do |config|
-  config.storage_options = $redis # Existing Redis connection, where $redis = Redis.new
+  config.storage_options = $redis
 end
 ```
 
 ### Client configuration options
 
-setting           | description
-------------------|-----------------------------------------------------------------------------------
-`logger`          | Define the logger to use. _(default: Rails.logger or ::Logger.new(STDOUT))_
-`log_level`       | Explicity define the logger level. _(default: ::Logger::WARN)_
-`verbose`         | When true, set `log_level` to ::Logger::DEBUG. _(default: false)_
+Client configuration options include the global options (`storage_adapter`, `storage_options`, `logger`, `log_level`, & `verbose`)
 
 You can define these configuration options as:
 
 ```
 SlackBotManager::Client.configure do |config|
-  config.check_interval = 10 # in seconds
   config.log_level = ::Logger::INFO
 end
 ```

data/examples/botspotting/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+ruby '2.2.3'
+
+gem 'dotenv'
+gem 'json'
+gem 'faye-websocket',           '0.10.2'
+gem 'activesupport',            '4.2.5',      require: ['active_support/all']
+gem 'slack-bot-manager'
+gem 'redis'

data/examples/botspotting/README.md

@@ -0,0 +1,29 @@
+# botspotting
+
+emails you (or just hits a webhook endpoint) when a new bot is added to your team
+
+an example bot using [slack-bot-manager](https://github.com/betaworks/slack-bot-manager) and [dexter](https://rundexter.com/)
+
+slack-bot-manager depends on `redis` and `slack-ruby-client`
+
+# setup
+
+1. make your Dexter app (see below), and get the webhook URL
+2. `touch .env` and then add your Slackbot token and Dexter webhook URL to `.env`
+3. `ruby bot.rb`
+
+# making a dexter app
+
+you can either build a dexter app from scratch for this or [use one we pre-built](https://rundexter.com/app/botspotting)
+
+1. [sign up for Dexter](https://rundexter.com/signup)
+2. in the top right, hit "New App" and name and describe the app ![](http://s.goose.im/screenshot20160115111705.png)
+3. drag the "Webhook" trigger from the left and on to the canvas. click on it and, on the right, add two new variables- name them "message" and "subject" ![](http://s.goose.im/screenshot20160115135756.png)
+4. back on the left, go to "Modules" and add a module- we're using Dexter Emailer, but you could use Dexter SMS, Twitter Tweeter, or anything else that takes text input
+5. click on your new module and hit "Configure", and drag the "message" and "subject" variables from the Webhook to the Module. for the email module, that looks like this: ![](http://s.goose.im/screenshot20160115140235.png)
+6. for the other inputs, you can either choose to prompt the user (we use this for the To field) or enter it manually. for Reply To, HTML Body, CC, and BCC, we choose to enter it manually but leave it blank
+7. click Use App in the upper right to configure the app and get your webhook URL
+
+# credit
+
+created by [Alex Balwdin](https://github.com/goosey)

data/examples/botspotting/bot.rb

@@ -0,0 +1,23 @@
+# Initialize
+require 'dotenv'
+Dotenv.load
+
+require 'rubygems'
+require 'bundler/setup'
+
+require './slack.rb'
+
+APP_ENV = ENV['APP_ENV'] if !defined?(APP_ENV) && ENV['APP_ENV']
+APP_ENV = 'development' if !defined?(APP_ENV)
+
+Bundler.require(:default, APP_ENV.to_sym)
+
+# Create bot manager
+botmanager = SlackBotManager::Manager.new
+
+# Add Slack token
+botmanager.add_token(ENV['SLACK_TOKEN'])
+
+# Start manager
+botmanager.start
+botmanager.monitor

data/examples/botspotting/sample.env

@@ -0,0 +1,3 @@
+APP_ENV=development
+SLACK_TOKEN=
+DEXTER_WEBHOOK=

data/examples/botspotting/slack.rb

@@ -0,0 +1,35 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
+module SlackBotManager
+  module Commands
+
+    attr_accessor :team_name, :team_domain
+
+    def on_hello(data)
+      debug(data)
+      @team_name = self.client_team['name']
+      @team_domain = self.client_team['domain']
+    end
+
+    def on_bot_added(data)
+      return if data['bot']['deleted'] == true
+
+      subject = "someone added a bot to your team #{self.team_name}"
+      message = "someone added the bot #{data['bot']['name']} to #{self.team_name}. \n
+find out more at https://#{self.team_domain}.slack.com/apps/manage \n
+[sent by botspotting]"
+
+      # Send to Dexter webhook
+      uri = URI(ENV['DEXTER_WEBHOOK'])
+      req = Net::HTTP::Post.new(uri, initheader = {'Content-Type' =>'application/json'})
+      req.body = {message: message, subject: subject}.to_json
+      res = Net::HTTP.start(uri.hostname, uri.port, :use_ssl => true) do |http|
+        http.request(req)
+      end
+
+      info(res.body)
+    end
+  end
+end

data/examples/dm-bot/dm-bot.rb

@@ -23,9 +23,8 @@ require 'bundler/setup'
 Bundler.require
 
 # Use Redis and configure slack-bot-manager
-$redis = Redis.new
 SlackBotManager.configure do |config|
-  config.storage_options = $redis # Set entire instance as option
+  config.storage_options = Redis.new # Set entire instance as option
 end
 
 # Extend commands to handle what we want done
@@ -38,38 +37,38 @@ module SlackBotManager
 
       # Get user info
       user_key = ['users', self.id, data['user']].join(':')
-      $redis.del user_key
-      unless $redis.exists user_key
+      storage.connection.del user_key
+      unless storage.connection.exists user_key
         # Get user info from Slack
         user_info = self.connection.web_client.users_info(user: data['user'])['user']
 
         # Store the basics into redis for quicker lookups
-        $redis.hmset user_key, *{ id: user_info['id'], name: user_info['name'], real_name: user_info['real_name'], is_bot: user_info['is_bot'] ? 1 : 0 }.flatten
+        storage.connection.hmset user_key, *{ id: user_info['id'], name: user_info['name'], real_name: user_info['real_name'], is_bot: user_info['is_bot'] ? 1 : 0 }.flatten
         # Expire this redis key weekly so that we do regular updates
-        $redis.expire user_key, 604800 # 1 week in seconds
+        storage.connection.expire user_key, 604800 # 1 week in seconds
       end
-      user_info = $redis.hgetall user_key
+      user_info = storage.connection.hgetall user_key
 
       return if [1,'1','true'].include?(user_info['is_bot'])
 
       # Get IM info, send hello message if first time
       im_key = ['ims', self.id, data['channel']].join(':')
-      $redis.del im_key
-      unless $redis.exists im_key
-        $redis.hmset im_key, *{ id: data['channel'], user: user_info['id'], started: Time.now.to_i, messages_sent: 0, messages_received: 0 }.flatten
-        self.send_message(data['channel'], "Hello there <@#{user_info['id']}>! I'm happy to listen to what you have to say. :simple_smile:")
-        $redis.hincrby im_key, 'messages_sent', 1
+      storage.connection.del im_key
+      unless storage.connection.exists im_key
+        storage.connection.hmset im_key, *{ id: data['channel'], user: user_info['id'], started: Time.now.to_i, messages_sent: 0, messages_received: 0 }.flatten
+        send_message(data['channel'], "Hello there <@#{user_info['id']}>! I'm happy to listen to what you have to say. :simple_smile:")
+        storage.connection.hincrby im_key, 'messages_sent', 1
       end
-      im_info = $redis.hgetall im_key
+      im_info = storage.connection.hgetall im_key
 
       # Increment message count
-      $redis.hincrby im_key, 'messages_received', 1
+      storage.connection.hincrby im_key, 'messages_received', 1
 
       # Parse message contents
-      message = 'If i was smarter, I would respond with something witty.'
+      msg = 'If i was smarter, I would respond with something witty.'
 
-      self.send_message(data['channel'], message)
-      $redis.hincrby im_key, 'messages_sent', 1
+      send_message(data['channel'], msg)
+      storage.connection.hincrby im_key, 'messages_sent', 1
     end
 
   end

data/examples/downforeveryone-bot/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+ruby '2.2.3'
+
+gem 'dotenv'
+gem 'json'
+gem 'bing-search'
+gem 'faye-websocket',           '0.10.2'
+gem 'activesupport',            '4.2.5',      require: ['active_support/all']
+gem 'slack-bot-manager'
+gem 'redis'

data/examples/downforeveryone-bot/README.md

@@ -0,0 +1,23 @@
+# "down for everyone or just me" bot
+
+an example bot using [slack-bot-manager](https://github.com/betaworks/slack-bot-manager)
+
+slack-bot-manager depends on `redis` and `slack-ruby-client`
+
+# setup
+
+1. get a free key for the [Bing Web-Only Search API](https://datamarket.azure.com/dataset/bing/searchweb)
+2. your key will be under "My Account > Account Keys"
+3. `touch .env` and then add the Bing key and your Slackbot token to `.env`
+4. `ruby bot.rb`
+
+# usage
+
+`is [site] up` or `is [site] down`
+
+site can be a url (like `google.com`) or a word (like `facebook`). using a word can be more time intensive and potentially less accurate, since it queries the [DuckDuckGo API
+](https://api.duckduckgo.com/api) and Bing as a backup.
+
+# credit
+
+created by [Alex Baldwin](https://github.com/goosey)

data/examples/downforeveryone-bot/bot.rb

@@ -0,0 +1,24 @@
+# Initialize
+require 'dotenv'
+Dotenv.load
+
+require 'rubygems'
+require 'bundler/setup'
+
+require './lib/status.rb'
+require './lib/slack.rb'
+
+APP_ENV = ENV['APP_ENV'] if !defined?(APP_ENV) && ENV['APP_ENV']
+APP_ENV = 'development' if !defined?(APP_ENV)
+
+Bundler.require(:default, APP_ENV.to_sym)
+
+# Create bot manager
+botmanager = SlackBotManager::Manager.new
+
+# Add Slack token
+botmanager.add_token(ENV['SLACK_TOKEN'])
+
+# Start manager
+botmanager.start
+botmanager.monitor

data/examples/downforeveryone-bot/lib/slack.rb

@@ -0,0 +1,39 @@
+module SlackBotManager
+  module Commands
+
+    def on_hello(data)
+      debug(data)
+    end
+
+    def on_message(data)
+      debug(data)
+
+			message = data['text'].downcase
+
+      site_by_word = /is (\w{2,}) (?:down|up)/
+      site_by_url = /is (\w{2,}\.\w{1,}) (?:down|up)/
+      site_by_link = /is <https?:\/\/[a-zA-Z\.]+\|((?:www.)\w{2,}\.\w\w{1,})> (?:down|up)/
+
+      if message =~ site_by_word
+        typing(data['channel'])
+        word = site_by_word.match(message)[1]
+        url = Status.find_url(word)
+        if (url)
+          message(data['channel'], Status.isitdown(url), icon_emoji: ":ok:")
+        end
+      end
+
+      if message =~ site_by_url
+        typing(data['channel'])
+        url = site_by_url.match(message)[1]
+        message(data['channel'], Status.isitdown(url), icon_emoji: ":ok:")
+      end
+
+      if message =~ site_by_link
+        typing(data['channel'])
+        url = site_by_link.match(message)[1]
+        message(data['channel'], Status.isitdown(url), icon_emoji: ":ok:")
+      end
+    end
+  end
+end

data/examples/downforeveryone-bot/lib/status.rb

@@ -0,0 +1,45 @@
+#require 'dotenv'
+#Dotenv.load
+
+require 'net/http'
+require 'json'
+require 'bing-search'
+
+BingSearch.account_key = ENV['BING_SEARCH_KEY']
+BingSearch.web_only = true
+
+class Status
+
+	def self.isitdown(url) # e.g. google.com
+		uri = URI('http://downforeveryoneorjustme.com/' + url)
+		output = Net::HTTP.get(uri)
+		if output =~ /It's just you/i
+			if url == 'encrypted.google.com'
+				return "google.com is up :ok_hand:"
+			else
+				return "#{url} is up :ok_hand:"
+			end
+		else
+			return "#{url} is down :warning:"
+		end
+	end
+
+	def self.find_url(word)
+		uri = URI('http://api.duckduckgo.com/?q=!' + word + '&format=json&t=downforeveryone-bot')
+		output = Net::HTTP.get(uri)
+		hash = JSON.parse(output)
+		if hash['Redirect'] != ""
+			return /https?:\/\/([\w{2,}\.]+)/.match(hash['Redirect'])[1]
+		else
+			return Status.search_url(word)
+		end
+	end
+
+	def self.search_url(word)
+		results = BingSearch.web(word, {:limit => 1})
+		if results[0] and results[0].display_url
+			return /(?:https?:\/\/)?([\w{2,}\.]+)/.match(results[0].display_url)[1]
+		end
+	end
+
+end

data/examples/downforeveryone-bot/sample.env

@@ -0,0 +1,3 @@
+APP_ENV=development
+SLACK_TOKEN=
+BING_SEARCH_KEY=

data/examples/emoji-art-bot/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+ruby '2.2.3'
+
+gem 'dotenv'
+gem 'json'
+gem 'faye-websocket',           '0.10.2'
+gem 'activesupport',            '4.2.5',      require: ['active_support/all']
+gem 'slack-bot-manager'
+gem 'redis'

data/examples/emoji-art-bot/README.md

@@ -0,0 +1,43 @@
+# emoji art bot
+
+an example bot using [slack-bot-manager](https://github.com/betaworks/slack-bot-manager) :sparkles:
+
+slack-bot-manager depends on `redis` and `slack-ruby-client`
+
+## usage
+`emoji art [set] [size]`  
+`set` and `size` are optional
+
+to get a list of available emoji sets, do `emoji help`
+
+around the 28-40 size range, messages may be too large to send back to Slack- if you get no response, try a smaller request.
+
+examples:  
+`emoji art shapes 20`  
+`emoji artist, make me art`  
+`make emoji art that's 10x10 and made of nature`
+
+![](http://i.imgur.com/d3Y0R1X.png)
+
+## get started
+
+1. `touch .env`
+2. add your Slackbot's token to `.env`
+3. `bundle install`
+4. `ruby bot.rb`
+
+## custom emoji sets
+
+1. add your set to `lib/json/emoji.json`
+2. near line 26 of `lib/slack.rb`, there's a case statement- add your keywords and set here (make sure you place it before the else statement)
+
+for example, to add a set called "buildings" that is used when the user says "buildings" or "city":
+```
+when message.include?("buildings") || message.include?("city")
+	group = "buildings"
+```
+
+## todo
+- add an `emoji again` command to do the last command again
+
+![](http://i.imgur.com/oZIs3A4.png)

data/examples/emoji-art-bot/bot.rb

@@ -0,0 +1,24 @@
+# Initialize
+require 'dotenv'
+Dotenv.load
+
+require 'rubygems'
+require 'bundler/setup'
+
+require './lib/emoji.rb'
+require './lib/slack.rb'
+
+APP_ENV = ENV['APP_ENV'] if !defined?(APP_ENV) && ENV['APP_ENV']
+APP_ENV = 'development' if !defined?(APP_ENV)
+
+Bundler.require(:default, APP_ENV.to_sym)
+
+# Create bot manager
+botmanager = SlackBotManager::Manager.new
+
+# Add Slack token
+botmanager.add_token(ENV['SLACK_TOKEN'])
+
+# Start manager
+botmanager.start
+botmanager.monitor

data/examples/emoji-art-bot/lib/emoji.rb

@@ -0,0 +1,37 @@
+require 'json'
+
+class Emoji
+
+	@@emoji = {}
+
+	@@current_list = "all"
+
+	def self.square(size)
+		list = @@emoji[@@current_list]
+		square = ""
+		(0...(size ** 2)).each do |i|
+			square << list.sample
+			if ((i + 1) % size) == 0
+				square << "\n"
+			end
+		end
+		return square
+	end
+
+	def self.choose(list)
+		@@current_list = list
+	end
+
+	def self.list
+		@@emoji.keys
+	end
+
+	def self.load(path)
+		file = File.read(path)
+		@@emoji = JSON.parse(file)
+	end
+
+end
+
+# Load emoji sets
+Emoji.load('./lib/json/emoji.json')