tg_geometry 0.1.0

data/spec/expansion_j_full_tg_api_coverage_spec.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe "Expansion Block J grouped TG API coverage" do
+  it "adds safe point and empty geometry constructors without public allocation" do
+    point = TG::Geometry.point_zm(1, 2, 3, 4)
+
+    expect(point).to be_a(TG::Geometry::Geom)
+    expect(point).to be_frozen
+    expect(point.type).to eq(:point)
+    expect(point.point).to eq([1.0, 2.0])
+    expect(point.dims).to eq(4)
+    expect(point.has_z?).to be(true)
+    expect(point.has_m?).to be(true)
+    expect(point.z).to eq(3.0)
+    expect(point.m).to eq(4.0)
+    expect(point.extra_coords).to eq([])
+    expect(point.to_wkt).to eq("POINT(1 2 3 4)")
+
+    expect(TG::Geometry.point(1, 2).dims).to eq(2)
+    expect(TG::Geometry.point_z(1, 2, 3).z).to eq(3.0)
+    expect(TG::Geometry.point_m(1, 2, 4).m).to eq(4.0)
+
+    expect(TG::Geometry.empty_point.to_wkt).to eq("POINT EMPTY")
+    expect(TG::Geometry.empty_linestring.to_wkt).to eq("LINESTRING EMPTY")
+    expect(TG::Geometry.empty_polygon.to_wkt).to eq("POLYGON EMPTY")
+    expect(TG::Geometry.empty_multipoint.to_wkt).to eq("MULTIPOINT EMPTY")
+    expect(TG::Geometry.empty_multilinestring.to_wkt).to eq("MULTILINESTRING EMPTY")
+    expect(TG::Geometry.empty_multipolygon.to_wkt).to eq("MULTIPOLYGON EMPTY")
+    expect(TG::Geometry.empty_geometrycollection.to_wkt).to eq("GEOMETRYCOLLECTION EMPTY")
+
+    expect { TG::Geometry.point(Float::NAN, 2) }.to raise_error(TG::Geometry::ArgumentError)
+    expect { TG::Geometry::Geom.allocate }.to raise_error(TypeError)
+  end
+
+  it "exposes additional TG predicates without changing == semantics" do
+    square = TG::Geometry.parse_wkt("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))")
+    same_square = TG::Geometry.parse_wkt("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))")
+    inner = TG::Geometry.parse_wkt("POINT (5 5)")
+    boundary = TG::Geometry.parse_wkt("POINT (0 0)")
+    outside = TG::Geometry.parse_wkt("POINT (20 20)")
+
+    expect(square.equals?(same_square)).to be(true)
+    expect(square.covers?(boundary)).to be(true)
+    expect(square.contains?(boundary)).to be(false)
+    expect(inner.within?(square)).to be(true)
+    expect(boundary.covered_by?(square)).to be(true)
+    expect(square.disjoint?(outside)).to be(true)
+    expect(square.intersects_xy?(5, 5)).to be(true)
+    expect(square.intersects_rect?(TG::Geometry::Rect.new(9, 9, 11, 11))).to be(true)
+    expect(square.intersects_rect?(20, 20, 21, 21)).to be(false)
+    expect(square == same_square).to be(false)
+  end
+
+  it "exposes collection accessors through borrowed immutable Geom wrappers" do
+    geom = TG::Geometry.parse_wkt(
+      "GEOMETRYCOLLECTION (POINT (1 2), LINESTRING (0 0, 3 4), POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0)))"
+    )
+
+    expect(geom.type).to eq(:geometrycollection)
+    expect(geom.num_geometries).to eq(3)
+    expect(geom.geometries.map(&:type)).to eq(%i[point linestring polygon])
+    expect(geom.geometry_at(0).point).to eq([1.0, 2.0])
+    expect(geom.geometry_at(1).line.length).to eq(5.0)
+    expect(geom.geometry_at(2).polygon.exterior_ring.area).to eq(1.0)
+
+    child = geom.geometry_at(2)
+    index = TG::Geometry::Index.build([[:child, child]], via: :geom, strategy: :flat)
+    geom = nil
+    child = nil
+    GC.start
+    GC.compact if GC.respond_to?(:compact)
+
+    expect(index.find_covering(0.5, 0.5)).to eq(:child)
+  end
+
+  it "exposes multipoint, multiline, and multipolygon child accessors" do
+    multipoint = TG::Geometry.parse_wkt("MULTIPOINT ((1 2), (3 4))")
+    multiline = TG::Geometry.parse_wkt("MULTILINESTRING ((0 0, 3 4), (10 10, 11 11))")
+    multipolygon = TG::Geometry.parse_wkt(
+      "MULTIPOLYGON (((0 0, 1 0, 1 1, 0 1, 0 0)), ((10 10, 11 10, 11 11, 10 11, 10 10)))"
+    )
+
+    expect(multipoint.num_points).to eq(2)
+    expect(multipoint.points).to eq([[1.0, 2.0], [3.0, 4.0]])
+    expect(multiline.num_lines).to eq(2)
+    expect(multiline.lines.map(&:length)).to eq([5.0, Math.sqrt(2)])
+    expect(multipolygon.num_polygons).to eq(2)
+    expect(multipolygon.polygon_at(1).bbox.center).to eq([10.5, 10.5])
+  end
+
+  it "exposes value Segment wrappers from Line and Ring" do
+    line = TG::Geometry.parse_wkt("LINESTRING (0 0, 3 4, 6 4)").line
+    ring = TG::Geometry.parse_wkt("POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))").polygon.exterior_ring
+
+    segment = line.segment_at(0)
+    other = line.segment_at(1)
+
+    expect(segment).to be_a(TG::Geometry::Segment)
+    expect(segment).to be_frozen
+    expect(segment.a).to eq([0.0, 0.0])
+    expect(segment.b).to eq([3.0, 4.0])
+    expect(segment.points).to eq([[0.0, 0.0], [3.0, 4.0]])
+    expect(segment.bbox.center).to eq([1.5, 2.0])
+    expect(segment.intersects?(segment)).to be(true)
+    expect(segment.intersects?(other)).to be(true)
+    expect(line.segments.size).to eq(2)
+    expect(ring.segments.size).to eq(4)
+
+    expect { TG::Geometry::Segment.allocate }.to raise_error(TypeError)
+    expect { line.segment_at(2) }.to raise_error(TG::Geometry::ArgumentError)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+
+ROOT = File.expand_path("..", __dir__)
+LIB_DIR = File.join(ROOT, "lib")
+EXT_SO = File.join(LIB_DIR, "tg_geometry_ext_geometry_ext.#{RbConfig::CONFIG.fetch("DLEXT")}")
+
+unless File.exist?(EXT_SO)
+  system(RbConfig.ruby, "-S", "rake", "compile:test", chdir: ROOT) or abort "failed to compile native extension"
+end
+
+$LOAD_PATH.unshift(LIB_DIR) unless $LOAD_PATH.include?(LIB_DIR)
+
+require "tg/geometry"

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: tg_geometry
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Roman Haydarov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: Defines TG::Geometry with immutable Geom parsing and constructor wrappers,
+  expanded geometry predicates and accessors, Rect helpers, Hex/GeoBIN writers, raw
+  extra_json access, read-only borrowed Line/Ring/Polygon and GeometryCollection child
+  wrappers, value Segment wrappers, Registry reload sugar, optional ActiveRecord source
+  helpers, and an immutable geofencing-oriented Index with owned and borrowed geometry
+  ingestion, flat/rtree strategies, deterministic ordered id results, exact rtree
+  allocation accounting, and native-endian packed point batch queries over vendored
+  TG sources. Ractor support is not claimed.
+email:
+- romnhajdarov@gmail.com
+executables: []
+extensions:
+- ext/tg_geometry/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- benchmark/_support.rb
+- benchmark/batch_packed_vs_loop.rb
+- benchmark/falcon_concurrency.rb
+- benchmark/flat_vs_rtree.rb
+- benchmark/gvl_threshold.rb
+- benchmark/objectspace_memsize.rb
+- benchmark/parse_throughput.rb
+- benchmark/rss_stability.rb
+- docs/ACTIVE_RECORD.md
+- docs/ARCHITECTURE.md
+- docs/AUTO_STRATEGY.md
+- docs/BENCHMARKING.md
+- docs/CASUAL_EXAMPLE.md
+- docs/CONCURRENCY.md
+- docs/ERROR_HANDLING.md
+- docs/EXPANSION_E_TO_H_STATUS.md
+- docs/FORMAT_COVERAGE.md
+- docs/FULL_TG_API_COVERAGE.md
+- docs/LIMITATIONS.md
+- docs/LOW_LEVEL_GEOMETRY.md
+- docs/MEMORY_OWNERSHIP.md
+- docs/RACTOR.md
+- docs/REGISTRY.md
+- docs/RELEASE_CHECKLIST.md
+- ext/tg_geometry/extconf.rb
+- ext/tg_geometry/tg_geometry_ext.c
+- ext/tg_geometry/tg_geometry_vendor_rtree.c
+- ext/tg_geometry/tg_geometry_vendor_tg.c
+- ext/tg_geometry/vendor/.vendored
+- ext/tg_geometry/vendor/rtree/LICENSE
+- ext/tg_geometry/vendor/rtree/README.md
+- ext/tg_geometry/vendor/rtree/VERSION
+- ext/tg_geometry/vendor/rtree/rtree.c
+- ext/tg_geometry/vendor/rtree/rtree.h
+- ext/tg_geometry/vendor/tg/LICENSE
+- ext/tg_geometry/vendor/tg/README.md
+- ext/tg_geometry/vendor/tg/VERSION
+- ext/tg_geometry/vendor/tg/tg.c
+- ext/tg_geometry/vendor/tg/tg.h
+- lib/tg/geometry.rb
+- lib/tg/geometry/active_record_source.rb
+- lib/tg/geometry/registry.rb
+- lib/tg/geometry/version.rb
+- lib/tg_geometry.rb
+- script/vendor_libs.rb
+- spec/block_10_rtree_strategy_spec.rb
+- spec/block_11_rtree_order_spec.rb
+- spec/block_12_batch_packed_spec.rb
+- spec/block_13_error_hardening_spec.rb
+- spec/block_14_memory_gc_hardening_spec.rb
+- spec/block_1_skeleton_spec.rb
+- spec/block_20_concurrency_spec.rb
+- spec/block_20_fuzz_spec.rb
+- spec/block_2_vendor_spec.rb
+- spec/block_3_geom_parse_spec.rb
+- spec/block_4_geom_api_spec.rb
+- spec/block_5_rect_api_spec.rb
+- spec/block_6_index_build_spec.rb
+- spec/block_7_index_owned_geometry_spec.rb
+- spec/block_8_index_borrowed_geometry_spec.rb
+- spec/block_9_flat_query_spec.rb
+- spec/expansion_a_auto_strategy_spec.rb
+- spec/expansion_b_registry_spec.rb
+- spec/expansion_c_active_record_source_spec.rb
+- spec/expansion_d_format_coverage_spec.rb
+- spec/expansion_e_low_level_geometry_spec.rb
+- spec/expansion_i_ractor_spec.rb
+- spec/expansion_j_full_tg_api_coverage_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/roman-haidarov/tg_geometry
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/roman-haidarov/tg_geometry
+  source_code_uri: https://github.com/roman-haidarov/tg_geometry/tree/main
+  changelog_uri: https://github.com/roman-haidarov/tg_geometry/blob/main/CHANGELOG.md
+post_install_message:
+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.3.27
+signing_key:
+specification_version: 4
+summary: Native extension for TG::Geometry parsing, predicates, immutable indexes,
+  registries, low-level wrappers, and packed point batches
+test_files: []