trusted-number 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d654dde743a279a169c51a99e165c81e6b752fba76e0a7e809cb70d6ded6a9f4
+  data.tar.gz: 816e752739bc7c0752bc2c58059e6406c6cc4fb960049dc13735fb93116bdddb
+SHA512:
+  metadata.gz: d75a97abd836092f32de8848ab222fdcb3047e44d9d84de6547d809e1ad0073534a2a1056efbe8ed6f410ad30503c6e55f97fd799f3eebf53c92339d5513d2a7
+  data.tar.gz: 5910305e64fc6de7ef1ac80ff6fee7fb6a386b0183b1cc1d5706c8133b37e641922e07602818adba9e7a612d64342b11a4793d43108344fd7e1082cf6927e4a7

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-03-25
+
+- Initial release

data/README.md

@@ -0,0 +1,26 @@
+# trusted-number
+
+A trusted number is a number whose value will not change secretly.
+
+## Installation
+
+```bash
+gem install trusted-number
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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 the created tag, 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/dvarrui/trusted-number.
+
+---
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/trusted/number`. To experiment with that code, run `bin/console` for an interactive prompt.

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "standard/rake"
+
+task default: %i[test standard]

data/examples/demo.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+require_relative "../lib/trusted-number"
+
+# ------------
+puts "\n" + "=" * 10
+puts "Base 2:"
+
+bin1 = TrustedNumber.new("1.1", base: 2) # (1.5 decimal)
+bin2 = TrustedNumber.new("1.1", base: 2) # (1.5 decimal)
+
+res = bin1 + bin2
+puts res
+puts "Value: #{res.value}" # => "11" (3.0 en decimal)
+
+# ------------
+puts "\n" + "=" * 10
+puts "Base 10"
+dec1 = TrustedNumber.new("0.1")
+dec2 = TrustedNumber.new("0.2")
+
+res = dec1 + dec2
+puts res
+puts "Value: #{res.value}"

data/lib/trusted-number/add.rb

@@ -0,0 +1,34 @@
+class TrustedNumber
+  def +(other)
+    # 1. Alinear partes decimales (rellenar con 0 a la derecha)
+    max_post = [@postnumber.length, other.postnumber.length].max
+    p1 = @postnumber.ljust(max_post, "0")
+    p2 = other.postnumber.ljust(max_post, "0")
+
+    # 2. Sumar postnumbers
+    res_post, carry = add_strings(p1, p2, @base)
+
+    # 3. Sumar prenumbers + acarreo anterior
+    res_pre, final_carry = add_strings(@prenumber, other.prenumber, @base, carry)
+    res_pre = DIGITS[final_carry] + res_pre if final_carry > 0
+
+    build_result(res_pre, res_post)
+  end
+
+  private
+
+  def add_strings(s1, s2, base, carry = 0)
+    res = []
+    i, j = s1.length - 1, s2.length - 1
+    while i >= 0 || j >= 0
+      v1 = (i >= 0) ? DIGITS.index(s1[i]) : 0
+      v2 = (j >= 0) ? DIGITS.index(s2[j]) : 0
+      sum = v1 + v2 + carry
+      res << DIGITS[sum % base]
+      carry = sum / base
+      i -= 1
+      j -= 1
+    end
+    [res.reverse.join, carry]
+  end
+end

data/lib/trusted-number/equal.rb

@@ -0,0 +1,9 @@
+class TrustedNumber
+  def ==(other)
+    cond = (@base == other.base)
+    cond &&= (@prenumber = other.prenumber)
+    cond &&= (@postnumber = other.postnumber)
+
+    cond
+  end
+end

data/lib/trusted-number/mul.rb

@@ -0,0 +1,42 @@
+class TrustedNumber
+  def *(other)
+    # Algoritmo: Multiplicar como si no hubiera puntos, luego posicionar punto
+    s1 = @prenumber + @postnumber
+    s2 = other.prenumber + other.postnumber
+
+    # Multiplicación de strings (suma de productos parciales)
+    res_int = multiply_strings(s1, s2, @base)
+
+    # Posicionar el punto decimal
+    total_decimals = @postnumber.length + other.postnumber.length
+
+    if total_decimals > 0
+      # Asegurar que el string sea lo bastante largo
+      res_int = res_int.rjust(total_decimals + 1, "0")
+      new_pre = res_int[0...-total_decimals]
+      # new_post = res_int[-total_decimals..-1]
+      new_post = res_int[-total_decimals..]
+    else
+      new_pre, new_post = res_int, ""
+    end
+
+    build_result(new_pre, new_post)
+  end
+
+  private
+
+  def multiply_strings(s1, s2, base)
+    # Multiplicación básica (Long Multiplication) carácter a carácter
+    product = Array.new(s1.length + s2.length, 0)
+
+    (s1.length - 1).downto(0) do |i|
+      (s2.length - 1).downto(0) do |j|
+        mul = DIGITS.index(s1[i]) * DIGITS.index(s2[j])
+        sum = mul + product[i + j + 1]
+        product[i + j + 1] = sum % base
+        product[i + j] += sum / base
+      end
+    end
+    product.map { |d| DIGITS[d] }.join.gsub(/^0+(?=\d)/, "")
+  end
+end

