scryfall 0.1.8 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13abae40c7e882e8875a38cbd87148cbf62beab005f92a2ff36ff4e040f0ce26
-  data.tar.gz: cb5d3f78f66eea16fad77f26c21383d9db85c3ad4b410454212db1601ef394ea
+  metadata.gz: 2af3560b509abc7263f3352c2a7ed89a0bd9f558a8863d5ef61bcbff93e3097d
+  data.tar.gz: 62d5b62b912d831adc186744a3702f38b3bf8c0ef245bf410fb7ed7c4596fe29
 SHA512:
-  metadata.gz: b90b6859fb7548b7aee1e694f401ff0f3099af8c8f8da906ea9dee3c13d55e413ed81d6aa5a80656984ecfbf71eb94d123c8c2480bff8cfda77b94e9bcab3f00
-  data.tar.gz: 39496f61f0327badd1a1e9f9b1eecf28191ae2f52bde95434f7b50ebe70e4c0eb9b48d031ac28a4b4acaba8478e800d6dd3a33c5ccff6da5d4827f69dcdaa722
+  metadata.gz: 130020646712432d62154f7c6413ebb1e73be7ec4f22007bb7b006a19fc677eeec1be61dd22ff8c14788e7824db0632a39c317641a893bb2253bcba069461f14
+  data.tar.gz: 8b1f2d712985f2e3b588ef758949fbd5ef5492122bc7d086a3f00ba7a972687277e970b61cb41937908f5cf50769483183e0dd1ad5e8ae34700badb1e9f96e0f

data/README.md

@@ -1,5 +1,6 @@
 # scryfall-rails
 [![Gem Version](https://badge.fury.io/rb/scryfall.svg)](https://badge.fury.io/rb/scryfall)
+[![CircleCI](https://circleci.com/gh/jlcarruda/scryfall-rails/tree/master.svg?style=svg)](https://circleci.com/gh/jlcarruda/scryfall-rails/tree/master)
 
 A simple gem that utilizes the Scryfall API to get Magic: the Gathering card information.
 
@@ -24,7 +25,7 @@ The Scryfall module have classes for each query on the Scryfall API. Each class
 
 At first, there are only a few methods available:
 
-# Cards
+# ::Cards
 ### Named (fuzzy and exact)
 
 It searches for cards named almost as the string passed (fuzzy), or with the exact name as the string passed (exact)
@@ -49,6 +50,28 @@ Scryfall::Cards.search "f:standard t:land id:UW"
 Scryfall::Cards.search "f:standard t:creature", page: 2
 ```
 
+### By IDs
+
+The `Scryfall::Cards` class has methods to retrieve cards by its identifier in multiple platforms.
+
+```ruby
+# Returning the "Yargle, Glutton of Urborg" card by its IDs
+
+# can be fetched by its MTGO id ...
+Scryfall::Cards.with_mtgo_id 67691
+
+# ... by its Arena id ...
+Scryfall::Cards.with_arena_id 67330
+
+# ... by its TCG Player id ...
+Scryfall::Cards.with_tcgplayer_id 164756
+
+# ... or by its unique ID.
+Scryfall::Cards.with_id "645cfc1b-76f2-4823-9fb0-03cb009f8b32"
+```
+
+Cards that are not on those systems can't be retrieved by its ids. For example, the **Austere Command** card can't be fetched by an Arena Id because the card isn't in the game.
+
 # Responses
 
 The default response for all calls are JSON. If a `to_struct: true` is passed as argument, the return will be a `OpenStruct` Hash object.

data/lib/scryfall/api.rb

@@ -1,9 +1,9 @@
 module Scryfall
   class API
-    require 'http'
+    require "http"
     require 'ostruct'
     require 'json'
-    require 'error_handler'
+    require 'scryfall/error_handler'
     require 'resolv-replace'
 
     def initialize(url = 'https://api.scryfall.com');

data/lib/scryfall/cards.rb

@@ -18,5 +18,21 @@ module Scryfall
 
       api.get '/cards/search', params, args
     end
+
+    def self.with_mtgo_id(id, **args)
+      api.get "/cards/mtgo/#{id}", {}, args
+    end
+
+    def self.with_arena_id(id, **args)
+      api.get "/cards/arena/#{id}", {}, args
+    end
+
+    def self.with_tcgplayer_id(id, **args)
+      api.get "/cards/tcgplayer/#{id}", {}, args
+    end
+
+    def self.with_id(id, **args)
+      api.get "/cards/#{id}", {}, args
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: scryfall
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.2.8
 platform: ruby
 authors:
 - João Lucas
@@ -70,8 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
 summary: A gem made to contact Scryfall API