rabbit-slide-niku-elixir-conf-japan-2017-04-01-lt 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6f3a2b48a7f2cb28004b3aaaffca95e58cabf21a
+  data.tar.gz: 6cf050253cf0d513c59f46ffdf6425e516367efe
+SHA512:
+  metadata.gz: 24119dcc72962f715a0e0fbbed5dfe06bb53a1e0077c01b34602ac1607a7932a11cb09ca3c95e5355536756a8b68cb7550088e861ef7f7bb80caefd7e09aba32
+  data.tar.gz: a7d2189f032727e0620dcf3b8c4ede780fdae701f18897be26903fa68ddc2ccb2ca7bd526205304a066918d60d5cea2357e6fcd9fb5d39d4410f5ca294543637

data/.rabbit

@@ -0,0 +1 @@
+elixir-conf-japan-2017-04-01-lt.md

data/README.md

@@ -0,0 +1,23 @@
+# Elixir client from OpenAPI(Swagger) definition
+
+Elixir client from OpenAPI(Swagger) definition
+
+## 作者向け
+
+### 表示
+
+    rake
+
+### 公開
+
+    rake publish
+
+## 閲覧者向け
+
+### インストール
+
+    gem install rabbit-slide-niku-elixir-conf-japan-2017-04-01-lt
+
+### 表示
+
+    rabbit rabbit-slide-niku-elixir-conf-japan-2017-04-01-lt.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: elixir-conf-japan-2017-04-01-lt
+base_name: elixir-conf-japan-2017-04-01-lt
+tags: [elixir, swagger, openapi]
+presentation_date: 2017-04-01
+version: 1.0.0
+licenses: [MIT]
+slideshare_id:
+speaker_deck_id:
+ustream_id:
+vimeo_id:
+youtube_id:
+author:
+  markup_language: :markdown
+  name: niku
+  email: niku@niku.name
+  rubygems_user: niku
+  slideshare_user:
+  speaker_deck_user:

data/elixir-conf-japan-2017-04-01-lt.md