data/lib/trusted-number/sub.rb

@@ -0,0 +1,37 @@
+class TrustedNumber
+  def -(other)
+    # 1. Alinear decimales
+    max_post = [@postnumber.length, other.postnumber.length].max
+    p1 = @postnumber.ljust(max_post, "0")
+    p2 = other.postnumber.ljust(max_post, "0")
+
+    # 2. Restar postnumbers (manejando el "pedir prestado" o borrow)
+    res_post, borrow = sub_strings(p1, p2, @base)
+
+    # 3. Restar prenumbers - borrow
+    res_pre, _ = sub_strings(@prenumber, other.prenumber, @base, borrow)
+
+    build_result(res_pre, res_post)
+  end
+
+  private
+
+  def sub_strings(s1, s2, base, borrow = 0)
+    res = ""
+    i, j = s1.length - 1, s2.length - 1
+    while i >= 0 || j >= 0
+      v1 = (i >= 0) ? DIGITS.index(s1[i]) : 0
+      v2 = ((j >= 0) ? DIGITS.index(s2[j]) : 0) + borrow
+      if v1 < v2
+        v1 += base
+        borrow = 1
+      else
+        borrow = 0
+      end
+      res << DIGITS[v1 - v2]
+      i -= 1
+      j -= 1
+    end
+    [res.reverse, borrow]
+  end
+end

data/lib/trusted-number/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class TrustedNumber
+  VERSION = "0.1.0"
+end

data/lib/trusted-number.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "trusted-number/version"
+require_relative "trusted-number/add"
+require_relative "trusted-number/equal"
+require_relative "trusted-number/sub"
+require_relative "trusted-number/mul"
+
+class TrustedNumber
+  attr_reader :base
+  attr_reader :prenumber, :postnumber
+
+  DIGITS = "0123456789abcdefghijklmnopqrstuvwxyz"
+
+  def initialize(number, base: 10)
+    @number = number
+    @base = base
+
+    num_str = @number.to_s.downcase.delete(" ")
+    pre, post = num_str.split(".")
+    @prenumber = pre || "0"
+    @postnumber = post || ""
+
+    validate_format!
+  end
+
+  def value
+    @postnumber.empty? ? @prenumber : "#{@prenumber}.#{@postnumber}"
+  end
+
+  def to_s
+    "TrustedNumber: #{value} (base: #{@base})"
+  end
+
+  private
+
+  def build_result(pre, post)
+    pre_clean = pre.gsub(/^0+(?=\d)/, "")
+    post_clean = post.gsub(/0+$/, "")
+    str = post_clean.empty? ? pre_clean : "#{pre_clean}.#{post_clean}"
+    TrustedNumber.new(str, base: @base)
+  end
+
+  def validate_format!
+    allowed = DIGITS[0...@base]
+    pattern = /\A[#{allowed}]*\z/
+    unless @prenumber.match?(pattern) && @postnumber.match?(pattern)
+      raise ArgumentError, "Caracteres inválidos para base #{@base}"
+    end
+  end
+end

data/sig/trusted-number.rbs

@@ -0,0 +1,5 @@
+class TrustedNumber
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: trusted-number
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- David Vargas
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A trusted number is a number whose value will not change secretly.
+email:
+- dvarrui@proton.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- Rakefile
+- examples/demo.rb
+- lib/trusted-number.rb
+- lib/trusted-number/add.rb
+- lib/trusted-number/equal.rb
+- lib/trusted-number/mul.rb
+- lib/trusted-number/sub.rb
+- lib/trusted-number/version.rb
+- sig/trusted-number.rbs
+homepage: https://github.com/dvarrui/trusted-number
+licenses: []
+metadata:
+  homepage_uri: https://github.com/dvarrui/trusted-number
+  source_code_uri: https://github.com/dvarrui/trusted-number
+  changelog_uri: https://github.com/dvarrui/trusted-number/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: A trusted number is a number whose value will not change secretly.
+test_files: []