rabbit-slide-kenhys-tokyodebian-debbugs-soap-20170520 2017.05.20.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7c53d3447446e260731decc63fd92b4ed596f9e2
+  data.tar.gz: b7387c57ecec9ec73c9d8fe8483cf3e814bf1630
+SHA512:
+  metadata.gz: 5cac9153370b119accf4e29a34e3d4b66e58b003144307e94eb66c43a062709da7b3df8efdf9976ed4ea9b375efe2007173037bcb95a33b2e23ed3e94ecc72df
+  data.tar.gz: f421492d8edc751f16ab12c82f702025b06a29cafd3386056f3ae9de4d0207b850305f3b198c2881e4d546abe7bdddc3eea6d8a821e46d2ec70f5dcf4a207693

data/.rabbit

@@ -0,0 +1 @@
+debbugs-soap.rab

data/README.md

@@ -0,0 +1,24 @@
+# Debbugsとの付き合い方:SOAP編
+
+2017年5月20日に開催された東京エリアDebian勉強会の発表資料です。
+
+## 作者向け
+
+### 表示
+
+  rake
+
+### 公開
+
+  rake publish
+
+## 閲覧者向け
+
+### インストール
+
+  gem install rabbit-slide-kenhys-tokyodebian-debbugs-soap-20170520
+
+### 表示
+
+  rabbit rabbit-slide-kenhys-tokyodebian-debbugs-soap-20170520.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  # spec.add_runtime_dependency("YOUR THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,22 @@
+---
+id: tokyodebian-debbugs-soap-20170520
+base_name: debbugs-soap
+tags:
+- rabbit
+- debbugs
+presentation_date: 
+version: 2017.05.20.1
+licenses: 
+- CC-BY-SA-4.0
+slideshare_id: 
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+author:
+  markup_language: :rd
+  name: Kentaro Hayashi
+  email: kenhys@gmail.com
+  rubygems_user: kenhys
+  slideshare_user: 
+  speaker_deck_user: 

data/debbugs-soap.rab

