slack-client 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4d77e9fa969018d6cf1751745c0594566473f29a
+  data.tar.gz: 816b9e9e0d3ce9e10efe7a23aa75cfc84615aba0
+SHA512:
+  metadata.gz: 2d4068089b12380475d786ec17a7fa10af43fc00597491d5f40aeee28cefdee1ebd2d4673517f090d23eab096d7984512d438e1cbfbab0a6c916009e6065ff6d
+  data.tar.gz: 072e07949e095385cd3a4c84f196d24a2d15dd60d93958ff121500ce183563ee9fb7b20e89faebbf35a1a43d32b55d222549be9e6b8f24acad77c53edb03e65a

data/.gitignore

@@ -0,0 +1,70 @@
+*.gem
+*.rbc
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+## Specific to Gems/Libraries:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+/.rvmrc
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Specific to Vim:
+[._]*.s[a-w][a-z]
+[._]s[a-w][a-z]
+*.un~
+Session.vim
+.netrwhist
+*~
+
+## Specific to Sublime Text:
+# cache files for sublime text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# workspace files are user-specific
+*.sublime-workspace
+
+# project files should be checked into the repository, unless a significant
+# proportion of contributors will probably not be using SublimeText
+# *.sublime-project
+
+# sftp configuration file
+sftp-config.json
+
+## Specific to TextMate:
+*.tmproj
+*.tmproject
+tmtags
+
+## Specific to OS X:
+.DS_Store
+.AppleDouble
+.LSOverride

data/.rubocop.yml

@@ -0,0 +1,91 @@
+AllCops:
+  Includes:
+    - 'Gemfile'
+    - 'slack-client.gemspec'
+
+# Avoid long parameter lists
+ParameterLists:
+  Max: 5
+  CountKeywordArgs: true
+
+MethodLength:
+  CountComments: false
+  Max: 15
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 4
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    collect!: 'map!'
+    inject:   'reduce'
+    detect:   'find'
+    find_all: 'select'
+
+# Limit line length
+LineLength:
+  Enabled: true
+
+# Disable documentation checking until a class needs to be documented once
+Documentation:
+  Enabled: false
+
+# Enforce Ruby 1.8-compatible hash syntax
+HashSyntax:
+  EnforcedStyle: ruby19
+
+# No spaces inside hash literals
+SpaceInsideHashLiteralBraces:
+  EnforcedStyle: space
+  EnforcedStyleForEmptyBraces: no_space
+
+# Allow dots at the end of lines
+DotPosition:
+  Enabled: false
+
+# Don't require magic comment at the top of every file
+Encoding:
+  Enabled: false
+
+# Enforce outdenting of access modifiers (i.e. public, private, protected)
+AccessModifierIndentation:
+  EnforcedStyle: indent
+
+EmptyLinesAroundAccessModifier:
+  Enabled: true
+
+# Align ends correctly
+EndAlignment:
+  AlignWith: variable
+
+AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+# Indentation of when/else
+CaseIndentation:
+  IndentWhenRelativeTo: end
+  IndentOneStep: false
+
+DoubleNegation:
+  Enabled: false
+
+PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  '{}'
+    '%i': '{}'
+    '%q': '{}'
+    '%Q': '{}'
+    '%r': '{}'
+    '%s': '{}'
+    '%w': '[]'
+    '%W': '[]'
+    '%x': '{}'
+
+RegexpLiteral:
+  MaxSlashes: 0
+
+StringLiterals:
+  EnforcedStyle: single_quotes

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 CodeUnion, Inc.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,31 @@
+# Slack::Client
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'slack-client'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install slack-client
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/slack-client/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/bin/slack

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+require 'slack/cli'
+require 'dotenv'
+
+Dotenv.load(Slack::CLI::CONFIG_FILE)
+
+Slack::CLI::App.start(ARGV)

data/lib/slack-client.rb

@@ -0,0 +1 @@
+require 'slack/client'

data/lib/slack/api.rb

@@ -0,0 +1,5 @@
+require 'slack/api/base'
+
+require 'slack/api/channels'
+require 'slack/api/im'
+require 'slack/api/users'

data/lib/slack/api/base.rb

@@ -0,0 +1,27 @@
+require 'faraday'
+require 'addressable/template'
+
+module Slack
+  module API
+    class Base
+      attr_reader :default_args
+
+      def initialize(default_args = {})
+        @default_args = default_args
+      end
+
+      def get(endpoint, args = {})
+        Faraday.get(api_url(endpoint, default_args.merge(args))).body
+      end
+
+      private
+
+      URL_TEMPLATE =
+        Addressable::Template.new('https://slack.com/api/{endpoint}{?args*}')
+
+      def api_url(endpoint, args = {})
+        URL_TEMPLATE.expand(endpoint: endpoint, args: args)
+      end
+    end
+  end
+end

data/lib/slack/api/channels.rb

