# Valle [![Build Status](https://secure.travis-ci.org/kaize/valle.png "Build Status")](http://travis-ci.org/kaize/valle) [![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/kaize/valle)

Valle automatically sets minimum and maximum values for the fields of your
ActiveRecord model(s), so you shouldn't worry, that string length or ID
value will exceed the permissible DB limit for this type of field.

For example, maximum length of the string in PostgreSQL is 255. We will
setup the following validator for you, so you don't need to write it by
hands.

    validates :field_name, length: { maximum: 255 }

Note: If you do not do this (and usually you are) and try to enter 2147483648 into the field with type: `integer` (see [Numeric types](http://www.postgresql.org/docs/9.2/static/datatype-numeric.html) section of PostgreSQL docs), you will get 500 error.

Example:

    PG::Error: ERROR:  value "2147483648" is out of range for type integer
    : SELECT  "users".* FROM "users"  WHERE "users"."id" = $1 LIMIT 1

### Supported ActiveRecord field types

- `:primary_key`
- `:integer`
- `:string`
- `:text`

## Installation

Add this line to your application's Gemfile:

    gem 'valle'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install valle

## Usage

By default, this gem adds validators to all your ActiveRecord models.
This means that, basically, you don't need to tweak it.

However, you could tell him directly what models it should take into account by adding `config/initializers/valle.rb`:

    Valle.configure do |config|
      config.models = %w(User, Post)
    end

Also, you should be able to turn it off temporary by setting `enabled` option to `false`.

    Valle.configure do |config|
      config.enabled = false
    end

## Alternatives

There is a similar gem, called [validates_lengths_from_database](http://github.com/rubiety/validates_lengths_from_database). It solves only one part -
applicable to strings. This gem is designed to work with all possible field types.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Run test suite (`rake test_suite`)
5. Push to the branch (`git push origin my-new-feature`)
6. Create new Pull Request

## Credits

Team members:

- [Anton Kalyaev](http://github.com/akalyaev)
- [Andrew Kulakov](http://github.com/Andrew8xx8)
- [Alexander Kirillov](http://github.com/saratovsource)

Thank you to all our amazing [contributors](http://github.com/kaize/valle/contributors)!

## License

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