marsdate 1.1.3 → 2.0.0

data/test/timescale_test.rb

@@ -0,0 +1,124 @@
+#!/usr/bin/env ruby
+# Tests for MarsDateTime::TimeScale (NASA/Allison / Mars24).
+# Run: ruby test/timescale_test.rb
+
+require 'minitest/autorun'
+require_relative '../lib/marsdate/timescale'
+require 'date'
+
+class TimeScaleTest < Minitest::Test
+  TS = MarsDateTime::TimeScale
+
+  def test_tai_utc_table
+    assert_in_delta 10.0, TS.tai_utc(Date.new(1972, 1, 1)), 1e-9
+    assert_in_delta 32.0, TS.tai_utc(Date.new(1999, 6, 1)), 1e-9
+    assert_in_delta 32.0, TS.tai_utc(Date.new(2000, 1, 6)), 1e-9
+    assert_in_delta 37.0, TS.tai_utc(Date.new(2017, 1, 1)), 1e-9
+    assert_in_delta 37.0, TS.tai_utc(Date.new(2026, 8, 13)), 1e-9
+    assert_in_delta 64.184, TS.tt_utc(Date.new(2000, 1, 6)), 1e-9
+    assert_in_delta 69.184, TS.tt_utc(Date.new(2017, 1, 1)), 1e-9
+  end
+
+  def test_mars24_2000_jan_6
+    # Mars24 worked example: 2000-01-06 00:00:00 UTC → MST 23:59:39
+    dt = DateTime.new(2000, 1, 6, 0, 0, 0)
+    assert_in_delta 2_451_549.5, TS.jd_ut(dt), 1e-9
+    assert_in_delta 2_451_549.500742407, TS.jd_tt(dt), 2e-6
+    h, m, s = TS.mtc_hms(dt)
+    hours = hms_to_hours(h, m, s)
+    assert_in_delta hms_to_hours(23, 59, 39), hours, 1.5 / 3600.0
+    assert_equal 23, h
+    assert_equal 59, m
+  end
+
+  def test_offset_independent
+    utc = DateTime.new(2000, 1, 1, 12, 0, 0)
+    est = utc.new_offset(Rational(-5, 24))
+    assert_in_delta TS.msd(utc), TS.msd(est), 1e-12
+    assert_in_delta TS.mtc_hours(utc), TS.mtc_hours(est), 1e-12
+  end
+
+  def test_wikipedia_2026_aug_12
+    # Wikipedia Timekeeping_on_Mars snapshot: 12 Aug 2026 00:25:08 UTC
+    # JDTT = 2461264.51825, MSD = 54251.08514, MTC = 02:02:36
+    dt = DateTime.new(2026, 8, 12, 0, 25, 8)
+    assert_in_delta 2_461_264.51825, TS.jd_tt(dt), 5e-5
+    assert_in_delta 54_251.08514, TS.msd(dt), 5e-5
+    h, m, s = TS.mtc_hms(dt)
+    assert_in_delta hms_to_hours(2, 2, 36), hms_to_hours(h, m, s), 2.0 / 3600.0
+  end
+
+  def test_mxt_vs_mtc
+    dt = DateTime.new(2000, 1, 6, 0, 0, 0)
+    frac = TS.sol_fraction(dt)
+    assert_operator frac, :>=, 0
+    assert_operator frac, :<, 1
+    si = TS.mxt_si_seconds(dt)
+    assert_in_delta frac * TS::SOL_SI_SECONDS, si, 1e-6
+    mtc_h = TS.mtc_hours(dt)
+    mxt_h = si / 3600.0
+    assert_in_delta mtc_h * TS::SOL_DAYS, mxt_h, 1e-6
+    assert_includes 88_775.0..88_776.0, TS::SOL_SI_SECONDS
+  end
+
+  def test_mtc_rounding_stays_below_24_hours
+    h, m, s = TS.hours_to_hms(24.0.prev_float, limit: 24)
+
+    assert_equal [23, 59], [h, m]
+    assert_operator s, :<, 60
+  end
+
+  def test_ls_j2000_region
+    dt = DateTime.new(2000, 1, 6, 0, 0, 0)
+    ls = TS.ls_deg(TS.jd_tt(dt))
+    assert_in_delta 277.19, ls, 0.05
+  end
+
+  def test_earth_from_msd_round_trip
+    dt = DateTime.new(2000, 1, 6, 0, 0, 0)
+    back = TS.earth_from_msd(TS.msd(dt))
+    assert_in_delta 0, (back - dt).to_f, 1e-9
+
+    dt = DateTime.new(2026, 8, 13, 0, 6, 56)
+    back = TS.earth_from_msd(TS.msd(dt))
+    assert_in_delta 0, (back - dt).to_f, 1e-8
+  end
+
+  def test_year1_caption_treats_tt_as_ut
+    r = TS.epoch_report
+    assert_match(/no year-1/, r[:caveat])
+    assert_equal(-665773, r[:epoch_msd])
+    cap = r[:epoch_earth_if_tt_were_ut]
+    assert_equal 1, cap.year
+    assert_equal 1, cap.month
+    assert_equal 23, cap.day
+    assert_equal 13, cap.hour
+    assert_equal 40, cap.min
+    eq = r[:ls0_earth_if_tt_were_ut]
+    assert_equal 1, eq.year
+    assert_equal 1, eq.month
+    assert_equal 24, eq.day
+    assert_equal 5, eq.hour
+    assert_equal 53, eq.min
+  end
+
+  def test_year1_equinox_sol
+    hint = DateTime.new(1, 1, 22, 12, 0, 0)
+    eq = TS.vernal_equinox_jd_tt(hint.ajd.to_f)
+    ls = TS.ls_deg(eq)
+    dist = [ls, (ls - 360).abs].min
+    assert_operator dist, :<, 0.01, "year-1 Ls=0 search: Ls=#{ls} at JD_TT=#{eq}"
+    m = TS.msd(jd_tt: eq)
+    assert_operator m, :<, 0, "year-1 MSD should be before 1873 (got #{m})"
+    frac = m % 1.0
+    frac += 1 if frac < 0
+    assert_operator frac, :>=, 0
+    assert_operator frac, :<, 1
+  end
+
+  private
+
+  def hms_to_hours(h, m, s)
+    h + m / 60.0 + s / 3600.0
+  end
+end

