eve_online 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cfcf5d53856441ce77e196540d444274bb85983d3e21f59fe8fe055ad1c8cf3
-  data.tar.gz: fc8b99941ea4281d94341dff860c86027d83cfb51411da0b22816c1c76370c02
+  metadata.gz: 8ea9c66ce5c8b66cff3e85f8c5fbadad3387dca9964bd0f94081ab1c9424da48
+  data.tar.gz: b08ea58f4c6fe3282af0371a76dbdd9ec612ae11de5a21a826220b533845a070
 SHA512:
-  metadata.gz: b047f8b03a1fce01689ec02d075f09b3fd83cbbb978f22d2bac6b04f4015716dabac16342a3914476fc3952de43c361c40608ab8b16ebcaf0cb2991dcb279578
-  data.tar.gz: a5d31f1c67bec23d6d1411ff26d88a6eadb436768f722095cb71ade44abc9463bfab226865c6ff87b654168cc51bc61b9ed90bfcb65968007eba2b675426b775
+  metadata.gz: 3ff3242caef5b4451da51868f402f0924bfac87b9b503a44943450bcc8732cfd96ef29560ab3eeece7c9a191c952185f69ecff92a0f4b918e1440dcd87d34d9c
+  data.tar.gz: 74a457edf29104186baf7c19fa2ffcbf6116e13b6fff4621ef5bf800f0c9b38bc30cde6196eef071fb3b868fc37ac829fcabc8474d9b970e0eeab5a3d84e8d79

data/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## v0.19.0
+
+* Replace `faraday` gem with ruby `net/http`
+* Add `Etag` / `If-None-Match` support for caching
+* Add `Accept-Language` header support
+* Add `EveOnline::ESI::CharacterAssetsLocations`
+* Add `EveOnline::ESI::Models::Position`
+* Add `EveOnline::ESI::Models::AssetLocation`
+* Add `EveOnline::ESI::Models::AssetName`
+* Add `EveOnline::ESI::CharacterAssetsNames`
+* Remove `EveOnline::ESI::UniverseConstellation#position_x, #position_y, #position_z`. Use new `#position` instead.
+* Add `EveOnline::ESI::UniverseType#dogma_attributes`
+* Add `EveOnline::ESI::UniverseType#dogma_effects`
+* Add `EveOnline::ESI::Models::DogmaAttributeShort`
+* Add `EveOnline::ESI::Models::DogmaEffectShort`
+* Add `EveOnline::ESI::Models::Type#dogma_attributes`
+* Add `EveOnline::ESI::Models::Type#dogma_effects`
+* Add `EveOnline::ESI::Models::DogmaAttributes`
+* Add `EveOnline::ESI::Models::DogmaEffects`
+* Add `EveOnline::ESI::Models::DogmaEffect`
+* Add `EveOnline::ESI::DogmaEffects`
+* Add `EveOnline::ESI::DogmaEffect`
+* Rename `EveOnline::ESI::AllianceCorporations#corporations` to `#corporation_ids`
+* Rename `EveOnline::ESI::Alliances#alliances` to `#alliance_ids`
+* Rename `EveOnline::ESI::Wars#wars_ids` to `#war_ids`
+* Rename `EveOnline::ESI::UniverseTypes#universe_types_ids` to `#universe_type_ids`
+* Rename `EveOnline::ESI::DogmaEffects#effects_ids` to `#effect_ids`
+* Rename `EveOnline::ESI::UniverseSystems#universe_systems_ids` to `#universe_system_ids`
+* Rename `EveOnline::ESI::UniverseRegions#universe_regions_ids` to `#universe_region_ids`
+* Rename `EveOnline::ESI::UniverseConstellations#constellations_ids` to `#constellation_ids`
+* Rename `EveOnline::ESI::DogmaAttributes#attributes` to `#attribute_ids`
+* Rename `EveOnline::ESI::CharacterImplants#implants` to `#implant_ids`
+* Add `EveOnline::ESI::DogmaEffect`
+* Add `EveOnline::ESI::Models::DogmaEffectModifier`
+* Add `EveOnline::ESI::Models::DogmaEffectModifiers`
+
 ## v0.18.0
 
 * Add `EveOnline::ESI::Models::CharacterShip`