@@ -0,0 +1,21 @@
+module Slack
+  module API
+    class Channels < Slack::API::Base
+      def info(args = {})
+        fail ArgumentError, 'channel is required' unless args.key?(:channel)
+
+        get('channels.list', args)
+      end
+
+      def history(args = {})
+        fail ArgumentError, 'channel is required' unless args.key?(:channel)
+
+        get('channels.history', args)
+      end
+
+      def list(args = {})
+        get('channels.list', args)
+      end
+    end
+  end
+end

data/lib/slack/api/im.rb

@@ -0,0 +1,15 @@
+module Slack
+  module API
+    class IM < Slack::API::Base
+      def history(args = {})
+        fail ArgumentError, 'channel is required' unless args.key?(:channel)
+
+        get('im.history', args)
+      end
+
+      def list(args = {})
+        get('im.list', args)
+      end
+    end
+  end
+end

data/lib/slack/api/users.rb

@@ -0,0 +1,9 @@
+module Slack
+  module API
+    class Users < Slack::API::Base
+      def list(args = {})
+        get('users.list', args)
+      end
+    end
+  end
+end

data/lib/slack/cli.rb

@@ -0,0 +1,9 @@
+require 'slack/cli/base'
+
+require 'slack/cli/channels'
+require 'slack/cli/im'
+require 'slack/cli/users'
+
+require 'slack/cli/config'
+
+require 'slack/cli/app'

data/lib/slack/cli/app.rb

@@ -0,0 +1,53 @@
+module Slack
+  module CLI
+    class App < Slack::CLI::Base
+      desc 'channels SUBCOMMAND ...ARGS', 'Channel-related commands'
+      subcommand 'channels', Slack::CLI::Channels
+
+      desc 'im SUBCOMMAND ...ARGS', 'IM-related commands'
+      subcommand 'im', Slack::CLI::IM
+
+      desc 'users SUBCOMMAND ...ARGS', 'User-related commands'
+      subcommand 'users', Slack::CLI::Users
+
+      desc 'config SUBCOMMAND ...ARGS', 'Configuration-related commands'
+      subcommand 'config', Slack::CLI::Config
+
+      method_option :oldest,
+        aliases: '-o',
+        type:    'string',
+        desc:    'Slack timestamp of the oldest message to export'
+      method_option :latest,
+        aliases: '-l',
+        type:    'string',
+        desc:    'Slack timestamp of the latest message to export'
+      method_option :count,
+        aliases: '-c',
+        type:    'numeric',
+        desc:    'Maximum number of messages to export'
+
+      desc 'export <channel-id> [OPTIONS]',
+        'Export Slack data from <channel-id>.'
+      def export(channel_id)
+        args = options.merge(channel: channel_id)
+
+        if args.key?(:oldest)
+          parse_slack_timestamp(args[:oldest])
+        end
+
+        if args.key?(:latest)
+          args[:latest] = parse_slack_timestamp(args[:latest])
+        end
+
+        case channel_id
+        when /^C/
+          puts client.channels.history(args)
+        when /^D/
+          puts client.im.history(args)
+        else
+          fail ArgumentError, "Unknown channel format (got `#{channel_id}')"
+        end
+      end
+    end
+  end
+end

data/lib/slack/cli/base.rb

@@ -0,0 +1,39 @@
+require 'slack/client'
+
+require 'thor'
+require 'multi_json'
+
+module Slack
+  module CLI
+    CONFIG_DIR  = File.join(Dir.home, '.slack-client')
+    CONFIG_FILE = File.join(CONFIG_DIR, 'config')
+
+    class Base < Thor
+      class_option :token,
+        aliases:     '-t',
+        desc:        'Your Slack API token'
+
+      private
+
+      def dump_json(obj)
+        MultiJson.dump(obj)
+      end
+
+      def load_json(json)
+        MultiJson.load(json)
+      end
+
+      def wrap_json(json)
+        dump_json(yield(load_json(json)))
+      end
+
+      def client
+        @client ||= Slack::Client.new(token: client_token)
+      end
+
+      def client_token
+        options[:token] || ENV['SLACK_TOKEN']
+      end
+    end
+  end
+end

data/lib/slack/cli/channels.rb

@@ -0,0 +1,20 @@
+module Slack
+  module CLI
+    class Channels < Slack::CLI::Base
+      desc 'list', 'List all channels'
+      def list
+        puts client.channels.list
+      end
+
+      desc 'history <channel-id>', 'Print channel history for <channel-id>'
+      def history(channel_id)
+        puts client.channels.history(channel: channel_id)
+      end
+
+      desc 'info <channel-id>', 'Print channel info for <channel-id>'
+      def info(channel_id)
+        puts client.channels.history(channel: channel_id)
+      end
+    end
+  end
+end

data/lib/slack/cli/config.rb

