datasizes 1.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.travis.yml

@@ -0,0 +1,15 @@
+script: "rake test"
+rvm:
+
+  - 2.1.2
+  - 2.1.1
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+  - jruby-18mode
+  - jruby-19mode
+  - ruby-head
+  - jruby-head
+  - 1.8.7
+  - ree
+  - rbx-2.2.7

data/CHANGES.txt

@@ -0,0 +1,6 @@
+
+1.0.1 (2014-09-25)
+* 'hash-utils' dependency removed
+
+1.0.0 (2012-11-22) 
+* initial version

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "bundler"
+  gem "jeweler"
+  gem "rake"
+  gem "rspec"
+  gem "simplecov"
+end

data/Gemfile.lock

@@ -0,0 +1,73 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    builder (3.2.2)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.2.5)
+    docile (1.1.3)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    git (1.2.7)
+    github_api (0.11.3)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (3.0.0)
+    highline (1.6.21)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (1.0.0)
+    mini_portile (0.6.0)
+    multi_json (1.10.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.2.1)
+      mini_portile (= 0.6.0)
+    oauth2 (0.9.4)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.3.2)
+    rdoc (4.1.1)
+      json (~> 1.4)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.8)
+    rspec-expectations (2.14.5)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.6)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    thread_safe (0.3.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  jeweler
+  rake
+  rspec
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012-2014 Martin Poljak (martin@poljak.cz)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+Datasizes
+=========
+
+**datasizes** gem provides simple API for converting `dd` like 
+data amount postfixes (like `3M` or `4G`) to bytes and bytes to these 
+strings.
+
+Usage is simple (see API reference for details):
+  
+  Datasizes::to_bytes("3K")           # will return 3072
+  Datasizes::to_magnitude(3072, :K)   # will return "3K"
+  Datasizes::from_bytes(3145728)      # will return "3M"
+  
+    
+Contributing
+------------
+
+1. Fork it.
+2. Create a branch (`git checkout -b 20101220-my-change`).
+3. Commit your changes (`git commit -am "Added something"`).
+4. Push to the branch (`git push origin 20101220-my-change`).
+5. Create an [Issue][9] with a link to your branch.
+6. Enjoy a refreshing Diet Coke and wait.
+
+
+Copyright
+---------
+
+Copyright © 2012-2014 [Martin Poljak][10]. See `LICENSE.txt` 
+for further details.
+
+[9]: http://github.com/martinkozak/datasizes/issues
+[10]: http://www.martinpoljak.net/

data/Rakefile

@@ -0,0 +1,41 @@
+# encoding: utf-8
+require 'rubygems'
+require 'bundler'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+### Jeweler
+
+require 'rake'
+require 'jeweler'
+
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "datasizes"
+  gem.homepage = "http://github.com/martinkozak/datasizes"
+  gem.license = "MIT"
+  gem.summary = 'Provides simple API for converting \'dd\' like data amount postfixes (like 3M or 4G) to bytes and bytes to these strings.'
+  gem.email = "martinkozak@martinkozak.net"
+  gem.authors = ["Martin Kozák"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+
+### RSpec
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:test) do |t|
+  t.pattern = 'tests.rb'
+  t.rspec_opts = '--format d -c'
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/datasizes.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "datasizes"
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Martin Koz\u{e1}k"]
+  s.date = "2014-09-25"
+  s.email = "martinkozak@martinkozak.net"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".travis.yml",
+    "CHANGES.txt",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "datasizes.gemspec",
+    "lib/datasizes.rb",
+    "lib/datasizes/exceptions.rb",
+    "tests.rb"
+  ]
+  s.homepage = "http://github.com/martinkozak/datasizes"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.29"
+  s.summary = "Provides simple API for converting 'dd' like data amount postfixes (like 3M or 4G) to bytes and bytes to these strings."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/lib/datasizes.rb