metadata

@@ -1,39 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: marsdate
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Hal Fulton
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-27 00:00:00.000000000 Z
-dependencies: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.4'
 description: |2
                     This is a library for handling dates and times on Mars
                     for the Martian Common Era calendar (created by Hal Fulton).
                     The functionality closely follows that of Ruby's Time class.
 email: rubyhacker@gmail.com
-executables: []
+executables:
+- marsdate
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
 - bin/marsdate
-- bin/marsdate-version
-- bin/mcal.rb
-- bin/meh.html
-- bin/mkcal.rb
-- bin/mtcon.rb
-- bin/mtoday.rb
 - lib/marsdate.rb
-- test/spec/marsdate_spec.rb
+- lib/marsdate/calendar.rb
+- lib/marsdate/timescale.rb
+- lib/marsdate/version.rb
+- marsdate.gemspec
+- test/calendar_test.rb
+- test/cli_test.rb
 - test/test.rb
+- test/timescale_test.rb
 homepage: https://github.com/Hal9000/marsdate
 licenses:
-- Ruby
-metadata: {}
-post_install_message: 
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/Hal9000/marsdate/issues
+  changelog_uri: https://github.com/Hal9000/marsdate/blob/master/CHANGELOG.md
+  source_code_uri: https://github.com/Hal9000/marsdate
+post_install_message: "\n Success! Run executable 'marsdate' for help.\n "
 rdoc_options: []
 require_paths:
 - lib
@@ -41,16 +75,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Date/time library for Mars
 test_files: []

data/bin/marsdate-version

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-
-require './lib/marsdate'
-puts MarsDateTime::VERSION
-

data/bin/mcal.rb

@@ -1,50 +0,0 @@
-require 'marsdate'
-
-def put_week(week)
-  week.each {|x| printf("%3s ",x.to_s) }
-  puts
-end
-
-mon, yr = ARGV 
-# p [mon, yr]
-now = MarsDateTime.now
-mon ||= now.month
-yr ||= now.year
-# p [mon, yr]
-mon = mon.to_i
-yr  = yr.to_i
-# p [mon, yr]
-
-ftm = MarsDateTime.new(yr, mon, 1)
-
-header = %w[Sun Mon Tue Wed Thu Fri Sat]
-
-week1 = Array.new(7)
-sol = 0
-ftm.dow.upto(6) do |d|
-  week1[d] = (sol += 1)
-end
-
-solN = MarsDateTime.sols_in_month(mon, yr)
-remaining = ((sol += 1)..solN).to_a
-
-weeks = []
-weeks << header << week1
-
-loop do
-  week = []
-  7.times { week << remaining.shift }
-  weeks << week
-  break if remaining.empty?
-end
-
-label = ftm.month_name + " " + ftm.year.to_s
-spacing = " "*((27 - label.length)/2)
-
-puts
-puts spacing + label
-puts
-
-weeks.each {|week| put_week(week) }
-
-puts