@@ -26,7 +62,6 @@
 * Remove `EveOnline::ESI::AlliancesNames`
 * Lint `README.md`, `CHANGELOG.md` and `TODO.md` with `mdl` gem
 * Add datasource support. Just add `datasource: tranquility` or `datasource: singularity` to options. Default is `tranquility`.
-* Allow change response parser from `JSON` to any json parser compatible with gem `json`. Add `parser: Oj` for `Oj` to default options hash to enable.
 * Rename `EveOnline::ESI::Models::DogmaAttribute#id` to `#attribute_id`
 * Rename input `attribute_id:` to `id:` in `EveOnline::ESI::DogmaAttribute`
 * Rename `EveOnline::ESI::Models::IndustryJob` to `EveOnline::ESI::Models::CharacterIndustryJob`

data/Gemfile.lock

@@ -1,9 +1,8 @@
 PATH
   remote: .
   specs:
-    eve_online (0.17.0)
+    eve_online (0.19.0)
       activesupport (>= 4.2.0)
-      faraday
       json
       memoist
 
@@ -25,8 +24,6 @@ GEM
       safe_yaml (~> 1.0.0)
     diff-lcs (1.3)
     docile (1.3.1)
-    faraday (0.15.2)
-      multipart-post (>= 1.2, < 3)
     hashdiff (0.3.7)
     i18n (1.1.0)
       concurrent-ruby (~> 1.0)
@@ -44,7 +41,6 @@ GEM
     mixlib-cli (1.7.0)
     mixlib-config (2.2.13)
       tomlrb
-    multipart-post (2.0.0)
     nokogiri (1.8.4)
       mini_portile2 (~> 2.3.0)
     parallel (1.12.1)
@@ -73,7 +69,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.8.0)
     rspec-support (3.8.0)
-    rubocop (0.59.1)
+    rubocop (0.59.2)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
       parser (>= 2.5, != 2.5.1.1)
@@ -121,4 +117,4 @@ DEPENDENCIES
   webmock
 
 BUNDLED WITH
-   1.16.4
+   1.16.5

data/Gemfile.mutant.lock

@@ -1,9 +1,8 @@
 PATH
   remote: .
   specs:
-    eve_online (0.16.0)
+    eve_online (0.18.0)
       activesupport (>= 4.2.0)
-      faraday
       json
       memoist
 
@@ -35,8 +34,6 @@ GEM
     diff-lcs (1.3)
     docile (1.3.1)
     equalizer (0.0.11)
-    faraday (0.15.2)
-      multipart-post (>= 1.2, < 3)
     hashdiff (0.3.7)
     i18n (1.1.0)
       concurrent-ruby (~> 1.0)
@@ -64,8 +61,7 @@ GEM
       equalizer (~> 0.0.9)
       ice_nine (~> 0.11.0)
       procto (~> 0.0.2)
-    multipart-post (2.0.0)
-    mutant (0.8.15)
+    mutant (0.8.17)
       abstract_type (~> 0.0.7)
       adamantium (~> 0.2.0)
       anima (~> 0.3.0)
@@ -77,38 +73,38 @@ GEM
       memoizable (~> 0.4.2)
       morpher (~> 0.2.6)
       parallel (~> 1.3)
-      parser (>= 2.3.1.4, < 2.5)
+      parser (~> 2.5.1)
       procto (~> 0.0.2)
       regexp_parser (~> 0.4.9)
       unparser (~> 0.2.5)
-    mutant-rspec (0.8.15)
-      mutant (~> 0.8.15)
-      rspec-core (>= 3.4.0, < 3.8.0)
+    mutant-rspec (0.8.17)
+      mutant (~> 0.8.17)
+      rspec-core (>= 3.4.0, < 4.0.0)
     nokogiri (1.8.4)
       mini_portile2 (~> 2.3.0)
     parallel (1.12.1)
-    parser (2.4.0.2)
-      ast (~> 2.3)
+    parser (2.5.1.2)
+      ast (~> 2.4.0)
     procto (0.0.3)
     public_suffix (3.0.3)
     rake (12.3.1)
     regexp_parser (0.4.13)
