eve_online 0.16.0 → 0.17.0

data/README.md

@@ -1,10 +1,9 @@
-# EveOnline ESI API.
+# EveOnline ESI API
 
 [![Gem Version](https://badge.fury.io/rb/eve_online.svg)](https://badge.fury.io/rb/eve_online)
 [![Gem Downloads](https://img.shields.io/gem/dt/eve_online.svg)](https://rubygems.org/gems/eve_online)
 [![Test Coverage](https://codeclimate.com/github/biow0lf/eve_online/badges/coverage.svg)](https://codeclimate.com/github/biow0lf/eve_online/coverage)
 [![Build Status](https://travis-ci.org/biow0lf/eve_online.svg?branch=master)](https://travis-ci.org/biow0lf/eve_online)
-[![Dependency Status](https://gemnasium.com/biow0lf/eve_online.svg)](https://gemnasium.com/biow0lf/eve_online)
 [![security](https://hakiri.io/github/biow0lf/eve_online/master.svg)](https://hakiri.io/github/biow0lf/eve_online/master)
 
 This gem implement Ruby API for EveOnline MMORPG (ESI).
@@ -21,12 +20,10 @@ This gem was extracted from [EveMonk](http://evemonk.com). Source code of evemon
 * [Useful links](#useful-links)
 * [Development](#development)
 * [Contributing](#contributing)
-* [TODO](#todo)
 * [Author](#author)
-* [Contributors. Thank you everyone!](#contributors-thank-you-everyone)
+* [Contributors](#contributors)
 * [License](#license)
 
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -37,28 +34,32 @@ gem 'eve_online'
 
 And then execute:
 
-    $ bundle
+```shell
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install eve_online
+```shell
+gem install eve_online
+```
 
 ## Supported ruby versions
 
- * MRI 2.3
- * MRI 2.4
- * MRI 2.5
- * MRI (head)
- * JRuby 9.2.0.0
- * JRuby (head)
+* MRI 2.3
+* MRI 2.4
+* MRI 2.5
+* MRI (head)
+* JRuby 9.2.0.0
+* JRuby (head)
 
 ## Supported rails versions
 
- * 4.2
- * 5.0
- * 5.1
- * 5.2
- * Edge
+* 4.2
+* 5.0
+* 5.1
+* 5.2
+* Edge
 
 ## Usage examples
 
@@ -85,21 +86,21 @@ alliance = EveOnline::ESI::Alliance.new(options)
 
 alliance.scope # => nil
 
-alliance.as_json # => {:name=>"Kids With Guns Alliance",
-                 #     :ticker=>"-KWG-",
+alliance.as_json # => {:creator_corporation_id=>98306624,
                  #     :creator_id=>94195096,
-                 #     :creator_corporation_id=>98306624,
-                 #     :executor_corporation_id=>98306624,
                  #     :date_founded=>Sun, 03 May 2015 19:45:17 UTC +00:00,
-                 #     :faction_id=>nil}
+                 #     :executor_corporation_id=>98306624,
+                 #     :faction_id=>nil,
+                 #     :name=>"Kids With Guns Alliance",
+                 #     :ticker=>"-KWG-"}
 
-alliance.name # => "Kids With Guns Alliance"
-alliance.ticker # => "-KWG-"
-alliance.creator_id # => 94195096
 alliance.creator_corporation_id # => 98306624
-alliance.executor_corporation_id # => 98306624
+alliance.creator_id # => 94195096
 alliance.date_founded # => Sun, 03 May 2015 19:45:17 UTC +00:00
+alliance.executor_corporation_id # => 98306624
 alliance.faction_id # => nil
+alliance.name # => "Kids With Guns Alliance"
+alliance.ticker # => "-KWG-"
 ```
 
 #### List alliance's corporations
@@ -125,30 +126,11 @@ alliance_icon = EveOnline::ESI::AllianceIcon.new(options)
 
 alliance_icon.scope # => nil
 
-alliance_icon.as_json # => {:icon_small=>"http://image.eveonline.com/Alliance/99005443_64.png", :icon_medium=>"http://image.eveonline.com/Alliance/99005443_128.png"}
+alliance_icon.as_json # => {:icon_medium=>"http://image.eveonline.com/Alliance/99005443_128.png",
+                      #     :icon_small=>"http://image.eveonline.com/Alliance/99005443_64.png"}
 
-alliance_icon.icon_small # => "http://image.eveonline.com/Alliance/99005443_64.png"
 alliance_icon.icon_medium # => "http://image.eveonline.com/Alliance/99005443_128.png"
-```
-
-#### Get alliance names
-
-```ruby
-options = { alliance_ids: [99005443, 99005443] }
-
-alliances_names = EveOnline::ESI::AlliancesNames.new(options)
-
-alliances_names.scope # => nil
-
-alliances_names.alliances.size # => 2
-
-alliance = alliances_names.alliances.first
-
-alliance.as_json
-# => {:alliance_id=>99005443, :alliance_name=>"Kids With Guns Alliance"}
-
-alliance.alliance_id # => 99005443
-alliance.alliance_name # => "Kids With Guns Alliance"
+alliance_icon.icon_small # => "http://image.eveonline.com/Alliance/99005443_64.png"
 ```
 
 ### Assets
@@ -166,21 +148,23 @@ character_assets.assets.size # => 486
 
 asset = character_assets.assets.first
 
-asset.as_json # => {:type_id=>2629,
-              #     :location_id=>60008674,
-              #     :location_type=>"station",
-              #     :item_id=>1006604012678,
+asset.as_json # => {:is_blueprint_copy=>true,
+              #     :is_singleton=>true,
+              #     :item_id=>716338097,
               #     :location_flag=>"Hangar",
-              #     :is_singleton=>false,
-              #     :quantity=>16156}
-
-asset.type_id # => 2629
-asset.location_id # => 60008674
-asset.location_type # => "station"
-asset.item_id # => 1006604012678
+              #     :location_id=>1027847409779,
+              #     :location_type=>"other",
+              #     :quantity=>1
+              #     :type_id=>1010}
+
+asset.is_blueprint_copy # => true
+asset.is_singleton # => true
+asset.item_id # => 716338097
 asset.location_flag # => "Hangar"
-asset.is_singleton # => false
-asset.quantity # => 16156
+asset.location_id # => 1027847409779
+asset.location_type # => "other"
+asset.quantity # => 1
+asset.type_id # => 1010
 
 # TODO: add pagination support
 ```
@@ -193,7 +177,7 @@ asset.quantity # => 16156
 
 #### Get corporation asset locations
 
-#### Get coporation asset names (typo in swagger)
+#### Get corporation asset names
 
 ### Bookmarks
 
@@ -211,30 +195,32 @@ character_bookmarks.bookmarks.size # => 20
 bookmark = character_bookmarks.bookmarks.first
 
 bookmark.as_json # => {:bookmark_id=>4,
-                 #     :folder_id=>5,
+                 #     :coordinate_x=>-144951231521.81625,
+                 #     :coordinate_y=>164030047870.25558,
+                 #     :coordinate_z=>211467631848.1311,
                  #     :created=>Mon, 09 Jul 2012 22:38:31 UTC +00:00,
-                 #     :label=>"Stargate",
-                 #     :notes=>"This is a stargate",
-                 #     :location_id=>30003430,
                  #     :creator_id=>2112625428,
+                 #     :folder_id=>5,
                  #     :item_id=>30003496,
                  #     :item_type_id=>5,
-                 #     :coordinate_x=>-144951231521.81625,
-                 #     :coordinate_y=>164030047870.25558,
-                 #     :coordinate_z=>211467631848.1311}
+                 #     :label=>"Stargate",
+                 #     :location_id=>30003430,
+                 #     :notes=>"This is a stargate"}
 
 bookmark.bookmark_id # => 4
-bookmark.folder_id # => 5
+bookmark.coordinate_x # => -144951231521.81625
+bookmark.coordinate_y # => 164030047870.25558
+bookmark.coordinate_z # => 211467631848.1311
 bookmark.created # => Mon, 09 Jul 2012 22:38:31 UTC +00:00
-bookmark.label # => "Stargate"
-bookmark.notes # => "This is a stargate"
-bookmark.location_id # => 30003430
 bookmark.creator_id # => 2112625428
+bookmark.folder_id # => 5
 bookmark.item_id # => 30003496
 bookmark.item_type_id # => 5
-bookmark.coordinate_x # => -144951231521.81625
-bookmark.coordinate_y # => 164030047870.25558
-bookmark.coordinate_z # => 211467631848.1311
+bookmark.label # => "Stargate"
+bookmark.location_id # => 30003430
+bookmark.notes # => "This is a stargate"
+
+# TODO: add pagination support
 ```
 
 #### List bookmark folders
@@ -255,6 +241,8 @@ bookmark_folder.as_json # => {:folder_id=>5,
 
 bookmark_folder.folder_id # => 5
 bookmark_folder.name # => "Icecream"
+
+# TODO: add pagination support
 ```
 
 #### List corporation bookmarks
@@ -276,17 +264,17 @@ character_calendar.events.size # => 22
 
 event = character_calendar.events.first
 
-event.as_json # => {:event_id=>1635240,
-              #     :event_date=>Tue, 06 Mar 2018 15:00:59 UTC +00:00,
-              #     :title=>"Moon extraction for 66-PMM - GoldMine-5-",
+event.as_json # => {:event_date=>Tue, 06 Mar 2018 15:00:59 UTC +00:00,
+              #     :event_id=>1635240,
+              #     :event_response=>"not_responded",
               #     :importance=>0,
-              #     :event_response=>"not_responded"}
+              #     :title=>"Moon extraction for 66-PMM - GoldMine-5-"}
 
-event.event_id # => 1635240
 event.event_date # => Tue, 06 Mar 2018 15:00:59 UTC +00:00
-event.title # => "Moon extraction for 66-PMM - GoldMine-5-"
-event.importance # => 0
+event.event_id # => 1635240
 event.event_response # => "not_responded"
+event.importance # => 0
+event.title # => "Moon extraction for 66-PMM - GoldMine-5-"
 
 # TODO: add from_event support
 ```
@@ -308,20 +296,29 @@ character = EveOnline::ESI::Character.new(options)
 
 character.scope # => nil
 
-character.as_json
-# => {:corporation_id=>1000168, :birthday=>Fri, 15 Jan 2010 15:26:00 UTC +00:00, :name=>"Green Black", :gender=>"male", :race_id=>2, :bloodline_id=>4, :description=>"", :alliance_id=>12345678, :ancestry_id=>24, :security_status=>1.8694881661345457, :faction_id=>500001}
+character.as_json # => {:alliance_id=>12345678,
+                  #     :ancestry_id=>24,
+                  #     :birthday=>Fri, 15 Jan 2010 15:26:00 UTC +00:00,
+                  #     :bloodline_id=>4,
+                  #     :corporation_id=>1000168,
+                  #     :description=>"",
+                  #     :faction_id=>500001,
+                  #     :gender=>"male",
+                  #     :name=>"Green Black",
+                  #     :race_id=>2,
+                  #     :security_status=>1.8694881661345457}
 
-character.corporation_id # => 1000168
+character.alliance_id # => 12345678
+character.ancestry_id # => 24
 character.birthday # => Fri, 15 Jan 2010 15:26:00 UTC +00:00
-character.name # => "Green Black"
-character.gender # => "male"
-character.race_id # => 2
 character.bloodline_id # => 4
+character.corporation_id # => 1000168
 character.description  # => ""
-character.alliance_id # => 12345678
-character.ancestry_id # => 24
-character.security_status # => 1.8694881661345457
 character.faction_id # => 500001
+character.gender # => "male"
+character.name # => "Green Black"
+character.race_id # => 2
+character.security_status # => 1.8694881661345457
 ```
 
 #### Get agents research
@@ -360,8 +357,6 @@ blueprint.type_id # => 1010
 # TODO: add pagination support
 ```
 
-#### Get chat channels
-
 #### Get corporation history
 
 #### Calculate a CSPA charge cost
@@ -375,7 +370,9 @@ character_fatigue = EveOnline::ESI::CharacterFatigue.new(options)
 
 character_fatigue.scope # => "esi-characters.read_fatigue.v1"
 
-character_fatigue.as_json # => {:jump_fatigue_expire_date=>nil, :last_jump_date=>nil, :last_update_date=>nil}
+character_fatigue.as_json # => {:jump_fatigue_expire_date=>nil,
+                          #     :last_jump_date=>nil,
+                          #     :last_update_date=>nil}
 
 character_fatigue.jump_fatigue_expire_date # => nil
 character_fatigue.last_jump_date # => nil
@@ -399,20 +396,21 @@ character_notifications.notifications.size # => 500
 
 notification = character_notifications.notifications.first
 
-notification.as_json # => {:notification_id=>774328832,
-                     #     :type=>"AllWarDeclaredMsg",
+notification.as_json # => {:is_read=>nil,
+                     #     :notification_id=>774328832,
                      #     :sender_id=>1000125,
                      #     :sender_type=>"corporation",
+                     #     :text=>"againstID: 99005443\ncost: 0\ndeclaredByID: 98442842\ndelayHours: 24\nhostileState: 0\n"
                      #     :timestamp=>Thu, 01 Mar 2018 13:48:00 UTC +00:00,
-                     #     :is_read=>nil,
-                     #     :text=>"againstID: 99005443\ncost: 0\ndeclaredByID: 98442842\ndelayHours: 24\nhostileState: 0\n"}
+                     #     :type=>"AllWarDeclaredMsg"}
 
+notification.is_read # => nil
 notification.notification_id # => 774328832
-notification.type # => "AllWarDeclaredMsg"
 notification.sender_id # => 1000125
 notification.sender_type # => "corporation"
-notification.timestamp # => Thu, 01 Mar 2018 13:48:00 UTC +00:00
 notification.text # => "againstID: 99005443\ncost: 0\ndeclaredByID: 98442842\ndelayHours: 24\nhostileState: 0\n"
+notification.timestamp # => Thu, 01 Mar 2018 13:48:00 UTC +00:00
+notification.type # => "AllWarDeclaredMsg"
 ```
 
 #### Get new contact notifications
@@ -426,13 +424,15 @@ character_portrait = EveOnline::ESI::CharacterPortrait.new(options)
 
 character_portrait.scope # => nil
 
-character_portrait.as_json
-# => {:small=>"http://image.eveonline.com/Character/90729314_64.jpg", :medium=>"http://image.eveonline.com/Character/90729314_128.jpg", :large=>"http://image.eveonline.com/Character/90729314_256.jpg", :huge=>"http://image.eveonline.com/Character/90729314_512.jpg"}
+character_portrait.as_json # => {:medium=>"http://image.eveonline.com/Character/90729314_128.jpg",
+                           #     :large=>"http://image.eveonline.com/Character/90729314_256.jpg",
+                           #     :huge=>"http://image.eveonline.com/Character/90729314_512.jpg"
+                           #     :small=>"http://image.eveonline.com/Character/90729314_64.jpg"}
 
-character_portrait.small # => "http://image.eveonline.com/Character/90729314_64.jpg"
 character_portrait.medium # => "http://image.eveonline.com/Character/90729314_128.jpg"
 character_portrait.large # => "http://image.eveonline.com/Character/90729314_256.jpg"
 character_portrait.huge # => "http://image.eveonline.com/Character/90729314_512.jpg"
+character_portrait.small # => "http://image.eveonline.com/Character/90729314_64.jpg"
 ```
 
 #### Get character corporation roles
@@ -450,7 +450,9 @@ character_standing.standings.size # => 37
 
 standing = character_standing.standings.first
 
-standing.as_json # => {:from_id=>500001, :from_type=>"faction", :standing=>0.3303719111639991}
+standing.as_json # => {:from_id=>500001,
+                 #     :from_type=>"faction",
+                 #     :standing=>0.3303719111639991}
 
 standing.from_id # => 500001
 standing.from_type # => "faction"
@@ -463,8 +465,6 @@ standing.standing # => 0.3303719111639991
 
 #### Character affiliation
 
-#### Get character names
-
 ### Clones
 
 #### Get clones
@@ -476,22 +476,26 @@ character_clones = EveOnline::ESI::CharacterClones.new(options)
 
 character_clones.scope # => "esi-clones.read_clones.v1"
 
-character_clones.last_clone_jump_date # => Fri, 27 Jul 2012 14:50:11 UTC +00:00
-
-character_clones.home_location.as_json # => {:location_id=>61000032, :location_type=>"station"}
+character_clones.home_location.as_json # => {:location_id=>61000032,
+                                       #     :location_type=>"station"}
 
 character_clones.jump_clones.size # => 2
 
 jump_clone = character_clones.jump_clones.first
 
-jump_clone.as_json
-# => {:jump_clone_id=>22357400, :name=>nil, :location_id=>61000032, :location_type=>"station", :implants=>[22118]}
+jump_clone.as_json # => {:implants=>[22118],
+                   #     :jump_clone_id=>22357400,
+                   #     :location_id=>61000032,
+                   #     :location_type=>"station",
+                   #     :name=>nil}
 
+jump_clone.implants # => [22118]
 jump_clone.jump_clone_id # => 22357400
-jump_clone.name # => nil
 jump_clone.location_id # => 61000032
 jump_clone.location_type # => "station"
-jump_clone.implants # => [22118]
+jump_clone.name # => nil
+
+character_clones.last_clone_jump_date # => Fri, 27 Jul 2012 14:50:11 UTC +00:00
 
 character_clones.last_station_change_date # => Tue, 30 Jun 2015 21:51:13 UTC +00:00
 ```
@@ -514,6 +518,8 @@ character_implants.implants # => [9899, 9941, 9942, 9943, 9956]
 
 #### Get alliance contacts
 
+#### Get alliance contact labels
+
 #### Delete contacts
 
 #### Get contacts
@@ -526,6 +532,8 @@ character_implants.implants # => [9899, 9941, 9942, 9943, 9956]
 
 #### Get corporation contacts
 
+#### Get corporation contact labels
+
 ### Contracts
 
 #### Get contracts
@@ -534,7 +542,13 @@ character_implants.implants # => [9899, 9941, 9942, 9943, 9956]
 
 #### Get contract items
 
-#### Get coporation contracts (typo in swagger)
+#### Get public contracts
+
+#### Get public contract bids
+
+#### Get public contract items
+
+#### Get corporation contracts
 
 #### Get corporation contract bids
 
@@ -551,34 +565,33 @@ corporation = EveOnline::ESI::Corporation.new(options)
 
 corporation.scope # => nil
 
-corporation.as_json
-# => {:name=>"Bullshit Bingo Club",
-#     :ticker=>"BUBIC",
-#     :member_count=>60,
-#     :ceo_id=>1721864142,
-#     :alliance_id=>99001258,
-#     :description=>"",
-#     :tax_rate=>0.1,
-#     :date_founded=>Mon, 11 Jul 2016 14:22:17 UTC +00:00,
-#     :creator_id=>1721864142,
-#     :corporation_url=>"http://",
-#     :faction_id=>nil,
-#     :home_station_id=>60011893,
-#     :shares=>1000}
+corporation.as_json # => {:alliance_id=>99001258,
+                    #     :ceo_id=>1721864142,
+                    #     :creator_id=>1721864142,
+                    #     :date_founded=>Mon, 11 Jul 2016 14:22:17 UTC +00:00,
+                    #     :description=>"",
+                    #     :faction_id=>nil,
+                    #     :home_station_id=>60011893,
+                    #     :member_count=>60,
+                    #     :name=>"Bullshit Bingo Club",
+                    #     :shares=>1000,
+                    #     :tax_rate=>0.1,
+                    #     :ticker=>"BUBIC",
+                    #     :corporation_url=>"http://"}
 
-corporation.name # => "Bullshit Bingo Club"
-corporation.ticker # => "BUBIC"
-corporation.member_count # => 60
-corporation.ceo_id # => 1721864142
 corporation.alliance_id # => 99001258
-corporation.description # => ""
-corporation.tax_rate # => 0.1
-corporation.date_founded # => Mon, 11 Jul 2016 14:22:17 UTC +00:00
+corporation.ceo_id # => 1721864142
 corporation.creator_id # => 1721864142
-corporation.corporation_url # => "http://"
+corporation.date_founded # => Mon, 11 Jul 2016 14:22:17 UTC +00:00
+corporation.description # => ""
 corporation.faction_id # => nil
 corporation.home_station_id # => 60011893
+corporation.member_count # => 60
+corporation.name # => "Bullshit Bingo Club"
 corporation.shares # => 1000
+corporation.tax_rate # => 0.1
+corporation.ticker # => "BUBIC"
+corporation.corporation_url # => "http://"
 ```
 
 #### Get alliance history
@@ -637,10 +650,6 @@ blueprint.type_id # => 31803
 
 #### Track corporation members
 
-#### Get corporation outposts
-
-#### Get corporation outpost details
-
 #### Get corporation member roles
 
 #### Get corporation member roles history
@@ -657,8 +666,6 @@ blueprint.type_id # => 31803
 
 #### Get corporation titles
 
-#### Get corporation names
-
 #### Get npc corporations
 
 ### Dogma
@@ -678,35 +685,37 @@ dogma_attributes.attributes.first # => 2
 #### Get attribute information
 
 ```ruby
-options = { attribute_id: 2 }
+options = { id: 2 }
 
 dogma_attribute = EveOnline::ESI::DogmaAttribute.new(options)
 
 dogma_attribute.scope # => nil
 
-dogma_attribute.as_json # => {:id=>2,
-                        #     :name=>"isOnline",
+dogma_attribute.as_json # => {:attribute_id=>2,
+                        #     :default_value=>0.0,
                         #     :description=>"Boolean to store status of online effect",
+                        #     :display_name=>"",
+                        #     :high_is_good=>true,
                         #     :icon_id=>nil,
-                        #     :default_value=>0.0,
+                        #     :name=>"isOnline",
                         #     :published=>nil,
-                        #     :display_name=>"",
-                        #     :unit_id=>nil,
                         #     :stackable=>true,
-                        #     :high_is_good=>true}
+                        #     :unit_id=>nil}
 
-dogma_attribute.id # => 2
-dogma_attribute.name # => "isOnline"
+dogma_attribute.attribute_id # => 2
+dogma_attribute.default_value # => 0.0
 dogma_attribute.description # => "Boolean to store status of online effect"
+dogma_attribute.display_name # => ""
+dogma_attribute.high_is_good # => true
 dogma_attribute.icon_id # => nil
-dogma_attribute.default_value # => 0.0
+dogma_attribute.name # => "isOnline"
 dogma_attribute.published # => nil
-dogma_attribute.display_name # => ""
-dogma_attribute.unit_id # => nil
 dogma_attribute.stackable # => true
-dogma_attribute.high_is_good # => true
+dogma_attribute.unit_id # => nil
 ```
 
+#### Get dynamic item information
+
 #### Get effects
 
 #### Get effect information
@@ -867,13 +876,13 @@ job.as_json # => {:activity_id=>1,
             #     :installer_id=>93174304,
             #     :job_id=>344736432,
             #     :licensed_runs=>1,
+            #     :location_id=>60006382,
             #     :output_location_id=>1024956764558,
             #     :pause_date=>nil,
             #     :probability=>1.0,
             #     :product_type_id=>28606,
             #     :runs=>1,
             #     :start_date=>Sat, 18 Nov 2017 11:20:14 UTC +00:00,
-            #     :station_id=>nil,
             #     :status=>"active",
             #     :successful_runs=>nil}
 
@@ -890,13 +899,13 @@ job.facility_id # => 1023579231924
 job.installer_id # => 93174304
 job.job_id # => 344736432
 job.licensed_runs # => 1
+job.location_id # => 60006382
 job.output_location_id # => 1024956764558
 job.pause_date # => nil
 job.probability # => 1.0
 job.product_type_id # => 28606
 job.runs # => 1
 job.start_date # => Sat, 18 Nov 2017 11:20:14 UTC +00:00
-job.station_id # => nil
 job.status # => "active"
 job.successful_runs # => nil
 
@@ -932,13 +941,15 @@ character_online = EveOnline::ESI::CharacterOnline.new(options)
 
 character_online.scope # => "esi-location.read_online.v1"
 
-character_online.as_json
-# => {:online=>false, :last_login=>Sun, 15 Jan 2017 11:39:24 UTC +00:00, :last_logout=>Sun, 15 Jan 2017 11:31:22 UTC +00:00, :logins=>370}
+character_online.as_json # => {:last_login=>Sun, 15 Jan 2017 11:39:24 UTC +00:00,
+                         #     :last_logout=>Sun, 15 Jan 2017 11:31:22 UTC +00:00,
+                         #     :logins=>370,
+                         #     :online=>false}
 
-character_online.online  # => false
 character_online.last_login # => Sun, 15 Jan 2017 11:39:24 UTC +00:00
 character_online.last_logout # => Sun, 15 Jan 2017 11:31:22 UTC +00:00
 character_online.logins # => 370
+character_online.online # => false
 ```
 
 #### Get current ship
@@ -1003,22 +1014,20 @@ order = character_orders.orders.first
 
 order.as_json
 
-order.order_id
-order.type_id
-order.region_id
-order.location_id
-order.range
-order.is_buy_order
-order.price
+order.duration,
+order.escrow,
+order.is_buy_order,
+order.is_corporation,
+order.issued,
+order.location_id,
+order.min_volume,
+order.order_id,
+order.price,
+order.range,
+order.region_id,
+order.type_id,
+order.volume_remain,
 order.volume_total
-order.volume_remain
-order.issued
-order.state
-order.min_volume
-order.account_id
-order.duration
-order.is_corp
-order.escrow
 
 # TODO: update example
 ```
@@ -1040,25 +1049,27 @@ order = corporation_orders.orders.first
 
 order.as_json
 
-order.order_id
-order.type_id
-order.region_id
-order.location_id
-order.range
+order.duration
+order.escrow
 order.is_buy_order
-order.price
-order.volume_total
-order.volume_remain
 order.issued
-order.state
+order.issued_by
+order.location_id
 order.min_volume
+order.order_id
+order.price
+order.range
+order.region_id
+order.type_id
+order.volume_remain
+order.volume_total
 order.wallet_division
-order.duration
-order.escrow
 
 # TODO: update example
 
 # TODO: add pagination support
+
+# TODO: update
 ```
 
 #### List historical orders from a corporation
@@ -1078,19 +1089,19 @@ statistics.size # => 417
 
 stats_today = statistics.last
 
-stats_today.as_json # => {:date=>Fri, 24 Nov 2017 00:00:00 UTC +00:00,
-                    #     :order_count=>52,
-                    #     :volume=>52,
+stats_today.as_json # => {:average=>754702326.19,
+                    #     :date=>Fri, 24 Nov 2017 00:00:00 UTC +00:00,
                     #     :highest=>769999999.99,
-                    #     :average=>754702326.19,
-                    #     :lowest=>701100002.49}
+                    #     :lowest=>701100002.49,
+                    #     :order_count=>52,
+                    #     :volume=>52}
 
+stats_today.average # => 754702326.19
 stats_today.date # => Fri, 24 Nov 2017 00:00:00 UTC +00:00
-stats_today.order_count # => 52
-stats_today.volume # => 52
 stats_today.highest # => 769999999.99
-stats_today.average # => 754702326.19
 stats_today.lowest # => 701100002.49
+stats_today.order_count # => 52
+stats_today.volume # => 52
 ```
 
 #### List orders in a region
@@ -1148,23 +1159,23 @@ character_attributes = EveOnline::ESI::CharacterAttributes.new(options)
 
 character_attributes.scope # => "esi-skills.read_skills.v1"
 
-character_attributes.as_json # => {:charisma=>20,
+character_attributes.as_json # => {:accrued_remap_cooldown_date=>Sun, 06 May 2012 12:58:06 UTC +00:00,
+                             #     :bonus_remaps=>2,
+                             #     :charisma=>20,
                              #     :intelligence=>24,
+                             #     :last_remap_date=>Sat, 07 May 2011 12:58:06 UTC +00:00,
                              #     :memory=>24,
                              #     :perception=>23,
-                             #     :willpower=>23,
-                             #     :bonus_remaps=>2,
-                             #     :last_remap_date=>Sat, 07 May 2011 12:58:06 UTC +00:00,
-                             #     :accrued_remap_cooldown_date=>Sun, 06 May 2012 12:58:06 UTC +00:00}
+                             #     :willpower=>23}
 
+character_attributes.accrued_remap_cooldown_date # => Sun, 06 May 2012 12:58:06 UTC +00:00
+character_attributes.bonus_remaps # => 2
 character_attributes.charisma # => 20
 character_attributes.intelligence # => 24
+character_attributes.last_remap_date # => Sat, 07 May 2011 12:58:06 UTC +00:00
 character_attributes.memory # => 24
 character_attributes.perception # => 23
 character_attributes.willpower # => 23
-character_attributes.bonus_remaps # => 2
-character_attributes.last_remap_date # => Sat, 07 May 2011 12:58:06 UTC +00:00
-character_attributes.accrued_remap_cooldown_date # => Sun, 06 May 2012 12:58:06 UTC +00:00
 ```
 
 #### Get character's skill queue
@@ -1180,17 +1191,23 @@ character_skill_queue.skills.size # => 50
 
 skill_queue_entry = character_skill_queue.skills.first
 
-skill_queue_entry.as_json
-# => {:skill_id=>12487, :finished_level=>3, :queue_position=>0, :finish_date=>Mon, 16 Jan 2017 03:00:35 UTC +00:00, :start_date=>Sun, 15 Jan 2017 11:38:25 UTC +00:00, :training_start_sp=>7263, :level_end_sp=>40000, :level_start_sp=>7072}
+skill_queue_entry.as_json # => {:finish_date=>Mon, 16 Jan 2017 03:00:35 UTC +00:00,
+                          #     :finished_level=>3,
+                          #     :level_end_sp=>40000,
+                          #     :level_start_sp=>7072
+                          #     :queue_position=>0,
+                          #     :skill_id=>12487,
+                          #     :start_date=>Sun, 15 Jan 2017 11:38:25 UTC +00:00,
+                          #     :training_start_sp=>7263}
 
-skill_queue_entry.skill_id # => 12487
+skill_queue_entry.finish_date # => Mon, 16 Jan 2017 03:00:35 UTC +00:00
 skill_queue_entry.finished_level # => 3
+skill_queue_entry.level_end_sp # => 40000
+skill_queue_entry.level_start_sp # => 7072
 skill_queue_entry.queue_position # => 0
-skill_queue_entry.finish_date # => Mon, 16 Jan 2017 03:00:35 UTC +00:00
+skill_queue_entry.skill_id # => 12487
 skill_queue_entry.start_date # => Sun, 15 Jan 2017 11:38:25 UTC +00:00
 skill_queue_entry.training_start_sp # => 7263
-skill_queue_entry.level_end_sp # => 40000
-skill_queue_entry.level_start_sp # => 7072
 ```
 
 #### Get character skills
@@ -1202,22 +1219,24 @@ character_skills = EveOnline::ESI::CharacterSkills.new(options)
 
 character_skills.scope # => "esi-skills.read_skills.v1"
 
-character_skills.total_sp # => 50362576
-character_skills.unallocated_sp # => 656000
-
 character_skills.as_json # => {:total_sp=>50362576, :unallocated_sp=>656000}
 
 character_skills.skills.size # => 179
 
 skill = character_skills.skills.first
 
-skill.as_json
-# => {:skill_id=>22536, :skillpoints_in_skill=>500, :trained_skill_level=>1, :active_skill_level=>0}
+skill.as_json # => {:active_skill_level=>0,
+              #     :skill_id=>22536,
+              #     :skillpoints_in_skill=>500,
+              #     :trained_skill_level=>1}
 
+skill.active_skill_level # => 0
 skill.skill_id # => 22536
 skill.skillpoints_in_skill # => 500
 skill.trained_skill_level # => 1
-skill.active_skill_level # => 0
+
+character_skills.total_sp # => 50362576
+character_skills.unallocated_sp # => 656000
 ```
 
 ### Sovereignty
@@ -1237,11 +1256,14 @@ server_status = EveOnline::ESI::ServerStatus.new
 
 server_status.scope # => nil
 
-server_status.as_json # => {:start_time=>Tue, 11 Apr 2017 11:05:35 UTC +00:00, :players=>34545, :server_version=>"1135520", :vip=>nil}
+server_status.as_json # => {:players=>34545,
+                      #     :server_version=>"1135520",
+                      #     :start_time=>Tue, 11 Apr 2017 11:05:35 UTC +00:00,
+                      #     :vip=>nil}
 
-server_status.start_time # => Tue, 11 Apr 2017 11:05:35 UTC +00:00
 server_status.players # => 34545
 server_status.server_version # => "1135520"
+server_status.start_time # => Tue, 11 Apr 2017 11:05:35 UTC +00:00
 server_status.vip # => nil
 ```
 
@@ -1258,23 +1280,25 @@ ancestries.ancestries.size # => 42
 
 ancestry = ancestries.ancestries.first
 
-ancestry.as_json # => {:ancestry_id=>24,
-                 #     :name=>"Slave Child",
-                 #     :bloodline_id=>4,
+ancestry.as_json # => {:bloodline_id=>4,
                  #     :description=>"Millions of slaves within the Amarr Empire dream of escape...",
-                 #     :short_description=>"Torn from the cold and brought to the warmth of a new life.",
-                 #     :icon_id=>1664}
+                 #     :icon_id=>1664,
+                 #     :ancestry_id=>24,
+                 #     :name=>"Slave Child",
+                 #     :short_description=>"Torn from the cold and brought to the warmth of a new life."}
 
-ancestry.ancestry_id # => 24
-ancestry.name # => "Slave Child"
 ancestry.bloodline_id # => 4
 ancestry.description # => "Millions of slaves within the Amarr Empire dream of escape..."
-ancestry.short_description # => "Torn from the cold and brought to the warmth of a new life."
 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
+
 #### Get bloodlines
 
 ```ruby
@@ -1287,28 +1311,28 @@ bloodlines.bloodlines.size # => 15
 bloodline = bloodlines.bloodlines.first
 
 bloodline.as_json # => {:bloodline_id=>4,
-                  #     :name=>"Brutor",
+                  #     :charisma=>6,
+                  #     :corporation_id=>1000049,
                   #     :description=>"A martial, strong-willed people, the Brutor...",
+                  #     :intelligence=>4,
+                  #     :memory=>4,
+                  #     :name=>"Brutor",
+                  #     :perception=>9,
                   #     :race_id=>2,
                   #     :ship_type_id=>588,
-                  #     :corporation_id=>1000049,
-                  #     :perception=>9,
-                  #     :willpower=>7,
-                  #     :charisma=>6,
-                  #     :memory=>4,
-                  #     :intelligence=>4}
+                  #     :willpower=>7}
 
 bloodline.bloodline_id # => 4
-bloodline.name # => "Brutor"
+bloodline.charisma # => 6
+bloodline.corporation_id # => 1000049
 bloodline.description # => "A martial, strong-willed people, the Brutor..."
+bloodline.intelligence # => 4
+bloodline.memory # => 4
+bloodline.name # => "Brutor"
+bloodline.perception # => 9
 bloodline.race_id # => 2
 bloodline.ship_type_id # => 588
-bloodline.corporation_id # => 1000049
-bloodline.perception # => 9
 bloodline.willpower # => 7
-bloodline.charisma # => 6
-bloodline.memory # => 4
-bloodline.intelligence # => 4
 
 # TODO: add languages
 ```
@@ -1332,27 +1356,27 @@ factions.factions.size # => 22
 
 faction = factions.factions.first
 
-faction.as_json # => {:faction_id=>500002,
-                #     :name=>"Minmatar Republic",
+faction.as_json # => {:corporation_id=>1000051,
                 #     :description=>"The Minmatar Republic was formed over a century ago when the Minmatar threw...",
-                #     :solar_system_id=>30002544,
-                #     :corporation_id=>1000051,
+                #     :faction_id=>500002,
+                #     :is_unique=>true,
                 #     :militia_corporation_id=>1000182,
+                #     :name=>"Minmatar Republic",
                 #     :size_factor=>5.0,
+                #     :solar_system_id=>30002544,
                 #     :station_count=>570,
-                #     :station_system_count=>291,
-                #     :is_unique=>true}
+                #     :station_system_count=>291}
 
-faction.faction_id # => 500002
-faction.name # => "Minmatar Republic"
-faction.description # => "The Minmatar Republic was formed over a century ago when the Minmatar threw..."
-faction.solar_system_id # => 30002544
 faction.corporation_id # => 1000051
+faction.description # => "The Minmatar Republic was formed over a century ago when the Minmatar threw..."
+faction.faction_id # => 500002
+faction.is_unique # => true
 faction.militia_corporation_id # => 1000182
+faction.name # => "Minmatar Republic"
 faction.size_factor # => 5.0
+faction.solar_system_id # => 30002544
 faction.station_count # => 570
 faction.station_system_count # => 291
-faction.is_unique # => true
 
 # TODO: add languages
 ```
@@ -1384,15 +1408,15 @@ races.races.size # => 4
 
 race = races.races.first
 
-race.as_json # => {:race_id=>2,
-             #     :name=>"Minmatar",
+race.as_json # => {:alliance_id=>500002,
              #     :description=>"Once a thriving tribal civilization, the Minmatar...",
-             #     :alliance_id=>500002}
+             #     :name=>"Minmatar",
+             #     :race_id=>2}
 
-race.race_id # => 2
-race.name # => "Minmatar"
-race.description # => "Once a thriving tribal civilization, the Minmatar..."
 race.alliance_id # => 500002
+race.description # => "Once a thriving tribal civilization, the Minmatar..."
+race.name # => "Minmatar"
+race.race_id # => 2
 
 # TODO: add languages
 
@@ -1437,41 +1461,41 @@ types.universe_types_ids.first # => 0
 #### Get type information
 
 ```ruby
-options = { type_id: 192 }
+options = { id: 192 }
 
 type = EveOnline::ESI::UniverseType.new(options)
 
 type.scope # => nil
 
-type.as_json # => {:type_id=>192,
-             #     :name=>"Phased Plasma M",
+type.as_json # => {:capacity=>0.0,
              #     :description=>"Medium Projectile Ammo...",
-             #     :published=>true,
+             #     :graphic_id=>1297,
              #     :group_id=>83,
+             #     :icon_id=>1297,
              #     :market_group_id=>112,
-             #     :radius=>1.0,
-             #     :volume=>0.0125,
+             #     :mass=>1.0,
+             #     :name=>"Phased Plasma M",
              #     :packaged_volume=>0.0125,
-             #     :icon_id=>1297,
-             #     :capacity=>0.0,
              #     :portion_size=>100,
-             #     :mass=>1.0,
-             #     :graphic_id=>1297}
+             #     :published=>true,
+             #     :radius=>1.0,
+             #     :type_id=>192,
+             #     :volume=>0.0125}
 
-type.type_id # => 192
-type.name # => "Phased Plasma M"
+type.capacity # => 0.0
 type.description # => "Medium Projectile Ammo..."
-type.published # => true
+type.graphic_id # => 1297
 type.group_id # => 83
+type.icon_id # => 1297
 type.market_group_id # => 112
-type.radius # => 1.0
-type.volume # => 0.0125
+type.mass # => 1.0
+type.name # => "Phased Plasma M"
 type.packaged_volume # => 0.0125
-type.icon_id # => 1297
-type.capacity # => 0.0
 type.portion_size # => 100
-type.mass # => 1.0
-type.graphic_id # => 1297
+type.published # => true
+type.radius # => 1.0
+type.type_id # => 192
+type.volume # => 0.0125
 
 # TODO: dogma_attributes
 # TODO: dogma_effects
@@ -1519,31 +1543,25 @@ character_wallet_journal.wallet_journal_entries.size # => 1
 
 wallet_journal_entry = character_wallet_journal.wallet_journal_entries.first
 
-wallet_journal_entry.as_json # => {:date=>Tue, 06 Mar 2018 12:43:50 UTC +00:00,
-                             #     :ref_id=>15264764711,
-                             #     :ref_type=>"market_escrow",
-                             #     :first_party_id=>90729314,
-                             #     :first_party_type=>"character",
-                             #     :second_party_id=>nil,
-                             #     :second_party_type=>nil,
-                             #     :amount=>-9.5,
-                             #     :balance=>4990.5,
-                             #     :reason=>nil,
-                             #     :tax_receiver_id=>nil,
-                             #     :tax=>nil}
-
-wallet_journal_entry.date # => Tue, 06 Mar 2018 12:43:50 UTC +00:00
-wallet_journal_entry.ref_id # => 15264764711
-wallet_journal_entry.ref_type # => "market_escrow"
-wallet_journal_entry.first_party_id # => 90729314
-wallet_journal_entry.first_party_type # => "character"
-wallet_journal_entry.second_party_id  # => nil
-wallet_journal_entry.second_party_type # => nil
-wallet_journal_entry.amount # => -9.5
-wallet_journal_entry.balance # => 4990.5
-wallet_journal_entry.reason # => nil
-wallet_journal_entry.tax_receiver_id # => nil
-wallet_journal_entry.tax # => nil
+wallet_journal_entry.as_json
+
+wallet_journal_entry.amount
+wallet_journal_entry.balance
+wallet_journal_entry.context_id
+wallet_journal_entry.context_id_type
+wallet_journal_entry.date
+wallet_journal_entry.description
+wallet_journal_entry.first_party_id
+wallet_journal_entry.id
+wallet_journal_entry.reason
+wallet_journal_entry.ref_type
+wallet_journal_entry.second_party_id
+wallet_journal_entry.tax
+wallet_journal_entry.tax_receiver_id
+
+# TODO: update example
+
+# TODO: add pagination
 ```
 
 #### Get wallet transactions
@@ -1602,6 +1620,7 @@ faraday.options.open_timeout = 60
 ```
 
 You can configure default timeouts with adding `read_timeout:` and `open_timeout:` to default hash with options:
+
 ```ruby
 options = { read_timeout: 120, open_timeout: 120 } # 120 seconds
 
@@ -1609,6 +1628,7 @@ races = EveOnline::ESI::Races.new(options)
 ```
 
 Or, dynamically:
+
 ```ruby
 races = EveOnline::ESI::Races.new
 
@@ -1621,6 +1641,16 @@ races.read_timeout = 120
 races.read_timeout # => 120
 ```
 
+## Datasource
+
+Default datasource is `tranquility`. If you want to change it, for e.g., to `singularity`, add `datasource: 'singularity'` to default hash with options:
+
+```ruby
+options = { datasource: 'singularity' }
+
+races = EveOnline::ESI::Races.new(options)
+```
+
 ## 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)
@@ -1638,13 +1668,15 @@ 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/biow0lf/eve_online>.
 
 ## Author
 
 * Igor Zubkov (@biow0lf)
 
-## Contributors. Thank you everyone!
+## Contributors
+
+Thank you everyone!
 
 * Ian Flynn (@monban)
 * Mekaret Eriker (@Mekaret)