https://github.com/ruby/bigdecimal
Arbitrary-precision decimal floating-point number library for Ruby
https://github.com/ruby/bigdecimal
bigdecimal ruby
Last synced: 7 months ago
JSON representation
Arbitrary-precision decimal floating-point number library for Ruby
- Host: GitHub
- URL: https://github.com/ruby/bigdecimal
- Owner: ruby
- License: other
- Created: 2015-12-25T01:37:05.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-12-25T03:01:02.000Z (12 months ago)
- Last Synced: 2025-05-03T08:40:19.209Z (8 months ago)
- Topics: bigdecimal, ruby
- Language: C
- Homepage:
- Size: 1.67 MB
- Stars: 125
- Watchers: 34
- Forks: 76
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# BigDecimal
BigDecimal provides an arbitrary-precision decimal floating-point number class.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'bigdecimal'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install bigdecimal
### For RubyInstaller users
If your Ruby comes from [RubyInstaller](https://rubyinstaller.org/), make sure [Devkit](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit) is available on your environment before installing bigdecimal.
### For Chocolatey
I don't have enough knowledge about Chocolatey. Please tell me what should I write here.
## Which version should you select
The differences among versions are given below:
| version | characteristics | Supported ruby version range |
| ------- | --------------- | ----------------------- |
| 3.0.0 | You can use BigDecimal with Ractor on Ruby 3.0 | 2.5 .. |
| 2.0.x | You cannot use BigDecimal.new and do subclassing | 2.4 .. |
| 1.4.x | BigDecimal.new and subclassing always prints warning. | 2.3 .. 2.7 |
| 1.3.5 | You can use BigDecimal.new and subclassing without warning | .. 2.5 |
You can select the version you want to use using `gem` method in Gemfile or scripts.
For example, you want to stick bigdecimal version 1.3.5, it works file to put the following `gem` call in you Gemfile.
```ruby
gem 'bigdecimal', '1.3.5'
```
## Usage
TODO: Write usage instructions here
## Development
After checking out the repo, run `bin/setup` to install dependencies.
Then, run `rake test` to run the tests.
You can also run `bin/console` for an interactive prompt that
will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`.
To release a new version, update the version number in `version.rb`,
and then run `bundle exec rake release`,
which will create a git tag for the version, push git commits and tags,
and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/bigdecimal.
## License
BigDecimal is released under the Ruby and 2-clause BSD licenses.
See LICENSE.txt for details.