-    rspec (3.7.0)
-      rspec-core (~> 3.7.0)
-      rspec-expectations (~> 3.7.0)
-      rspec-mocks (~> 3.7.0)
-    rspec-core (3.7.1)
-      rspec-support (~> 3.7.0)
-    rspec-expectations (3.7.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
+      rspec-support (~> 3.8.0)
     rspec-its (1.2.0)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.7.0)
+    rspec-mocks (3.8.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-support (3.7.1)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
     safe_yaml (1.0.4)
     simplecov (0.16.1)
       docile (~> 1.1)
@@ -151,4 +147,4 @@ DEPENDENCIES
   webmock
 
 BUNDLED WITH
-   1.16.4
+   1.16.5

data/README.md

@@ -8,9 +8,9 @@
 
 This gem implement Ruby API for EveOnline MMORPG (ESI).
 
-Looking for [EveOnline SSO OAuth2 Strategy for OmniAuth](https://github.com/biow0lf/omniauth-eve_online-sso)?
+Looking for [EveOnline SSO OAuth2 Strategy for OmniAuth](https://github.com/evemonk/omniauth-eve_online-sso)?
 
-This gem was extracted from [EveMonk](http://evemonk.com). Source code of evemonk backend published [here](https://github.com/biow0lf/evemonk).
+This gem was extracted from [EveMonk](http://evemonk.com). Source code of evemonk backend published [here](https://github.com/evemonk/evemonk).
 
 ## TOC
 
@@ -72,9 +72,9 @@ alliances = EveOnline::ESI::Alliances.new
 
 alliances.scope # => nil
 
-alliances.alliances.size # => 3013
+alliances.alliance_ids.size # => 3013
 
-alliances.alliances.first # => 1354830081
+alliances.alliance_ids.first # => 1354830081
 ```
 
 #### Get alliance information
@@ -112,9 +112,9 @@ alliance_corporations = EveOnline::ESI::AllianceCorporations.new(options)
 
 alliance_corporations.scope # => nil
 
-alliance_corporations.corporations.size # => 33
+alliance_corporations.corporation_ids.size # => 33
 
-alliance_corporations.corporations.first # => 98134807
+alliance_corporations.corporation_ids.first # => 98134807
 ```
 
 #### Get alliance icon
@@ -173,8 +173,50 @@ asset.type_id # => 1010
 
 #### Get character asset locations
 
+```ruby
+options = { token: 'token123', character_id: 1337512245, item_ids: [1001215602246] }
+
+character_assets_locations = EveOnline::ESI::CharacterAssetsLocations.new(options)
+
+character_assets_locations.scope # => "esi-assets.read_assets.v1"
+
+character_assets_locations.assets_locations.size # => 1
+
+asset_location = character_assets_locations.assets_locations.first
+
+asset_location.as_json # => {:item_id=>1001215602246}
+
+asset_location.item_id # => 1001215602246
+
+asset_location.position.as_json # => {:x=>-928621543221.3319,
+                                #     :y=>297645715142.40234,
+                                #     :z=>-971212198300.4812}
+
+asset_location.position.x # => -928621543221.3319
+asset_location.position.y # => 297645715142.40234
+asset_location.position.z # => -971212198300.4812
+```
+
 #### Get character asset names
 
+```ruby
+options = { token: 'token123', character_id: 1337512245, item_ids: [1001215602246] }
+
+character_assets_names = EveOnline::ESI::CharacterAssetsNames.new(options)
+
+character_assets_names.scope # => "esi-assets.read_assets.v1"
+
+character_assets_names.assets_names.size # => 1
+
+character_asset_name = character_assets_names.assets_names.first
+
+character_asset_name.as_json # => {:item_id=>1001215602246,
+                             #     :name=>"HOLE"}
+
+character_asset_name.item_id # => 1001215602246
+character_asset_name.name # => "HOLE"
+```
+
 #### Get corporation assets
 
 #### Get corporation asset locations
@@ -517,9 +559,9 @@ character_implants = EveOnline::ESI::CharacterImplants.new(options)
 
 character_implants.scope # => "esi-clones.read_implants.v1"
 
-character_implants.implants.size # => 5
+character_implants.implant_ids.size # => 5
 
-character_implants.implants # => [9899, 9941, 9942, 9943, 9956]
+character_implants.implant_ids # => [9899, 9941, 9942, 9943, 9956]
 ```
 
 ### Contacts
@@ -689,9 +731,9 @@ dogma_attributes = EveOnline::ESI::DogmaAttributes.new
 
 dogma_attributes.scope # => nil
 
-dogma_attributes.attributes.size # => 2385
+dogma_attributes.attribute_ids.size # => 2385
 
-dogma_attributes.attributes.first # => 2
+dogma_attributes.attribute_ids.first # => 2
 ```
 
 #### Get attribute information
@@ -730,8 +772,86 @@ dogma_attribute.unit_id # => nil
 
 #### Get effects
 
+```ruby
+dogma_effects = EveOnline::ESI::DogmaEffects.new
+
+dogma_effects.scope # => nil
+
+dogma_effects.effects_ids.size # => 4123
+
+dogma_effects.effects_ids.first # => 4
+```
+
 #### Get effect information
 
+```ruby
+options = { id: 6717 }
+
+dogma_effect = EveOnline::ESI::DogmaEffect.new(options)
+
+dogma_effect.scope # => nil
+
+dogma_effect.as_json # => {:description=>"Automatically generated effect",
+                     #     :disallow_auto_repeat=>nil,
+                     #     :discharge_attribute_id=>nil,
+                     #     :display_name=>"",
+                     #     :duration_attribute_id=>nil,
+                     #     :effect_category=>0,
+                     #     :effect_id=>6717,
+                     #     :electronic_chance=>nil,
+                     #     :falloff_attribute_id=>nil,
+                     #     :icon_id=>nil,
+                     #     :is_assistance=>nil,
+                     #     :is_offensive=>nil,
+                     #     :is_warp_safe=>nil,
+                     #     :name=>"roleBonusIceOreMiningDurationCap",
+                     #     :post_expression=>19291,
+                     #     :pre_expression=>19290,
+                     #     :published=>nil,
+                     #     :range_attribute_id=>nil,
+                     #     :range_chance=>nil,
+                     #     :tracking_speed_attribute_id=>nil}
+
+dogma_effect.description # => "Automatically generated effect"
+dogma_effect.disallow_auto_repeat # => nil
+dogma_effect.discharge_attribute_id # => nil
+dogma_effect.display_name # => ""
+dogma_effect.duration_attribute_id # => nil
+dogma_effect.effect_category # => 0
+dogma_effect.effect_id # => 6717
+dogma_effect.electronic_chance # => nil
+dogma_effect.falloff_attribute_id # => nil
+dogma_effect.icon_id # => nil
+dogma_effect.is_assistance # => nil
+dogma_effect.is_offensive # => nil
+dogma_effect.is_warp_safe # => nil
+dogma_effect.name # => "roleBonusIceOreMiningDurationCap"
+dogma_effect.post_expression # => 19291
+dogma_effect.pre_expression # => 19290
+dogma_effect.published # => nil
+dogma_effect.range_attribute_id # => nil
+dogma_effect.range_chance # => nil
+dogma_effect.tracking_speed_attribute_id # => nil
+
+dogma_effect.modifiers.size # => 4
+
+modifier = dogma_effect.modifiers.first
+
+modifier.as_json # => {:domain=>"shipID",
+                 #     :effect_id=>nil,
+                 #     :func=>"LocationRequiredSkillModifier",
+                 #     :modified_attribute_id=>73,
+                 #     :modifying_attribute_id=>2458,
+                 #     :operator=>6}
+
+modifier.domain # => "shipID"
+modifier.effect_id # => nil
+modifier.func # => "LocationRequiredSkillModifier"
+modifier.modified_attribute_id # => 73
+modifier.modifying_attribute_id # => 2458
+modifier.operator # => 6
+```
+
 ### Faction Warfare
 
 #### Overview of a character involved in faction warfare
@@ -1365,7 +1485,9 @@ server_status.vip # => nil
 #### Get ancestries
 
 ```ruby
-ancestries = EveOnline::ESI::Ancestries.new
+options = { language: 'en-us' }
+
+ancestries = EveOnline::ESI::Ancestries.new(options)
 
 ancestries.scope # => nil
 
@@ -1386,8 +1508,6 @@ ancestry.icon_id # => 1664
 ancestry.ancestry_id # => 24
 ancestry.name # => "Slave Child"
 ancestry.short_description # => "Torn from the cold and brought to the warmth of a new life."
-
-# TODO: add languages
 ```
 
 #### Get asteroid belt information
@@ -1395,7 +1515,9 @@ ancestry.short_description # => "Torn from the cold and brought to the warmth of
 #### Get bloodlines
 
 ```ruby
-bloodlines = EveOnline::ESI::Bloodlines.new
+options = { language: 'en-us' }
+
+bloodlines = EveOnline::ESI::Bloodlines.new(options)
 
 bloodlines.scope # => nil
 
@@ -1426,8 +1548,6 @@ bloodline.perception # => 9
 bloodline.race_id # => 2
 bloodline.ship_type_id # => 588
 bloodline.willpower # => 7
-
-# TODO: add languages
 ```
 
 #### Get item categories
@@ -1441,15 +1561,15 @@ constellations = EveOnline::ESI::UniverseConstellations.new
 
 constellations.scope # => nil
 
-constellations.constellations_ids.size # => 1146
+constellations.constellation_ids.size # => 1146
 
-constellations.constellations_ids.first # => 20000001
+constellations.constellation_ids.first # => 20000001
 ```
 
 #### Get constellation information
 
 ```ruby
-options = { id: 20000001 }
+options = { id: 20000001, language: 'en-us' }
 
 constellation = EveOnline::ESI::UniverseConstellation.new(options)
 
@@ -1457,27 +1577,29 @@ constellation.scope # => nil
 
 constellation.as_json # => {:constellation_id=>20000001,
                       #     :name=>"San Matar",
-                      #     :position_x=>-9.404655970099134e+16,
-                      #     :position_y=>4.952015315379885e+16,
-                      #     :position_z=>-4.273873181840197e+16,
                       #     :region_id=>10000001,
                       #     :systems=>[30000001, 30000002, 30000003, 30000004, 30000005, 30000006, 30000007, 30000008]}
 
 constellation.constellation_id # => 20000001
 constellation.name # => "San Matar"
-constellation.position_x # => -9.404655970099134e+16
-constellation.position_y # => 4.952015315379885e+16
-constellation.position_z # => -4.273873181840197e+16
 constellation.region_id # => 10000001
 constellation.systems # => [30000001, 30000002, 30000003, 30000004, 30000005, 30000006, 30000007, 30000008]
 
-# TODO: translations
+constellation.position.as_json # => {:x=>-9.404655970099134e+16,
+                               #     :y=>4.952015315379885e+16,
+                               #     :z=>-4.273873181840197e+16}
+
+constellation.position.x # => -9.404655970099134e+16
+constellation.position.y # => 4.952015315379885e+16
+constellation.position.z # => -4.273873181840197e+16
 ```
 
 #### Get factions
 
 ```ruby
-factions = EveOnline::ESI::Factions.new
+options = { language: 'en-us' }
+
+factions = EveOnline::ESI::Factions.new(options)
 
 factions.scope # => nil
 
@@ -1506,8 +1628,6 @@ faction.size_factor # => 5.0
 faction.solar_system_id # => 30002544
 faction.station_count # => 570
 faction.station_system_count # => 291
-
-# TODO: add languages
 ```
 
 #### Get graphics
@@ -1529,7 +1649,9 @@ faction.station_system_count # => 291
 #### Get character races
 
 ```ruby
-races = EveOnline::ESI::Races.new
+options = { language: 'en-us' }
+
+races = EveOnline::ESI::Races.new(options)
 
 races.scope # => nil
 
@@ -1546,8 +1668,6 @@ race.alliance_id # => 500002
 race.description # => "Once a thriving tribal civilization, the Minmatar..."
 race.name # => "Minmatar"
 race.race_id # => 2
-
-# TODO: add languages
 ```
 
 #### Get regions
@@ -1557,15 +1677,15 @@ regions = EveOnline::ESI::UniverseRegions.new
 
 regions.scope # => nil
 
-regions.universe_regions_ids.size # => 106
+regions.universe_region_ids.size # => 106
 
-regions.universe_regions_ids.first # => 10000001
+regions.universe_region_ids.first # => 10000001
 ```
 
 #### Get region information
 
 ```ruby
-options = { id: 10000001 }
+options = { id: 10000001, language: 'en-us' }
 
 region = EveOnline::ESI::UniverseRegion.new(options)
 
@@ -1580,8 +1700,6 @@ region.constellations # => [20000001,20000002,20000003,20000016]
 region.description # => "The Derelik region..."
 region.name # => "Derelik"
 region.region_id # => 10000001
-
-# TODO: translations
 ```
 
 #### Get stargate information
@@ -1605,9 +1723,9 @@ systems = EveOnline::ESI::UniverseSystems.new
 
 systems.scope # => nil
 
-systems.universe_systems_ids.size # => 8285
+systems.universe_system_ids.size # => 8285
 
-systems.universe_systems_ids.first # => 30000001
+systems.universe_system_ids.first # => 30000001
 ```
 
 #### Get solar system information
@@ -1625,15 +1743,15 @@ types.page # => 1
 
 types.total_pages # => 35
 
-types.universe_types_ids.size # => 1000
+types.universe_type_ids.size # => 1000
 
-types.universe_types_ids.first # => 0
+types.universe_type_ids.first # => 0
 ```
 
 #### Get type information
 
 ```ruby
-options = { id: 192 }
+options = { id: 192, language: 'en-us' }
 
 type = EveOnline::ESI::UniverseType.new(options)
 
@@ -1669,9 +1787,25 @@ type.radius # => 1.0
 type.type_id # => 192
 type.volume # => 0.0125
 
-# TODO: dogma_attributes
-# TODO: dogma_effects
-# TODO: add localization
+type.dogma_attributes.size # => 17
+
+type_dogma_attribute = type.dogma_attributes.first
+
+type_dogma_attribute.as_json # => {:attribute_id=>128,
+                             #     :value=>2.0}
+
+dogma_attribute.attribute_id # => 128
+dogma_attribute.value # => 2.0
+
+type.dogma_effects.size # => 3
+
+type_dogma_effect = type.dogma_effects.first
+
+type_dogma_effect.as_json # => {:effect_id=>596,
+                          #     :is_default=>false}
+
+type_dogma_effect.effect_id # => 596
+type_dogma_effect.is_default # => false
 ```
 
 ### User Interface
@@ -1755,9 +1889,9 @@ wars = EveOnline::ESI::Wars.new
 
 wars.scope # => nil
 
-wars.wars_ids.size # => 2000
+wars.war_ids.size # => 2000
 
-wars.wars_ids.first # => 615639
+wars.war_ids.first # => 615639
 
 # TODO: max_war_id
 ```
@@ -1818,13 +1952,13 @@ List of exceptions:
 
 ## Timeouts
 
-`eve_online` gem uses `faraday` for network request. `faraday` configured with:
+`eve_online` gem uses `net/http` for network request. `net/http` configured with:
 
 ```ruby
-faraday = Faraday.new
+http = Net::HTTP.new
 
-faraday.options.timeout = 60
-faraday.options.open_timeout = 60
+http.read_timeout = 60
+http.open_timeout = 60
 ```
 
 You can configure default timeouts with adding `read_timeout:` and `open_timeout:` to default hash with options:
@@ -1859,6 +1993,28 @@ options = { datasource: 'singularity' }
 races = EveOnline::ESI::Races.new(options)
 ```
 
+## Languages support
+
+Default language is `en-us`. Supported languages: `de`, `en-us`, `fr`, `ja`, `ru`, `zh`.
+
+If you want change it, for e.g., to `de`, add `language: 'de'` to default hash with options:
+
+```ruby
+options = { language: 'de' }
+
+races = EveOnline::ESI::Races.new(options)
+```
+
+## Oj as JSON Parser
+
+```ruby
+require 'oj'
+
+Oj.mimic_JSON()
+
+races = EveOnline::ESI::Races.new
+```
+
 ## Useful links
 
 * [BREAKING CHANGES AND YOU - HOW TO USE ALT-ROUTES TO ENHANCE YOUR SANITY](https://developers.eveonline.com/blog/article/breaking-changes-and-you)
@@ -1876,7 +2032,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Issue reports and pull requests are welcome on GitHub at <https://github.com/biow0lf/eve_online>.
+Issue reports and pull requests are welcome on GitHub at <https://github.com/evemonk/eve_online>.
 
 ## Author