spacex 0.0.5 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 26e5f1c2dfc3df1fb6474f11e1566fe3cc82193b
-  data.tar.gz: 48f6adde1cc156854b828b88d51536d666adc419
+  metadata.gz: 5607f20bf6f57edb0ce7b939c89438e21807f29e
+  data.tar.gz: 6babf6b994bad5f9fcfa917efad871360485be28
 SHA512:
-  metadata.gz: 2130be20a9251a4a431efdcb325215d9f862d7da3743c715b6f7c448cfd19cb3240607d428fe00bd6b69181b919852a6083d13cee8f4f5bbd515ff2d32ee2568
-  data.tar.gz: 96e6677d0b36a332d172614d22b95d6b9a73192f232895c00693e0d19a8ea122ac6a8b90d1b9e2a087839160698189a6cb4dad1e852a8e3356e93e48c1a90866
+  metadata.gz: 80d2b5726d2e72e74885a54f69ac7e10919b6f882d2f834a86fd3e99513d6f7db1d142cdb00d35c882304ee8b393d0358321477bbebf10d6896c595f6328e762
+  data.tar.gz: 3ed27942335b8ce402da3141efd7fb0e34939ab8656b2da619864364321d971f4e3e61c91158a195f5020c315d2cc1411ac685ea38fce740365f0b2425843982

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,7 @@
+### Purpose of the issue
+- [ ] Bug report (encountered problems/errors)
+- [ ] Feature request (request for new functionality)
+- [ ] Question
+
+### Description of the issue
+

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,6 @@
+#### Why?
+
+
+#### Description
+
+

data/.gitignore

@@ -50,3 +50,4 @@ Gemfile.lock
 .rvmrc
 
 *.gem
+.byebug_history

data/.rubocop.yml

@@ -5,4 +5,10 @@ AllCops:
 Naming/MethodName:
   Enabled: false
 
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
 inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,38 +1,24 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2018-08-21 21:48:44 -0400 using RuboCop version 0.51.0.
+# on 2018-11-01 20:09:44 -0400 using RuboCop version 0.51.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-Lint/AmbiguousOperator:
+# Offense count: 4
+Lint/ParenthesesAsGroupedExpression:
   Exclude:
-    - 'spec/spacex/launches_spec.rb'
+    - 'spec/spacex/dragon_capsules_spec.rb'
+    - 'spec/spacex/ships_spec.rb'
 
-# Offense count: 3
+# Offense count: 36
 # Configuration parameters: CountComments, ExcludedMethods.
 Metrics/BlockLength:
-  Max: 71
+  Max: 625
 
-# Offense count: 25
+# Offense count: 136
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
 # URISchemes: http, https
 Metrics/LineLength:
-  Max: 247
-
-# Offense count: 1
-# Configuration parameters: CountComments.
-Metrics/MethodLength:
-  Max: 11
-
-# Offense count: 4
-Style/Documentation:
-  Exclude:
-    - 'spec/**/*'
-    - 'test/**/*'
-    - 'lib/spacex/base_request.rb'
-    - 'lib/spacex/company_info.rb'
-    - 'lib/spacex/launches.rb'
-    - 'lib/spacex/version.rb'
+  Max: 264

data/.ruby-version

@@ -1 +1 @@
-2.4.1
+2.4.4

data/.travis.yml

@@ -1,6 +1,21 @@
-language: ruby
+env:
+  global:
+    - CC_TEST_REPORTER_ID=$CC_TEST_REPORTER_ID
 
+language: ruby
+rvm:
+  - 2.4.2
 cache: bundler
+sudo: required
+
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+
+script:
+  - bundle exec rspec
+
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT
 
-rvm:
-  - 2.4.1

data/CHANGELOG.md

