range_utils 1.1.0 → 1.2.0

data/.travis.yml

@@ -3,8 +3,7 @@ rvm:
   - 1.9.2
   - 1.9.3
   - 2.0.0
-  - 2.1.1
-  - 2.1.2
-  - jruby
-cache: bundler
-sudo: false
+  - 2.1.5
+  - 2.2.2
+sudo: false
+cache: bundler

data/Gemfile

@@ -6,5 +6,5 @@ group :development do
   gem "rspec", "~> 3.0"
   gem "rdoc", "~> 3.12"
   gem "bundler", "~> 1.0"
-  gem "jeweler", "~> 2.0.1"
+  gem "jeweler", "1.8.4"
 end

data/README.md

@@ -1,36 +1,35 @@
 # range_utils
 
+[![Build Status](https://travis-ci.org/julik/range_utils.svg?branch=master)](https://travis-ci.org/julik/range_utils)
+
 There is more to a Range than meets the eye. Or more to the eye than meets the Range. Or whatever.
-`RangeUtils` is a non-intrusive module for doing useful things to Range objects.
 
+`RangeUtils` is a non-intrusive module for doing useful things to Range objects.
 It is mainly useful for working with batches of IDs and HTTP content ranges.
 
 ## Usage
 
-Combine consecutive Range objects:
-
+    # Combine consecutive Range objects:
     RangeUtils.splice([0..0, 0..4, 5..14, 16..20]) #=> [0..14, 16..20]
-
-Get the range for a given size of the collection:
-
+    
+    # Get the range for a given size of the collection:
     RangeUtils.range_for_size_of(14) #=> 0..13
-
-or get the size from a Range:
-
+    
+    # or get the size from a Range:
     RangeUtils.size_from_range(0..0) #=> 1
     RangeUtils.size_from_range(12..123) #=> 112
-
-Get the Ranges of maximum size for a given number of elements:
-
+    
+    # Get the Ranges of maximum size for a given number of elements:
     RangeUtils.ranges_of_offfsets_for_size(3, 1) #=> [0..0, 1..1, 2..2]
-
-Split a large Range into smaller ranges of given maximum size:
-
+    
+    # Split a large Range into smaller ranges of given maximum size:
     RangeUtils.split_range_into_subranges_of(0..7, 3) #=> [0..2, 3..5, 5..7]
-
-Prepare a number of HTTP Range headers (each request will be 1 byte):
-
+    
+    # Prepare a number of HTTP Range headers (each request will be 1 byte):
     RangeUtils.http_ranges_for_size(3, 1) #=> [0..0, 1..1, 2..2]
+    
+    # Take N items from the range
+    RangeUtils.take(4..514, 3) #=> [4..6, 7..514]
 
 ## Contributing to range_utils
  

data/lib/range_utils.rb

@@ -1,5 +1,5 @@
 module RangeUtils
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
   
   # Tells whether the +item+ is included in the +range+, without enumerating
   # through the +range+ (performing a quick bounds check).
@@ -92,6 +92,22 @@ module RangeUtils
     size
   end
   
+  # Take N items from the range, and return two Ranges
+  # the first being the range containing N items requested,
+  # and the other containing the remainder
+  #   take(4..514, 3) #=> [4..6, 7..514]
+  # If the range is too small for the number of items requested, the range itself and +nil+ will
+  # be returned instead:
+  #
+  #   take(4..514, 1024) #=> [4..514, nil]
+  #
+  # Range members and n_items must support aruthmetic with integers
+  def take(from_range, n_items)
+    end_at = from_range.begin + (n_items - 1)
+    return [from_range, nil] if end_at > from_range.end
+    [from_range.begin..end_at, end_at.succ..from_range.end]
+  end
+  
   alias_method :http_ranges_for_size, :ranges_of_offfsets_for_size
   extend self
 end

data/range_utils.gemspec

@@ -2,16 +2,14 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: range_utils 1.1.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "range_utils"
-  s.version = "1.1.0"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
   s.authors = ["Julik Tarkhanov"]
-  s.date = "2015-06-10"
+  s.date = "2015-08-25"
   s.description = "There is a whole range of things you can do with a Range"
   s.email = "me@julik.nl"
   s.extra_rdoc_files = [
@@ -32,28 +30,29 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "http://github.com/julik/range_utils"
   s.licenses = ["MIT"]
-  s.rubygems_version = "2.2.2"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23.2"
   s.summary = "Range splice, split and other niceties"
 
   if s.respond_to? :specification_version then
-    s.specification_version = 4
+    s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<rspec>, ["~> 3.0"])
       s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
       s.add_development_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_development_dependency(%q<jeweler>, ["= 1.8.4"])
     else
       s.add_dependency(%q<rspec>, ["~> 3.0"])
       s.add_dependency(%q<rdoc>, ["~> 3.12"])
       s.add_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_dependency(%q<jeweler>, ["= 1.8.4"])
     end
   else
     s.add_dependency(%q<rspec>, ["~> 3.0"])
     s.add_dependency(%q<rdoc>, ["~> 3.12"])
     s.add_dependency(%q<bundler>, ["~> 1.0"])
-    s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+    s.add_dependency(%q<jeweler>, ["= 1.8.4"])
   end
 end
 

data/spec/range_utils_spec.rb

@@ -123,6 +123,22 @@ describe "RangeUtils" do
     end
   end
   
+  context '.take' do
+    it 'returns the first range and the remainder' do
+      first, remainder = subject.take(0..12, 3)
+      expect(subject.size_from_range(first)).to eq(3)
+      expect(first).to eq(0..2)
+      expect(remainder).to eq(3..12)
+      expect(subject.splice([first, remainder])).to eq([0..12])
+    end
+    
+    it 'returns nil as the remainder if n_items exceeds the whole range' do
+      first, remainder = subject.take(0..12, 15)
+      expect(first).to eq(0..12)
+      expect(remainder).to be_nil
+    end
+  end
+  
   context '.size_from_range' do
     it 'raises an ArgumentError when the range goes into negative' do
       expect{

metadata

@@ -1,71 +1,80 @@
 --- !ruby/object:Gem::Specification
 name: range_utils
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
+  prerelease: 
 platform: ruby
 authors:
 - Julik Tarkhanov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-10 00:00:00.000000000 Z
+date: 2015-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.12'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: 1.8.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: 1.8.4
 description: There is a whole range of things you can do with a Range
 email: me@julik.nl
 executables: []
@@ -74,9 +83,9 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.md
 files:
-- ".document"
-- ".rspec"
-- ".travis.yml"
+- .document
+- .rspec
+- .travis.yml
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -87,25 +96,29 @@ files:
 homepage: http://github.com/julik/range_utils
 licenses:
 - MIT
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 3847094652455965733
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 1.8.23.2
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Range splice, split and other niceties
 test_files: []

checksums.yaml

@@ -1,7 +0,0 @@
----
-SHA1:
-  metadata.gz: 3c29b94d801585958a9838998e968c88685af5c2
-  data.tar.gz: 0f2df5d19f9a96541ec539af239424a4ad147ce4
-SHA512:
-  metadata.gz: bf6651003f4cc15e932f99f9744fa7a5c4e6050c54965ef914dd7edd116ea659fb9c4877b31952794f8d1210bfa95d299b7c307b91f17a3f0c5d880a7a4312da
-  data.tar.gz: 83f1e046df43c7e002e860ead4a3e79c5a28da97c8e4f8ab6483966daf56ce9f1c07f9c37f58e5a70b951da65f8ac504f1df7e44018de97af2a811c5a05c116b