heatmap-builder 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89293cf9e6068ce5530ee73db83843afaef78d4a76aa8b228e1967eee045a5a6
-  data.tar.gz: 762d8a6ac9b4f9186a508484c02d765331550dab22410a0ad0c042ac1fd7d673
+  metadata.gz: cf666db73abc3356f19fea3869f4a6bb4af21c28a2036f2926c811250636c904
+  data.tar.gz: 6ba3349f270af6ef2216d7501888187aa39e2c11d8b874d084e861cf3f41ef8b
 SHA512:
-  metadata.gz: 4b9c8d43222905f84007b4664a713a337f229d5220f6242f090daa7a220a1345b3d92e848560141bcfcf99a18eed10b5ca6ad33d46fe6bd4eaefb40fbb016403
-  data.tar.gz: 71a3a436f449d1703120167c7775200d721cf6a5419737423ca2eca4b890d23e3c2a38cbf86bcb36fa103d5863c852d2d0be8cb2bc1eeaa1f47bdf68badd3abe
+  metadata.gz: 65f06b77aeeda0e45054bbfe402b9d344bf2996a7a5423ca17ab005f79a2aaced93a656eb830294d021b46c2c7ad3c01338553d7d8ece9259d7208ace6ece1b9
+  data.tar.gz: 5fdb4ea1d6c8ff1f7d4966cadd13f6cbeb06916754bdd1e68e553b58632cbc6d49a154f7629f8fc1bb127513dc848831ae87c6d26503f94c29510d8772ee0e08

data/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: ['3.0', '3.1', '3.2', '3.3']
+        ruby-version: ['3.0', '3.1', '3.2', '3.3', '3.4']
 
     steps:
     - uses: actions/checkout@v4

data/.gitignore

@@ -10,3 +10,6 @@
 
 # Gem build artifacts
 *.gem
+
+# Development environment config
+mise.toml

data/CHANGELOG.md

@@ -7,10 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-10-02
+
+### Added
+- Support for raw numeric values with automatic score calculation using linear distribution
+- `values:` parameter as alternative to `scores:` for both linear and calendar heatmaps
+- `value_min:` and `value_max:` options for explicit boundary control
+- `value_to_score:` option for custom value-to-score conversion functions
+- Automatic boundary detection from input data when not explicitly specified
+- Dynamic color palette generation using OKLCH color space interpolation
+- Rounded corners support for heatmap cells via `corner_radius` option
+- Test coverage reporting with SimpleCov
+- Snapshot testing for visual regression testing
+- YARD documentation for public API methods
+- Logarithmic scale example for custom scoring logic
+- Detailed options documentation in README
+
+### Changed
+- Primary API now uses keyword arguments (`scores:`, `values:`, etc.) for clarity and flexibility
+- Refactored common validation logic into base Builder class
+- Improved test suite with Minitest specs syntax
+- Enhanced README with better organization and forward references
+- Renamed `num_scores` parameter to `max_score` for better clarity in custom scoring functions
+- Automatic corner radius clamping to valid range
+
+### Deprecated
+- `HeatmapBuilder.generate(scores, options)` - use `HeatmapBuilder.build_linear(scores: scores, **options)` instead
+- `HeatmapBuilder.generate_calendar(scores, options)` - use `HeatmapBuilder.build_calendar(scores: scores, **options)` instead
+- Old API still works with deprecation warnings for backward compatibility
+
 ## [0.1.0] - 2025-09-19
 
+Initial release with core heatmap visualization capabilities.
+
 ### Added
-- Initial release of HeatmapBuilder gem
 - Linear heatmap generation with `HeatmapBuilder.generate()`
 - Calendar heatmap generation with `HeatmapBuilder.generate_calendar()`
 - GitHub-style color schemes and styling
@@ -18,5 +48,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for custom start of week (Monday/Sunday)
 - SVG output format for perfect scaling
 
