excel-esv 3.0.1 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61b9d8716af48b7a32382ba6e9558a5f9f2afc71cb6ec0e6a380686dd91ea308
-  data.tar.gz: 8d737947eb7b20510cd234a5c23a033c5eaec2a8f90d22152c8c6892de99e271
+  metadata.gz: d46877da5cc1642f15c16ed055a62a15656ff495eb5d3854a606134668f988df
+  data.tar.gz: 46c7e0920178b82d593a6a1d1dfef31d929a914ef22ed4ea23efd5a675526eba
 SHA512:
-  metadata.gz: e72fa2c2685e9833c15d4ea0c6278b41ca0b8f45fe296ff81f6691652cd0b477f68e69365b9bc42b3d70024738361cd8805ab0d21885de875b028febab293d0d
-  data.tar.gz: 2dacf749dcc74944f9ad3cf2ef671e123a16f8665ecfab299541cd22c702663b9e168218675cfd75cc56ef1bac455b3d90f6f554f0d3549f71928931074808ea
+  metadata.gz: 7dcd7941790d2a1082105f03eb7813b62a91dce96a5624fb124b0819431f7c6261e8e848a78fffd0ac03759bd3bbc8697d32fd05bba9463842fff2e07c445a27
+  data.tar.gz: a279ac0df840b36fbb719c3e210696bf6c261e80e80970d9d2accdfa0fea4b5e592542da1cbbb86dbf4d1531266c18294c1726f99c16da872b575edf41c5f399

data/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

data/.github/workflows/ci.yml

@@ -7,16 +7,22 @@ on:
     branches: [ master ]
 
 jobs:
-  test:
+  ruby-versions:
+    uses: ruby/actions/.github/workflows/ruby_versions.yml@master
+    with:
+      min_version: 3.2
+      engine: cruby
 
+  test:
+    needs: ruby-versions
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        ruby-version: ["3.0", "2.7", "2.6", "2.5"]
-
+        ruby-version: ${{ fromJson(needs.ruby-versions.outputs.versions) }}
+        
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v7
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
         with:

data/.gitignore

@@ -11,4 +11,5 @@
 *.so
 *.o
 *.a
+*.gem
 mkmf.log

data/CHANGELOG.md

