destiny_matrix 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b7c69d031dd66416eaf2aaa7b13deb3c0b0f6ef79b987b89eb512cdfeaaff2b6
+  data.tar.gz: 0f481aa0f61ca7f866fcaec13c58eb0d6a17bbccb357d4c8a96976ce889bacbd
+SHA512:
+  metadata.gz: 702dcc3c8bec34d6fb0bde34bdd93c650c2a16a80e3e35da7e85a8e20ea2cddd368c13753307f94f33d0bb29b659adf77296bb50d75e25bed0ad74cb9a43791e
+  data.tar.gz: 52f09dbe8a04b33dd7c65dc150fc0c55bc0c9e31c4275fa9d135f2283fdb99edc1db0df9934fc140e24c35b6fcd53dd9167d0d22777ba177000320b5ac1c059d

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wsgtcyx
+
+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,35 @@
+# Destiny Matrix (Ruby)
+
+A small Ruby library to compute Destiny Matrix personal points and derived structures
+(`years`, `purposes`, `chart_heart`) from a birth date.
+
+## Install
+
+```bash
+gem install destiny_matrix
+```
+
+## Usage
+
+```ruby
+require 'destiny_matrix'
+
+result = DestinyMatrix::Calculator.calculate(day: 1, month: 1, year: 1990)
+
+result.points[:apoint]       # => 1
+result.purposes[:skypoint]   # => 22
+result.chart_heart[:sahphysics]
+result.years[:afpoint]
+```
+
+## API
+
+- `DestinyMatrix::Calculator.calculate(day:, month:, year:)` returns a `DestinyMatrix::Result`
+- `DestinyMatrix::Calculator.points(day:, month:, year:)` returns only the points hash
+- `DestinyMatrix::Calculator.reduce_number(number)` and `calculate_year(year)` are exposed for parity
+
+The computation logic mirrors the Destiny Matrix calculation used on the website.
+
+## License
+
+MIT

data/lib/destiny_matrix/calculator.rb