@@ -0,0 +1,17 @@
+module Slack
+  module CLI
+    class Config < Slack::CLI::Base
+      desc 'set <OPTION="value" ...>',
+        "Update settings #{Slack::CLI::CONFIG_FILE}"
+      def set(*args)
+        unless Dir.exist?(Slack::CLI::CONFIG_DIR)
+          Dir.mkdir(Slack::CLI::CONFIG_DIR)
+        end
+
+        File.open(Slack::CLI::CONFIG_FILE, 'w') do |f|
+          f.puts args
+        end
+      end
+    end
+  end
+end

data/lib/slack/cli/im.rb

@@ -0,0 +1,15 @@
+module Slack
+  module CLI
+    class IM < Slack::CLI::Base
+      desc 'list', 'List all IMs'
+      def list
+        puts client.im.list
+      end
+
+      desc 'history <channel-id>', 'Display IM history for <channel-id>'
+      def history(channel_id)
+        puts client.channels.history(channel: channel_id)
+      end
+    end
+  end
+end

data/lib/slack/cli/users.rb

@@ -0,0 +1,19 @@
+module Slack
+  module CLI
+    class Users < Slack::CLI::Base
+      desc 'list', 'List all Slack users'
+      def list
+        puts client.users.list
+      end
+
+      desc 'info <user-id>', 'Display user info for <user-id>'
+      def info(user_id)
+        results = wrap_json(client.users.list) do |data|
+          data['members'].find { |m| m['id'] == user_id }
+        end
+
+        puts results
+      end
+    end
+  end
+end

data/lib/slack/client.rb

@@ -0,0 +1,16 @@
+require 'slack/api'
+
+module Slack
+  class Client
+    attr_accessor :token
+    attr_reader :channels, :im, :users
+
+    def initialize(args = {})
+      @token = args[:token]
+
+      @channels = Slack::API::Channels.new(token: @token)
+      @im       = Slack::API::IM.new(token: @token)
+      @users    = Slack::API::Users.new(token: @token)
+    end
+  end
+end

data/lib/slack/utils.rb

@@ -0,0 +1,25 @@
+module Slack
+  module Utils
+    module_function
+
+    # Public: Extracts the timestamp information encoded in a Slack-style
+    # timestamp (e.g., "p1409120227001488").
+    #
+    # slack_ts - The Slack-tyle timestamp, e.g., "p1409120227001488"
+    #
+    # Returns a Float containing the timestamp in UNIX time w/ milliseconds.
+    #
+    # Examples
+    #
+    #   parse_slack_timestamp("p1409120227001488") # => 1409120227.001488
+    #   parse_slack_timestamp("s1409192267000101") # => 1409192267.000101
+    def self.parse_slack_timestamp(slack_ts)
+      if match = slack_ts.match(/\A[a-z](\d+)\z/i)
+        match[1].to_f / 10**6
+      else
+        fail ArgumentError,
+          "argument does not look like a Slack timestamp (got `#{slack_s}')"
+      end
+    end
+  end
+end

data/lib/slack/version.rb

@@ -0,0 +1,3 @@
+module Slack
+  VERSION = '0.0.1'
+end

data/slack-client.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'slack/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'slack-client'
+  spec.version       = Slack::VERSION
+  spec.authors       = ['Jesse Farmer']
+  spec.email         = ['jesse@codeunion.io']
+  spec.summary       = 'Ruby Slack API gem'
+  spec.description   = 'A Ruby client for the Slack API.'
+  spec.homepage      = 'http://github.com/codeunion/slack-client'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'faraday',     '~> 0.9'
+  spec.add_runtime_dependency 'addressable', '~> 2.3'
+  spec.add_runtime_dependency 'thor',        '~> 0.19'
+  spec.add_runtime_dependency 'multi_json',  '~> 1.10'
+  spec.add_runtime_dependency 'dotenv',      '~> 0.11'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rubocop', '~> 0.25'
+  spec.add_development_dependency 'rake',    '~> 10.0'
+end

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification
+name: slack-client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jesse Farmer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: A Ruby client for the Slack API.
+email:
+- jesse@codeunion.io
+executables:
+- slack
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/slack
+- lib/slack-client.rb
+- lib/slack/api.rb
+- lib/slack/api/base.rb
+- lib/slack/api/channels.rb
+- lib/slack/api/im.rb
+- lib/slack/api/users.rb
+- lib/slack/cli.rb
+- lib/slack/cli/app.rb
+- lib/slack/cli/base.rb
+- lib/slack/cli/channels.rb
+- lib/slack/cli/config.rb
+- lib/slack/cli/im.rb
+- lib/slack/cli/users.rb
+- lib/slack/client.rb
+- lib/slack/utils.rb
+- lib/slack/version.rb
+- slack-client.gemspec
+homepage: http://github.com/codeunion/slack-client
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby Slack API gem
+test_files: []