@@ -1,12 +1,32 @@
-# 3.0.0
+# Changelog
+
+## 3.3.0 (Aug 28, 2026)
+
+* Fix Numbers.app misrendering by formatting date cells as ISO 8601 ("2026-08-28") and time cells as ISO-like ("2026-08-28 13:45").
+
+## 3.2.0 (Nov 12, 2025)
+
+* Support `worksheet_index:` in `.parse_file`, too.
+
+## 3.1.0 (Nov 12, 2025)
+
+* Support specifying worksheet index when there are multiple: `ESV.parse(data, worksheet_index: 0)`.
+
+## 3.0.1 (Nov 19, 2021)
+
+* Add `ESV.parse(data, header_converters:)` [#9]
+
+[#9]: https://github.com/barsoom/excel-esv/pull/9
+
+## 3.0.0 (Nov 20, 2018)
 
 * Returns the last value of any formula cells instead of returning a `Spreadsheet::Formula`.
 * Returns the URL of any link cells instead of returning a `Spreadsheet::Link`.
 
-# 2.0.0
+## 2.0.0 (Nov 19, 2018)
 
 * `parse` now returns an actual nested `Array`, not array-like `Spreadsheet::Row` records.
 
-# 1.0.0
+## 1.0.0 (Dec 8, 2017)
 
 * `send_excel` now supports a `filename:` argument, e.g. `send_excel(data, filename: "salaries.xls")`.

data/Gemfile

@@ -4,7 +4,7 @@ source "https://rubygems.org"
 gemspec
 
 group :development do
-  gem "barsoom_utils", github: "barsoom/barsoom_utils"
+  gem "barsoom_utils"
   gem "bundler"
   gem "rake"
   gem "rspec"

data/README.md

@@ -45,7 +45,31 @@ output = ESV.parse(data)
 # => [ [ "Name", "Dogs", … ], … ]
 ```
 
-This assumes a file with a single worksheet and will raise otherwise.
+This will raise for a file with multiple worksheets unless you explicitly specify the one you want (the first worksheet is index 0):
+
+``` ruby
+ESV.parse(data, worksheet_index: 0)
+```
+
+`.parse` supports the `header_converters:` keyword argument, which takes the same arguments as `CSV.parse` does:
+
+- a Symbol name for a registered header converter
+- a Proc which takes the value and returns the converted value
+- an Array of Symbol names for registered header converters
+
+``` ruby
+require "esv"
+
+data = File.read("/tmp/test.xls")
+output = ESV.parse(data, header_converters: :symbol)
+# => [ [ :name, :dogs, … ], … ]
+```
+
+Registering a new converter:
+
+``` ruby
+ESV::HEADER_CONVERTERS[:upcase] = ->(value) { value.upcase }
+```
 
 ### Parse file
 
@@ -56,7 +80,7 @@ output = ESV.parse_file("/tmp/test.xls")
 # => [ [ "Name", "Dogs", … ], … ]
 ```
 
-This assumes a file with a single worksheet and will raise otherwise.
+This is a thin wrapper around `ESV.parse` and takes the same arguments.
 
 ### Generate in Ruby on Rails
 

data/excel-esv.gemspec

@@ -12,9 +12,11 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/barsoom/excel-esv"
   spec.license       = "MIT"
   spec.metadata      = { "rubygems_mfa_required" => "true" }
+  spec.required_ruby_version = ">= 3.1.0"
 
   spec.files         = `git ls-files -z`.split("\x0")
   spec.require_paths = [ "lib" ]
 
-  spec.add_dependency "spreadsheet"
+  spec.add_runtime_dependency "logger"
+  spec.add_runtime_dependency "spreadsheet"
 end

data/lib/esv/generator.rb

@@ -1,4 +1,10 @@
 class ESV::Generator
+  # The spreadsheet gem otherwise formats date and time cells as "DD.MM.YYYY".
+  # Excel reads that case-insensitively, but Numbers.app only recognises the "MM", so it renders e.g. "DD.06.YYYY". Lowercase "dd" and "yyyy" work in both.
+  # "hh" is confirmed to render as 24-hour time in Numbers.app.
+  DATE_FORMAT = "yyyy-MM-dd"
+  DATE_TIME_FORMAT = "yyyy-MM-dd hh:mm:ss"
+
   def initialize
     @data_rows = []
   end
@@ -14,6 +20,7 @@ class ESV::Generator
     @data_rows.each_with_index do |data_row, index|
       row = sheet.row(index)
       row.push(*data_row)
+      format_dates_and_times(row, data_row)
     end
 
     content = ""
@@ -21,4 +28,23 @@ class ESV::Generator
     book.write(fake_file)
     content
   end
+
+  private
+
+  def format_dates_and_times(row, data_row)
+    data_row.each_with_index do |value, index|
+      format =
+        case value
+        # DateTime is a Date, so it has to be matched first.
+        # Rails' `ActiveSupport::TimeWithZone` is matched by `when Time` since ActiveSupport patches `Time.===`.
+        when DateTime, Time then date_time_format
+        when Date then date_format
+        end
+
+      row.set_format(index, format) if format
+    end
+  end
+
+  def date_format = @date_format ||= Spreadsheet::Format.new(number_format: DATE_FORMAT)
+  def date_time_format = @date_time_format ||= Spreadsheet::Format.new(number_format: DATE_TIME_FORMAT)
 end

data/lib/esv/rails_controller.rb

@@ -10,7 +10,7 @@ module ESV
         data,
         type: ESV::CONTENT_TYPE,
         disposition: "attachment",
-        filename: filename,
+        filename:,
       )
     end
   end

data/lib/esv/version.rb

@@ -1,3 +1,3 @@
 module ESV
-  VERSION = "3.0.1"
+  VERSION = "3.3.0"
 end

data/lib/esv.rb

@@ -16,27 +16,78 @@ module ESV
     end
   end
 
-  def self.parse(data)
+  # You can register your own header converters in this Hash.
+  #
+  # @see https://rubyapi.org/3.2/o/csv#class-CSV-label-Custom+Header+Converters
+  HEADER_CONVERTERS = {
+    downcase: ->(value) {
+      value.respond_to?(:downcase) ? value.downcase : value
+    },
+    # Details:
+    #
+    #  Strips leading and trailing whitespace.
+    #  Downcases the header.
+    #  Replaces embedded spaces with underscores.
+    #  Removes non-word characters.
+    #  Makes the string into a Symbol.
+    symbol: ->(value) {
+      value.to_s.strip.downcase.tr(" ", "_").gsub(/\W+/, "").to_sym
+    },
+  }
+
+  # @param data [Object] Spreadsheet data to be parsed.
+  # @param header_converters [nil, Symbol, Proc, Array<Symbol>] If given, can take these forms:
+  #   - a Symbol name for a registered header converter
+  #   - a Proc which takes the value and returns the converted value
+  #   - an Array of Symbol names for registered header converters
+  # @param worksheet_index [nil, Integer] If given, specifies which worksheet index to parse (first is 0). If nil, expects exactly one worksheet.
+  # @return [Array<Array>] a list of rows
+  def self.parse(data, header_converters: nil, worksheet_index: nil)
     fake_file = StringIO.new(data)
     book = Spreadsheet.open(fake_file)
 
-    # We could support multiple worksheets, but let's not until we actually need it.
-    # Until then, we prefer raising to silently ignoring worksheets.
-    worksheet_count = book.worksheets.length
-    raise "Expected 1 worksheet, found #{worksheet_count}." if worksheet_count > 1
-
-    book.worksheet(0).to_a.map(&:to_a).map { |row|
-      row.map { |cell|
-        case cell
-        when Spreadsheet::Formula then cell.value
-        when Spreadsheet::Link then cell.href
-        else cell
+    # We prefer raising to silently ignoring worksheets.
+    if !worksheet_index && book.worksheets.length > 1
+      raise "Expected 1 worksheet, found #{book.worksheets.length}."
+    end
+
+    worksheet_index ||= 0
+
+    is_first_row = true
+    book.worksheet(worksheet_index).to_a.map(&:to_a).map { |row|
+      row.each_with_index.map { |cell, index|
+        value =
+          case cell
+          when Spreadsheet::Formula then cell.value
+          when Spreadsheet::Link then cell.href
+          else cell
+          end
+
+        if header_converters && is_first_row
+          case header_converters
+          when Proc then
+            value = header_converters.call(value)
+          when Symbol then
+            value = HEADER_CONVERTERS[header_converters].call(value)
+          when Enumerable then
+            # Apply the converters in order.
+            header_converters.each { |name|
+              value = HEADER_CONVERTERS.fetch(name).call(value)
+            }
+          else
+            raise "Unsupported kind of header_converters #{header_converters.inspect}"
+          end
+          value
+        else
+          value
         end
+      }.tap {
+        is_first_row = false
       }
     }
   end
 
-  def self.parse_file(path)
-    parse File.read(path)
+  def self.parse_file(path, header_converters: nil, worksheet_index: nil)
+    parse(File.read(path), header_converters:, worksheet_index:)
   end
 end

data/spec/esv_spec.rb

@@ -1,114 +1,262 @@
 require "esv"
 
-RSpec.describe ESV, ".generate and .parse" do
-  it "works" do
-    data = ESV.generate do |esv|
-      esv << [ "Dogs", "Cats" ]
-      esv << [ 1, 2 ]
+RSpec.describe ESV do
+  describe ".generate and .parse" do
+    it "works" do
+      data = ESV.generate do |esv|
+        esv << [ "Dogs", "Cats" ]
+        esv << [ 1, 2 ]
+      end
+
+      output = ESV.parse(data)
+
+      expect(output).to eq [
+        [ "Dogs", "Cats" ],
+        [ 1, 2 ],
+      ]
+    end
+
+    it "keeps date and time cells readable as such, rather than as text" do
+      data = ESV.generate do |esv|
+        esv << [ Date.new(2026, 6, 24), DateTime.new(2026, 6, 24, 13, 30, 5) ]
+      end
+
+      expect(ESV.parse(data)).to eq([ [ Date.new(2026, 6, 24), DateTime.new(2026, 6, 24, 13, 30, 5) ] ])
     end
 
-    output = ESV.parse(data)
+    it "reads a Time back as a DateTime" do
+      data = ESV.generate { |esv| esv << [ Time.utc(2026, 6, 24, 13, 30, 5) ] }
 
-    expect(output).to eq [
-      [ "Dogs", "Cats" ],
-      [ 1, 2 ],
-    ]
+      expect(ESV.parse(data)).to eq([ [ DateTime.new(2026, 6, 24, 13, 30, 5) ] ])
+    end
   end
-end
 
-RSpec.describe ESV, ".parse" do
-  it "raises if there's more than one worksheet" do
-    excel_file_with_two_worksheets = generate_excel_file do |sheet, book|
-      book.create_worksheet
+  describe ".generate" do
+    it "formats date and time cells so that both Excel and Numbers.app render them" do
+      data = ESV.generate do |esv|
+        esv << [ Date.new(2026, 6, 24), Time.utc(2026, 6, 24, 13, 30), DateTime.new(2026, 6, 24, 13, 30), "Dogs", 1 ]
+      end
+
+      expect(number_formats_in(data)).to eq([
+        "yyyy-MM-dd",
+        "yyyy-MM-dd hh:mm:ss",
+        "yyyy-MM-dd hh:mm:ss",
+        "GENERAL",
+        "GENERAL",
+      ])
     end
 
-    expect {
-      ESV.parse(excel_file_with_two_worksheets)
-    }.to raise_error(/Expected 1 worksheet, found 2/)
+    private
+
+    def number_formats_in(data)
+      row = Spreadsheet.open(StringIO.new(data)).worksheet(0).row(0)
+
+      row.each_with_index.map { |_value, index| row.format(index).number_format }
+    end
   end
 
-  it "ignores formatting, always returning a plain array of data" do
-    excel_file_with_formatting = generate_excel_file do |sheet|
-      sheet.row(0).replace([ 1, 2 ])
-      sheet.row(0).default_format = Spreadsheet::Format.new(color: :blue)
+  describe "::HEADER_CONVERTERS" do
+    context "with :downcase" do
+      it "downcases string value" do
+        expect(described_class::HEADER_CONVERTERS[:downcase].call("CAT")).to eq("cat")
+      end
+
+      it "returns a non-string value" do
+        expect(described_class::HEADER_CONVERTERS[:downcase].call(1)).to eq(1)
+      end
     end
 
-    output = ESV.parse(excel_file_with_formatting)
+    context "with :symbol" do
+      it "stringifies before symbolizing given value" do
+        expect(described_class::HEADER_CONVERTERS[:symbol].call(1)).to eq(:"1")
+      end
 
-    expect(output).to eq [
-      [ 1, 2 ],
-    ]
+      it "symbolizes given value" do
+        expect(described_class::HEADER_CONVERTERS[:symbol].call("cat")).to eq(:cat)
+      end
 
-    expect(output[0].class).to eq Array
+      context "symbolizes and" do
+        it "downcases given value" do
+          expect(described_class::HEADER_CONVERTERS[:symbol].call("CAT")).to eq(:cat)
+        end
+
+        it "strips any spaces around value" do
+          expect(described_class::HEADER_CONVERTERS[:symbol].call("   CAT ")).to eq(:cat)
+        end
+
+        it "replaces embedded spaces with underscores" do
+          expect(described_class::HEADER_CONVERTERS[:symbol].call("CAT CAT")).to eq(:cat_cat)
+        end
+
+        it "removes non-word characters" do
+          expect(described_class::HEADER_CONVERTERS[:symbol].call("CAT?")).to eq(:cat)
+        end
+      end
+    end
   end
 
-  it "returns the last value of a formula cell" do
-    excel_file_with_formula = generate_excel_file do |sheet|
-      formula = Spreadsheet::Formula.new
-      formula.value = "two"
-      sheet.row(0).replace([ "one", formula ])
+  describe ".parse" do
+    describe "worksheet handling" do
+      context "with more than one worksheet" do
+        let(:excel_file_with_two_worksheets) {
+          generate_excel_file do |sheet_0, book|
+            sheet_0.row(0).replace([ "I am worksheet 0" ])
+
+            sheet_1 = book.create_worksheet
+            sheet_1.row(0).replace([ "I am worksheet 1" ])
+          end
+        }
+
+        it "raises when not given a worksheet index" do
+          expect {
+            ESV.parse(excel_file_with_two_worksheets)
+          }.to raise_error(/Expected 1 worksheet, found 2/)
+        end
+
+        it "allows specifying a worksheet index" do
+          output = ESV.parse(excel_file_with_two_worksheets, worksheet_index: 0)
+          expect(output).to eq [ [ "I am worksheet 0" ] ]
+
+          output = ESV.parse(excel_file_with_two_worksheets, worksheet_index: 1)
+          expect(output).to eq [ [ "I am worksheet 1" ] ]
+        end
+      end
     end
 
-    output = ESV.parse(excel_file_with_formula)
+    it "ignores formatting, always returning a plain array of data" do
+      excel_file_with_formatting = generate_excel_file do |sheet|
+        sheet.row(0).replace([ 1, 2 ])
+        sheet.row(0).default_format = Spreadsheet::Format.new(color: :blue)
+      end
 
-    expect(output).to eq [
-      [ "one", "two" ],
-    ]
-    expect(output[0].class).to eq Array
-  end
+      output = ESV.parse(excel_file_with_formatting)
 
+      expect(output).to eq [
+        [ 1, 2 ],
+      ]
 
-  it "returns the URL of a link cell" do
-    excel_file_with_link = generate_excel_file do |sheet|
-      link = Spreadsheet::Link.new("https://example.com", "desc", "foo")
-      sheet.row(0).replace([ "one", link ])
+      expect(output[0].class).to eq Array
     end
-    output = ESV.parse(excel_file_with_link)
-    expect(output).to eq [
-      [ "one", "https://example.com#foo" ],
-    ]
 
-    expect(output[0][1].class).to eq String
-  end
+    it "returns the last value of a formula cell" do
+      excel_file_with_formula = generate_excel_file do |sheet|
+        formula = Spreadsheet::Formula.new
+        formula.value = "two"
+        sheet.row(0).replace([ "one", formula ])
+      end
 
-  private
+      output = ESV.parse(excel_file_with_formula)
 
-  def generate_excel_file(&block)
-    book = Spreadsheet::Workbook.new
-    sheet = book.create_worksheet
+      expect(output).to eq [
+        [ "one", "two" ],
+      ]
+      expect(output[0].class).to eq Array
+    end
 
-    block.call(sheet, book)
 
-    data = ""
-    fake_file = StringIO.new(data)
-    book.write(fake_file)
-    data
-  end
-end
+    it "returns the URL of a link cell" do
+      excel_file_with_link = generate_excel_file do |sheet|
+        link = Spreadsheet::Link.new("https://example.com", "desc", "foo")
+        sheet.row(0).replace([ "one", link ])
+      end
+      output = ESV.parse(excel_file_with_link)
+      expect(output).to eq [
+        [ "one", "https://example.com#foo" ],
+      ]
 
-RSpec.describe ESV, ".generate_file and .parse_file" do
-  before do
-    @file = Tempfile.new("esv")
-  end
+      expect(output[0][1].class).to eq String
+    end
+
+    context "when given a header_converters: option" do
+      let(:data) {
+        ESV.generate do |esv|
+          esv << [ "Dogs", "Cats cats" ]
+          esv << [ 1, 2 ]
+        end
+      }
+
+      it "lets you specify header_converters by symbolic name" do
+        output = ESV.parse(data, header_converters: :downcase)
+
+        expect(output).to eq [
+          [ "dogs", "cats cats" ],
+          [ 1, 2 ],
+        ]
+      end
+
+      it "lets you specify header_converters as a proc" do
+        output = ESV.parse(data, header_converters: ->(value) { value.upcase })
+
+        expect(output).to eq [
+          [ "DOGS", "CATS CATS" ],
+          [ 1, 2 ],
+        ]
+      end
+
+      it "lets you register new symbolic names for header_converters and use them" do
+        ESV::HEADER_CONVERTERS[:upcase] = ->(value) { value.upcase }
+
+        output = ESV.parse(data, header_converters: :upcase)
+
+        expect(output).to eq [
+          [ "DOGS", "CATS CATS" ],
+          [ 1, 2 ],
+        ]
+
+        ESV::HEADER_CONVERTERS.delete(:upcase)
+      end
 
-  it "works" do
-    path = @file.path
+      it "lets you specify header_converters by symbolic names as a list and have them apply in order" do
+        ESV::HEADER_CONVERTERS[:reverse] = ->(value) { value.reverse }
+        output = ESV.parse(data, header_converters: [ :downcase, :reverse, :symbol ])
 
-    ESV.generate_file(path) do |esv|
-      esv << [ "Dogs", "Cats" ]
-      esv << [ 1, 2 ]
+        expect(output).to eq [
+          [ :sgod, :stac_stac ],
+          [ 1, 2 ],
+        ]
+        ESV::HEADER_CONVERTERS.delete(:reverse)
+      end
     end
 
-    output = ESV.parse_file(path)
+    private
 
-    expect(output).to eq [
-      [ "Dogs", "Cats" ],
-      [ 1, 2 ],
-    ]
+    def generate_excel_file(&block)
+      book = Spreadsheet::Workbook.new
+      sheet = book.create_worksheet
+
+      block.call(sheet, book)
+
+      data = ""
+      fake_file = StringIO.new(data)
+      book.write(fake_file)
+      data
+    end
   end
 
-  after do
-    @file.close
-    @file.unlink
+  describe ".generate_file and .parse_file" do
+    before do
+      @file = Tempfile.new("esv")
+    end
+
+    it "works" do
+      path = @file.path
+
+      ESV.generate_file(path) do |esv|
+        esv << [ "Dogs", "Cats" ]
+        esv << [ 1, 2 ]
+      end
+
+      output = ESV.parse_file(path, worksheet_index: 0)
+
+      expect(output).to eq [
+        [ "Dogs", "Cats" ],
+        [ 1, 2 ],
+      ]
+    end
+
+    after do
+      @file.close
+      @file.unlink
+    end
   end
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: excel-esv
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.3.0
 platform: ruby
 authors:
 - Henrik Nyh
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-19 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: spreadsheet
   requirement: !ruby/object:Gem::Requirement
@@ -24,13 +37,13 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
 email:
 - henrik@nyh.se
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
@@ -53,7 +66,6 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -61,15 +73,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.28
-signing_key: 
+rubygems_version: 4.0.9
 specification_version: 4
 summary: Excel parsing and generation with the ease of CSV.
 test_files: []