@@ -0,0 +1,120 @@
+# encoding: utf-8
+# (c) 2012-2014 Martin Kozák (martinkozak@martinkozak.net)
+# (c) 2014 Martin Poljak (martin@poljak.cz)
+
+require "datasizes/exceptions"
+
+module Datasizes
+
+    ##
+    # Magnitudes list.
+    # @var [Hash]
+    #
+    
+    MAGNITUDES = Hash[{
+        nil => 0,
+        :K => 1,
+        :M => 2,
+        :G => 3,
+        :T => 4,
+        :P => 5,
+        :E => 6,
+        :Z => 7,
+        :Y => 8,
+    }.to_a.reverse]
+    
+    ##
+    # Contains analyser query.
+    # @var [Regexp]
+    #
+    
+    ANALYSER = /^(\d+)([KMGTPEZY])?$/u
+
+    ##
+    # Converts specification to bytes.
+    #
+    # @param [String] spec
+    # @return [Integer] size in bytes
+    #
+
+    def self.to_bytes(spec)
+        amount, magnitude = self::analyze_specification(spec)
+        return self.count_bytes(amount, magnitude)
+    end
+    
+    ##
+    # Counts bytes for given amount and magnitude.
+    # 
+    # @param [Integer] size  size in bytes
+    # @param [Symbol, String] magnitude  magnitude name
+    # @return [Integer] size in bytes
+    #
+    
+    def self.count_bytes(amount, magnitude = nil)
+        magnitude = magnitude.to_sym if magnitude.kind_of? String
+        magnitude = self::MAGNITUDES[magnitude]
+        return amount * (1024 ** magnitude)
+    end
+        
+    ##
+    # Converts given size in bytes to given magnitude.
+    #
+    # @param [Integer] size  size in bytes
+    # @param [Symbol, String] magnitude  magnitude name
+    # @return [String] specification
+    #
+    
+    def self.to_magnitude(size, magnitude = nil)
+        magnitude = magnitude.to_sym if magnitude.kind_of? String
+        factor = self::MAGNITUDES[magnitude]
+        
+        if factor.nil?
+            raise Datasizes::InvalidMagnitude::new("Invalid magnitude '#{magnitude}'.")
+        end
+        
+        (size / (1024 ** factor)).to_s + magnitude.to_s
+    end
+    
+    ##
+    # Converts given size to nearest reasonable magnitude 
+    # specification.
+    #
+    # @param [Integer] size  size in bytes
+    # @return [String] specification
+    #
+    
+    def self.from_bytes(size)
+        self::MAGNITUDES.each_key do |magnitude|
+            amount = self.count_bytes(1, magnitude)
+            remain = size % amount
+            
+            if remain == 0
+                return (size / amount).to_s + magnitude.to_s
+            end
+        end
+    end
+    
+    ##
+    # Analyzes the given specification.
+    #
+    # @param [String] spec  specification
+    # @return [Array] amount (Integer) and magnitude 
+    #   identifier (Symbol)
+    #
+    
+    def self.analyze_specification(spec)
+        matches = spec.match(self::ANALYSER)
+        
+        if matches.nil?
+            raise Datasizes::InvalidSpecification
+        else
+            size = matches[1].to_i 
+            if not matches[2].nil?
+                magnitude = matches[2].to_sym
+            end
+            
+            return [size, magnitude]
+        end
+    end
+    
+end

data/lib/datasizes/exceptions.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+# (c) 2012 Martin Kozák (martinkozak@martinkozak.net)
+
+module Datasizes
+    
+    class InvalidSpecification < ::Exception
+    end
+
+    class InvalidMagnitude < ::Exception
+    end
+    
+end

data/tests.rb

@@ -0,0 +1,75 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+# (c) 2012 Martin Kozák (martinkozak@martinkozak.net)
+
+$:.push("./lib")
+$:.unshift("./lib")
+
+require "rspec"
+require "simplecov"
+SimpleCov.start
+
+require "datasizes"
+require "datasizes/exceptions"
+
+describe "#to_bytes" do
+    specify("bytes") do
+        Datasizes::to_bytes("3072").should eq(3072)
+    end
+
+    specify("kilobytes") do
+        Datasizes::to_bytes("3K").should eq(3 * 1024)
+    end
+    
+    specify("megabytes") do
+        Datasizes::to_bytes("3M").should eq(3 * (1024 ** 2))
+    end
+    
+    specify("gigabytes") do
+        Datasizes::to_bytes("3G").should eq(3 * (1024 ** 3))
+    end
+    
+    specify("terabytes") do
+        Datasizes::to_bytes("3T").should eq(3 * (1024 ** 4))    
+    end
+
+    specify("invalid") do
+        expect { Datasizes::to_bytes("abcd") }.to raise_error(Datasizes::InvalidSpecification)
+    end
+end
+
+describe "#to_magnitude" do
+    specify("bytes") do
+        Datasizes::to_magnitude(3072).should eq('3072')
+    end
+
+    specify("kilobytes") do
+        Datasizes::to_magnitude(3072, :K).should eq('3K')
+    end
+    
+    specify("megabytes") do
+        Datasizes::to_magnitude(3 * (1024 ** 2), :M).should eq('3M')
+    end
+    
+    specify("gigabytes") do
+        Datasizes::to_magnitude(3 * (1024 ** 3), :G).should eq('3G')
+    end
+    
+    specify("terabytes") do
+        Datasizes::to_magnitude(3 * (1024 ** 4), :T).should eq('3T')
+    end
+    
+    specify("invalid") do
+        expect { Datasizes::to_magnitude(3 * (1024 ** 4), :a) }.to raise_error(Datasizes::InvalidMagnitude)
+    end
+end
+
+describe "#from_bytes" do
+    specify("pass to magnitude") do
+        Datasizes::from_bytes(30 * (1024 ** 3)).should eq('30G')
+    end
+    
+    specify("pass to bytes") do
+        Datasizes::from_bytes(30 * (1024 ** 3) + 1).should eq('32212254721')
+    end
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: datasizes
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Martin Kozák
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: martinkozak@martinkozak.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- ".document"
+- ".travis.yml"
+- CHANGES.txt
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- datasizes.gemspec
+- lib/datasizes.rb
+- lib/datasizes/exceptions.rb
+- tests.rb
+homepage: http://github.com/martinkozak/datasizes
+licenses:
+- MIT
+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: 4130729054067846878
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.29
+signing_key: 
+specification_version: 3
+summary: Provides simple API for converting 'dd' like data amount postfixes (like
+  3M or 4G) to bytes and bytes to these strings.
+test_files: []