latinum 1.5.0 → 1.6.0

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:test)
-
-task :default => :test

data/latinum.gemspec

@@ -1,22 +0,0 @@
-
-require_relative "lib/latinum/version"
-
-Gem::Specification.new do |spec|
-	spec.name          = "latinum"
-	spec.version       = Latinum::VERSION
-	spec.authors       = ["Samuel Williams"]
-	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
-	spec.summary       = %q{Latinum is a simple gem for managing resource computations, including money and minerals.}
-	spec.homepage      = "https://github.com/ioquatix/latinum"
-	spec.license       = "MIT"
-	
-	spec.files         = `git ls-files`.split($/)
-	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-	spec.require_paths = ["lib"]
-	
-	spec.add_development_dependency "covered"
-	spec.add_development_dependency "bundler"
-	spec.add_development_dependency "rspec", "~> 3.4"
-	spec.add_development_dependency "rake"
-end

data/spec/latinum/bank_spec.rb

@@ -1,92 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# 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.
-
-require 'latinum'
-require 'latinum/currencies/global'
-
-RSpec.describe Latinum::Bank do
-	before(:all) do
-		@bank = Latinum::Bank.new(Latinum::Currencies::Global)
-		
-		@bank << Latinum::ExchangeRate.new("NZD", "AUD", "0.5")
-	end
-	
-	it "should format the amounts correctly" do
-		resource = Latinum::Resource.new("10", "NZD")
-		
-		expect(@bank.format(resource)).to be == "$10.00 NZD"
-		expect(@bank.format(resource, name: nil)).to be == "$10.00"
-		
-		resource = Latinum::Resource.new("391", "AUD")
-		expect(@bank.format(resource)).to be == "$391.00 AUD"
-		
-		resource = Latinum::Resource.new("-100", "NZD")
-		expect(@bank.format(resource)).to be == "-$100.00 NZD"
-		
-		resource = Latinum::Resource.new("1.12345678", "BTC")
-		expect(@bank.format(resource)).to be == "B⃦1.12345678 BTC"
-	end
-	
-	it "should round up using correct precision" do
-		resource = Latinum::Resource.new("19.9989", "NZD")
-		
-		expect(@bank.round(resource)).to be == Latinum::Resource.new(20, "NZD")
-	end
-	
-	it "should round down using correct precision" do
-		resource = Latinum::Resource.new("19.991", "NZD")
-		
-		expect(@bank.round(resource)).to be == Latinum::Resource.new("19.99", "NZD")
-	end
-	
-	it "should round values when formatting" do
-		resource = Latinum::Resource.new("19.9989", "NZD")
-		
-		expect(@bank.format(resource)).to be == "$20.00 NZD"
-	end
-	
-	it "should exchange currencies from NZD to AUD" do
-		nzd = Latinum::Resource.new("10", "NZD")
-		
-		aud = @bank.exchange nzd, "AUD"
-		expect(aud).to be == Latinum::Resource.new("5", "AUD")
-	end
-	
-	it "should parse strings into resources" do
-		expect(@bank.parse("$5")).to be == Latinum::Resource.new("5", "USD")
-		expect(@bank.parse("$5 NZD")).to be == Latinum::Resource.new("5", "NZD")
-		expect(@bank.parse("€5")).to be == Latinum::Resource.new("5", "EUR")
-		
-		expect(@bank.parse("5 NZD")).to be == Latinum::Resource.new("5", "NZD")
-	
-		expect(@bank.parse("-$5")).to be == Latinum::Resource.new("-5", "USD")
-		expect(@bank.parse("-$5 NZD")).to be == Latinum::Resource.new("-5", "NZD")
-		expect(@bank.parse("-€5")).to be == Latinum::Resource.new("-5", "EUR")
-	
-		expect(@bank.parse("5", default_name: "EUR")).to be == Latinum::Resource.new("5", "EUR")
-		expect(@bank.parse("-5", default_name: "EUR")).to be == Latinum::Resource.new("-5", "EUR")
-	end
-	
-	it "should fail to parse unknown resource" do
-		expect{@bank.parse("B5")}.to raise_error(ArgumentError)
-	end
-end

data/spec/latinum/collection_spec.rb

