j-law-ruby 0.0.3-arm64-darwin-23

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c2ba61bed3130192d5b8df9f58dc7002729fecaaf9d536b2c4425578ded90f74
+  data.tar.gz: 1047e5e69952e609072899b6abfc26fb25ba94a2d2b3d9d8a9cb8eba1a427408
+SHA512:
+  metadata.gz: 5049ca6b3b91621c57fc8f260dfdc803f8fc957682db07eb2122572f20a94043789715ee878bf239346e36267ddb8d346532b27ffe4dbe43741f619ce8359de8
+  data.tar.gz: 337db412a37f7f7476ffc8671f446ba5f47406c3ed172eb65b95d3ce61ac8d597fa158ba8123a99a213afef82eecfc78333e44e87ebc2508b534a10d726b1d70

data/README.md

@@ -0,0 +1,109 @@
+# j_law_ruby
+
+日本法令計算の PoC を Ruby から試すためのバインディングです。
+
+内部では `j-law-c-ffi` の C ABI を `ffi` gem 経由で呼び出し、Rust コアの整数演算ロジックを Ruby から利用します。
+
+> [!WARNING]
+> **PoC / アルファ版に関する注意事項**
+>
+> - 本ライブラリは現在 **`v0.0.1` のアルファ版**です。API と配布形態は予告なく変更される場合があります。
+> - この binding が返す計算結果について、法的正確性、完全性、最新性、個別事案への適合性は保証しません。
+> - コードの一部には **AI 生成 / AI 補助**による実装が含まれ、人手による全面レビューは完了していません。
+> - 税務申告や契約実務の唯一の根拠として使用せず、一次資料と専門家で検証してください。
+> - 詳細は [プロジェクトステータスと免責](../../docs/project-status.md) を参照してください。
+
+## 対応機能
+
+- `JLawRuby::ConsumptionTax.calc_consumption_tax`
+- `JLawRuby::RealEstate.calc_brokerage_fee`
+- `JLawRuby::IncomeTax.calc_income_tax`
+- `JLawRuby::IncomeTax.calc_income_deductions`
+- `JLawRuby::IncomeTax.calc_income_tax_assessment`
+- `JLawRuby::StampTax.calc_stamp_tax`
+- `JLawRuby::WithholdingTax.calc_withholding_tax`
+
+## インストール
+
+CI と publish workflow で検証している Ruby の範囲は `3.1` から `4.0` です。
+RubyGems では `linux/x86_64` `linux/aarch64` `macos/x86_64` `macos/arm64` `windows/amd64`
+向けの build 済み platform gem を配布します。これらの環境では Rust toolchain は不要です。
+その他の環境では source gem にフォールバックし、`gem install` 時に Rust `1.94.0`
+toolchain を使って `j-law-c-ffi` をビルドします。
+
+```sh
+gem install j_law_ruby
+```
+
+source gem を明示的に使う場合は次を実行します。
+
+```sh
+gem install j_law_ruby --platform ruby
+```
+
+開発環境では次を実行します。
+
+```sh
+cd crates/j-law-ruby
+bundle install
+bundle exec rake compile
+bundle exec rake test
+```
+
+## クイックスタート
+
+```ruby
+require "date"
+require "j_law_ruby"
+
+date = Date.new(2024, 8, 1)
+
+puts JLawRuby::ConsumptionTax.calc_consumption_tax(100_000, Date.new(2024, 1, 1), false).tax_amount
+puts JLawRuby::RealEstate.calc_brokerage_fee(5_000_000, date, false, false).total_with_tax
+
+assessment = JLawRuby::IncomeTax.calc_income_tax_assessment(
+  8_000_000,
+  Date.new(2024, 1, 1),
+  social_insurance_premium_paid: 600_000
+)
+puts assessment.tax.total_tax
+
+puts JLawRuby::StampTax.calc_stamp_tax(:article1_real_estate_transfer, 5_000_000, date).tax_amount
+
+puts JLawRuby::WithholdingTax.calc_withholding_tax(
+  1_500_000,
+  Date.new(2026, 1, 1),
+  :professional_fee
+).tax_amount
+```
+
+## API メモ
+
+- すべての金額は整数円です。
+- すべての API は `Date` / `DateTime` を受け取り、型不一致は `TypeError` を送出します。
+- 法令適用外日付や入力不正は `RuntimeError` を送出します。
+- `calc_stamp_tax()` の `document_code` / `flags` は `Symbol` または `String` を受け取ります。
+- `calc_withholding_tax()` の `category` は `:manuscript_and_lecture` / `:professional_fee` / `:exclusive_contract_fee` などを指定します。
+
+## Gem ビルド
+
+```sh
+cd crates/j-law-ruby
+bundle install
+bundle exec rake build_source_gem
+bundle exec rake build_binary_gem
+```
+
+`rake build` は `build_source_gem` のエイリアスです。
+`build_source_gem` は source gem 用に必要な Rust ソースを `vendor/rust/` へ同期してから gem を生成します。
+`build_binary_gem` は共有ライブラリを事前にビルドして、platform gem に同梱します。
+
+## 関連ドキュメント
+
+- [プロジェクトステータスと免責](../../docs/project-status.md)
+- [リポジトリ README](../../README.md)
+- [利用ガイド](../../docs/usage.md)
+
+## ライセンス
+
+[MIT License](../../LICENSE)

data/lib/j_law_ruby/build_support.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+
+module JLawRuby
+  module BuildSupport
+    module_function
+
+    BINARY_GEM_ENV = "JLAW_RUBY_BINARY_GEM"
+    FORCE_CARGO_BUILD_ENV = "JLAW_RUBY_FORCE_CARGO_BUILD"
+
+    def cargo_profile
+      ENV.fetch("JLAW_RUBY_CARGO_PROFILE", "release")
+    end
+
+    def binary_gem_build?
+      ENV[BINARY_GEM_ENV] == "1"
+    end
+
+    def force_cargo_build?
+      ENV[FORCE_CARGO_BUILD_ENV] == "1"
+    end
+
+    def gem_platform
+      require "rubygems/platform"
+
+      Gem::Platform.local
+    end
+
+    def make_command
+      RbConfig::CONFIG.fetch("MAKE", "make")
+    end
+
+    def shared_library_filename
+      case RbConfig::CONFIG["host_os"]
+      when /mswin|mingw|cygwin/
+        "j_law_c_ffi.dll"
+      when /darwin/
+        "libj_law_c_ffi.dylib"
+      else
+        "libj_law_c_ffi.so"
+      end
+    end
+
+    def native_dir(gem_root)
+      File.join(gem_root, "lib", "j_law_ruby", "native")
+    end
+
+    def packaged_shared_library_path(gem_root)
+      File.join(native_dir(gem_root), shared_library_filename)
+    end
+
+    def packaged_shared_library?(gem_root)
+      File.file?(packaged_shared_library_path(gem_root))
+    end
+
+    def vendored_workspace_root(gem_root)
+      File.join(gem_root, "vendor", "rust")
+    end
+
+    def vendored_manifest_path(gem_root)
+      File.join(vendored_workspace_root(gem_root), "Cargo.toml")
+    end
+
+    def repo_workspace_root(gem_root)
+      File.expand_path("../..", gem_root)
+    end
+
+    def repo_manifest_path(gem_root)
+      File.join(repo_workspace_root(gem_root), "Cargo.toml")
+    end
+
+    def manifest_path(gem_root)
+      vendored_manifest = vendored_manifest_path(gem_root)
+      return vendored_manifest if File.file?(vendored_manifest)
+
+      repo_manifest = repo_manifest_path(gem_root)
+      return repo_manifest if File.file?(repo_manifest)
+
+      nil
+    end
+
+    def built_shared_library_path(manifest_path, profile)
+      File.join(File.dirname(manifest_path), "target", profile, shared_library_filename)
+    end
+
+    def shared_library_candidates(gem_root)
+      candidates = []
+      env_path = ENV["JLAW_RUBY_C_FFI_LIB"]
+      candidates << env_path unless env_path.nil? || env_path.empty?
+      candidates << packaged_shared_library_path(gem_root)
+
+      [vendored_manifest_path(gem_root), repo_manifest_path(gem_root)].each do |manifest|
+        next unless File.file?(manifest)
+
+        candidates << built_shared_library_path(manifest, "release")
+        candidates << built_shared_library_path(manifest, "debug")
+      end
+
+      candidates.uniq
+    end
+
+    def resolve_shared_library_path(gem_root)
+      shared_library_candidates(gem_root).find { |path| File.file?(path) }
+    end
+
+    def should_build_shared_library?(gem_root)
+      return true if force_cargo_build?
+
+      !packaged_shared_library?(gem_root)
+    end
+
+    def write_stub_makefile(path = "Makefile")
+      File.write(
+        path,
+        <<~MAKEFILE
+          all:
+          \t@true
+
+          install:
+          \t@true
+
+          clean:
+          \t@true
+        MAKEFILE
+      )
+    end
+  end
+end