OSS Gate Workshop: akatsuki: 2019-02-25: bluexxsun: slack-api: Work log

[bluexxsun]

This is a work log of a "OSS Gate workshop".
"OSS Gate workshop" is an activity to increase OSS developers.
Here's been discussed in Japanese. Thanks.

作業ログ作成時の説明

以下のテンプレートを埋めてタイトルに設定します。埋め方例はスクロールすると見えてきます。

OSS Gate Workshop: ${LOCATION}: ${YEAR}-${MONTH}-${DAY}: ${ACCOUNT_NAME}: ${OSS_NAME}: Work log

タイトル例↓：

OSS Gate Workshop: Tokyo: 2017-01-16: kou: Rabbit: Work log

OSS Gateワークショップ関連情報

• スライド：ワークショップの進行に使っているスライドがあります。
• チャット：OSS開発に関することならなんでも相談できます。ワークショップが終わった後もオンラインで相談しながら継続的にOSSの開発に参加しましょう！
• シナリオ：ワークショップの目的・内容・進め方の詳細が書いています。
• 過去のビギナーの作業ログ：他の人の作業ログから学べることがいろいろあるはずです。

[bluexxsun]

「gem slack-api」で検索
rubygems.orgのページを開く
右側に「LICENSE: MIT」を確認

[bluexxsun]

右側の
LINKS: Homepage から git のリポジトリに移動、ここでもMIT LICENSEを確認

[bluexxsun]

ディレクトリ作成してrailsアプリを作る

mkdir oss-gate
cd oss-gate
rails new oss

rails入ってなかった...

Rails is not currently installed on this system. To get the latest version, simply type:

    $ sudo gem install rails

You can then rerun your "rails" command.

[bluexxsun]

改めてrailsアプリを作成、atomでプロジェクトを開いてGemFileを確認

sudo gem install rails
rails new oss
atom oss

[bluexxsun]

デフォルトで色々と入っているけどslack-apiが入っていないことは確認済み

↓Gemfile

source 'https://rubygems.org'
git_source(:github) { |repo| "https://github.com/#{repo}.git" }

ruby '2.3.7'

# Bundle edge Rails instead: gem 'rails', github: 'rails/rails'
gem 'rails', '~> 5.2.2'
# Use sqlite3 as the database for Active Record
gem 'sqlite3'
# Use Puma as the app server
gem 'puma', '~> 3.11'
# Use SCSS for stylesheets
gem 'sass-rails', '~> 5.0'
# Use Uglifier as compressor for JavaScript assets
gem 'uglifier', '>= 1.3.0'
# See https://github.com/rails/execjs#readme for more supported runtimes
# gem 'mini_racer', platforms: :ruby

# Use CoffeeScript for .coffee assets and views
gem 'coffee-rails', '~> 4.2'
# Turbolinks makes navigating your web application faster. Read more: https://github.com/turbolinks/turbolinks
gem 'turbolinks', '~> 5'
# Build JSON APIs with ease. Read more: https://github.com/rails/jbuilder
gem 'jbuilder', '~> 2.5'
# Use Redis adapter to run Action Cable in production
# gem 'redis', '~> 4.0'
# Use ActiveModel has_secure_password
# gem 'bcrypt', '~> 3.1.7'

# Use ActiveStorage variant
# gem 'mini_magick', '~> 4.8'

# Use Capistrano for deployment
# gem 'capistrano-rails', group: :development

# Reduces boot times through caching; required in config/boot.rb
gem 'bootsnap', '>= 1.1.0', require: false

group :development, :test do
  # Call 'byebug' anywhere in the code to stop execution and get a debugger console
  gem 'byebug', platforms: [:mri, :mingw, :x64_mingw]
end

group :development do
  # Access an interactive console on exception pages or by calling 'console' anywhere in the code.
  gem 'web-console', '>= 3.3.0'
  gem 'listen', '>= 3.0.5', '< 3.2'
  # Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring
  gem 'spring'
  gem 'spring-watcher-listen', '~> 2.0.0'
end

