Rynaro/FipExtractor

View on GitHub
README.md

Summary

Maintainability
Test Coverage
# FipExtractor

[![Gem Version](https://badge.fury.io/rb/fipextractor.svg)](https://badge.fury.io/rb/fipextractor)
[![Build Status](https://travis-ci.org/Rynaro/FipExtractor.svg?branch=master)](https://travis-ci.org/Rynaro/FipExtractor)
[![Coverage Status](https://coveralls.io/repos/github/Rynaro/FipExtractor/badge.svg?branch=master)](https://coveralls.io/github/Rynaro/FipExtractor?branch=master)
[![Maintainability](https://api.codeclimate.com/v1/badges/e99b5562ae060486d7d9/maintainability)](https://codeclimate.com/github/Rynaro/FipExtractor/maintainability)

Unofficial client gem for FIPE vehicle table.

## Installation

Add this line in your Gemfile:

```ruby
gem 'fipextractor', '~> 1.0'
```

    $ bundle

Or

    $ gem install fipextractor

## Implemented Calls

- [ReferenceTable](#referencetable)
- [Brand](#brand)
- [Model](#Model)
- [ModelYear](#modelyear)
- [ModelThroughYear](#modelthroughyear)
- [Vehicle](#vehicle)

### ReferenceTable

```ruby
response = FipExtractor::ReferenceTable.new.call
response.all # array of reference tables id
```

### Brand

```ruby
response = FipExtractor::Brand.new(vehicle_type: :car, reference_table_id: 66).call
response.all # array of vehicle brands
```

### Model

```ruby
response = FipExtractor::Model.new(vehicle_type: :car, reference_table_id: 66, brand_id: 44).call
response.all # array of model and years
response.models # array of model hashes
response.years # array of year designated
```

### ModelYear

```ruby
response = FipExtractor::ModelYear.new(vehicle_type: :car, reference_table_id: 66, brand_id: 44, model_id: 1878).call
response.all # array of models with aging
```

### ModelThroughYear

```ruby
response = FipExtractor::ModelThroughYear.new(vehicle_type: :car, reference_table_id: 66, brand_id: 44, year: 1999, fuel: 1).call
response.all # array of models ordered by year, and/or fuel filter
```

### Vehicle

```ruby
response = FipExtractor::Vehicle.new(vehicle_type: :car, reference_table_id: 237, brand_id: 59, model_id: 2365, year: 1999, fuel: 3).call
response.details # detailed fipe information of vehicle
```

#### Vehicle Types

```ruby
  { car: 1, motorcycle: 2, truck: 3 }
```

### Tests

`rake spec`

### Console

`bundle console`

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).