-[Unreleased]: https://github.com/dreikanter/heatmap-builder/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/dreikanter/heatmap-builder/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/dreikanter/heatmap-builder/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/dreikanter/heatmap-builder/releases/tag/v0.1.0

data/Gemfile.lock

@@ -1,12 +1,13 @@
 PATH
   remote: .
   specs:
-    heatmap-builder (0.1.0)
+    heatmap-builder (0.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
+    docile (1.4.1)
     json (2.14.1)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
@@ -39,6 +40,12 @@ GEM
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
     ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
     standard (1.51.1)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
@@ -64,6 +71,7 @@ DEPENDENCIES
   heatmap-builder!
   minitest (~> 5.0)
   rake (~> 13.0)
+  simplecov (~> 0.22)
   standard (~> 1.0)
 
 BUNDLED WITH

data/README.md

@@ -8,10 +8,15 @@ A Ruby gem that generates embeddable SVG heatmap visualizations with GitHub-styl
 
 - GitHub-style calendar layouts for date-based data.
 - Linear heatmaps.
+- Vector-based output (SVG) for crisp rendering at any resolution.
+- Optional numeric values displayed in each cell.
+- **Use pre-calculated scores or raw numeric values** - automatic mapping to color scales.
+- Custom value-to-score conversion functions for advanced scoring logic.
 - Parametric everything: customize cell size, spacing, colors, fonts, etc.
-- Shows numeric values in each cell.
+- Rounded corners (and circular cells, if you're into that kind of thing).
+- Dynamic palette generation from two colors or manually-specified colors.
+- OKLCH color interpolation for clean color transitions and perceptual uniformity.
 - **Zero dependencies.**
-- Responsive: SVG format scales perfectly at any size
 
 ## Installation
 
@@ -38,10 +43,10 @@ require 'heatmap-builder'
 
 # Generate SVG for daily scores
 scores = [0, 1, 2, 3, 4, 5, 2, 1]
-svg = HeatmapBuilder.generate(scores)
+svg = HeatmapBuilder.build_linear(scores: scores)
 
 # In a Rails view
-<%= raw HeatmapBuilder.generate(@daily_scores) %>
+<%= raw HeatmapBuilder.build_linear(scores: @daily_scores) %>
 ```
 
 ![Weekly Progress](examples/weekly_progress.svg)
@@ -57,64 +62,362 @@ scores_by_date = {
   # ... more dates
 }
 
-svg = HeatmapBuilder.generate_calendar(scores_by_date)
+svg = HeatmapBuilder.build_calendar(scores: scores_by_date)
 ```
 
-### Custom Configuration
+![GitHub-style Calendar](examples/calendar_github_style.svg)
+
+### Linear Heatmap Options
+
+You must provide either `scores:` or `values:` (but not both). All other options are optional keyword arguments with sensible defaults.
+
+**Data options:**
+
+- `scores` - Array of pre-calculated scores (integers from 0 to number of colors minus 1). Required if `values` is not provided.
+- `values` - Array of arbitrary numeric values to be automatically mapped to scores. Required if `scores` is not provided. See [Using Raw Values Instead of Scores](#using-raw-values-instead-of-scores).
+
+**Value-to-score conversion options** (only used with `values:`):
+
+- `value_min` - Minimum boundary for value-to-score mapping. Defaults to the minimum value in your data.
+- `value_max` - Maximum boundary for value-to-score mapping. Defaults to the maximum value in your data.
+- `value_to_score` - Custom callable for value-to-score conversion. Receives `value:`, `index:`, `min:`, `max:`, `max_score:` parameters and must return an integer between 0 and `max_score`. See [Custom Scoring Logic](#custom-scoring-logic) for details.
+
+**Appearance options:**
+
+- `cell_size` - Size of each square in pixels. Defaults to 10.
+- `cell_spacing` - Space between squares in pixels. Defaults to 1.
+- `font_size` - Font size for score text in pixels. Defaults to 8.
+- `border_width` - Border width around each cell in pixels. Defaults to 1.
+- `corner_radius` - Corner radius for rounded cells. Must be between 0 (square corners) and `floor(cell_size/2)` (circular cells). Values outside this range are automatically clamped. Defaults to 0.
+- `text_color` - Color of score text as a hex string. Defaults to `"#000000"` (black).
+
+**Color options:**
+
+- `colors` - Color palette for the heatmap. Can be a predefined palette constant (e.g., `HeatmapBuilder::GITHUB_GREEN`), an array of hex color strings (e.g., `%w[#ebedf0 #9be9a8 #40c463]`), or a hash for OKLCH interpolation (e.g., `{ from: "#ebedf0", to: "#216e39", steps: 5 }`). Defaults to `HeatmapBuilder::GITHUB_GREEN`. See [Predefined Color Palettes](#predefined-color-palettes) and [Dynamic Palettes Generation](#dynamic-palettes-generation).
+
+### Calendar Heatmap Options
+
+You must provide either `scores:` or `values:` (but not both). All other options are optional keyword arguments with sensible defaults.
+
+**Data options:**
+
+- `scores` - Hash of pre-calculated scores by date (integers from 0 to number of colors minus 1). Keys can be Date objects or date strings (e.g., `'2024-01-01'`). Required if `values` is not provided.
+- `values` - Hash of arbitrary numeric values by date to be automatically mapped to scores. Keys can be Date objects or date strings. Required if `scores` is not provided. See [Using Raw Values Instead of Scores](#using-raw-values-instead-of-scores).
+
+**Value-to-score conversion options** (only used with `values:`):
+
+- `value_min` - Minimum boundary for value-to-score mapping. Defaults to the minimum value in your data.
+- `value_max` - Maximum boundary for value-to-score mapping. Defaults to the maximum value in your data.
+- `value_to_score` - Custom callable for value-to-score conversion. Receives `value:`, `date:`, `min:`, `max:`, `max_score:` parameters and must return an integer between 0 and `max_score`. See [Custom Scoring Logic](#custom-scoring-logic) for details.
+
+**Appearance options:**
+
+- `cell_size` - Size of each square in pixels. Defaults to 12.
+- `cell_spacing` - Space between squares in pixels. Defaults to 1.
+- `font_size` - Font size for labels in pixels. Defaults to 8.
+- `border_width` - Border width around each cell in pixels. Defaults to 1.
+- `corner_radius` - Corner radius for rounded cells. Must be between 0 (square corners) and `floor(cell_size/2)` (circular cells). Values outside this range are automatically clamped. Defaults to 0.
+- `text_color` - Color of label text as a hex string. Defaults to `"#000000"` (black).
+
+**Color options:**
+
+- `colors` - Color palette for the heatmap. Can be a predefined palette constant (e.g., `HeatmapBuilder::GITHUB_GREEN`), an array of hex color strings (e.g., `%w[#ebedf0 #9be9a8 #40c463]`), or a hash for OKLCH interpolation (e.g., `{ from: "#ebedf0", to: "#216e39", steps: 5 }`). Defaults to `HeatmapBuilder::GITHUB_GREEN`. See [Predefined Color Palettes](#predefined-color-palettes) and [Dynamic Palettes Generation](#dynamic-palettes-generation).
+
+**Calendar-specific options:**
+
+- `start_of_week` - First day of the week. One of `:sunday`, `:monday`, `:tuesday`, `:wednesday`, `:thursday`, `:friday`, `:saturday`. Defaults to `:monday`.
+- `month_spacing` - Extra horizontal space between months in pixels. Defaults to 5.
+- `show_month_labels` - Show month names at the top of the calendar. Defaults to `true`.
+- `show_day_labels` - Show day abbreviations on the left side of the calendar. Defaults to `true`.
+- `show_outside_cells` - Show cells outside the date range with inactive styling. Defaults to `false`.
+
+**Internationalization options:**
+
+- `day_labels` - Array of day abbreviations starting from Sunday (7 elements). Defaults to `%w[S M T W T F S]`. See [I18n](#i18n).
+- `month_labels` - Array of month abbreviations from January to December (12 elements). Defaults to `%w[Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec]`. See [I18n](#i18n).
+
+### Using Raw Values Instead of Scores
+
+A **score** is an integer (0 to N-1) that maps directly to a color in your palette. For example, with 5 colors, valid scores are 0-4.
+
+Instead of pre-calculating scores, you can provide raw numeric values (like 45.2, 78, 1000) and let the builder automatically map them to scores using linear distribution:
+
+```ruby
+# Linear heatmap with automatic score calculation
+values = [10, 25, 50, 75, 100]
+svg = HeatmapBuilder.build_linear(
+  values: values,
+  value_min: 0,    # Optional: explicitly set minimum (defaults to actual min)
+  value_max: 100   # Optional: explicitly set maximum (defaults to actual max)
+)
+
+# Calendar heatmap with automatic score calculation
+values_by_date = {
+  Date.new(2024, 1, 1) => 45.2,
+  Date.new(2024, 1, 2) => 78.5,
+  Date.new(2024, 1, 3) => 12.0
+}
+
+svg = HeatmapBuilder.build_calendar(
+  values: values_by_date,
+  value_min: 0,
+  value_max: 100
+)
+```
+
+The builder will automatically:
+- Calculate min/max boundaries from your data if not specified
+- Map values to color scores using linear distribution
+- Clamp values outside the boundaries
+- Handle nil values by treating them as the minimum boundary
+
+### Custom Scoring Logic
+
+By default, values are mapped to scores using linear distribution. You can provide a custom value-to-score conversion function for different behaviors like logarithmic scales, exponential curves, or custom thresholds.
+
+The callable receives these parameters:
+- `value:` - The current value being converted
+- `index:` or `date:` - The position in the data (linear heatmaps use `index:`, calendar heatmaps use `date:`)
+- `min:` - The minimum boundary value
+- `max:` - The maximum boundary value
+- `max_score:` - The maximum valid score (color palette length minus 1)
+
+The function must return an integer between 0 and `max_score`.
+
+Custom scoring logic - linear distribution example:
 
 ```ruby
-# Customize linear heatmap appearance
-options = {
-  cell_size: 35,           # Size of each square (default: 20)
-  cell_spacing: 1,         # Space between squares (default: 2)
-  font_size: 20,           # Font size for score text (default: 12)
-  colors: %w[              # Custom color palette (default: GitHub-style)
-    #f0f0f0
-    #c6e48b
-    #7bc96f
-    #239a3b
-    #196127
-  ]
+linear_formula = ->(value:, index:, min:, max:, max_score:) {
+  ((value - min) / (max - min) * max_score).round
+}
+
+svg = HeatmapBuilder.build_linear(
+  values: [10, 20, 30],
+  value_to_score: linear_formula
+)
+```
+
+Logarithmic scale for data with wide range (e.g., 1 to 10000):
+
+```ruby
+logarithmic_formula = ->(value:, index:, min:, max:, max_score:) {
+  return 0 if value <= 0 || min <= 0
+
+  log_value = Math.log10(value)
+  log_min = Math.log10(min)
+  log_max = Math.log10(max)
+
+  ((log_value - log_min) / (log_max - log_min) * max_score).round.clamp(0, max_score)
 }
 
-svg = HeatmapBuilder.generate([1, 2, 3, 4, 5, 6, 7], options)
+svg = HeatmapBuilder.build_linear(
+  values: [1, 10, 100, 1000, 10000],
+  value_to_score: logarithmic_formula
+)
+```
+
+### Predefined Color Palettes
+
+#### GitHub Green (Default)
+
+```ruby
+HeatmapBuilder.build_linear(scores: scores, colors: HeatmapBuilder::GITHUB_GREEN)
+```
+
+![GitHub Green Linear](examples/linear_github_green.svg)
+
+```ruby
+HeatmapBuilder.build_calendar(scores: calendar_data, colors: HeatmapBuilder::GITHUB_GREEN)
+```
+
+![Default Calendar](examples/calendar_default.svg)
+
+#### Blue Ocean
+
+```ruby
+HeatmapBuilder.build_linear(scores: scores, colors: HeatmapBuilder::BLUE_OCEAN)
+```
+
+![Blue Ocean Linear](examples/linear_blue_ocean.svg)
+
+```ruby
+HeatmapBuilder.build_calendar(scores: calendar_data, colors: HeatmapBuilder::BLUE_OCEAN)
+```
+
+![Blue Ocean Calendar](examples/calendar_blue_ocean.svg)
+
+#### Warm Sunset
+
+```ruby
+HeatmapBuilder.build_linear(scores: scores, colors: HeatmapBuilder::WARM_SUNSET)
+```
+
+![Warm Sunset Linear](examples/linear_warm_sunset.svg)
+
+```ruby
+HeatmapBuilder.build_calendar(scores: calendar_data, colors: HeatmapBuilder::WARM_SUNSET)
 ```
 
-![Large Cells](examples/large_cells.svg)
+![Warm Sunset Calendar](examples/calendar_warm_sunset.svg)
+
+#### Purple Vibes
+
+```ruby
+HeatmapBuilder.build_linear(scores: scores, colors: HeatmapBuilder::PURPLE_VIBES)
+```
+
+![Purple Vibes Linear](examples/linear_purple_vibes.svg)
+
+```ruby
+HeatmapBuilder.build_calendar(scores: calendar_data, colors: HeatmapBuilder::PURPLE_VIBES)
+```
+
+![Purple Vibes Calendar](examples/calendar_purple_vibes.svg)
+
+#### Red to Green
+
+```ruby
+HeatmapBuilder.build_linear(scores: scores, colors: HeatmapBuilder::RED_TO_GREEN)
+```
+
+![Red to Green Linear](examples/linear_red_to_green.svg)
+
+```ruby
+HeatmapBuilder.build_calendar(scores: calendar_data, colors: HeatmapBuilder::RED_TO_GREEN)
+```
+
+![Red to Green Calendar](examples/calendar_red_to_green.svg)
+
+### Dynamic Palettes Generation
+
+Generate custom color palettes from any two colors using OKLCH color space for superior color interpolation:
 
 ```ruby
-# Calendar heatmap options
-calendar_options = {
-  cell_size: 14,
-  start_of_week: :sunday,    # :monday (default) or :sunday
-  show_outside_cells: true   # Show cells outside date range
+# Generate a 5-step palette from electric cyan to hot magenta
+neon_gradient = {
+  from: "#00FFFF",
+  to: "#FF1493",
+  steps: 5
 }
 
-svg = HeatmapBuilder.generate_calendar(scores_by_date, calendar_options)
+svg = HeatmapBuilder.build_linear(scores: scores, colors: neon_gradient)
+```
+
+![Neon Gradient Linear](examples/linear_neon_gradient.svg)
+
+The OKLCH color space ensures perceptually uniform color transitions, making gradients appear smooth and natural to the human eye.
+
+### Rounded Corners
+
+Both linear and calendar heatmaps support rounded corners using the `corner_radius` option.
+
+A typical value is around 2 pixels for a subtle rounded effect:
+
+```ruby
+# Linear heatmap with rounded corners
+HeatmapBuilder.build_linear(
+  scores: scores,
+  corner_radius: 2,
+  cell_size: 18
+)
+```
+
+![Linear Rounded Corners](examples/linear_rounded_corners.svg)
+
+The `corner_radius` value must be between 0 (square corners) and `floor(cell_size/2)`. Values outside this range are automatically clamped to the valid range (negative values become 0, values exceeding the maximum become `floor(cell_size/2)`). Maximum radius values render circular cells:
+
+```ruby
+# Linear heatmap with max radius rounded corners - circular cells
+HeatmapBuilder.build_linear(
+  scores: scores,
+  corner_radius: 9,
+  cell_size: 18
+)
 ```
 
-![Calendar with Sunday Start](examples/calendar_sunday_start.svg)
+![Linear Rounded Corners](examples/linear_rounded_corners_max_radius.svg)
 
-### Color Mapping
+Calendar heatmap examples:
 
-- Score `0`: Uses the first color (typically light gray)
-- Score `1+`: Cycles through remaining colors based on score value
-- Higher scores automatically map to available colors in the palette
+```ruby
+# Calendar heatmap with rounded corners
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  corner_radius: 2,
+  cell_size: 14
+)
+```
+
+![Calendar Rounded Corners](examples/calendar_rounded_corners.svg)
+
+```ruby
+# Calendar heatmap with max radius rounded corners - circular cells
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  corner_radius: 7,
+  cell_size: 14
+)
+```
+
+![Calendar Rounded Corners](examples/calendar_rounded_corners_max_radius.svg)
+
+### I18n
+
+Calendar heatmaps support internationalization by customizing the `day_labels` and `month_labels` options:
+
+```ruby
+# French calendar
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  day_labels: %w[D L M M J V S],  # Dimanche, Lundi, Mardi, etc.
+  month_labels: %w[Jan Fév Mar Avr Mai Jun Jul Aoû Sep Oct Nov Déc]
+)
+
+# German calendar
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  day_labels: %w[S M D M D F S],  # Sonntag, Montag, Dienstag, etc.
+  month_labels: %w[Jan Feb Mär Apr Mai Jun Jul Aug Sep Okt Nov Dez]
+)
+
+# Italian calendar
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  day_labels: %w[D L M M G V S],  # Domenica, Lunedì, Martedì, etc.
+  month_labels: %w[Gen Feb Mar Apr Mag Giu Lug Ago Set Ott Nov Dic]
+)
+
+# Spanish calendar
+HeatmapBuilder.build_calendar(
+  scores: calendar_data,
+  day_labels: %w[D L M X J V S],  # Domingo, Lunes, Martes, etc.
+  month_labels: %w[Ene Feb Mar Abr May Jun Jul Ago Sep Oct Nov Dic]
+)
+```
+
+The `day_labels` array should contain 7 elements starting from Sunday, and `month_labels` should contain 12 elements for January through December.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Run tests with:
+After checking out the repo, run `bin/setup` to install development dependencies.
+
+### Running Tests
 
 ```bash
-ruby -Ilib:test test/heatmap_builder_test.rb
-```
+# Run all tests
+rake test
+
+# Run tests with code linting
+rake
 
-To install this gem onto your local machine, run `bundle exec rake install`.
+# Update test snapshots after making intentional changes to output
+rake update_snapshots
+```
 
 To generate all example SVG files you see in this readme:
 
 ```bash
-ruby examples/generate_samples.rb
+bin/generate_examples
 ```
 
 ## Contributing
@@ -127,4 +430,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the HeatmapBuilder project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/dreikanter/heatmap-builder/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the HeatmapBuilder project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/dreikanter/heatmap-builder/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -13,4 +13,19 @@ rescue LoadError
   # standard is not available
 end
 
+desc "Update test snapshots"
+task :update_snapshots do
+  require "fileutils"
+  snapshots_dir = File.expand_path("test/snapshots", __dir__)
+
+  if Dir.exist?(snapshots_dir)
+    puts "Removing existing snapshots..."
+    FileUtils.rm_rf(Dir["#{snapshots_dir}/*"])
+  end
+
+  puts "Regenerating snapshots..."
+  ENV["UPDATE_SNAPSHOTS"] = "1"
+  Rake::Task[:test].invoke
+end
+
 task default: [:standard, :test]