iceberg 0.10.2-x64-mingw-ucrt → 0.10.3-x64-mingw-ucrt

data/README.md

@@ -82,9 +82,7 @@ Iceberg::MemoryCatalog.new(
 )
 ```
 
-## Reference
-
-### Namespaces
+## Namespaces
 
 List namespaces
 
@@ -122,7 +120,7 @@ Drop a namespace
 catalog.drop_namespace("main")
 ```
 
-### Tables
+## Tables
 
 List tables
 
@@ -169,7 +167,7 @@ Drop a table
 catalog.drop_table("main.events")
 ```
 
-### Static Tables
+## Static Tables
 
 Load a static table
 

data/lib/iceberg/table.rb

@@ -83,15 +83,28 @@ module Iceberg
       @table.properties
     end
 
-    def to_polars(snapshot_id: nil, storage_options: nil)
+    def scan(snapshot_id: nil)
+      TableScan.new(@table.scan(snapshot_id), self)
+    end
+
+    def to_polars(snapshot_id: nil, storage_options: nil, _schema_changes: false)
       require "polars-df"
 
-      files = @table.scan(snapshot_id).plan_files
+      # TODO always take this path in 0.2.0
+      if _schema_changes
+        return Polars.scan_iceberg(self, snapshot_id:, storage_options:)
+      end
+
+      scan = scan(snapshot_id:)
+      files = scan.plan_files
+
       if files.empty?
+        snapshot = scan.snapshot
+        scan_schema = snapshot ? schema_by_id(snapshot[:schema_id]) : current_schema
+
         # TODO improve
         schema =
-          # TODO use schema from snapshot_id
-          current_schema.fields.to_h do |field|
+          scan_schema.fields.to_h do |field|
             dtype =
               case field[:type]
               when "int"
@@ -122,16 +135,12 @@ module Iceberg
             .to_h { |v, i| [i, v[:deletes].map { |d| d[:file_path] }] }
         ]
 
-        Polars.scan_parquet(
-          sources,
+        scan_options = {
           storage_options: storage_options,
-          # TODO
-          # cast_options: Polars::ScanCastOptions._default_iceberg,
-          # allow_missing_columns: true,
-          # extra_columns: "ignore",
-          # _column_mapping: column_mapping,
-          _deletion_files: deletion_files
-        )
+          _deletion_files: deletion_files,
+        }
+
+        Polars.scan_parquet(sources, **scan_options)
       end
     end
 

data/lib/iceberg/table_scan.rb

@@ -0,0 +1,18 @@
+module Iceberg
+  class TableScan
+    attr_reader :table
+
+    def initialize(scan, table)
+      @scan = scan
+      @table = table
+    end
+
+    def plan_files
+      @scan.plan_files
+    end
+
+    def snapshot
+      @scan.snapshot
+    end
+  end
+end

data/lib/iceberg/version.rb

@@ -1,3 +1,3 @@
 module Iceberg
-  VERSION = "0.10.2"
+  VERSION = "0.10.3"
 end

data/lib/iceberg.rb

@@ -9,6 +9,7 @@ end
 require_relative "iceberg/catalog"
 require_relative "iceberg/schema"
 require_relative "iceberg/table"
+require_relative "iceberg/table_scan"
 require_relative "iceberg/static_table"
 require_relative "iceberg/table_definition"
 require_relative "iceberg/version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iceberg
 version: !ruby/object:Gem::Version
-  version: 0.10.2
+  version: 0.10.3
 platform: x64-mingw-ucrt
 authors:
 - Andrew Kane
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-08-28 00:00:00.000000000 Z
+date: 2025-10-16 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: andrew@ankane.org
@@ -36,6 +36,7 @@ files:
 - lib/iceberg/static_table.rb
 - lib/iceberg/table.rb
 - lib/iceberg/table_definition.rb
+- lib/iceberg/table_scan.rb
 - lib/iceberg/version.rb
 homepage: https://github.com/ankane/iceberg-ruby
 licenses: