vishnu-standard-time 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 59b1b839f360e681af0cf1048575aca912a8590339723b3932dc63f9b2daa648
+  data.tar.gz: 177ad7aa34b141327d871b4e5ef5547375716c245e719af0ca0db1de56b91c57
+SHA512:
+  metadata.gz: a86aad8123fc755334d07e62442108fc6051a284b087c1e00492e10430c1f6459fdf8ad2fd8cc026b4b220f78a4fb188abcc43306f42d2ed58b38ea8d8eb59c6
+  data.tar.gz: dde90f5af4d50f7aa97030d15c88902bcd82c11842f962559074b0bba1eda2e5aa4f11f7bf4041cf15c197b44dec5c8df31249b40bae730675c8778bc11f303d

data/README.md

@@ -0,0 +1,14 @@
+# vishnu-standard-time
+
+Ruby gem for **Vishnu Standard Time (VST)**.
+
+```bash
+gem install vishnu-standard-time
+```
+
+```ruby
+require "vishnu/standard_time"
+
+parts = Vishnu::StandardTime.now
+puts Vishnu::StandardTime.format_vst(parts)
+```

data/lib/vishnu/standard_time.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+module Vishnu
+  module StandardTime
+    VST_SPEC_VERSION = "0.1.0"
+    VST_EPOCH_UNIX_MS = 1_767_225_600_000
+    MS_PER_DAY = 86_400_000
+    FLOWS_PER_SECOND = 3
+    FLOWS_PER_MINUTE = 180
+    FLOWS_PER_DAY = 259_200
+    FLOW_LENGTH_MS_TEXT = "333⅓"
+    VICKS_PER_DAY = 100_000
+    MS_PER_VICK = 864
+
+    Parts = Struct.new(
+      :day,
+      :day_ms,
+      :flow,
+      :flow_of_minute,
+      :second_of_day,
+      :percent_of_day,
+      :vick,
+      :pulse,
+      :unix_ms,
+      :source,
+      keyword_init: true
+    )
+
+    module_function
+
+    def from_unix_ms(unix_ms)
+      ms = Integer(unix_ms)
+      day, day_ms = (ms - VST_EPOCH_UNIX_MS).divmod(MS_PER_DAY)
+      parts_from_day_ms(day, day_ms, unix_ms: ms, source: "standard")
+    end
+
+    def from_day_ms(day, day_ms)
+      parts_from_day_ms(Integer(day), Integer(day_ms))
+    end
+
+    def parts_from_day_ms(day, day_ms, unix_ms: nil, source: "standard")
+      raise ArgumentError, "day_ms must be from 0 through 86399999" if day_ms.negative? || day_ms >= MS_PER_DAY
+
+      flow = (day_ms * FLOWS_PER_DAY) / MS_PER_DAY
+      Parts.new(
+        day: day,
+        day_ms: day_ms,
+        flow: flow,
+        flow_of_minute: flow % FLOWS_PER_MINUTE,
+        second_of_day: day_ms / 1000,
+        percent_of_day: (day_ms.to_f / MS_PER_DAY) * 100,
+        vick: day_ms / MS_PER_VICK,
+        pulse: day_ms % MS_PER_VICK,
+        unix_ms: unix_ms,
+        source: source
+      )
+    end
+
+    def now
+      from_unix_ms((Time.now.to_f * 1000).floor)
+    end
+
+    def local_now(time = Time.now)
+      day_ms = ((time.hour * 60 + time.min) * 60 + time.sec) * 1000 + (time.usec / 1000)
+      local_midnight_as_utc = Time.utc(time.year, time.month, time.day)
+      epoch = Time.at(VST_EPOCH_UNIX_MS / 1000, in: "+00:00")
+      day = ((local_midnight_as_utc - epoch) / 86_400).floor
+      parts_from_day_ms(day, day_ms, unix_ms: (time.to_f * 1000).floor, source: "local")
+    end
+
+    def to_unix_ms(parts)
+      VST_EPOCH_UNIX_MS + parts.day * MS_PER_DAY + parts.day_ms
+    end
+
+    def format_vst_day(parts)
+      sign = parts.day.negative? ? "-" : "+"
+      "D#{sign}#{parts.day.abs.to_s.rjust(6, "0")}" 
+    end
+
+    def comma6(value)
+      s = value.to_i.to_s.rjust(6, "0")
+      "#{s[0, 3]},#{s[3, 3]}"
+    end
+
+    def format_flow_count(parts)
+      "#{comma6(parts.flow)} / 259,200 flows"
+    end
+
+    def format_flow_of_minute(parts)
+      "FLOW #{parts.flow_of_minute.to_s.rjust(3, "0")} / 179"
+    end
+
+    def format_percent_of_day(parts, digits = 2)
+      "%0#{digits + 3}.#{digits}f%% OF DAY" % parts.percent_of_day
+    end
+
+    def format_vst(parts)
+      "VST #{format_vst_day(parts)} · #{format_flow_count(parts)} · #{format_percent_of_day(parts)}"
+    end
+
+    def format_vst_precise(parts)
+      "VST #{format_vst_day(parts)} · #{format_flow_of_minute(parts)} · #{format_flow_count(parts)} · #{format_percent_of_day(parts)}"
+    end
+
+    def to_h(parts)
+      {
+        scale: "VST",
+        version: VST_SPEC_VERSION,
+        day: parts.day.to_s,
+        flow: parts.flow,
+        flow_of_minute: parts.flow_of_minute,
+        flows_per_day: FLOWS_PER_DAY,
+        percent_of_day: parts.percent_of_day.round(6),
+        text: format_vst(parts),
+        day_ms: parts.day_ms.to_s,
+        vick: parts.vick,
+        pulse: parts.pulse
+      }
+    end
+  end
+end

data/vishnu-standard-time.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |spec|
+  spec.name = "vishnu-standard-time"
+  spec.version = "0.1.0"
+  spec.summary = "Vishnu Standard Time (VST): 259,200 flows per day, no AM/PM."
+  spec.authors = ["Vishnu"]
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0"
+  spec.files = Dir["lib/**/*.rb", "README.md", "LICENSE*", "*.gemspec"]
+  spec.require_paths = ["lib"]
+  spec.homepage = "https://time.vishnu.store"
+  spec.metadata = {
+    "source_code_uri" => "https://time.vishnu.store",
+    "changelog_uri" => "https://time.vishnu.store/.well-known/vst.json"
+  }
+  spec.add_development_dependency "minitest", "~> 5.25"
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: vishnu-standard-time
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vishnu
+bindir: bin
+cert_chain: []
+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: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/vishnu/standard_time.rb
+- vishnu-standard-time.gemspec
+homepage: https://time.vishnu.store
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://time.vishnu.store
+  changelog_uri: https://time.vishnu.store/.well-known/vst.json
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Vishnu Standard Time (VST): 259,200 flows per day, no AM/PM.'
+test_files: []