@@ -0,0 +1,237 @@
+# Elixir client from OpenAPI(Swagger) definition
+
+author
+: niku
+
+date
+: 2017/04/01
+
+allotted-time
+: 5m
+
+# About Me
+
+twitter: niku_name
+github: niku
+
+![](niku.png){:relative_height='80'}
+
+Live in Sapporo City, Hokkaido
+
+# About Me
+
+A member of Sapporo.beam
+
+- Local meetup for ErlangVM
+- In Sapporo City, Hokkaido
+- On every thursday
+- Since 2014-02-12
+- Next 161th
+
+# About Me
+
+An elixir-lang contributer
+
+```
+/Users/niku/src/elixir-head% git log --author=niku
+commit a4028e73604807b9e13a5404a98e9f51d2a1eb0d
+Author: niku <niku@niku.name>
+Date:   Mon Dec 12 17:27:28 2016 +0900
+
+    Make the example a valid mix project (#5555)
+
+commit 5b9b186d4b6f78f83211821bb4453897be14c13b
+Author: niku <niku@niku.name>
+Date:   Sun Aug 3 22:58:55 2014 +0900
+
+    Improve IEx docs about .iex.exs
+
+commit e68f617e2add9772082b09c4e35cc03c2cc5bd04
+Author: niku <niku@niku.name>
+Date:   Tue Jul 29 23:46:52 2014 +0900
+
+    Remove duplicate test
+```
+
+# Elixir
+
+I ♡ Elixir and ErlangVM.
+
+# A hard thing
+
+In many cases, Official SDK for ErlangVM haven't been provided (yet).
+
+![](aws-sdk.png){:relative_height='100'}
+
+# Should I make a elixir client to each service?
+
+(╯ಠ~ಠ）╯︵ ┻━┻
+
+# OpenAPI(Swagger)
+
+[https://github.com/OAI/OpenAPI-Specification](https://github.com/OAI/OpenAPI-Specification)
+
+> language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service
+
+# OpenAPI definition example
+
+write in yaml or json
+
+```yaml
+swagger: '2.0'
+info:
+  version: 0.1.0
+  title: Simple API
+paths:
+  /:
+    get:
+      responses:
+        200:
+          description: OK
+```
+
+# OpenAPI definition example
+
+![](swagger-definition.png){:relative_height='100'}
+
+# Generate from OpenAPI definition
+
+[https://github.com/swagger-api/swagger-codegen#template-creator](https://github.com/swagger-api/swagger-codegen#template-creator)
+
+![](swagger-codegen-template-creator.png){:relative_height='100'}
+
+# OpenAPI online editor
+
+[http://editor.swagger.io/](http://editor.swagger.io/)
+
+![](swagger-editor-1.png){:relative_height='100'}
+
+# OpenAPI online editor
+
+You can download an elixir client generated from OpenAPI definition
+
+![](swagger-editor-2.png)
+
+# An elixir client generated from OpenAPI definition
+
+```
+/Users/niku/Downloads/elixir-client% tree
+.
+├── README.md
+├── config
+│   └── config.exs
+├── lib
+│   └── swagger_petstore
+│       ├── api
+│       │   ├── pet.ex
+│       │   ├── store.ex
+│       │   └── user.ex
+│       └── model
+│           ├── apiResponse.ex
+│           ├── category.ex
+│           ├── order.ex
+│           ├── pet.ex
+│           ├── tag.ex
+│           └── user.ex
+├── mix.exs
+└── test
+    └── test_helper.exs
+
+6 directories, 13 files
+```
+
+# Use an elixir client
+
+Add new pet (definition)
+
+![](add_pet.png){:relative_height='100'}
+
+# Use an elixir client
+
+Add new pet (code)
+
+named `ElixirConfJa2017`
+
+```ruby
+SwaggerPetstore.Api.Pet.add_pet(%{"name" => "ElixirConfJa2017"})
+```
+
+# Use an elixir client
+
+```ruby
+/Users/niku/Downloads/elixir-client% mix deps.get
+(...snip...)
+/Users/niku/Downloads/elixir-client%  mix run -e \
+% 'IO.inspect SwaggerPetstore.Api.Pet.add_pet(%{"name" => "ElixirConfJa2017"})'
+%Tesla.Env{body: %{"id" => 9072482292156441678, "name" => "ElixirConfJa2017",
+   "photoUrls" => [], "tags" => []},
+ headers: %{"access-control-allow-headers" => "Content-Type, api_key, Authorization",
+   "access-control-allow-methods" => "GET, POST, DELETE, PUT",
+   "access-control-allow-origin" => "*", "connection" => "close",
+   "content-type" => "application/json",
+   "date" => "Fri, 31 Mar 2017 14:47:18 GMT",
+   "server" => "Jetty(9.2.9.v20150224)"}, method: :post, opts: [], query: [],
+ status: 200, url: "http://petstore.swagger.io/v2/pet"}
+```
+
+Get an pet ID `9072482292156441678`
+
+# Use elixir client
+
+Get the pet by ID (definition)
+
+![](get_pet.png){:relative_height='100'}
+
+# Use elixir client
+
+Get the pet by ID (code)
+
+ID `9072482292156441678`
+
+```ruby
+SwaggerPetstore.Api.Pet.get_pet_by_id(9072482292156441678)
+```
+
+# Use elixir client
+
+```ruby
+/Users/niku/Downloads/elixir-client% mix run -e \
+'IO.inspect SwaggerPetstore.Api.Pet.get_pet_by_id(9072482292156441678)'
+%Tesla.Env{body: %{"id" => 9072482292156441678, "name" => "ElixirConfJa2017",
+   "photoUrls" => [], "tags" => []},
+ headers: %{"access-control-allow-headers" => "Content-Type, api_key, Authorization",
+   "access-control-allow-methods" => "GET, POST, DELETE, PUT",
+   "access-control-allow-origin" => "*", "connection" => "close",
+   "content-type" => "application/json",
+   "date" => "Fri, 31 Mar 2017 14:53:28 GMT",
+   "server" => "Jetty(9.2.9.v20150224)"}, method: :get, opts: [], query: [],
+ status: 200, url: "http://petstore.swagger.io/v2/pet/9072482292156441678"}
+```
+
+It seems work well.
+
+# Brand-new feature (not yet released)
+
+View API Document with using `h/1`
+
+![](brand-new-feature.png){:relative_height='30'}
+
+```ruby
+iex(1)> h SwaggerPetstore.Api.Store.get_inventory
+
+                              def get_inventory()
+
+Returns pet inventories by status
+
+Returns a map of status codes to quantities
+```
+
+# Conclusion
+
+- For web service provider
+  - Please provide us SDK of ErlangVM
+  - Or else OpenAPI definition
+- For elixir user
+  - It is *very experimental* now
+  - However, please try it
+  - Please let me know if it dosn't work well

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-niku-elixir-conf-japan-2017-04-01-lt
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- niku
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-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: Elixir client from OpenAPI(Swagger) definition
+email:
+- niku@niku.name
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- add_pet.png
+- aws-sdk.png
+- brand-new-feature.png
+- config.yaml
+- elixir-conf-japan-2017-04-01-lt.md
+- find_by_tags.png
+- get_pet.png
+- niku.png
+- pdf/elixir-conf-japan-2017-04-01-lt-elixir-conf-japan-2017-04-01-lt.pdf
+- swagger-codegen-template-creator.png
+- swagger-definition.png
+- swagger-editor-1.png
+- swagger-editor-2.png
+homepage: http://slide.rabbit-shocker.org/authors/niku/elixir-conf-japan-2017-04-01-lt/
+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.6.8
+signing_key: 
+specification_version: 4
+summary: Elixir client from OpenAPI(Swagger) definition
+test_files: []