@@ -0,0 +1,308 @@
+# frozen_string_literal: true
+
+module DestinyMatrix
+  Result = Struct.new(:points, :purposes, :chart_heart, :years, keyword_init: true)
+
+  class Calculator
+    class << self
+      def calculate(day:, month:, year:)
+        day_value = coerce_integer(day, 'day')
+        month_value = coerce_integer(month, 'month')
+        year_value = coerce_integer(year, 'year')
+
+        validate_date_parts!(day_value, month_value, year_value)
+
+        apoint = reduce_number(day_value)
+        bpoint = month_value
+        cpoint = calculate_year(year_value)
+
+        calculate_from_points(apoint, bpoint, cpoint)
+      end
+
+      def points(day:, month:, year:)
+        calculate(day: day, month: month, year: year).points
+      end
+
+      def reduce_number(number)
+        num = number
+        if number > 22
+          num = (number % 10) + (number / 10).floor
+        end
+        num
+      end
+
+      def calculate_year(year)
+        y = 0
+        value = year
+        while value > 0
+          y += value % 10
+          value /= 10
+        end
+        reduce_number(y)
+      end
+
+      private
+
+      def coerce_integer(value, label)
+        Integer(value)
+      rescue ArgumentError, TypeError
+        raise ArgumentError, "#{label} must be an integer"
+      end
+
+      def validate_date_parts!(day, month, year)
+        unless day >= 1 && day <= 31
+          raise ArgumentError, 'day must be between 1 and 31'
+        end
+        unless month >= 1 && month <= 12
+          raise ArgumentError, 'month must be between 1 and 12'
+        end
+        unless year >= 0
+          raise ArgumentError, 'year must be greater than or equal to 0'
+        end
+      end
+
+      def calculate_from_points(a_point, b_point, c_point)
+        dpoint = reduce_number(a_point + b_point + c_point)
+        epoint = reduce_number(a_point + b_point + c_point + dpoint)
+        fpoint = reduce_number(a_point + b_point)
+        gpoint = reduce_number(b_point + c_point)
+        hpoint = reduce_number(dpoint + a_point)
+        ipoint = reduce_number(c_point + dpoint)
+        jpoint = reduce_number(dpoint + epoint)
+
+        npoint = reduce_number(c_point + epoint)
+        lpoint = reduce_number(jpoint + npoint)
+        mpoint = reduce_number(lpoint + npoint)
+        kpoint = reduce_number(jpoint + lpoint)
+
+        qpoint = reduce_number(npoint + c_point)
+        rpoint = reduce_number(jpoint + dpoint)
+        spoint = reduce_number(a_point + epoint)
+        tpoint = reduce_number(b_point + epoint)
+
+        opoint = reduce_number(a_point + spoint)
+        ppoint = reduce_number(b_point + tpoint)
+
+        upoint = reduce_number(fpoint + gpoint + hpoint + ipoint)
+        vpoint = reduce_number(epoint + upoint)
+        wpoint = reduce_number(spoint + epoint)
+        xpoint = reduce_number(tpoint + epoint)
+
+        f2point = reduce_number(fpoint + upoint)
+        f1point = reduce_number(fpoint + f2point)
+        g2point = reduce_number(gpoint + upoint)
+        g1point = reduce_number(gpoint + g2point)
+        i2point = reduce_number(ipoint + upoint)
+        i1point = reduce_number(ipoint + i2point)
+        h2point = reduce_number(hpoint + upoint)
+        h1point = reduce_number(hpoint + h2point)
+
+        afpoint = reduce_number(a_point + fpoint)
+        af1point = reduce_number(a_point + afpoint)
+        af2point = reduce_number(a_point + af1point)
+        af3point = reduce_number(afpoint + af1point)
+        af4point = reduce_number(afpoint + fpoint)
+        af5point = reduce_number(afpoint + af4point)
+        af6point = reduce_number(af4point + fpoint)
+
+        fbpoint = reduce_number(fpoint + b_point)
+        fb1point = reduce_number(fpoint + fbpoint)
+        fb2point = reduce_number(fpoint + fb1point)
+        fb3point = reduce_number(fbpoint + fb1point)
+        fb4point = reduce_number(fbpoint + b_point)
+        fb5point = reduce_number(fbpoint + fb4point)
+        fb6point = reduce_number(fb4point + b_point)
+
+        bgpoint = reduce_number(b_point + gpoint)
+        bg1point = reduce_number(b_point + bgpoint)
+        bg2point = reduce_number(b_point + bg1point)
+        bg3point = reduce_number(bgpoint + bg1point)
+        bg4point = reduce_number(bgpoint + gpoint)
+        bg5point = reduce_number(bgpoint + bg4point)
+        bg6point = reduce_number(bg4point + gpoint)
+
+        gcpoint = reduce_number(gpoint + c_point)
+        gc1point = reduce_number(gpoint + gcpoint)
+        gc2point = reduce_number(gpoint + gc1point)
+        gc3point = reduce_number(gcpoint + gc1point)
+        gc4point = reduce_number(gcpoint + c_point)
+        gc5point = reduce_number(gcpoint + gc4point)
+        gc6point = reduce_number(gc4point + c_point)
+
+        cipoint = reduce_number(c_point + ipoint)
+        ci1point = reduce_number(c_point + cipoint)
+        ci2point = reduce_number(c_point + ci1point)
+        ci3point = reduce_number(cipoint + ci1point)
+        ci4point = reduce_number(cipoint + ipoint)
+        ci5point = reduce_number(cipoint + ci4point)
+        ci6point = reduce_number(ci4point + ipoint)
+
+        idpoint = reduce_number(ipoint + dpoint)
+        id1point = reduce_number(ipoint + idpoint)
+        id2point = reduce_number(ipoint + id1point)
+        id3point = reduce_number(idpoint + id1point)
+        id4point = reduce_number(idpoint + dpoint)
+        id5point = reduce_number(idpoint + id4point)
+        id6point = reduce_number(id4point + dpoint)
+
+        dhpoint = reduce_number(dpoint + hpoint)
+        dh1point = reduce_number(dpoint + dhpoint)
+        dh2point = reduce_number(dpoint + dh1point)
+        dh3point = reduce_number(dhpoint + dh1point)
+        dh4point = reduce_number(dhpoint + hpoint)
+        dh5point = reduce_number(dhpoint + dh4point)
+        dh6point = reduce_number(dh4point + hpoint)
+
+        hapoint = reduce_number(hpoint + a_point)
+        ha1point = reduce_number(hpoint + hapoint)
+        ha2point = reduce_number(hpoint + ha1point)
+        ha3point = reduce_number(hapoint + ha1point)
+        ha4point = reduce_number(hapoint + a_point)
+        ha5point = reduce_number(hapoint + ha4point)
+        ha6point = reduce_number(ha4point + a_point)
+
+        skypoint = reduce_number(b_point + dpoint)
+        earthpoint = reduce_number(a_point + c_point)
+        perspurpose = reduce_number(skypoint + earthpoint)
+        femalepoint = reduce_number(gpoint + hpoint)
+        malepoint = reduce_number(fpoint + ipoint)
+        socialpurpose = reduce_number(femalepoint + malepoint)
+        generalpurpose = reduce_number(perspurpose + socialpurpose)
+        planetarypurpose = reduce_number(socialpurpose + generalpurpose)
+
+        points = {
+          apoint: a_point,
+          bpoint: b_point,
+          cpoint: c_point,
+          dpoint: dpoint,
+          epoint: epoint,
+          fpoint: fpoint,
+          gpoint: gpoint,
+          hpoint: hpoint,
+          ipoint: ipoint,
+          jpoint: jpoint,
+          kpoint: kpoint,
+          lpoint: lpoint,
+          mpoint: mpoint,
+          npoint: npoint,
+          opoint: opoint,
+          ppoint: ppoint,
+          qpoint: qpoint,
+          rpoint: rpoint,
+          spoint: spoint,
+          tpoint: tpoint,
+          upoint: upoint,
+          vpoint: vpoint,
+          wpoint: wpoint,
+          xpoint: xpoint,
+          f2point: f2point,
+          f1point: f1point,
+          g2point: g2point,
+          g1point: g1point,
+          i2point: i2point,
+          i1point: i1point,
+          h2point: h2point,
+          h1point: h1point
+        }
+
+        purposes = {
+          skypoint: skypoint,
+          earthpoint: earthpoint,
+          perspurpose: perspurpose,
+          femalepoint: femalepoint,
+          malepoint: malepoint,
+          socialpurpose: socialpurpose,
+          generalpurpose: generalpurpose,
+          planetarypurpose: planetarypurpose
+        }
+
+        chart_heart = {
+          sahphysics: a_point,
+          ajphysics: opoint,
+          vishphysics: spoint,
+          anahphysics: wpoint,
+          manphysics: epoint,
+          svadphysics: jpoint,
+          mulphysics: c_point,
+
+          sahenergy: b_point,
+          ajenergy: ppoint,
+          vishenergy: tpoint,
+          anahenergy: xpoint,
+          manenergy: epoint,
+          svadenergy: npoint,
+          mulenergy: dpoint,
+
+          sahemotions: reduce_number(a_point + b_point),
+          ajemotions: reduce_number(opoint + ppoint),
+          vishemotions: reduce_number(spoint + tpoint),
+          anahemotions: reduce_number(wpoint + xpoint),
+          manemotions: reduce_number(epoint + epoint),
+          svademotions: reduce_number(jpoint + npoint),
+          mulemotions: reduce_number(c_point + dpoint)
+        }
+
+        years = {
+          afpoint: afpoint,
+          af1point: af1point,
+          af2point: af2point,
+          af3point: af3point,
+          af4point: af4point,
+          af5point: af5point,
+          af6point: af6point,
+          fbpoint: fbpoint,
+          fb1point: fb1point,
+          fb2point: fb2point,
+          fb3point: fb3point,
+          fb4point: fb4point,
+          fb5point: fb5point,
+          fb6point: fb6point,
+          bgpoint: bgpoint,
+          bg1point: bg1point,
+          bg2point: bg2point,
+          bg3point: bg3point,
+          bg4point: bg4point,
+          bg5point: bg5point,
+          bg6point: bg6point,
+          gcpoint: gcpoint,
+          gc1point: gc1point,
+          gc2point: gc2point,
+          gc3point: gc3point,
+          gc4point: gc4point,
+          gc5point: gc5point,
+          gc6point: gc6point,
+          cipoint: cipoint,
+          ci1point: ci1point,
+          ci2point: ci2point,
+          ci3point: ci3point,
+          ci4point: ci4point,
+          ci5point: ci5point,
+          ci6point: ci6point,
+          idpoint: idpoint,
+          id1point: id1point,
+          id2point: id2point,
+          id3point: id3point,
+          id4point: id4point,
+          id5point: id5point,
+          id6point: id6point,
+          dhpoint: dhpoint,
+          dh1point: dh1point,
+          dh2point: dh2point,
+          dh3point: dh3point,
+          dh4point: dh4point,
+          dh5point: dh5point,
+          dh6point: dh6point,
+          hapoint: hapoint,
+          ha1point: ha1point,
+          ha2point: ha2point,
+          ha3point: ha3point,
+          ha4point: ha4point,
+          ha5point: ha5point,
+          ha6point: ha6point
+        }
+
+        Result.new(points: points, purposes: purposes, chart_heart: chart_heart, years: years)
+      end
+    end
+  end
+end

data/lib/destiny_matrix/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module DestinyMatrix
+  VERSION = '0.1.0'
+end

data/lib/destiny_matrix.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative 'destiny_matrix/version'
+require_relative 'destiny_matrix/calculator'
+
+module DestinyMatrix
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: destiny_matrix
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- wsgtcyx
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-02-05 00:00:00.000000000 Z
+dependencies: []
+description: Compute Destiny Matrix personal points and derived structures (years,
+  purposes, chart heart).
+email:
+- 439248005@qq.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/destiny_matrix.rb
+- lib/destiny_matrix/calculator.rb
+- lib/destiny_matrix/version.rb
+homepage: https://destiny-matrix.cc/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://destiny-matrix.cc/
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Destiny Matrix personal calculation utilities.
+test_files: []