eve_online 0.29.0 → 0.34.0

data/README.md

@@ -1,9 +1,9 @@
 # EveOnline ESI API
 
+[![CircleCI](https://circleci.com/gh/evemonk/eve_online.svg?style=svg)](https://circleci.com/gh/evemonk/eve_online)
 [![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://api.codeclimate.com/v1/badges/955073c905b91d53e68c/test_coverage)](https://codeclimate.com/github/evemonk/eve_online/test_coverage)
-[![Build Status](https://travis-ci.com/evemonk/eve_online.svg?branch=master)](https://travis-ci.com/evemonk/eve_online)
 [![security](https://hakiri.io/github/evemonk/eve_online/master.svg)](https://hakiri.io/github/evemonk/eve_online/master)
 
 This gem implement Ruby API for EveOnline MMORPG (ESI).
@@ -12,6 +12,8 @@ Looking for [EveOnline SSO OAuth2 Strategy for OmniAuth](https://github.com/evem
 
 This gem was extracted from [EveMonk](https://evemonk.com). Source code of EveMonk backend published [here](https://github.com/evemonk/evemonk).
 
+[API Documentation for latest release at rubydoc](https://rubydoc.info/gems/eve_online/frames).
+
 ## TOC
 
 * [Installation](#installation)
@@ -35,7 +37,7 @@ gem 'eve_online'
 And then execute:
 
 ```shell
-bundle
+bundle install
 ```
 
 Or install it yourself as:
@@ -46,20 +48,15 @@ gem install eve_online
 
 ## Supported ruby versions
 
-* MRI 2.4
 * MRI 2.5
 * MRI 2.6
-* MRI (head)
-* JRuby 9.2.8.0
-* JRuby (head)
+* MRI 2.7
+* JRuby 9.2.11.1
 
 ## Supported rails versions
 
-* 4.2
-* 5.0
-* 5.1
 * 5.2
-* 6.0.0
+* 6.0
 * Edge
 
 ## Usage examples
@@ -330,74 +327,8 @@ corporation_assets_names.etag # => NotImplementedError
 
 #### List bookmarks
 
-```ruby
-options = { token: 'token123', character_id: 90_729_314, page: 1 }
-
-character_bookmarks = EveOnline::ESI::CharacterBookmarks.new(options)
-
-character_bookmarks.scope # => "esi-bookmarks.read_character_bookmarks.v1"
-
-character_bookmarks.page # => 1
-
-character_bookmarks.total_pages # => 1
-
-character_bookmarks.bookmarks.size # => 20
-
-bookmark = character_bookmarks.bookmarks.first
-
-bookmark.as_json # => {:bookmark_id=>4,
-                 #     :created=>Mon, 09 Jul 2012 22:38:31 UTC +00:00,
-                 #     :creator_id=>2112625428,
-                 #     :folder_id=>5,
-                 #     :item_id=>30003496,
-                 #     :item_type_id=>5,
-                 #     :label=>"Stargate",
-                 #     :location_id=>30003430,
-                 #     :notes=>"This is a stargate"}
-
-bookmark.bookmark_id # => 4
-bookmark.created # => Mon, 09 Jul 2012 22:38:31 UTC +00:00
-bookmark.creator_id # => 2112625428
-bookmark.folder_id # => 5
-bookmark.item_id # => 30003496
-bookmark.item_type_id # => 5
-bookmark.label # => "Stargate"
-bookmark.location_id # => 30003430
-bookmark.notes # => "This is a stargate"
-
-bookmark.coordinates.as_json # => {:x=>-144951231521.81625,
-                             #     :y=>164030047870.25558,
-                             #     :z=>211467631848.1311}
-
-# TODO: character_bookmarks.etag
-```
-
 #### List bookmark folders
 
-```ruby
-options = { token: 'token123', character_id: 90_729_314, page: 1 }
-
-character_bookmark_folders = EveOnline::ESI::CharacterBookmarkFolders.new(options)
-
-character_bookmark_folders.scope # => "esi-bookmarks.read_character_bookmarks.v1"
-
-character_bookmark_folders.page # => 1
-
-character_bookmark_folders.total_pages # => 1
-
-character_bookmark_folders.bookmark_folders.size # => 1
-
-bookmark_folder = character_bookmark_folders.bookmark_folders.first
-
-bookmark_folder.as_json # => {:folder_id=>5,
-                        #     :name=>"Icecream"}
-
-bookmark_folder.folder_id # => 5
-bookmark_folder.name # => "Icecream"
-
-# TODO: character_bookmark_folders.etag
-```
-
 #### List corporation bookmarks
 
 #### List corporation bookmark folders
@@ -644,15 +575,15 @@ character_portrait = EveOnline::ESI::CharacterPortrait.new(options)
 
 character_portrait.scope # => nil
 
-character_portrait.as_json # => {:medium=>"http://imageserver.eveonline.com/Character/90729314_128.jpg",
-                           #     :large=>"http://imageserver.eveonline.com/Character/90729314_256.jpg",
-                           #     :huge=>"http://imageserver.eveonline.com/Character/90729314_512.jpg",
-                           #     :small=>"http://imageserver.eveonline.com/Character/90729314_64.jpg"}
+character_portrait.as_json # => {:medium=>"https://images.evetech.net/Character/1337512245_128.jpg",
+                           #     :large=>"https://images.evetech.net/Character/1337512245_256.jpg",
+                           #     :huge=>"https://images.evetech.net/Character/1337512245_512.jpg",
+                           #     :small=>"https://images.evetech.net/Character/1337512245_64.jpg"}
 
-character_portrait.medium # => "http://imageserver.eveonline.com/Character/90729314_128.jpg"
-character_portrait.large # => "http://imageserver.eveonline.com/Character/90729314_256.jpg"
-character_portrait.huge # => "http://imageserver.eveonline.com/Character/90729314_512.jpg"
-character_portrait.small # => "http://imageserver.eveonline.com/Character/90729314_64.jpg"
+character_portrait.medium # => "https://images.evetech.net/Character/1337512245_128.jpg"
+character_portrait.large # => "https://images.evetech.net/Character/1337512245_256.jpg"
+character_portrait.huge # => "https://images.evetech.net/Character/1337512245_512.jpg"
+character_portrait.small # => "https://images.evetech.net/Character/1337512245_64.jpg"
 
 character_portrait.etag # => "2c8392581d493e06c015ca3d48d4076079bf4c976b1f776742592260"
 ```
@@ -766,6 +697,66 @@ character_implants.implant_ids # => [9899, 9941, 9942, 9943, 9956]
 
 #### Get contracts
 
+```ruby
+options = { token: 'token123', character_id: 1337512245, page: 1 }
+
+contracts = EveOnline::ESI::CharacterContracts.new(options)
+
+contracts.scope # => "esi-contracts.read_character_contracts.v1"
+
+contracts.contracts.size # => 3
+
+contract = contracts.contracts.first
+
+contract.as_json # => {:acceptor_id=>2116199184,
+                 #     :assignee_id=>2116199184,
+                 #     :availability=>"personal",
+                 #     :buyout=>nil,
+                 #     :collateral=>0.0,
+                 #     :contract_id=>154837125,
+                 #     :date_accepted=>Fri, 06 Mar 2020 21:09:32 UTC +00:00,
+                 #     :date_completed=>Fri, 06 Mar 2020 21:09:32 UTC +00:00,
+                 #     :date_expired=>Sat, 07 Mar 2020 21:09:11 UTC +00:00,
+                 #     :date_issued=>Fri, 06 Mar 2020 21:09:11 UTC +00:00,
+                 #     :days_to_complete=>0,
+                 #     :end_location_id=>60008674,
+                 #     :for_corporation=>false,
+                 #     :issuer_corporation_id=>98134807,
+                 #     :issuer_id=>1337512245,
+                 #     :price=>0.0,
+                 #     :reward=>0.0,
+                 #     :start_location_id=>60008674,
+                 #     :status=>"finished",
+                 #     :title=>"",
+                 #     :type=>"item_exchange",
+                 #     :volume=>15000.0}
+
+contract.acceptor_id # => 2116199184
+contract.assignee_id # => 2116199184
+contract.availability # => "personal"
+contract.buyout # => nil
+contract.collateral # => 0.0
+contract.contract_id # => 154837125
+contract.date_accepted # => Fri, 06 Mar 2020 21:09:32 UTC +00:00
+contract.date_completed # => Fri, 06 Mar 2020 21:09:32 UTC +00:00
+contract.date_expired # => Sat, 07 Mar 2020 21:09:11 UTC +00:00
+contract.date_issued # => Fri, 06 Mar 2020 21:09:11 UTC +00:00
+contract.days_to_complete # => 0
+contract.end_location_id # => 60008674
+contract.for_corporation # => false
+contract.issuer_corporation_id # => 98134807
+contract.issuer_id # => 1337512245
+contract.price # => 0.0
+contract.reward # => 0.0
+contract.start_location_id # => 60008674
+contract.status # => "finished"
+contract.title # => ""
+contract.type # => "item_exchange"
+contract.volume # => 15000.0
+
+contracts.etag # => "6e18566a8f786f08aba678262360d0c74a783f9923aa43f8043133e4"
+```
+
 #### Get contract bids
 
 #### Get contract items
@@ -932,6 +923,18 @@ corporation_blueprints.roles # => ["Director"]
 
 #### Get npc corporations
 
+```ruby
+corporation_npcs = EveOnline::ESI::CorporationNPC.new
+
+corporation_npcs.scope # => nil
+
+corporation_npcs.corporation_npc_ids.size # => 262
+
+corporation_npcs.corporation_npc_ids.first # => 1000001
+
+corporation_npcs.etag # => "085946820256a4f7be2e9926e9d1de9e420cca53ffb31f7547740a05"
+```
+
 ### Dogma
 
 #### Get attributes
@@ -1297,13 +1300,13 @@ character_killmails.killmails.size # => 1
 
 killmail = character_killmails.killmails.first
 
-killmail.as_json # => {:killmail_hash=>"07f7ef1d7f6090e78d8e85b4a98e680f67b5e9d5",
-                 #     :killmail_id=>72410059}
+killmail.as_json # => {:killmail_hash=>"8f1450fca8ce97be9b10e106a1257088407ef387",
+                 #     :killmail_id=>81_646_519}
 
-killmail.killmail_hash # => "07f7ef1d7f6090e78d8e85b4a98e680f67b5e9d5"
-killmail.killmail_id # => 72410059
+killmail.killmail_hash # => "8f1450fca8ce97be9b10e106a1257088407ef387"
+killmail.killmail_id # => 81646519
 
-# TODO: character_killmails.etag
+character_killmails.etag # => "ba5068bc1b07db98d9efce93437295fbdb9d29b14b4ffbcbfa91ac0d"
 ```
 
 #### Get a corporation's recent kills and losses
@@ -1336,6 +1339,14 @@ corporation_killmails.roles # => ["Director"]
 
 #### Get a single killmail
 
+```ruby
+options = { killmail_id: 81_646_519, killmail_hash: "8f1450fca8ce97be9b10e106a1257088407ef387" }
+
+killmail = EveOnline::ESI::Killmail.new(options)
+
+# TODO: finish this
+```
+
 ### Location
 
 #### Get character location
@@ -1452,7 +1463,12 @@ offer.offer_id # => 3584
 offer.quantity # => 5000
 offer.type_id # => 23047
 
-# TODO: offer.required_items
+offer.offer_required_items.size # => 1
+
+offer_required_item = offer.offer_required_items.first
+
+offer_required_item.quantity # => 5000
+offer_required_item.type_id # => 234
 
 corporation_loyalty_store_offers.etag # => "89211f42fde090e4d22621e9b97d7604ab87af95b3b6ffed7fe81bc0"
 ```
@@ -1461,22 +1477,103 @@ corporation_loyalty_store_offers.etag # => "89211f42fde090e4d22621e9b97d7604ab87
 
 #### Return mail headers
 
+```ruby
+```
+
 #### Send a new mail
 
+```ruby
+```
+
 #### Delete a mail
 
+```ruby
+```
+
 #### Return a mail
 
+```ruby
+options = { character_id: 1_337_512_245, mail_id: 376_045_681, token: "token" }
+
+character_mail = EveOnline::ESI::CharacterGetMail.new(options)
+
+character_mail.scope # => "esi-mail.read_mail.v1"
+
+character_mail.as_json # => {:body=>"<font size=\"12\" color=\"#bfffffff\">moving</font>",
+                       #     :from_id=>1208274826,
+                       #     :read=>true,
+                       #     :subject=>"moving",
+                       #     :timestamp=>Mon, 10 Jun 2019 07:50:00 UTC +00:00}
+
+character_mail.body # => "<font size=\"12\" color=\"#bfffffff\">moving</font>"
+character_mail.from_id # => 1208274826
+character_mail.read # => true
+character_mail.subject # => "moving"
+character_mail.timestamp # => Mon, 10 Jun 2019 07:50:00 UTC +00:00
+
+character_mail.label_ids # => [4]
+
+character_mail.recipients.size # => 1
+
+recipient = character_mail.recipients.first
+
+recipient.as_json # => {:recipient_id=>98134807,
+                  #     :recipient_type=>"corporation"}
+
+recipient.recipient_id # => 98134807
+recipient.recipient_type # => "corporation"
+
+character_mail.etag # => "90dba7f7a6e60bfe8527b9f5112b9ca588c8f57d01415717be525a91"
+```
+
 #### Update metadata about a mail
 
+```ruby
+```
+
 #### Get mail labels and unread counts
 
+```ruby
+options = { character_id: 1_337_512_245, token: "token" }
+
+character_mail_labels = EveOnline::ESI::CharacterMailLabels.new(options)
+
+character_mail_labels.scope # => "esi-mail.read_mail.v1"
+
+character_mail_labels.total_unread_count # => 288
+
+character_mail_labels.labels.size # => 4
+
+label = character_mail_labels.labels.last
+
+label.as_json # => {:color=>"#ffffff",
+              #     :label_id=>8,
+              #     :name=>"[Alliance]",
+              #     :unread_count=>227}
+
+label.color # => "#ffffff"
+label.label_id # => 8
+label.name # => "[Alliance]"
+label.unread_count # => 227
+
+character_mail_labels.etag # => "265cfe7f2d7df2273342ed75c92b5047af6f76a3807dcc8353b5f379"
+```
+
 #### Create a mail label
 
+```ruby
+```
+
 #### Delete a mail label
 
+```ruby
+```
+
 #### Return mailing list subscriptions
 
+```ruby
+```
+
 ### Market
 
 #### List open orders from a character
@@ -1600,10 +1697,67 @@ market_history.etag # => "01636947a53db63a0369aab78bbc98bae94a49cd6aa3950c29d588
 
 #### Get item groups
 
+```ruby
+market_groups = EveOnline::ESI::MarketGroups.new
+
+market_groups.scope # => nil
+
+market_groups.market_group_ids.size # => 1872
+
+market_groups.market_group_ids.first # => 2
+
+market_groups.etag # => "bf7832bfc20f5f9fdeddc9cb0360b941067310e7e3a2a80315b45a43"
+```
+
 #### Get item group information
 
+```ruby
+options = { id: 618, language: 'en-us' }
+
+market_group = EveOnline::ESI::MarketGroup.new(options)
+
+market_group.scope # => nil
+
+market_group.as_json # => {:description=>"Implants intended for Subcervical Processing Slot 1.",
+                     #     :market_group_id=>618,
+                     #     :name=>"Implant Slot 01",
+                     #     :parent_group_id=>532}
+
+market_group.description # => "Implants intended for Subcervical Processing Slot 1."
+market_group.market_group_id # => 618
+market_group.name # => "Implant Slot 01"
+market_group.parent_group_id # => 532
+
+market_group.type_ids.size # => 48
+
+market_group.type_ids.first # => 28802
+
+market_group.etag # => "bf7832bfc20f5f9fdeddc9cb0360b941067310e7e3a2a80315b45a43"
+```
+
 #### List market prices
 
+```ruby
+market_prices = EveOnline::ESI::MarketPrices.new
+
+market_prices.scope # => nil
+
+market_prices.market_prices.size # => 12565
+
+market_price = market_prices.market_prices.first
+
+
+market_price.as_json # => {:adjusted_price=>923296.88,
+                     #     :average_price=>1273871.6,
+                     #     :type_id=>32772}
+
+market_price.adjusted_price # => 923296.88
+market_price.average_price # => 1273871.6
+market_price.type_id # => 32772
+
+market_prices.etag # => "2d5acc3bd4555821bb91d787596f5ddad129f849739e83162e93c02f"
+```
+
 #### List orders in a structure
 
 ### Opportunities
@@ -1897,7 +2051,7 @@ category.published # => true
 category.group_ids.size # => 46
 category.group_ids.first # => 25
 
-# TODO: category.etag
+category.etag # => "37a39e7a5f5ecc07b19a3128c319f1198d035aee10052d0a21ccdd94"
 ```
 
 #### Get constellations
@@ -2180,23 +2334,24 @@ region = EveOnline::ESI::UniverseRegion.new(options)
 
 region.scope # => nil
 
-region.as_json # => {:constellations=>[20000001,20000002,20000003,...,20000016],
-               #     :description=>"The Derelik region...",
+region.as_json # => {:description=>"The Derelik region...",
                #     :name=>"Derelik",
                #     :region_id=>10000001}
 
-region.constellations # => [20000001,20000002,20000003,...,20000016]
 region.description # => "The Derelik region..."
 region.name # => "Derelik"
 region.region_id # => 10000001
 
+region.constellation_ids.size # => 16
+region.constellation_ids.first # => 20000001
+
 region.etag # => "2c8392581d493e06c015ca3d48d4076079bf4c976b1f776742592260"
 ```
 
 #### Get stargate information
 
 ```ruby
-options = { id: 50000056 }
+options = { id: 50_000_056 }
 
 stargate = EveOnline::ESI::UniverseStargate.new(options)
 
@@ -2205,18 +2360,16 @@ stargate.scope # => nil
 stargate.as_json # => {:name=>"Stargate (Akpivem)",
                  #     :stargate_id=>50000056,
                  #     :system_id=>30000001,
-                 #     :type_id=>29624}
+                 #     :type_id=>29624,
+                 #     :destination_stargate_id=>50000342,
+                 #     :destination_system_id=>30000003}
 
 stargate.name # => "Stargate (Akpivem)"
 stargate.stargate_id # => 50000056
 stargate.system_id # => 30000001
 stargate.type_id # => 29624
-
-stargate.destination.as_json # => {:stargate_id=>50000342,
-                             #     :system_id=>30000003}
-
-stargate.destination.stargate_id # => 50000342
-stargate.destination.system_id # => 30000003
+stargate.destination_stargate_id # => 50000342
+stargate.destination_system_id # => 30000003
 
 stargate.position.as_json # => {:x=>331516354560.0,
                           #     :y=>43597455360.0,
@@ -2568,7 +2721,7 @@ type.etag # => "e3f6a76b4a1287f54966c6253f8f5d6ac6460bc43d47570331b43e0b"
 #### Get a character's wallet balance
 
 ```ruby
-options = { token: 'token123', character_id: 90729314 }
+options = { token: 'token123', character_id: 90_729_314 }
 
 character_wallet = EveOnline::ESI::CharacterWallet.new(options)
 
@@ -2578,13 +2731,13 @@ character_wallet.as_json # => {:wallet=>409488252.49}
 
 character_wallet.wallet # => 409488252.49
 
-# TODO: character_wallet.etag
+character_wallet.etag # => "482786a491138fdf393f42c457424b0cd3f3c3c7c2c9afb3f55c618a"
 ```
 
 #### Get character wallet journal
 
 ```ruby
-options = { token: 'token123', character_id: 90729314, page: 1 }
+options = { token: 'token123', character_id: 90_729_314, page: 1 }
 
 character_wallet_journal = EveOnline::ESI::CharacterWalletJournal.new(options)
 
@@ -2594,39 +2747,94 @@ character_wallet_journal.page # => 1
 
 character_wallet_journal.total_pages # => 1
 
-character_wallet_journal.wallet_journal_entries.size # => 1
+character_wallet_journal.wallet_journal_entries.size # => 220
 
 wallet_journal_entry = character_wallet_journal.wallet_journal_entries.first
 
-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: character_wallet_journal.etag
+wallet_journal_entry.as_json # => {:amount=>87375.0,
+                             #     :balance=>2405126.01,
+                             #     :context_id=>30003498,
+                             #     :context_id_type=>"system_id",
+                             #     :date=>Sun, 08 Mar 2020 12:08:25 UTC +00:00,
+                             #     :description=>"Johnn Dillinger got bounty prizes for killing pirates in Sharhelund",
+                             #     :first_party_id=>1000125,
+                             #     :wallet_journal_id=>17740466914,
+                             #     :reason=>"3744: 2,3748: 2,18085: 2,18070: 1",
+                             #     :ref_type=>"bounty_prizes",
+                             #     :second_party_id=>1337512245,
+                             #     :tax=>nil,
+                             #     :tax_receiver_id=>nil}
+
+wallet_journal_entry.amount # => 87375.0
+wallet_journal_entry.balance # => 2405126.01
+wallet_journal_entry.context_id # => 30003498
+wallet_journal_entry.context_id_type # => "system_id"
+wallet_journal_entry.date # => Sun, 08 Mar 2020 12:08:25 UTC +00:00
+wallet_journal_entry.description # => "Johnn Dillinger got bounty prizes for killing pirates in Sharhelund"
+wallet_journal_entry.first_party_id # => 1000125
+wallet_journal_entry.wallet_journal_id # => 17740466914
+wallet_journal_entry.reason # => "3744: 2,3748: 2,18085: 2,18070: 1"
+wallet_journal_entry.ref_type # => "bounty_prizes"
+wallet_journal_entry.second_party_id # => 1337512245
+wallet_journal_entry.tax # => nil
+wallet_journal_entry.tax_receiver_id # => nil
+
+character_wallet_journal.etag # => "b618a1a584f6aad53cb79c72d6de26d8c9210d0a18be1421d5355446"
 ```
 
 #### Get wallet transactions
 
+```ruby
+options = { token: "token123", character_id: 1_337_512_245 } # optional, add `from_id: 123` to skip records
+
+wallet_transactions = EveOnline::ESI::CharacterWalletTransactions.new(options)
+
+wallet_transactions.scope # => "esi-wallet.read_character_wallet.v1"
+
+wallet_transactions.wallet_transactions.size # => 47
+
+wallet_transaction = wallet_transactions.wallet_transactions.first
+
+wallet_transaction.as_json # => {:client_id=>2116253203,
+                           #     :date=>Sun, 08 Mar 2020 11:49:16 UTC +00:00,
+                           #     :is_buy=>true,
+                           #     :is_personal=>true,
+                           #     :journal_ref_id=>17740411474,
+                           #     :location_id=>60008494,
+                           #     :quantity=>1,
+                           #     :transaction_id=>5296927639,
+                           #     :type_id=>3538,
+                           #     :unit_price=>99887.79}
+
+wallet_transaction.client_id # => 2116253203
+wallet_transaction.date # => Sun, 08 Mar 2020 11:49:16 UTC +00:00
+wallet_transaction.is_buy # => true
+wallet_transaction.is_personal # => true
+wallet_transaction.journal_ref_id # => 17740411474
+wallet_transaction.location_id # => 60008494
+wallet_transaction.quantity # => 1
+wallet_transaction.transaction_id # => 5296927639
+wallet_transaction.type_id # => 3538
+wallet_transaction.unit_price # => 99887.79
+
+wallet_transactions.etag # => "55d0fbe8b408d6a76dab70c0a709d4e7c5dd58d4e0b7bd785549e268"
+```
+
 #### Returns a corporation's wallet balance
 
+```ruby
+```
+
 #### Get corporation wallet journal
 
+```ruby
+```
+
 #### Get corporation wallet transactions
 
+```ruby
+```
+
 ### Wars
 
 #### List wars
@@ -2657,6 +2865,66 @@ wars.etag # => "f1c28227847464613c1cb82dfc8a8c859b7b6857fad2c2a54c562812"
 
 #### Get war information
 
+```ruby
+options = { id: 615578 }
+
+war = EveOnline::ESI::War.new(options)
+
+war.scope # => nil
+
+war.as_json # => {:declared=>Fri, 14 Sep 2018 10:42:03 UTC +00:00,
+            #     :finished=>Thu, 20 Sep 2018 03:52:00 UTC +00:00,
+            #     :war_id=>615578,
+            #     :mutual=>false,
+            #     :open_for_allies=>false,
+            #     :retracted=>nil,
+            #     :started=>Fri, 14 Sep 2018 10:42:03 UTC +00:00}
+
+war.declared # => Fri, 14 Sep 2018 10:42:03 UTC +00:00
+war.finished # => Thu, 20 Sep 2018 03:52:00 UTC +00:00
+war.war_id # => 615578
+war.mutual # => false
+war.open_for_allies # => false
+war.retracted # => nil
+war.started # => Fri, 14 Sep 2018 10:42:03 UTC +00:00
+
+war.aggressor.as_json # => {:alliance_id=>99008592,
+                      #     :corporation_id=>nil,
+                      #     :isk_destroyed=>222167.22000000003,
+                      #     :ships_killed=>9}
+
+aggressor = war.aggressor
+
+aggressor.alliance_id # => 99008592
+aggressor.corporation_id # => nil
+aggressor.isk_destroyed # => 222167.22000000003
+aggressor.ships_killed # => 9
+
+war.allies.size # => 3
+
+ally = war.allies.first
+
+ally.as_json # => {:alliance_id=>99008228,
+             #     :corporation_id=>nil}
+
+ally.alliance_id # => 99008228
+ally.corporation_id # => nil
+
+war.defender.as_json # => {:alliance_id=>99008228,
+                     #     :corporation_id=>nil,
+                     #     :isk_destroyed=>0.0,
+                     #     :ships_killed=>0}
+
+defender = war.defender
+
+defender.alliance_id # => 99008228
+defender.corporation_id # => nil
+defender.isk_destroyed # => 0.0
+defender.ships_killed # => 0
+
+war.etag # => "3933b0baeaac259101f55fdad865c5590deeb9e1613fb2344b3db293"
+```
+
 #### List kills for a war
 
 ```ruby
@@ -2752,19 +3020,9 @@ races.write_timeout = 120
 races.write_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::UniverseRaces.new(options)
-```
-
 ## Languages support
 
-Default language is `en-us`. Supported languages: `de`, `en-us`, `fr`, `ja`, `ru`, `zh`.
+Default language is `en-us`. Supported languages: `de`, `en-us`, `fr`, `ja`, `ru`, `zh`, `ko`.
 
 If you want change it, for e.g., to `de`, add `language: 'de'` to default hash with options:
 
@@ -2784,6 +3042,26 @@ Oj.mimic_JSON()
 races = EveOnline::ESI::UniverseRaces.new
 ```
 
+## Formulas
+
+### Blueprint copy time
+
+```ruby
+seconds = 240 # 240 seconds it time to copy e.g. "Acolyte I Blueprint"
+science_level = 5 # character science level
+advanced_industry_level = 1 # character advanced industry level
+science_copy_speed_bonus_per_level = -5.00 # type dogma attribute copy speed bonus for science
+advanced_industry_skill_industry_job_time_bonus_per_level = -3.00 # type dogma attribute industry job time bonuse for advanced industry
+runs = 1 # number of copy, optional. default: 1
+
+formula = EveOnline::Formulas::BlueprintCopyTime.new(seconds, science_level,
+  advanced_industry_level, science_copy_speed_bonus_per_level,
+  advanced_industry_skill_industry_job_time_bonus_per_level, runs)
+
+# time of copy in seconds
+formula.time # => 174.6
+```
+
 ## 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)