group :test do
  # Adds support for Capybara system testing and selenium driver
  gem 'capybara', '>= 2.15'
  gem 'selenium-webdriver'
  # Easy installation and use of chromedriver to run system tests with Chrome
  gem 'chromedriver-helper'
end

# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby]

[bluexxsun]

公式のリポジトリを見つつインストール

Gemfileの最後に

gem 'slack-api'

を追記。

その後コマンド実行

bundle

cdしてなかった

Could not locate Gemfile

改めてコマンド実行

bundle

[bluexxsun]

ちょっと勘違いしていたらしく rails を使わなくても bundler だけでいけるっぽいので、Railsアプリを一旦やめて戻って bundler から
bundlerの説明を見つつ進める

cd ~/oss 
sudo gem install bundler

パーミッションエラー。

Fetching: bundler-2.0.1.gem (100%)
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.

改めてinstall

sudo gem install bundler

[bluexxsun]

Gemfileを作成して書き込む

↓Gemfile作成

touch Gemfile
atom Gemfile

↓Gemfileの中身

source 'https://rubygems.org' do
  # Gems here
  gem 'slack-api'
end

[bluexxsun]

slack-apiの説明通りにコマンド実行

bundle

2回パスワードを要求されるがインストールされたらしい

Fetching gem metadata from https://rubygems.org/..........
Resolving dependencies...
Using bundler 2.0.1
Following files may not be writable, so sudo is needed:
  /Library/Ruby/Gems/2.3.0
  /Library/Ruby/Gems/2.3.0/build_info
  /Library/Ruby/Gems/2.3.0/cache
  /Library/Ruby/Gems/2.3.0/doc
  /Library/Ruby/Gems/2.3.0/extensions
  /Library/Ruby/Gems/2.3.0/gems
  /Library/Ruby/Gems/2.3.0/specifications
Fetching eventmachine 1.2.7


Your user account isn't allowed to install to the system RubyGems.
  You can cancel this installation and run:

      bundle install --path vendor/bundle

  to install the gems into ./vendor/bundle/, or you can enter your password
  and install the bundled gems to RubyGems using sudo.

  Password: 


Your user account isn't allowed to install to the system RubyGems.
  You can cancel this installation and run:

      bundle install --path vendor/bundle

  to install the gems into ./vendor/bundle/, or you can enter your password
  and install the bundled gems to RubyGems using sudo.

  Password: 
Installing eventmachine 1.2.7 with native extensions
Using multipart-post 2.0.0
Using faraday 0.15.4
Fetching faraday_middleware 0.10.1
Installing faraday_middleware 0.10.1
Using websocket-extensions 0.1.3
Using websocket-driver 0.7.0
Fetching faye-websocket 0.10.7
Installing faye-websocket 0.10.7
Using multi_json 1.13.1
Fetching slack-api 1.6.1
Installing slack-api 1.6.1
Bundle complete! 1 Gemfile dependency, 10 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.

[bluexxsun]

Usageがあるので実行してみる

touch slack-test.rb
atom slack-test.rb

require "slack"

Slack.configure do |config|
  config.token = "YOUR_TOKEN"
end

Slack.auth_test

"YOUR_TOKEN"って書いてあるのでSlackのトークンが必要そう

[bluexxsun]

「slack token」で検索してトークンの事が書かれているっぽい所に行く

user token なるものが実験してみるのに良さそうなので「generate slack user token」で再度検索
英語のドキュメント見てたけど普通に日本語のページがあった→トークンの作り方を見つけてトークンを作成

[bluexxsun]

"YOUR_TOKEN"に値を入れて実験

ruby slack-test.rb

何も出力されない...

[bluexxsun]

コード良く見たら出力してないので p を追加して無理矢理出力するように変更

require "slack"

Slack.configure do |config|
  config.token = "YOUR_TOKEN"
end

p Slack.auth_test

再実行！

ruby slack-test.rb

うまく動いてるっぽい！(実際の値は隠してます)

{"ok"=>true, "url"=>"**********", "team"=>"**********", "user"=>"**********", "team_id"=>"**********", "user_id"=>"**********"}

[bluexxsun]

同期から「これ irb での実行前提では？」との事。
確かに irb だったら戻り値見られるけど、それだったら irb って明記して欲しいような。