chalk-ip 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDQ0NTNmNjFlMzM3NzVhMzhlOWUzYTM2YmFjMDkwMDZlNWFkZmE0OA==
+  data.tar.gz: !binary |-
+    ZjU1OTIyNGFkNjBhMmMwOTcwOWRkZWVkMWFhN2ExZGJmMDNlYjllOQ==
+SHA512:
+  metadata.gz: !binary |-
+    Yzk4ZWI4NjkxMmVmMWY0NDE1NmY3NzE0Zjk1MDgzZjA2MTkxMjIyMWM5ZGZl
+    MGNkOWMzZTRiZTczZmU0MjY4OGEwNjlkNzNlZWYwYWNkN2MzOTk0ZDJlNmQ0
+    MWQxZTAyNzEyMjI1ZWRiZGNiMGY3YTE4Yzk4MTE1OWJkNTZmNTI=
+  data.tar.gz: !binary |-
+    ZDljYThlMGEyZTBkZDI2NjUzZWI1OWM2NTJkZGM2NTc0NjRmYjZjYzBkZTRh
+    NGVjZjFiMDQxNjc1NDUwM2YzNWE2YjQ2MGEyNjIxY2FiZjdiZDYwYmEyNjVh
+    ZDYzZjZmYmU5YzRlNGI1MDhiODI1OGUzYTdkNzgzZjVkN2M0ODc=

data/.gitignore

@@ -0,0 +1,2 @@
+/Gemfile.lock
+/pkg/

data/.rubocop-disables.yml

@@ -0,0 +1,11 @@
+Style/Documentation:
+  Enabled: false
+
+Style/BracesAroundHashParameters:
+  Enabled: false
+
+Style/EmptyLines:
+  Enabled: false
+
+Style/EmptyLinesAroundClassBody:
+  Enabled: false

data/.rubocop.yml

@@ -0,0 +1,17 @@
+inherit_from:
+  - .rubocop-disables.yml
+
+Style/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: no_space
+
+Style/TrailingComma:
+  EnforcedStyleForMultiline: comma
+
+Style/SignalException:
+  EnforcedStyle: only_raise
+
+AllCops:
+  Include:
+    - '**/Rakefile'
+  Exclude:
+    - Gemfile

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3

data/Gemfile

@@ -0,0 +1,7 @@
+# Execute bundler hook if present
+['~/.', '/etc/'].any? do |file|
+ File.lstat(path = File.expand_path(file + 'bundle-gemfile-hook')) rescue next
+ eval(File.read(path), binding, path); break true
+end || source('https://rubygems.org/')
+
+gemspec

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/gem_tasks'
+require 'bundler/setup'
+# require 'rspec/core/rake_task'
+
+task :default do
+  sh 'rake -T'
+end
+
+def alias_task(alias_task, original)
+  desc "Alias for rake #{original}"
+  task alias_task, Rake.application[original].arg_names => original
+end

data/chalk-ip.gemspec

@@ -0,0 +1,41 @@
+require File.expand_path('../lib/chalk-ip/version', __FILE__)
+
+def self.list_files
+  Dir.chdir(File.dirname(__FILE__)) do
+    `git ls-files`.split($\)
+  end
+end
+
+# Find files under bin/ that include "ruby" in the first line (shebang).
+def self.find_binaries
+  list_files.grep(%r{^bin/[^/]+$}).find_all { |name|
+    File.open(name, 'r') do |f|
+      f.readline.include?('ruby')
+    end
+  }.map {|f| File.basename(f)}
+end
+
+Gem::Specification.new do |gem|
+  gem.authors   = ["Andy Brody"]
+  gem.email     = ["oss@stripe.com"]
+  gem.summary   = "Chalk::IP manipulates IP addresses"
+  gem.description = <<-EOM
+    Chalk::IP contains a few utilities for manipulating IPAddr objects that
+    really ought to be in the ruby standard library.
+  EOM
+  gem.homepage = "https://github.com/stripe/chalk-ip/"
+
+  gem.files         = list_files
+  gem.executables   = find_binaries
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "chalk-ip"
+  gem.require_paths = ["lib"]
+
+  gem.version = Chalk::IP::VERSION
+
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rubocop'
+
+  gem.required_ruby_version = '>= 1.9.3'
+end

data/lib/chalk-ip.rb