@@ -0,0 +1,61 @@
+### 1.0.3 (next)
+
+* Your contribution here.
+
+### 1.0.2 (2019/10/06)
+
+* [#73](https://github.com/rodolfobandeira/spacex/pull/73): Fix Faraday adaptor failing rspec locally [@rodolfobandeira](https://github.com/rodolfobandeira).
+* [#71](https://github.com/rodolfobandeira/spacex/pull/71): Implement Landing Pads endpoint [@invacuo](https://github.com/invacuo).
+* [#70](https://github.com/rodolfobandeira/spacex/pull/70): Implement Landing Pads endpoint [@invacuo](https://github.com/invacuo).
+* [#69](https://github.com/rodolfobandeira/spacex/pull/69): Implement API Info endpoint [@fernandomaia](https://github.com/fernandomaia).
+* [#65](https://github.com/rodolfobandeira/spacex/pull/65): Add CodeClimate test coverage [@rodolfobandeira](https://github.com/rodolfobandeira).
+* [#64](https://github.com/rodolfobandeira/spacex/pull/64): Fix failing build on Travis-CI [@rodolfobandeira](https://github.com/rodolfobandeira).
+
+### 1.0.1 (2018/11/04)
+
+* [#45](https://github.com/rodolfobandeira/spacex/pull/45): Implement History endpoint [@invacuo](https://github.com/invacuo).
+* [#48](https://github.com/rodolfobandeira/spacex/pull/48): Add ability to query specific Launch via `.info('flight_number')` - [@mtking2](https://github.com/mtking2).
+* [#51](https://github.com/rodolfobandeira/spacex/pull/51): Added payloads endpoint [@maiafernando](https://github.com/maiafernando).
+* [#52](https://github.com/rodolfobandeira/spacex/pull/52): Add ability to query Past Launches - [@mtking2](https://github.com/mtking2).
+* [#54](https://github.com/rodolfobandeira/spacex/pull/54): Refactor ENDPOINT_URI - [@ludamillion](https://github.com/ludamillion).
+* [#56](https://github.com/rodolfobandeira/spacex/pull/56): Add ability to query upcoming launches - [@mtking2](https://github.com/mtking2).
+
+
+### 1.0.0 (2018/10/15)
+
+* [#41](https://github.com/rodolfobandeira/spacex/pull/41): General Refactor cleaning endpoint classes [@invacuo](https://github.com/invacuo).
+* [#44](https://github.com/rodolfobandeira/spacex/pull/44): Add flickr_images key into rockets endpoint [@Dfenniak](https://github.com/Dfenniak).
+* [#42](https://github.com/rodolfobandeira/spacex/pull/42): Add pry gem to debug - [@Dfenniak](https://github.com/Dfenniak).
+* [#40](https://github.com/rodolfobandeira/spacex/pull/40): Update and clarify information in README - [@annawinkler](https://github.com/annawinkler).
+* [#34](https://github.com/rodolfobandeira/spacex/pull/34): Implement Capsules endpoint - [@efl7a](https://github.com/efl7a).
+* [#34](https://github.com/rodolfobandeira/spacex/pull/34): Implement Cores endpoint - [@efl7a](https://github.com/efl7a).
+* [#35](https://github.com/rodolfobandeira/spacex/pull/35): Implement Rockets endpoint - [@invacuo](https://github.com/invacuo).
+* [#28](https://github.com/rodolfobandeira/spacex/pull/28): Add ability to query all launches - [@ludamillion](https://github.com/ludamillion).
+* [#26](https://github.com/rodolfobandeira/spacex/pull/26): Fix dependencies - [@harman28](https://github.com/harman28).
+* [#25](https://github.com/rodolfobandeira/spacex/pull/25): Add code coverage tools - [@harman28](https://github.com/harman28).
+* [#27](https://github.com/rodolfobandeira/spacex/pull/27): Add ability to query next launch - [@Andrey-Raspopov](https://github.com/Andrey-Raspopov)
+
+
+### 0.0.7 (2018/10/07)
+
+* Refactor responses getting multiple objects like Ships, Capsules to wrap a specific object. This helps translating specific properties like `id` and `class` to `ship_id`, `ship_class` - [@rodolfobandeira](https://github.com/rodolfobandeira).
+* Add ability to retrieve specific Ship via `.info('ship_id')` - [@rodolfobandeira](https://github.com/rodolfobandeira).
+* Add ability to retrieve specific Dragon Capsule via `.info('dragon_id')` - [@rodolfobandeira](https://github.com/rodolfobandeira).
+* [#10](https://github.com/rodolfobandeira/spacex/pull/10): Added Ships information - [@zainalmustofa](https://github.com/zainalmustofa).
+* [#9](https://github.com/rodolfobandeira/spacex/pull/9): Added Dragon Capsules information - [@JackieCalapristi](https://github.com/JackieCalapristi).
+* [#16](https://github.com/rodolfobandeira/spacex/pull/16): Added missions information - [@maiafernando](https://github.com/maiafernando).
+
+
+### 0.0.6 (2018/08/22)
+
+* Added Roadster information - [@rodolfobandeira](https://github.com/rodolfobandeira).
+
+
+### 0.0.5 (2018/08/21)
+
+* Added Company information and General Refactors - [@rodolfobandeira](https://github.com/rodolfobandeira).
+
+
+### 0.0.4 (2018/08/21)
+
+* Initial public release - [@rodolfobandeira](https://github.com/rodolfobandeira).

data/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+## How to Contribute to the SpaceX gem?
+
+### Fork the repository
+
+```
+git clone https://github.com/rodolfobandeira/spacex.git
+cd spacex
+git remote add upstream https://github.com/rodolfobandeira/spacex.git
+bundle install
+```
+
+### Write test
+
+We use `rspec`. After writing your tests, you can run tests with the following command:
+
+`bundle exec rspec`
+
+
+### Write your code
+
+Write your code to make your tests pass. After that, make sure you run `Rubocop` like this:
+
+`bundle exec rubocop`
+
+Sometimes errors can be fixed by running:
+
+`bundle exec rubocop -a`
+
+### Update the CHANGELOG with the description of your code and your name
+
+Update the CHANGELOG with the description of your code and your name on the line after `"* Your contribution here"`.
+
+### Push your change and open a pull request
+
+Use the pull request template to explaing why the PR is being made and give a brief description.
+
+Thank you!

data/Gemfile

@@ -1,5 +1,7 @@
-# frozen_string_literal: true
-
 source 'http://rubygems.org'
+group :test do
+  gem 'byebug'
+  gem 'pry'
+end
 
 gemspec

data/README.md

@@ -3,34 +3,328 @@ SpaceX Ruby Client
 
 [![Gem Version](https://badge.fury.io/rb/spacex.svg)](https://badge.fury.io/rb/spacex)
 [![Build Status](https://travis-ci.com/rodolfobandeira/spacex.svg?branch=master)](https://travis-ci.org/rodolfobandeira/spacex)
+[![Coverage Status - Coverall](https://coveralls.io/repos/github/rodolfobandeira/spacex/badge.svg?branch=master)](https://coveralls.io/github/rodolfobandeira/spacex?branch=master)
+[![Maintainability](https://api.codeclimate.com/v1/badges/d125a8ff6d902eb48c8f/maintainability)](https://codeclimate.com/github/rodolfobandeira/spacex/maintainability)
+[![Test Coverage - CodeClimate](https://api.codeclimate.com/v1/badges/d125a8ff6d902eb48c8f/test_coverage)](https://codeclimate.com/github/rodolfobandeira/spacex/test_coverage)
 
-Ruby library that consumes SpaceX API
+A Ruby library that consumes the [SpaceX API](https://github.com/r-spacex/SpaceX-API).
 
 
 ## Table of Contents
 
 - [Installation](#installation)
 - [Usage](#usage)
-  - [Latest Launch](#latest-launch)
+  - [API Info](#api-info)
+    - `SPACEX::ApiInfo.info`
+  - [Capsules](#capsules)
+    - `SPACEX::Capsules.info`
+    - `SPACEX::Capsules.info('capsule_serial')`
   - [Company Info](#company-info)
+    - `SPACEX::CompanyInfo.info`
+  - [Cores](#cores)
+    - `SPACEX::Cores.info`
+    - `SPACEX::Cores.info('core_serial')`
+  - [Dragon Capsules](#dragon-capsules)
+    - `SPACEX::DragonCapsules.info`
+    - `SPACEX::DragonCapsules.info('dragon_id')`
+  - [History](#history)
+    - `SPACEX::History.info`
+    - `SPACEX::History.info(4)`
+  - [LandingPads](#landing_pads)
+    - `SPACEX::LandingPads.info`
+    - `SPACEX::LandingPads.info('LZ-4')`
+  - [LaunchPads](#launch_pads)
+    - `SPACEX::LaunchPads.info`
+    - `SPACEX::LaunchPads.info('vafb_slc_4e')`
+  - [Launches](#launches)
+    - `SPACEX::Launches.all`
+    - `SPACEX::Launches.info`
+    - `SPACEX::Launches.info('flight_number')`
+    - `SPACEX::Launches.latest`
+    - `SPACEX::Launches.next`
+    - `SPACEX::Launches.past`
+  - [Missions](#missions)
+    - `SPACEX::Missions.info`
+    - `SPACEX::Missions.info('mission_id')`
+  - [Payloads](#payloads)
+    - `SPACEX::Payloads.info`
+    - `SPACEX::Payloads.info('payload_id')`
+  - [Roadster](#roadster)
+    - `SPACEX::Roadster.info`
+  - [Rockets](#rockets)
+    - `SPACEX::Rockets.info`
+    - `SPACEX::Rockets.info('falcon1')`
+  - [Ships](#ships)
+    - `SPACEX::Ships.info`
+    - `SPACEX::Ships.info('ship_id')`
 - [Contributing](#contributing)
 - [Copyright](#copyright)
 
 
 ## Installation
 
-Add to Gemfile.
+Add the gem to your Gemfile:
 
 ```
 gem 'spacex'
 ```
 
-Run `bundle install`.
+Then run `bundle install`.
 
 
 ## Usage
 
-### Latest Launch
+### API Info
+
+- Get information about the API: `SPACEX::ApiInfo.info`
+
+Here's an example of the response:
+
+```ruby
+api_info = SPACEX::ApiInfo.info
+
+api_info.project_name # 'SpaceX-API'
+api_info.description = # 'Open Source REST API for rocket, core, capsule, pad, and launch data, created and maintained by the developers of the r/SpaceX organization'
+api_info.organization = # 'r/SpaceX'
+api_info.organization_link = # 'https://github.com/r-spacex'
+api_info.project_link = # 'https://github.com/r-spacex/SpaceX-API'
+api_info.version = # '3.1.0'
+```
+
+### Capsules
+
+- Get information for all capsules: `SPACEX::Capsules.info`
+- Get information about a specific capsule: `SPACEX::Capsules.info('capsule_serial')`
+
+This example shows how to get capsule information and what the data fields are for that object:
+
+```ruby
+capsules_info = SPACEX::Capsules.info
+
+capsules_info.first.capsule_id # 'dragon2'
+capsules_info.first.capsule_serial # 'C201'
+capsules_info.first.details # 'Pressure vessel used for Dragon 2 structural testing. Rumored to be repurposed for first Red Dragon Mission'
+capsules_info.first.landings # 0
+capsules_info.first.missions # []
+capsules_info.first.original_launch # nil capsules_info.first.original_launch_unix # nil
+capsules_info.first.status # 'active'
+capsules_info.first.type # 'Dragon 2.0'
+```
+
+### Company Info
+
+- Get information about the company: `SPACEX::CompanyInfo.info`
+
+Here is an example of the company information:
+
+```ruby
+company_info = SPACEX::CompanyInfo.info
+
+company_info.name # 'SpaceX'
+company_info.founder # 'Elon Musk'
+company_info.founded # 2002
+company_info.employees # 7000
+company_info.vehicles # 3
+company_info.launche_sites # nil
+company_info.test_sites # 1
+company_info.ceo # 'Elon Musk'
+company_info.cto # 'Elon Musk'
+company_info.coo # 'Gwynne Shotwell'
+company_info.cto_propulsion # 'Tom Mueller'
+company_info.valuation # 15_000_000_000
+company_info.headquarters.address # 'Rocket Road'
+company_info.headquarters.city # 'Hawthorne'
+company_info.headquarters.state # 'California'
+company_info.summary # 'SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.'
+```
+
+### Cores
+
+- Get information for all cores: `SPACEX::Cores.info`
+- Get information about a specific core: `SPACEX::Cores.info('core_serial')`
+
+The following code snippet shows how to get the cores information and what the data fields are for a single core:
+
+```ruby
+cores_info = SPACEX::Cores.info
+
+cores_info.first.asds_attempts # 0
+cores_info.first.asds_landings # 0
+cores_info.first.block # 5
+cores_info.first.core_serial # 'B1052'
+cores_info.first.details # 'On test stand at McGregor'
+cores_info.first.missions # []
+cores_info.first.original_launch # nil
+cores_info.first.original_launch_unix # nil
+cores_info.first.rtls_attempts # 0
+cores_info.first.rtls_landings # 0
+cores_info.first.status # 'active'
+cores_info.first.water_landing # false
+```
+
+### Dragon Capsules
+
+- Get information for all dragon capsules: `SPACEX::DragonCapsules.info`
+- Get information about a specific dragon capsule: `SPACEX::DragonCapsules.info('dragon_id')`
+
+This code snippet shows the `dragon1` dragon capsule information:
+
+```ruby
+dragon_capsules = SPACEX::DragonCapsules.info
+
+dragon_capsules.first.capsule_id # "dragon1"
+dragon_capsules.first.name # "Dragon 1"
+dragon_capsules.first.type # "capsule"
+dragon_capsules.first.active # true
+dragon_capsules.first.crew_capacity # 0
+dragon_capsules.first.sidewall_angle_deg # 15
+dragon_capsules.first.orbit_duration_yr # 2
+dragon_capsules.first.dry_mass_kg # 4200
+dragon_capsules.first.dry_mass_lb # 9300
+dragon_capsules.first.first_flight # "2010-12-08"
+dragon_capsules.first.heat_shield['material'] # "PICA-X"
+dragon_capsules.first.heat_shield['size_meters'] # 3.6
+dragon_capsules.first.heat_shield['temp_degrees'] # 3000
+dragon_capsules.first.heat_shield['dev_partner'] # "NASA"
+dragon_capsules.first.thrusters[0]['type'] # "Draco"
+dragon_capsules.first.thrusters[0]['amount'] # 18
+dragon_capsules.first.thrusters[0]['pods'] # 4
+dragon_capsules.first.thrusters[0]['fuel_1'] # "nitrogen tetroxide"
+dragon_capsules.first.thrusters[0]['fuel_2'] # "monomethylhydrazine"
+dragon_capsules.first.thrusters[0]['thrust']['kN'] # 0.4
+dragon_capsules.first.thrusters[0]['thrust']['lbf'] # 90
+dragon_capsules.first.launch_payload_mass['kg'] # 6000
+dragon_capsules.first.launch_payload_mass['lb'] # 13228
+dragon_capsules.first.launch_payload_vol['cubic_meters'] # 25
+dragon_capsules.first.launch_payload_vol['cubic_feet'] # 883
+dragon_capsules.first.return_payload_mass['kg'] # 3000
+dragon_capsules.first.return_payload_mass['lb'] # 6614
+dragon_capsules.first.return_payload_vol['cubic_meters'] # 11
+dragon_capsules.first.return_payload_vol['cubic_feet'] # 388
+dragon_capsules.first.pressurized_capsule['payload_volume']['cubic_meters']) # 11
+dragon_capsules.first.pressurized_capsule['payload_volume']['cubic_feet'] # 388
+dragon_capsules.first.trunk['trunk_volume['cubic_meters'] # 14
+dragon_capsules.first.trunk['trunk_volume['cubic_feet'] # 494
+dragon_capsules.first.trunk['cargo']['solar_array'] # 2
+dragon_capsules.first.trunk['cargo']['unpressurized_cargo'] # true
+dragon_capsules.first.height_w_trunk['meters'] # 7.2
+dragon_capsules.first.height_w_trunk['feet'] # 23.6
+dragon_capsules.first.diameter['meters'] # 3.7
+dragon_capsules.first.diameter['feet'] # 12
+dragon_capsules.first.wikipedia # "https://en.wikipedia.org/wiki/SpaceX_Dragon"
+dragon_capsules.first.description # "Dragon is a reusable spacecraft developed by SpaceX, an American private space transportation company based in Hawthorne, California. Dragon is launched into space by the SpaceX Falcon 9 two-stage-to-orbit launch vehicle. The Dragon spacecraft was originally designed for human travel, but so far has only been used to deliver cargo to the International Space Station (ISS)."
+```
+
+### History
+
+- Get information for all historical events: `SPACEX::History.info`
+- Get information about a specific historical event: `SPACEX::History.info('4')`
+
+```ruby
+require 'spacex'
+historical_events = SPACEX::History.info
+
+first_event = historical_events.first
+first_event.id # 1
+first_event.title # Falcon 1 Makes History
+first_event.event_date_utc # 2008-09-28T23:15:00Z
+first_event.event_date_unix # 1222643700
+first_event.flight_number # 4
+first_event.details # Falcon 1 becomes the first privately developed liquid fuel rocket to reach Earth orbit.
+first_event.links['reddit'] # nil
+first_event.links['article'] # http://www.spacex.com/news/2013/02/11/flight-4-launch-update-0
+first_event.links['wikipedia'] # https://en.wikipedia.org/wiki/Falcon_1
+```
+
+### LandingPads
+
+- Get information for all LandingPads: `SPACEX::LandingPads.info`
+- Get information about a specific LandingPad: `SPACEX::LandingPads.info('LZ-4')`
+
+This code shows how to get the information for a specific LandingPad by id and lists the fields:
+
+```ruby
+landing_pad = SPACEX::LandingPads.info('LZ-4')
+landing_pad.id # 'LZ-4'
+landing_pad.full_name # 'Landing Zone 4'
+landing_pad.status # 'active'
+landing_pad.location['name'] # 'Vandenberg Air Force Base'
+landing_pad.location['region'] # 'California'
+landing_pad.location['latitude'] # 34.632989
+landing_pad.location['longitude'] # -120.615167
+landing_pad.landing_type # 'RTLS'
+landing_pad.attempted_landings # 2
+landing_pad.successful_landings # 2
+landing_pad.wikipedia # "https://en.wikipedia.org/wiki/Vandenberg_AFB_Space_Launch_Complex_4#LZ-4_landing_history"
+landing_pad.details # "SpaceX's west coast landing pad. The pad is adjacent to SLC-4E, SpaceX's west coast launch site. The pad was under construction for about a year starting in 2016. After concerns with seal mating season, this pad was first used for the SAOCOM 1A mission in October 2018. Officially referred to as LZ-4 in FCC filings."
+```
+
+### LaunchPads
+
+- Get information for all LaunchPads: `SPACEX::LaunchPads.info`
+- Get information about a specific LaunchPad: `SPACEX::LaunchPads.info('vafb_slc_4e')`
+
+This code shows how to get the information for a specific LaunchPad by site_id and lists the fields:
+
+```ruby
+launch_pad = SPACEX::LaunchPads.info('vafb_slc_4e')
+
+launch_pad.id # 6
+launch_pad.name # 'VAFB SLC 4E'
+launch_pad.status # 'active'
+launch_pad.location['name'] # 'Vandenberg Air Force Base',
+launch_pad.location['region'] # 'California',
+launch_pad.location['latitude'] # 34.632093,
+launch_pad.location['longitude'] # -120.610829
+launch_pad.vehicles_launched # ['Falcon 9']
+launch_pad.attempted_launches # 15
+launch_pad.successful_launches # 15
+launch_pad.wikipedia # 'https://en.wikipedia.org/wiki/Vandenberg_AFB_Space_Launch_Complex_4'
+launch_pad.details # 'SpaceX primary west coast launch pad for polar orbits and sun synchronous orbits, primarily used for Iridium. Also intended to be capable of launching Falcon Heavy.'
+launch_pad.site_id # 'vafb_slc_4e'
+launch_pad.site_name_long # 'Vandenberg Air Force Base Space Launch Complex 4E'
+```
+
+### Launches
+
+- Get information for all launches: `SPACEX::Launches.all` or `SPACEX::Launches.info`
+- Get information about a specific launch: `SPACEX::Launches.info('flight_number')`
+- Get information on past launches: `SPACEX::Launches.past`
+- Get information on the next launch: `SPACEX::Launches.next`
+- Get the latest launch information: `SPACEX::Launches.latest`
+- Get information on upcoming launches: `SPACEX::Launches.upcoming`
+
+This code snippet shows how to get information for a specific launch by flight number and list the fields:
+
+```ruby
+require 'spacex'
+launch_68 = SPACEX::Launches.info(68)
+
+launch_68.flight_number # 68
+launch_68.mission_name # 'Telstar 18V'
+launch_68.rocket.rocket_name # 'Falcon 9'
+launch_68.rocket.first_stage.cores.first.land_success # true
+```
+
+This code snippet shows how to get information on past launches:
+```ruby
+past_launches = SPACEX::Launches.past
+
+past_launches.first.flight_number # 1
+past_launches.first.mission_name # 'FalconSat'
+past_launches.first.rocket.rocket_name # 'Falcon 1'
+past_launches.first.launch_success # false
+
+past_launches.last.flight_number # 69
+past_launches.last.mission_name # 'SAOCOM 1A'
+past_launches.last.rocket.rocket_name # 'Falcon 9'
+past_launches.last.rocket.first_stage.cores.first.land_success # true
+past_launches.last.launch_success # true
+```
+
+
+
+The following code snippet shows the latest launch information and the data fields available on the Launch object:
 
 ```ruby
 require 'spacex'
@@ -102,37 +396,176 @@ latest_launch.upcoming # false
 latest_launch.static_fire_date_utc # '2018-08-02T15:53:00.000Z'
 ```
 
+This code snippet shows how to get information on upcoming launches:
+```ruby
+upcoming_launches = SPACEX::Launches.upcoming
+
+upcoming_launches.first.flight_number # 70
+upcoming_launches.first.mission_name # 'Es’hail 2'
+upcoming_launches.first.launch_date_utc # '2018-11-14T20:46:00.000Z'
+
+upcoming_launches.last.flight_number # 91
+upcoming_launches.last.mission_name # 'GPS IIIA-3'
+upcoming_launches.last.launch_date_utc # '2019-10-01T00:00:00.000Z'
+```
+
+### Missions
 
-### Company Info
+- Get information for all mission: `SPACEX::Missions.info`
+- Get information about a specific mission: `SPACEX::Missions.info('mission_id')`
+
+This code shows how to get the first mission information and lists the fields:
 
 ```ruby
-company_info = SPACEX::CompanyInfo.info
+missions = SPACEX::Missions.info
 
-company_info.name # 'SpaceX'
-company_info.founder # 'Elon Musk'
-company_info.founded # 2002
-company_info.employees # 7000
-company_info.vehicles # 3
-company_info.launche_sites # nil
-company_info.test_sites # 1
-company_info.ceo # 'Elon Musk'
-company_info.cto # 'Elon Musk'
-company_info.coo # 'Gwynne Shotwell'
-company_info.cto_propulsion # 'Tom Mueller'
-company_info.valuation # 15_000_000_000
-company_info.headquarters.address # 'Rocket Road'
-company_info.headquarters.city # 'Hawthorne'
-company_info.headquarters.state # 'California'
-company_info.summary # 'SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.'
+missions.first.mission_id # "F3364BF"
+missions.first.mission_name # "Iridium NEXT"
+missions.first.manufacturers # ["Orbital ATK"]
+missions.first.payload_ids # ["Iridium NEXT 1", "Iridium NEXT 2", "Iridium NEXT 3", "Iridium NEXT 4", "Iridium NEXT 5", "Iridium NEXT 6", "Iridium NEXT 7"]
+missions.first.wikipedia # "https://en.wikipedia.org/wiki/Iridium_satellite_constellation"
+missions.first.website # "https://www.iridiumnext.com/"
+missions.first.twitter # "https://twitter.com/IridiumBoss?lang=en"
+missions.first.description # "In 2017, Iridium began launching Iridium NEXT, a second-generation worldwide network of telecommunications satellites, consisting of 66 active satellites, with another nine in-orbit spares and six on-ground spares. These satellites will incorporate features such as data transmission that were not emphasized in the original design. The constellation will provide L-band data speeds of up to 128 kbit/s to mobile terminals, up to 1.5 Mbit/s to Iridium Pilot marine terminals, and high-speed Ka-band service of up to 8 Mbit/s to fixed/transportable terminals. The next-generation terminals and service are expected to be commercially available by the end of 2018. However, Iridium's proposed use of its next-generation satellites has raised concerns the service will harmfully interfere with GPS devices. The satellites will incorporate a secondary payload for Aireon, a space-qualified ADS-B data receiver. This is for use by air traffic control and, via FlightAware, for use by airlines. A tertiary payload on 58 satellites is a marine AIS ship-tracker receiver, for Canadian company exactEarth Ltd. Iridium can also be used to provide a data link to other satellites in space, enabling command and control of other space assets regardless of the position of ground stations and gateways."
+```
+
+### Payloads
+
+- Get information for all payloads: `SPACEX::Payloads.info`
+- Get information about a specific payload: `SPACEX::Payloads.info('payload_id')`
+
+The following code shows how to get information about a specific payload and lists the payload data fields:
+
+```ruby
+payload = SPACEX::Payloads.info('FalconSAT-2')
+
+payload.payload_id # 'FalconSAT-2'
+payload.reused # false
+payload.customers # ['DARPA']
+payload.nationality # 'United States'
+payload.manufacturer # 'SSTL'
+payload.payload_type # 'Satellite'
+payload.payload_mass_kg # 20
+payload.payload_mass_lbs # 43
+payload.orbit # 'LEO'
+payload.orbit_params # {"reference_system"=>"geocentric", "regime"=>"low-earth", "longitude"=>nil, "semi_major_axis_km"=>nil, "eccentricity"=>nil, "periapsis_km"=>400, "apoapsis_km"=>500, "inclination_deg"=>39, "period_min"=>nil, "lifespan_years"=>nil, "epoch"=>nil, "mean_motion"=>nil, "raan"=>nil, "arg_of_pericenter"=>nil, "mean_anomaly"=>nil}
 ```
 
+### Roadster
+
+- Get roadster orbital data: `SPACEX::Roadster.info`
+
+The following code shows how to get information about the Roadster:
+
+```ruby
+roadster = SPACEX::Roadster.info
+
+roadster.name # "Elon Musk's Tesla Roadster"
+roadster.launch_date_utc # '2018-02-06T20:45:00.000Z'
+roadster.launch_date_unix # 1_517_949_900
+roadster.launch_date_kg # nil
+roadster.launch_date_lbs # nil
+roadster.norad_id # 43_205
+roadster.epoch_jd # 2_458_353.027800926
+roadster.orbit_type # 'heliocentric'
+roadster.apoapsis_au # 1.663757412460597
+roadster.periapsis_au # 0.9860953641129515
+roadster.semo_major_axis_au # nil
+roadster.eccentricity # 0.2557357353354217
+roadster.inclination # 1.077474057737451
+roadster.longitude # 317.0962040947829
+roadster.periapsis_arg # 177.491390597234
+roadster.speed_kph # 76_703.72399999999
+roadster.speed_mph # 47_661.469685603995
+roadster.earth_distance_km # 172_954_806.23899576
+roadster.earth_distance_mi # 107_469_100.90753104
+roadster.mars_distance_km # 147_648_108.6344399
+roadster.mars_distance_mi # 91_744_252.91029055
+roadster.wikipedia # 'https://en.wikipedia.org/wiki/Elon_Musk%27s_Tesla_Roadster'
+roadster.details # "Elon Musk's Tesla Roadster is an electric sports car that served as the dummy payload for the February 2018 Falcon Heavy test flight and is now an artificial satellite of the Sun. Starman, a mannequin dressed in a spacesuit, occupies the driver's seat. The car and rocket are products of Tesla and SpaceX, both companies founded by Elon Musk. This 2008-model Roadster was previously used by Musk for commuting, and is the only consumer car sent into space."
+```
+
+### Rockets
+
+- Get information for all rockets: `SPACEX::Rockets.info`
+- Get information about a specific rocket: `SPACEX::Rockets.info('rocket_id')`
+
+This example shows a single rocket and its data fields:
+
+```
+rockets = SPACEX::Rockets.info
+first_rocket = rockets.first
+
+first_rocket.id # 1
+first_rocket.active # false
+first_rocket.stages # 2
+first_rocket.boosters # 0
+first_rocket.cost_per_launch # 6700000
+first_rocket.success_rate_pct # 40
+first_rocket.first_flight # "2006-03-24"
+first_rocket.country # "Republic of the Marshall Islands"
+first_rocket.company # "SpaceX"
+first_rocket.height # {"meters"=>22.25, "feet"=>73}
+first_rocket.diameter # {"meters"=>1.68, "feet"=>5.5}
+first_rocket.mass # {"kg"=>30146, "lb"=>66460}
+first_rocket.payload_weights # [{"id"=>"leo", "name"=>"Low Earth Orbit", "kg"=>450, "lb"=>992}]
+first_rocket.first_stage # {"reusable"=>false, "engines"=>1, "fuel_amount_tons"=>44.3, "burn_time_sec"=>169, "thrust_sea_level"=>{"kN"=>420, "lbf"=>94000}, "thrust_vacuum"=>{"kN"=>480, "lbf"=>110000}}
+first_rocket.second_stage # {"engines"=>1, "fuel_amount_tons"=>3.38, "burn_time_sec"=>378, "thrust"=>{"kN"=>31, "lbf"=>7000}, "payloads"=>{"option_1"=>"composite fairing", "composite_fairing"=>{"height"=>{"meters"=>3.5, "feet"=>11.5}, "diameter"=>{"meters"=>1.5, "feet"=>4.9}}}}
+first_rocket.engines # {"number"=>1, "type"=>"merlin", "version"=>"1C", "layout"=>"single", "engine_loss_max"=>0, "propellant_1"=>"liquid oxygen", "propellant_2"=>"RP-1 kerosene", "thrust_sea_level"=>{"kN"=>420, "lbf"=>94000}, "thrust_vacuum"=>{"kN"=>480, "lbf"=>110000}, "thrust_to_weight"=>96}
+first_rocket.landing_legs # {"number"=>0, "material"=>nil}
+first_rocket.wikipedia # "https://en.wikipedia.org/wiki/Falcon_1"
+first_rocket.description # "The Falcon 1 was an expendable launch system privately developed and manufactured by SpaceX during 2006-2009. On 28 September 2008, Falcon 1 became the first privately-developed liquid-fuel launch vehicle to go into orbit around the Earth."
+first_rocket.rocket_id # "falcon1"
+first_rocket.rocket_name # "Falcon 1"
+first_rocket.rocket_type # "rocket"
+first_rocket.flickr_images # ["https://www.spacex.com/sites/spacex/files/styles/media_gallery_large/public/2009_-_01_liftoff_south_full_wide_ro8a1280_edit.jpg?itok=8loiSGt1", "https://www.spacex.com/sites/spacex/files/styles/media_gallery_large/public/2009_-_02_default_liftoff_west_full_wide_nn6p2062_xl.jpg?itok=p776nHsM"]
+```
+
+### Ships
+
+- Get information for all ships: `SPACEX::Ships.info`
+- Get information about a specific ship: `SPACEX::Ships.info('ship_id')`
+
+The following code shows how to get information about a specific ship and lists the ship data fields:
+
+```ruby
+ship = SPACEX::Ships.info('AMERICANCHAMPION')
+
+ship.ship_id # 'AMERICANCHAMPION'
+ship.ship_name # 'American Champion'
+ship.ship_model # nil
+ship.ship_type # 'Tug'
+ship.roles # ['Support Ship', 'Barge Tug']
+ship.active # false
+ship.imo # 7_434_016
+ship.mmsi # 367_020_820
+ship.abs # 571_252
+ship.ship_class # 7_604_342 # Call as array since "class" is a method in Ruby
+ship.weight_lbs # 588_000
+ship.weight_kg # 266_712
+ship.year_built # 1976
+ship.home_port # 'Port of Los Angeles'
+ship.status # 'Stopped'
+ship.speed_kn # 0
+ship.course_deg # nil
+ship.position # ({ 'latitude' => 30.52852, 'longitude' => -88.09869 })
+ship.successful_landings # nil
+ship.attempted_landings # nil
+ship.missions # [{ 'flight' => 7, 'name' => 'COTS 1' }, { 'flight' => 8, 'name' => 'COTS 2' }]
+ship.url # 'https://www.marinetraffic.com/en/ais/details/ships/shipid:434663/vessel:AMERICAN%20CHAMPION'
+ship.image # 'https://i.imgur.com/woCxpkj.jpg'
+```
+
+
 ## Contributing
 
-Want to help? Create an issue, open a pull request. Any help is welcome.
+See [CONTRIBUTING](CONTRIBUTING.md).
+
+[List of awesome people that already helped this project](CHANGELOG.md).
 
 
 ## Copyright
 
-Copyright (c) Rodolfo Bandeira, 2018
+Copyright (c) 2018, [Rodolfo Bandeira](https://twitter.com/rodolfobandeira) and [Contributors](CHANGELOG.md).
 
 MIT License, see [LICENSE](https://github.com/rodolfobandeira/spacex/blob/master/LICENSE) for details.