@@ -1,142 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# 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.
-
-require 'latinum'
-require 'latinum/currencies/global'
-
-require 'set'
-
-RSpec.describe Latinum::Collection do
-	it "can set an initial value" do
-		subject["NZD"] = BigDecimal("20")
-		
-		expect(subject["NZD"]).to be == Latinum::Resource.load("20 NZD")
-	end
-	
-	it "can be negated" do
-		subject["NZD"] = BigDecimal("20")
-		
-		negated = -subject
-		
-		expect(negated["NZD"]).to be == BigDecimal("-20")
-	end
-	
-	it "should sum up currencies correctly" do
-		resource = Latinum::Resource.new("10", "NZD")
-		
-		subject << resource
-		expect(subject["NZD"]).to be == resource
-		
-		subject << resource
-		expect(subject["NZD"]).to be == (resource * 2)
-	end
-	
-	it "should sum up multiple currencies correctly" do
-		resources = [
-			Latinum::Resource.new("10", "NZD"),
-			Latinum::Resource.new("10", "AUD"),
-			Latinum::Resource.new("10", "USD"),
-			Latinum::Resource.new("10", "NZD"),
-			Latinum::Resource.new("10", "AUD"),
-			Latinum::Resource.new("10", "USD"),
-		]
-		
-		subject = Latinum::Collection.new
-		subject << resources
-		
-		expect(subject["NZD"]).to be == (resources[0] * 2)
-		expect(subject.names).to be == Set.new(["NZD", "AUD", "USD"])
-	end
-	
-	it "can add two collections together" do
-		other_resources = [
-			Latinum::Resource.new("10", "NZD"),
-			Latinum::Resource.new("10", "AUD"),
-			Latinum::Resource.new("10", "USD"),
-		]
-		
-		other_collection = Latinum::Collection.new
-		other_collection << other_resources
-		
-		resources = [
-			Latinum::Resource.new("10", "NZD"),
-			Latinum::Resource.new("10", "AUD"),
-			Latinum::Resource.new("10", "USD"),
-		]
-		
-		subject << resources
-		subject << other_collection
-		
-		expect(subject["NZD"]).to be == Latinum::Resource.load("20 NZD")
-		expect(subject["AUD"]).to be == Latinum::Resource.load("20 AUD")
-		expect(subject["USD"]).to be == Latinum::Resource.load("20 USD")
-	end
-	
-	it "can enumerate resources" do
-		resources = [
-			Latinum::Resource.new("10", "NZD"),
-			Latinum::Resource.new("10", "AUD"),
-			Latinum::Resource.new("10", "USD"),
-		]
-		
-		collection = Latinum::Collection.new
-		collection << resources
-		
-		expect(collection.each.to_a).to be == resources
-	end
-	
-	describe '#-@' do
-		it "can subtract itself" do
-			subject << Latinum::Resource.new("10.0", "NZD")
-			
-			result = (subject - subject).compact
-			
-			expect(result).to be_empty
-		end
-	end
-	
-	describe '#compact' do
-		it "can remove zero value resources" do
-			subject << Latinum::Resource.new("0.0", "NZD")
-			
-			expect(subject).to include "NZD"
-			expect(subject.compact).to_not include "NZD"
-		end
-		
-		it "doesn't remove non-zero value resources" do
-			subject << Latinum::Resource.new("1.0", "NZD")
-			
-			expect(subject).to include "NZD"
-			expect(subject.compact).to include "NZD"
-		end
-	end
-	
-	describe '#to_s' do
-		it "can geneate formatted output" do
-			subject << Latinum::Resource.new("5.0", "NZD")
-			subject << Latinum::Resource.new("10.0", "AUD")
-			subject << Latinum::Resource.new("20", "JPY")
-			
-			expect(subject.to_s).to be == "5.0 NZD; 10.0 AUD; 20.0 JPY"
-		end
-	end
-end

data/spec/latinum/formatters_spec.rb

@@ -1,95 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# 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.
-
-require 'latinum/bank'
-require 'latinum/currencies/global'
-require 'latinum/formatters'
-
-RSpec.describe Latinum::Formatters::PlainFormatter.new(name: "NZD") do
-	let(:amount) {BigDecimal(10)}
-	
-	it "can convert to integral" do
-		expect(subject.to_integral(amount)).to be == 10
-	end
-	
-	it "can convert from integral" do
-		expect(subject.from_integral(10)).to be == amount
-	end
-	
-	it "can do basic formatting" do
-		expect(subject.format(amount)).to be == "10.0 NZD"
-	end
-end
-
-RSpec.describe Latinum::Formatters::DecimalCurrencyFormatter do
-	before(:all) do
-		@bank = Latinum::Bank.new
-		@bank.import(Latinum::Currencies::Global)
-	end
-	
-	let(:resource) {Latinum::Resource.load("10 NZD")}
-	
-	it "should format output" do
-		expect(@bank.format(resource)).to be == "$10.00 NZD"
-	end
-	
-	it "should format output without name" do
-		expect(@bank.format(resource, name: nil)).to be == "$10.00"
-	end
-	
-	it "should format output with alternative name" do
-		expect(@bank.format(resource, name: "Foo")).to be == "$10.00 Foo"
-	end
-	
-	it "should format output" do
-		expect(@bank.format(resource)).to be == "$10.00 NZD"
-	end
-	
-	it "should format output without symbol" do
-		expect(@bank.format(resource, symbol: nil)).to be == "10.00 NZD"
-	end
-	
-	it "should format output with alternative symbol" do
-		expect(@bank.format(resource, symbol: "!!")).to be == "!!10.00 NZD"
-	end
-	
-	context "negative zero" do
-		let(:resource) {Latinum::Resource.new(BigDecimal("-0"), "NZD")}
-		
-		it "should format as (positve) zero" do
-			expect(@bank.format(resource)).to be == "$0.00 NZD"
-		end
-	end
-end
-
-RSpec.describe Latinum::Formatters::DecimalCurrencyFormatter do
-	before(:all) do
-		@bank = Latinum::Bank.new
-		@bank.import(Latinum::Currencies::Global)
-	end
-	
-	let(:resource) {Latinum::Resource.load("10 JPY")}
-	
-	it "should format without separator or fractional part" do
-		expect(@bank.format(resource)).to be == "¥10 JPY"
-	end
-end

