Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ruby/ipaddr
A class to manipulate an IP address
https://github.com/ruby/ipaddr
ruby
Last synced: 3 days ago
JSON representation
A class to manipulate an IP address
- Host: GitHub
- URL: https://github.com/ruby/ipaddr
- Owner: ruby
- License: bsd-2-clause
- Created: 2017-07-19T05:11:22.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-23T04:07:25.000Z (3 months ago)
- Last Synced: 2025-01-17T06:03:50.568Z (10 days ago)
- Topics: ruby
- Language: Ruby
- Homepage:
- Size: 191 KB
- Stars: 65
- Watchers: 32
- Forks: 36
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# IPAddr
IPAddr provides a set of methods to manipulate an IP address. Both
IPv4 and IPv6 are supported.
[](https://github.com/ruby/ipaddr/actions/workflows/test.yml)
## Installation
This library is part of the standard ruby distribution as default gem
and synchronized periodically, but you can explicitly depend on this
gem with version constraints as necessary, like when you need a newer
version than comes with older versions of ruby.
For example, you can add this line to your application's Gemfile:
```ruby
gem 'ipaddr', '~> 1.2'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install ipaddr
## Usage
```ruby
require 'ipaddr'
ipaddr1 = IPAddr.new "3ffe:505:2::1"
p ipaddr1 #=> #
p ipaddr1.to_s #=> "3ffe:505:2::1"
ipaddr2 = ipaddr1.mask(48) #=> #
p ipaddr2.to_s #=> "3ffe:505:2::"
ipaddr3 = IPAddr.new "192.168.2.0/24"
p ipaddr3 #=> #
```
## Alternative
The [ipaddress](https://rubygems.org/gems/ipaddress) gem is a popular,
extensive library for manipulating IP addresses with a layer of
compatibility with `ipaddr`. If you need a richer set of features
than `ipaddr` has, try this library instead.
## Development
After checking out the repo, run `bundle install` to install dependencies. Then, run `rake test` to run the tests.
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/ipaddr.
## License
The gem is available as open source under the terms of the [2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause).