# Credy [![Build Status](https://travis-ci.org/TimPetricola/Credy.png?branch=master)](https://travis-ci.org/TimPetricola/Credy) [![Gem Version](https://badge.fury.io/rb/credy.png)](http://badge.fury.io/rb/credy) [![Code Climate](https://codeclimate.com/github/TimPetricola/Credy.png)](https://codeclimate.com/github/TimPetricola/Credy)

Simple credit card generator/validator.
Need a valid credit card number to sign up on a site but you don't want to use your real card?
Need to validate your customers credit card?

## Functionalities
* Generates a valid number (per country/type)
* Get information for a number
* Check validity of a number

## Installation

`gem install credy`

## CLI usage

### Generate
```
credy generate --country au --type visa
```

### Get informations
```
credy infos 5108756163954799
```

### Validate
```
credy validate 5108756163954799
```

## Ruby usage

### Generate
``` ruby
options {
  country: 'au',
  type:    'mastercard'
}
Credy::CreditCard.generate options
```

### Get informations
``` ruby
Credy::CreditCard.infos '5108756163954799'
```

### Validate
``` ruby
Credy::CreditCard.validate '5108756163954799'
```

## Supported cards

At the moment, only a few types and countries are (partially) supported.

### Types
* `americanexpress`: American Express
* `bankcard`: Bankcard
* `china-unionpay`: China UnionPay
* `diners-club-carte-blanche`: Diners Club Carte Blanche
* `diners-club-enroute`: Diners Club enRoute
* `diners-club-international`: Diners Club International
* `diners-club-us-ca`: Diners Club United States & Canada
* `instapayment`: InstaPayment
* `jcb`: JCB
* `laser`: Laser
* `maestro`: Maestro
* `mastercard`: Mastercard
* `solo`: Solo
* `switch`: Switch
* `visa`: Visa
* `visa-electron`: Visa Electron

### Countries
* `au`: Australia
* `ca`: Canada
* `fr`: France
* `pl`: Poland
* `es`: Spain
* `ch`: Switzerland
* `uk`: United Kingdom
* `us`: United States

## Todo
* Add more data (see the Data source section)
* Remove luhn validation for *China UnionPay* and *Diners Club enRoute*

## Data source
All data is coming from the [Bank card number](http://en.wikipedia.org/wiki/Bank_card_number) page and the now deleted [List of Issuer Identification Numbers](http://en.wikipedia.org/wiki/List_of_Issuer_Identification_Numbers) on Wikipedia. I do not assume the responsibility for wrong data.

## License
Credy is released under the [MIT License](http://opensource.org/licenses/MIT).