calcsheet 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 79bc1c89fd78d1d3350d4018f828341811fbeb50ca15bcdf57bebf4673196d1a
+  data.tar.gz: a32050d33976568d5a40ba3667bc4abce2a6c5bc28b6e7dd1ea49ecc63bc7bca
+SHA512:
+  metadata.gz: 5a2c9a9420a2f5869519ce1eaa10dd7463ab21e63ad45de2d2e948fe54af0f66bda5a9ce424e06b17b3adcf01c0bad941b8dce7a529fe486559696ee2669ccdc
+  data.tar.gz: 06acdf306e97bd8a9305e2b5a537e1d119a6e3c47257831abacdba9a5fe52cd752316f87e7e05b74fbf9cc5e12c1ae10b83d9400b51b7319de68b5d02a3831d5

data/.yardopts

@@ -0,0 +1,9 @@
+--markup rdoc
+--hide-api private
+--readme README.md
+--output-dir tmp/yard
+--no-save
+lib/**/*.rb
+-
+CHANGELOG.md
+LICENSE.txt

data/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to this gem are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this gem adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-21
+
+First release.
+
+### Added
+
+- Read CSV, XLSX and ODS from a path or any IO, one row at a time with bounded memory: `Calcsheet.open`,
+  `Book#sheets`, `#sample`, `#merge_check`, `#rows`, `#each_row` and `#each_batch`. The format is detected from the
+  content; XLS files get a specific `UnsupportedFormatError`.
+- Native types: `String`, `Integer`, `BigDecimal` from the cell text (rounded half up to 15 significant digits only
+  when the text is the full print of a double: a fraction or an exponent with 16 or 17 significant digits), `Date`
+  and `Time` decided by the number format, durations in seconds, booleans; formula cached values; `nil` with a
+  `:cell_error` for error cells. Option `decimals: :float`.
+- Column schemas by 0-based position or by header name, with declared types (`:string`, `:integer`, `:decimal`,
+  `:date`, `:datetime`, `:boolean`), `required:` columns and `required_headers:`; `types: :string`.
+- Row numbers as the user sees them: XLSX `r` attributes, ODS repeated rows, CSV records (plus `Row#line`).
+- Merged reading of sheets with the same header (`sheet: :all`), hidden sheets excluded unless asked for;
+  `start_at:` resumes a read; `skip_blank:`.
+- Cell errors collected per row (`on_error: :collect`) or raised (`on_error: :raise`), with sheet, row, column,
+  key, value and a reason code.
+- CSV detection of encoding (BOM, whole-file UTF-8 check, Windows-1252), separator and quote; options `encoding:`,
+  `col_sep:`, `quote_char:`, `strip_formula_prefix:`. Non-seekable CSV streams are read directly with an explicit
+  format.
+- Write CSV, XLSX and ODS to a path, any IO (non-seekable included) or a Rack body (`Calcsheet.stream`), with
+  typed columns, widths, decimal `scale:` (display only), bold and frozen header rows, several sheets, sheet name
+  validation (`sanitize_sheet_names:`) and overflow into continuation sheets `"Name (2)"` at 1,048,576 rows
+  (`max_rows_per_sheet:`).
+- CSV writing options `col_sep:`, `row_sep:`, `bom:`, `decimal_separator:`, `date_format:`, `datetime_format:` and
+  the `excel_it: true` preset; formula injection protection on by default, disabled per column.
+- `time_zone:` for reading and writing: UTC offsets, or any object responding to `local` (and, for writing, to
+  `utc_to_local` or `utc_offset`), such as `ActiveSupport::TimeZone`, without depending on ActiveSupport.
+- Limits: `max_file_size`, `max_rows`, cumulative `max_uncompressed_size`, `max_compression_ratio` with
+  `compression_ratio_floor`, `max_zip_entries`, `max_sheets` and `max_cell_bytes`, enforced on the bytes actually
+  inflated; bounds on untrusted XML.
+- Global configuration with `Calcsheet.configure`, every option overridable per call.
+- Memory specs for large files (`bundle exec rspec --tag performance`, excluded from the default run). Each case
+  runs in its own process and the bound is its peak RSS. The measured throughput and memory of 1,000,000 rows are
+  in the [README](https://gitlab.opinioni.net/demetra-developers/rubygems/calcsheet/-/blob/main/README.md#performance).
+- Every runnable (```` ```ruby ````) example of the README is run by `spec/readme_spec.rb`, which also checks the
+  options reference against `Configuration::DEFAULTS`.
+- API documentation with YARD (`bundle exec yard`; `.yardopts` hides the `@api private` implementation).
+
+### Security
+
+- Files from untrusted sources are bounded: the limits above are enforced while the bytes are inflated, not from
+  the sizes the archive declares, and the XML the readers buffer has fixed bounds. `max_rows` has no default; set it
+  when reading uploads. See the "Limits" section of the README.
+- CSV written by Calcsheet is protected against formula injection by default (`formula_protection:`).
+- Report vulnerabilities as described in
+  [SECURITY.md](https://gitlab.opinioni.net/demetra-developers/rubygems/calcsheet/-/blob/main/SECURITY.md).
+
+[Unreleased]: https://gitlab.opinioni.net/demetra-developers/rubygems/calcsheet/-/compare/v0.1.0...develop
+[0.1.0]: https://gitlab.opinioni.net/demetra-developers/rubygems/calcsheet/-/tags/v0.1.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Demetra Opinioni.net Srl
+
+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.