data/spec/latinum/integrals_spec.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# 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.
-
-require 'latinum'
-require 'latinum/currencies/global'
-
-RSpec.describe Latinum::Bank do
-	before(:all) do
-		@bank = Latinum::Bank.new
-		@bank.import(Latinum::Currencies::Global)
-	end
-	
-	it "should convert to NZD integral value" do
-		resource = Latinum::Resource.new("10", "NZD")
-		
-		expect(@bank.to_integral(resource)).to be == 1000
-		
-		expect(@bank.from_integral(1000, "NZD")).to be == resource
-	end
-	
-	it "should convert to BTC integral value" do
-		resource = Latinum::Resource.new("1.12345678", "BTC")
-		
-		expect(@bank.to_integral(resource)).to be == 112345678
-		
-		expect(@bank.from_integral(112345678, "BTC")).to be == resource
-	end
-end

data/spec/latinum/resource_spec.rb

@@ -1,132 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# 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.
-
-require 'latinum/resource'
-
-RSpec.describe Latinum::Resource do
-	it "should load and dump resources" do
-		resource = Latinum::Resource.load("10 NZD")
-		string_representation = Latinum::Resource.dump(resource)
-		
-		loaded_resource = Latinum::Resource.load(string_representation)
-		
-		expect(loaded_resource).to be == loaded_resource
-	end
-	
-	it "should load and dump nil correctly" do
-		expect(Latinum::Resource.load(nil)).to be nil
-		expect(Latinum::Resource.dump(nil)).to be nil
-	end
-	
-	it "should handle empty strings correctly" do
-		expect(Latinum::Resource.load("")).to be nil
-	end
-	
-	it "should handle whitespace strings correctly" do
-		expect(Latinum::Resource.load(" ")).to be nil
-	end
-	
-	it "should load and dump resources correctly" do
-		resource = Latinum::Resource.new(10, 'NZD')
-		
-		expect(Latinum::Resource.load("10.0 NZD")).to be == resource
-		expect(Latinum::Resource.dump(resource)).to be == "10.0 NZD"
-	end
-	
-	it "should inspect nicely" do
-		resource = Latinum::Resource.load("10 NZD")
-		
-		expect(resource.inspect).to be == '#<Latinum::Resource "10.0 NZD">'
-	end
-	
-	it "should compute percentage difference" do
-		original_price = Latinum::Resource.load("10 NZD")
-		discount_price = Latinum::Resource.load("5 NZD")
-		
-		discount = (original_price - discount_price) / original_price
-		
-		expect(discount).to be == 0.5
-	end
-	
-	it "should not divide" do
-		original_price = Latinum::Resource.load("10 NZD")
-		discount_price = Latinum::Resource.load("5 USD")
-		
-		expect{original_price / discount_price}.to raise_exception(Latinum::DifferentResourceNameError)
-	end
-	
-	it "should compute quotient" do
-		original_price = Latinum::Resource.load("10 NZD")
-		
-		expect(original_price / 2.0).to be == Latinum::Resource.load("5 NZD")
-	end
-	
-	it "should add two resources of the same symbol" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("5 NZD")
-		c = Latinum::Resource.load("15 NZD")
-		
-		expect(a+b).to be == c
-	end
-	
-	it "should fail two resources of different symbol" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("5 USD")
-		
-		expect{a+b}.to raise_error(Latinum::DifferentResourceNameError)
-	end
-	
-	it "should be able to negate a value" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("-10 NZD")
-		
-		expect(-a).to be == b
-	end
-	
-	it "can be used as a hash key" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("0 NZD")
-		
-		hash = {a => true}
-		
-		expect(hash).to be_include a
-		expect(hash).to_not be_include b
-	end
-	
-	it "can be zero" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("0 NZD")
-		
-		expect(a).to_not be_zero
-		expect(b).to be_zero
-	end
-	
-	it "can be eql?" do
-		a = Latinum::Resource.load("10 NZD")
-		b = Latinum::Resource.load("0 NZD")
-		c = Latinum::Resource.load("0 NZD")
-		
-		expect(a).to be_eql a
-		expect(a).to_not be_eql b
-		expect(b).to be_eql c
-	end
-end