rabbit-slide-unasuke-omotesandorb-49 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7f92821c2ed020ee61e5f58e0c5604585f78ae2e55306152c6221e6bc9a97d06
+  data.tar.gz: 6f8186bf8a6796b636d8fa6011046e7315f6ba8b261de53da31d566c251837df
+SHA512:
+  metadata.gz: 10322592a1f6903a8179969021acb041afbb0d877fdda0ee3879057b68722a0999875d887926c2c53cb9fffb2ab33135ed315058f7e1f36ff3693f9a7444ec88
+  data.tar.gz: 3ec5cb3e2f8e98cd3c2fc86860ebbd9100cc4f2b55c180b6d9af078db2e121d6e9db0f85c4156785e1ec6a70ec5d3f430db05e6fbb3033879d99283ae4993135

data/.rabbit

@@ -0,0 +1 @@
+slide.md

data/README.md

@@ -0,0 +1,22 @@
+# omotesandorb #49
+
+## 作者向け
+
+### 表示
+
+    rake
+
+### 公開
+
+    rake publish
+
+## 閲覧者向け
+
+### インストール
+
+    gem install rabbit-slide-unasuke-omotesandorb-49
+
+### 表示
+
+    rabbit rabbit-slide-unasuke-omotesandorb-49.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,19 @@
+---
+id: omotesandorb-49
+base_name: slide
+tags: ['ruby', 'rails', 'openapi']
+presentation_date: 
+version: 1.0.0
+licenses: []
+slideshare_id: 
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+author:
+  markup_language: :markdown
+  name: unasuke
+  email: yusuke1994525@gmail.com
+  rubygems_user: unasuke
+  slideshare_user: 
+  speaker_deck_user: 

data/slide.md

@@ -0,0 +1,87 @@
+# OpenAPI 3 によるスキーマラスト開発
+subtitle
+: 2019-08-01
+
+subtitle
+: 表参道.rb #49
+
+author
+: うなすけ
+
+theme
+: unasuke-white
+
+
+# 自己紹介
+- 名前 : うなすけ
+- 仕事 : 株式会社バンク (エンジニア)
+  - インフラ寄りサーバーサイドエンジニア
+  - Ruby, Rails, Kubernetes...
+
+- {::tag name="x-small"}GitHub [@unasuke](https://github.com/unasuke){:/tag}
+- {::tag name="x-small"}Mastodon [@unasuke@mstdn.unasuke.com](https://mstdn.unasuke.com/@unasuke){:/tag}
+- {::tag name="x-small"}Twitter [@yu\_suke1994](https://twitter.com/yu_suke1994){:/tag}
+
+![](img/icon_raw.jpg){:relative_width="24" align="right" relative_margin_right="-10" relative_margin_top="42"}
+
+# OpenAPI 3
+![](https://www.openapis.org/wp-content/uploads/sites/3/2018/02/OpenAPI_Logo_Pantone-1.png){:relative_width="90"}
+
+<https://www.openapis.org/>
+
+- YAMLやJSONで REST APIの仕様を記述するやつ
+- Swaggerとか聞いたことある人多いんでは
+
+# OpenAPI 3
+- スキーマファースト開発で使われる
+  - serverとclientがAPIのschemaを定義してから開発
+    - 手戻りが少ない
+    - documentができる
+- [スキーマファースト開発のススメ - onk.ninja](https://blog.onk.ninja/2017/09/21/schema_first_development)
+
+# OpenAPI 3 例
+```yaml
+openapi: 3.0.0
+info:
+  title: Sample API
+  description: Optional multiline or single-line description
+  version: 0.1.9
+servers:
+  - url: http://api.example.com/v1
+    description: Optional server description, e.g. Main (production) server
+  - url: http://staging-api.example.com
+    description: Optional server description, e.g. Internal staging server for testing
+paths:
+  /users:
+    get:
+      summary: Returns a list of users.
+      description: Optional extended description in CommonMark or HTML.
+      responses:
+        '200':    # status code
+          description: A JSON array of user names
+```
+
+<https://swagger.io/docs/specification/basic-structure/>
+
+# 現実世界には様々なことがある
+- 途中からOpenAPIを導入したい
+ - 大量の定義を書かねばならぬ
+  - タスクがパンク
+    - 終了
+
+# `config/routes.rb` があるじゃん
+- ここからなんとか paths のやつだけ自動生成できないか？
+
+# できた
+<https://github.com/unasuke/openapi3_definition_generator-rails>
+
+# つらみ
+ここからコードを見ながら話します
+
+# つらみ
+- 何もかもがPrivate API
+
+# まとめ
+- 今月中にブログ書きます
+
+![](img/esa-wip.png){:relative_width='100'}

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-unasuke-omotesandorb-49
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- unasuke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-08-01 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: ''
+email:
+- yusuke1994525@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- img/esa-wip.png
+- img/icon_raw.jpg
+- pdf/omotesandorb-49-slide.pdf
+- slide.md
+homepage: http://slide.rabbit-shocker.org/authors/unasuke/omotesandorb-49/
+licenses: []
+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: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: 'omotesandorb #49'
+test_files: []