@@ -0,0 +1,115 @@
+require 'ipaddr'
+
+module Chalk; module IP
+  # Given netmask, return the number of leading 1 bits (appropriate for use
+  # with CIDR notation).
+  #
+  # I can't believe this isn't built in to the IPAddr class, but whatever.
+  #
+  # @example
+  #
+  #     >> netmask_to_cidr_bits('255.255.0.0')
+  #     => 16
+  #
+  #     >> mask = IPAddr.new('255.255.255.255/8')
+  #     => #<IPAddr: IPv4:255.0.0.0/255.0.0.0>
+  #     >> netmask_to_cidr_bits(mask)
+  #     => 8
+  #
+  #     >> netmask_to_cidr_bits('ffff:ffff:ffff:ffff::')
+  #     => 64
+  #
+  #     >> netmask_to_cidr_bits('ffff::')
+  #     => 16
+  #
+  # @param addr [String, IPAddr]
+  #
+  # @return Fixnum
+  #
+  def self.netmask_to_cidr_bits(addr)
+    case addr
+    when IPAddr
+      addr_obj = addr
+    when String
+      addr_obj = IPAddr.new(addr)
+    else
+      raise ArgumentError.new("Unexpected address: #{addr.inspect}")
+    end
+
+    if addr_obj.ipv4?
+      total = 32
+      xor = IPAddr::IN4MASK
+    elsif addr_obj.ipv6?
+      total = 128
+      xor = IPAddr::IN6MASK
+    else
+      raise "#{addr_obj.inspect} is neither IPv4 nor IPv6??"
+    end
+
+    Integer(total - Math.log2((addr_obj.to_i ^ xor) + 1))
+  end
+
+  # Given IPAddr, return the CIDR netmask bits.
+  #
+  # There doesn't seem to be any native way to do this in Rubby.
+  #
+  # @param addr [IPAddr]
+  #
+  # @return Fixnum
+  #
+  def self.addr_to_cidr_bits(addr)
+    mask = IPAddr.new(addr.instance_variable_get(:@mask_addr), addr.family)
+
+    netmask_to_cidr_bits(mask)
+  end
+
+  # Given an IP address, return it as a string in CIDR notation.
+  #
+  # I really can't believe there's no way to do this natively. Rubby.
+  #
+  # @param addr [IPAddr, String]
+  #
+  # @return String
+  #
+  def self.addr_to_s_cidr(addr)
+    if addr.is_a?(IPAddr)
+      addr_obj = addr
+    else
+      addr_obj = IPAddr.new(addr)
+    end
+
+    "#{addr_obj}/#{addr_to_cidr_bits(addr_obj)}"
+  end
+
+  # Given an enumerable of addresses, find the smallest CIDR block that will
+  # cover those addresses.
+  #
+  # @param [Enumerable<IPAddr>] addresses
+  #
+  # @return [IPAddr] A network range covering the addresses.
+  #
+  def self.cidr_block_covering(addresses)
+    # start with the first address as our range
+    net = addresses.find { true }
+    if net.nil?
+      raise ArgumentError.new('addresses cannot be empty')
+    end
+
+    addresses.each do |addr|
+      # make sure we don't mix IPv4 and IPv6 addresses
+      if net.family != addr.family
+        raise ArgumentError.new('Cannot mix addresses of differing family')
+      end
+
+      # expand net until it includes addr
+      until net.include?(addr)
+        mask_bits = addr_to_cidr_bits(net)
+        net = IPAddr.new("#{net.to_string}/#{mask_bits - 1}")
+      end
+    end
+
+    net
+  end
+end; end
+
+require_relative './chalk-ip/version'

data/lib/chalk-ip/version.rb

@@ -0,0 +1,5 @@
+module Chalk
+  module IP
+    VERSION = '0.0.1' unless defined?(self::VERSION)
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: chalk-ip
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andy Brody
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "    Chalk::IP contains a few utilities for manipulating IPAddr objects
+  that\n    really ought to be in the ruby standard library.\n"
+email:
+- oss@stripe.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rubocop-disables.yml
+- .rubocop.yml
+- .ruby-version
+- Gemfile
+- Rakefile
+- chalk-ip.gemspec
+- lib/chalk-ip.rb
+- lib/chalk-ip/version.rb
+homepage: https://github.com/stripe/chalk-ip/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: Chalk::IP manipulates IP addresses
+test_files: []