README.md in pokemon_tcg_sdk-3.0.0 vs README.md in pokemon_tcg_sdk-4.0.0

- old
+ new

@@ -1,159 +1,186 @@ -# Pokémon TCG SDK - -[![Gem Version](https://badge.fury.io/rb/pokemon_tcg_sdk.svg)](https://badge.fury.io/rb/pokemon_tcg_sdk) -[![Build Status](https://travis-ci.org/PokemonTCG/pokemon-tcg-sdk-ruby.svg?branch=master)](https://travis-ci.org/PokemonTCG/pokemon-tcg-sdk-ruby) -[![Dependency Status](https://gemnasium.com/badges/github.com/PokemonTCG/pokemon-tcg-sdk-ruby.svg)](https://gemnasium.com/github.com/PokemonTCG/pokemon-tcg-sdk-ruby) -[![Code Climate](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby/badges/gpa.svg)](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby) -[![Test Coverage](https://api.codeclimate.com/v1/badges/ee9d7d6ee5f8276729bc/test_coverage)](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby/test_coverage) - -This is the Pokémon TCG SDK Ruby implementation. It is a wrapper around the Pokémon TCG API of [pokemontcg.io](http://pokemontcg.io/). - -## Installation - -Add this line to your application's Gemfile: - - gem 'pokemon_tcg_sdk' - -And then execute: - - $ bundle - -Or install it yourself as: - - $ gem install pokemon_tcg_sdk - -## Usage - -To change the API version (currently defaults to version 1) - - Pokemon.configure do |config| - config.api_version = 2 - end - -### Classes - - Card - Set - Type - Supertype - Subtype - Ability - AncientTrait - Attack - TypeValue - -### Properties Per Class - -#### Card - - id - name - national_pokedex_number - image_url - image_url_hi_res - subtype - supertype - ability - ancient_trait - hp - number - artist - rarity - series - set - set_code - retreat_cost - converted_retreat_cost - text - types - attacks - weaknesses - resistances - evolves_from - -#### Set - - code - name - series - total_cards - symbol_url - logo_url - standard_legal - expanded_legal - release_date - updated_at - -#### Ability - - name - text - type - -#### AncientTrait - - name - text - -#### Attack - - cost - name - text - damage - converted_energy_cost - -#### TypeValue - - type - value - -### Functions Available - -#### Find a card by id - - card = Pokemon::Card.find('xy1-1') - -#### Filter Cards via query parameters - - cards = Pokemon::Card.where(set: 'generations', supertype: 'pokemon') - -#### Find all cards (will take awhile) - - cards = Pokemon::Card.all - -#### Get all cards, but only a specific page of data - - cards = Pokemon::Card.where(page: 5, pageSize: 100) - -#### Find a set by code - - set = Pokemon::Set.find('base1') - -#### Filter sets via query parameters - - sets = Pokemon::Set.where(standardLegal: true) - -#### Get all Sets - - sets = Pokemon::Set.all - -#### Get all Types - - types = Pokemon::Type.all - -#### Get all Subtypes - - subtypes = Pokemon::Subtype.all - -#### Get all Supertypes - - supertypes = Pokemon::Supertype.all - -## Contributing - -1. Fork it ( https://github.com/[my-github-username]/pokemon-tcg-sdk-ruby/fork ) -2. Create your feature branch (`git checkout -b my-new-feature`) -3. Commit your changes (`git commit -am 'Add some feature'`) -4. Push to the branch (`git push origin my-new-feature`) -5. Create a new Pull Request +# Pokémon TCG SDK + +[![Gem Version](https://badge.fury.io/rb/pokemon_tcg_sdk.svg)](https://badge.fury.io/rb/pokemon_tcg_sdk) +[![Build Status](https://travis-ci.org/PokemonTCG/pokemon-tcg-sdk-ruby.svg?branch=master)](https://travis-ci.org/PokemonTCG/pokemon-tcg-sdk-ruby) +[![Dependency Status](https://gemnasium.com/badges/github.com/PokemonTCG/pokemon-tcg-sdk-ruby.svg)](https://gemnasium.com/github.com/PokemonTCG/pokemon-tcg-sdk-ruby) +[![Code Climate](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby/badges/gpa.svg)](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby) +[![Test Coverage](https://api.codeclimate.com/v1/badges/ee9d7d6ee5f8276729bc/test_coverage)](https://codeclimate.com/github/PokemonTCG/pokemon-tcg-sdk-ruby/test_coverage) + +### Now supporting Version 2 of the Pokémon TCG API! + +This is the Pokémon TCG SDK Ruby implementation. It is a wrapper around the Pokémon TCG API of [pokemontcg.io](http://pokemontcg.io/). + +## Installation + +Add this line to your application's Gemfile: + + gem 'pokemon_tcg_sdk' + +And then execute: + + $ bundle + +Or install it yourself as: + + $ gem install pokemon_tcg_sdk + +## Usage + +To configure your API Key: + + Pokemon.configure do |config| + config.api_key = "xxxxxxxxx" + end + +### Classes + + Card + Set + Type + Supertype + Subtype + Ability + AncientTrait + Attack + Resistance + Weakness + Legalities + Rarity + SetImages + CardImages + Tcgplayer + +### Properties Per Class + +#### Card + + id + name + supertype + subtypes + level + hp + types + evolves_from + evolves_to + rules + ancient_trait + abilities + weaknesses + resistances + retreat_cost + converted_retreat_cost + set + number + artist + rarity + national_pokedex_numbers + legalities + tcgplayer + images + +#### Set + + id + name + series + printedTotal + total + legalities + ptcgo_code + release_date + updated_at + images + +#### Ability + + name + text + type + +#### AncientTrait + + name + text + +#### Attack + + cost + name + text + damage + converted_energy_cost + +#### Weakness + + type + value + +#### Resistance + + type + value + +#### CardImages + + small + large + +#### SetImages + + logo + symbol + +### Functions Available + +#### Find a card by id + + card = Pokemon::Card.find('xy1-1') + +#### Filter Cards via query parameters + + cards = Pokemon::Card.where(q: 'set.name:generations subtypes:mega') + +#### Find all cards (will take awhile) + + cards = Pokemon::Card.all + +#### Get all cards, but only a specific page of data + + cards = Pokemon::Card.where(page: 5, pageSize: 100) + +#### Find a set by code + + set = Pokemon::Set.find('base1') + +#### Filter sets via query parameters + + sets = Pokemon::Set.where(q: 'legalities.standard:legal') + +#### Get all Sets + + sets = Pokemon::Set.all + +#### Get all Types + + types = Pokemon::Type.all + +#### Get all Subtypes + + subtypes = Pokemon::Subtype.all + +#### Get all Supertypes + + supertypes = Pokemon::Supertype.all + +#### Get all Rarities + + supertypes = Pokemon::Rarity.all + +## Contributing + +1. Fork it ( https://github.com/[my-github-username]/pokemon-tcg-sdk-ruby/fork ) +2. Create your feature branch (`git checkout -b my-new-feature`) +3. Commit your changes (`git commit -am 'Add some feature'`) +4. Push to the branch (`git push origin my-new-feature`) +5. Create a new Pull Request