@@ -0,0 +1,367 @@
+= Debbugsとの\nつきあいかた
+
+: subtitle
+  SOAP編
+: author
+  Kentaro Hayashi
+: institution
+  ClearCode Inc.
+: content-source
+  東京エリアDebian勉強会
+: date
+  2017-05-20
+: allotted-time
+  15m
+: theme
+  .
+
+= 自己紹介(1)
+
+  # image
+  # relative-height = 40
+  # src = https://pbs.twimg.com/profile_images/2290018079/cvcy12slbeva80jboxzf_400x400.png
+
+* Twitter/GitHub: @kenhys
+* 所属: ((*トラックポイント・ソフトドーム派*))
+
+= 自己紹介(2)
+
+  # image
+  # relative-height = 60
+  # src = images/track-points.png
+
+* トラックポイント・ソフトドーム派
+
+= 参考画像の出典
+
+  # image
+  # relative-height = 80
+  # src = images/irasutoya.png
+
+* http://www.irasutoya.com/
+
+= パッケージ関連の活動
+
+* groonga (全文検索エンジン)
+* groonga-normalizer-mysql
+* libhinawa
+* fcitx-imlist
+* hal-flash (Flashを延命させるアレ)
+* growl-for-linux
+
+= 閑話休題
+
+(('tag:center'))
+そろそろ本題に
+
+= 本日の話題
+
+* Debbugsとのつきあいかた:SOAP編
+
+= 本日の話題
+
+* Debbugsとのつきあいかた((*:SOAP編*))
+
+= 話さないこと
+
+* Debbugsのふつうの使い方
+
+= Debbugsとは？
+
+  # image
+  # relative-height = 100
+  # src = images/debbugs-debbugs.png
+
+= Debbugsとは？
+
+* 1994年 Ian Jackson氏が開発を始めた\n
+  Issueトラッキングシステム
+* GNOMEやKDEもかつて採用していた\n
+  →Bugzillaへ移行した
+
+= ふつうの人のバグ報告(1)
+
+  # image
+  # relative-height = 80
+  # src = images/reportbug.png
+
+* Reportbug!
+
+= ふつうの人のバグ報告(2)
+
+  # image
+  # relative-height = 80
+  # src = images/reportbug-ng.png
+
+* Reportbug-NG!
+
+= Debbugsのよいところ
+
+* メールで気軽にバグ報告
+* 報告にログインとか不要
+* 一見さんをカジュアルに殺せる初見殺し機能搭載
+
+= Debbugsの見方
+
+  # image
+  # relative-height = 80
+  # src = images/debbugs-status.png
+
+* [重要度|タグ|状態]
+
+= Debbugsの重要度
+
+* m: minor
+* w: wishlist
+* n: normal
+* S: serious
+* G: grave
+
+= Debbugsのタグ
+
+* +: patch
+* ☹: wontfix
+* M: moreinfo
+* P: pending
+
+= Debbugsの状態
+
+* ♔: blocks
+* ☣: affects
+* ☺: fixed
+
+= なぜDebbugsに興味を?
+
+* 社内のグループチャットがZulip
+  * https://zulip.org/
+* Zulipのbotにdebbugsをサポートさせたい
+  * https://github.com/okkez/pragmatic-bot
+* バグ報告のURLを貼り付けたらbotに処理させたい
+
+= botに処理させるには？
+
+* bugs.d.oをスクレイピング？
+* もっといいやりかたはない？
+
+= SOAP!
+
+* https://wiki.debian.org/DebbugsSoapInterface
+
+= サンプルコードもあるよ
+
+    require 'soap/rpc/driver'
+
+    host = "bugs.debian.org"
+    port = 80
+    server="http://#{host}:#{port}/cgi-bin/soap.cgi"
+    ns = 'Debbugs/SOAP/'
+    drv = SOAP::RPC::Driver.new(server, ns)
+    drv.wiredump_dev = STDOUT if $DEBUG
+    drv.add_method('get_status','bugnumber')
+    drv.add_method('get_bugs','keyparam')
+
+    p drv.get_status(drv.get_bugs(['package', 'pbuilder', 'severity', 'wishlist']))
+
+* Ruby 1.8 or ((*修正済みsoap4r*))じゃないと動かない
+
+= Rubyの事情
+
+* soap4rはもともとRuby 1.8にバンドル
+* Ruby 1.9ではバンドルされなくなった
+* soap4rはメンテされなくなった
+* 雨後の筍 soap4r
+
+= 雨後の筍 soap4r
+
+* soap4r-ng (2.0.3)
+* soap4r-r19 (1.5.9) Ruby1.9対応版
+* soap4r-ruby1.9 (2.0.5) Ruby1.9対応版
+* soap4r-ruby19 (1.5.9) Ruby1.9対応版
+
+= soapXr
+
+* soap2r (1.5.8) soap4rの後にリリース
+* soap5r (2.0.3)
+
+= upstream on Debian
+
+* ruby-soap4r
+  * https://github.com/noeticpenguin/soap4r-noeticpenguin
+
+= 混沌とした世界
+
+* あまり踏み込まないほうがよい予感
+
+= SOAPを使うには
+
+* ポイント:WSDL
+
+= WSDL
+
+* Web Services Description Language
+  * Webサービス記述言語
+  * XMLでインターフェースを定義する
+  * WSDLを元にSOAPで通信
+
+= DebbugsのWSDL
+
+* https://wiki.debian.org/DebbugsSoapInterface
+* ((*一切言及はない*))
+* どうなってるの？
+
+= WSDLを探せ
+
+  # image
+  # relative-height = 70
+  # src = images/debbugs-wsdl-found.png
+
+* Emacs使いはdebbugs.el
+  * https://elpa.gnu.org/packages/debbugs.html
+
+= Debbugs.wsdl
+
+* Debbugs用のWSDL
+* debian.orgとgnu.orgのdebbugsで使える
+
+= WSDLの構造
+
+* <wsdl:definitions>の子要素として定義
+  * <wsdl:types>
+  * <wsdl:message>
+  * <wsdl:portType>
+  * <wsdl:binding>
+  * <wsdl:service>
+
+= <wsdl:types>
+
+
+   <complexType name="ArrayOfBugNumber">
+     <complexContent>
+       <restriction base="soapenc:Array">
+         <attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[]"/>
+       </restriction>
+     </complexContent>
+   </complexType>
+
+* データ型の定義をする
+  * 例:バグ番号の配列を定義
+
+= <wsdl:message>
+
+    <wsdl:message name="get_statusRequest">
+      <wsdl:part name="bugs" type="types:ArrayOfBugNumber"/>
+    </wsdl:message>
+    <wsdl:message name="get_statusResponse">
+      <wsdl:part name="s-gensym3" type="apachens:Map"/>
+    </wsdl:message>
+
+* データの抽象的な定義
+  * 例:ステータス取得時にやりとりするデータの定義
+
+= <wsdl:portType>
+
+* 操作の定義 <wsl:operation>を含む
+
+    <wsdl:portType name="Debbugs/SOAP">
+      <wsdl:operation name="get_status" parameterOrder="bugs">
+        ...
+      </wsdl:operation>
+      <wsdl:operation name="get_bug_log" parameterOrder="bugnumber">
+        ...
+      </wsdl:operation>
+    </wsdl:portType>
+
+= <wsdl:operation>
+
+    <wsdl:operation name="get_status" parameterOrder="bugs">
+      <wsdl:input message="tns:get_statusRequest">
+        <soap:body
+              encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
+              namespace="urn:Debbugs/SOAP"
+              use="encoded"/>
+      </wsdl:input>
+      <wsdl:output message="tns:get_statusResponse">
+        <soap:body
+              encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
+              namespace="urn:Debbugs/SOAP"
+              use="encoded"/>
+      </wsdl:output>
+    </wsdl:operation>
+
+* 操作の入出力を定義
+  * 例:ステータス取得時の入出力を定義
+
+= <wsdl:binding>
+
+* portTypeで定義した操作のプロトコルを指定
+
+    <wsdl:binding name="Debbugs/SOAP/BINDING" type="tns:Debbugs/SOAP">
+      <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
+      <wsdl:operation name="get_status">
+        ...
+      </wsdl:operation>
+    </wsdl:binding>
+
+= <wsdl:service>
+
+* 通信先を定義
+
+    <wsdl:service name="Debbugs/SOAP/SERVICE">
+      <wsdl:port binding="tns:Debbugs/SOAP/BINDING" name="gnu.org">
+        <wsdlsoap:address location="http://debbugs.gnu.org/cgi/soap.cgi"/>
+      </wsdl:port>
+      <wsdl:port binding="tns:Debbugs/SOAP/BINDING" name="debian.org">
+        <wsdlsoap:address location="http://bugs.debian.org/cgi-bin/soap.cgi"/>
+      </wsdl:port>
+    </wsdl:service>
+
+= 実践:debbugs
+
+* 実際にSOAPでやりとりしてみるには
+
+= 何を使う？
+
+* savon
+  * http://savonrb.com/
+  * RubyのSOAP clientライブラリー
+
+= savonの使い方
+
+* require "savon"
+* WSDLからクライアントのインスタンス作成
+* callでdebbugsのメソッドを呼ぶ
+* レスポンスを表示する
+
+= savonクライアント
+
+    client = Savon.client(wsdl: "(WSDLのURL)",
+                          endpoint: "http://bugs.debian.org/cgi-bin/soap.cgi",
+                          namespace: "Debbugs/SOAP")
+
+* クライアント作成
+
+= メソッドを呼ぶ
+
+    # fetch status of pbuilder specific bugs
+    response = client.call(:get_status) do
+      message(bugs: ["807406", "837812"])
+    end
+    
+* 例: get_statusメソッドを呼ぶ
+
+= レスポンスを表示する
+
+    bugs = response.body[:get_status_response][:s_gensym3][:item]
+    bugs.each do |bug|
+      item = bug[:value]
+      puts "#{bug[:key]}:#{item[:pending]}:#{item[:subject]}"
+    end
+    #=> 
+    807406:pending:pbuilder: drop all the 'xenial' (...)
+    837812:pending:[pbuilder] New hook improving dpkgi
+    
+= まとめ
+
+* debbugsにはSOAPインターフェースがある
+* Debbug.wsdlはdebbugs.el方面から入手せよ
+* Rubyから使うならsoap4r(修正版) or savonを使え

data/theme.rb

@@ -0,0 +1 @@
+include_theme("debian")

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kenhys-tokyodebian-debbugs-soap-20170520
+version: !ruby/object:Gem::Version
+  version: 2017.05.20.1
+platform: ruby
+authors:
+- Kentaro Hayashi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: 2017年5月20日に開催された東京エリアDebian勉強会の発表資料です。
+email:
+- kenhys@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- debbugs-soap-interface-not-work.png
+- debbugs-soap.rab
+- images/computer_trackpoint_classicdome.png
+- images/computer_trackpoint_softdome.png
+- images/computer_trackpoint_softrim.png
+- images/debbugs-debbugs.png
+- images/debbugs-status.png
+- images/debbugs-wsdl-found.png
+- images/irasutoya.png
+- images/reportbug-ng.png
+- images/reportbug.png
+- images/track-points.png
+- pdf/tokyodebian-debbugs-soap-20170520-debbugs-soap.pdf
+- theme.rb
+homepage: http://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-debbugs-soap-20170520/
+licenses:
+- CC-BY-SA-4.0
+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.6.11
+signing_key: 
+specification_version: 4
+summary: Debbugsとの付き合い方:SOAP編
+test_files: []