trevl 0.1.0

data/scripts/generate_screenshots.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Generates PNG screenshots for all TREVL examples.
+# Usage: ruby scripts/generate_screenshots.rb
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "trevl"
+require "grover"
+
+OUTPUT_DIR = File.expand_path("../docs/screenshots", __dir__)
+
+EXAMPLE_DATA = {
+  "01_bar_chart" => {
+    "pirates" => {"data" => [
+      {"name" => "Guybrush", "barrels" => 12},
+      {"name" => "LeChuck", "barrels" => 47},
+      {"name" => "Elaine", "barrels" => 3},
+      {"name" => "Stan", "barrels" => 28},
+      {"name" => "Murray", "barrels" => 0}
+    ]}
+  },
+  "02_column_chart" => {
+    "loot" => {"data" => [
+      {"quarter" => "Q1", "doubloons" => 3200},
+      {"quarter" => "Q2", "doubloons" => 8100},
+      {"quarter" => "Q3", "doubloons" => 5400},
+      {"quarter" => "Q4", "doubloons" => 12600}
+    ]}
+  },
+  "03_line_chart" => {
+    "monkeys" => {"data" => [
+      {"month" => "Jan", "sightings" => 3},
+      {"month" => "Feb", "sightings" => 5},
+      {"month" => "Mar", "sightings" => 2},
+      {"month" => "Apr", "sightings" => 8},
+      {"month" => "May", "sightings" => 12},
+      {"month" => "Jun", "sightings" => 7}
+    ]}
+  },
+  "04_pie_chart" => {
+    "candidates" => {"data" => [
+      {"candidate" => "Guybrush Threepwood", "votes" => 42},
+      {"candidate" => "Carla the Sword Master", "votes" => 31},
+      {"candidate" => "Stan S. Stanman", "votes" => 18},
+      {"candidate" => "Murray the Skull", "votes" => 9}
+    ]}
+  },
+  "05_computed_fields" => {
+    "pirates" => {"data" => [
+      {"name" => "Guybrush", "skill" => 92},
+      {"name" => "Carla", "skill" => 98},
+      {"name" => "Captain Smirk", "skill" => 75},
+      {"name" => "LeChuck", "skill" => 45},
+      {"name" => "Stan", "skill" => 62}
+    ]}
+  },
+  "06_postprocess_top_n" => {
+    "islands" => {"data" => [
+      {"name" => "Monkey Island", "buried" => 42},
+      {"name" => "Melee Island", "buried" => 28},
+      {"name" => "Booty Island", "buried" => 35},
+      {"name" => "Phatt Island", "buried" => 19},
+      {"name" => "Scabb Island", "buried" => 31},
+      {"name" => "Lucre Island", "buried" => 15},
+      {"name" => "Jambalaya Island", "buried" => 22},
+      {"name" => "Blood Island", "buried" => 8}
+    ]}
+  },
+  "10_multi_series" => {
+    "sales" => {"data" => [
+      {"month" => "Jan", "grog" => 340, "rum" => 120},
+      {"month" => "Feb", "grog" => 280, "rum" => 150},
+      {"month" => "Mar", "grog" => 410, "rum" => 180},
+      {"month" => "Apr", "grog" => 520, "rum" => 210},
+      {"month" => "May", "grog" => 380, "rum" => 190},
+      {"month" => "Jun", "grog" => 600, "rum" => 250}
+    ]}
+  }
+}
+
+SKIP = %w[07_score_kpi 08_table 09_template_inheritance]
+
+Dir.glob(File.join(File.expand_path("../examples", __dir__), "*.yml")).sort.each do |path|
+  name = File.basename(path, ".yml")
+  next if SKIP.include?(name)
+
+  data = EXAMPLE_DATA[name]
+  unless data
+    puts "SKIP #{name} (no sample data)"
+    next
+  end
+
+  Trevl::DataSource.reset!
+  Trevl::DataSource.register("demo", Trevl::DataSource::Static.new(data: data))
+
+  yaml = File.read(path).sub(/\A(#[^\n]*\n)+/, "")
+
+  html = Trevl.render_to_html(yaml, width: 800, height: 400)
+  png = Grover.new(html, format: "png", viewport: {width: 900, height: 500}).to_png
+
+  output_path = File.join(OUTPUT_DIR, "#{name}.png")
+  File.write(output_path, png)
+  puts "OK #{name}.png (#{File.size(output_path)} bytes)"
+end
+
+puts "\nDone! Screenshots in #{OUTPUT_DIR}"

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: trevl
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Robin Stammer
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: execjs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Parse, render, and display TREVL (Trendence Visualization Language) YAML
+  configurations. Connects data sources to Highcharts through declarative YAML.
+email:
+- robin.stammer@trendence.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- NOTICE
+- README.md
+- Rakefile
+- assets/trendence-logo.svg
+- assets/trevl-logo.svg
+- docs/screenshots/01_bar_chart.png
+- docs/screenshots/02_column_chart.png
+- docs/screenshots/03_line_chart.png
+- docs/screenshots/04_pie_chart.png
+- docs/screenshots/05_computed_fields.png
+- docs/screenshots/06_postprocess_top_n.png
+- docs/screenshots/10_multi_series.png
+- examples/01_bar_chart.yml
+- examples/02_column_chart.yml
+- examples/03_line_chart.yml
+- examples/04_pie_chart.yml
+- examples/05_computed_fields.yml
+- examples/06_postprocess_top_n.yml
+- examples/07_score_kpi.yml
+- examples/08_table.yml
+- examples/09_template_inheritance.yml
+- examples/10_multi_series.yml
+- lib/trevl.rb
+- lib/trevl/auth/bearer_token.rb
+- lib/trevl/configuration.rb
+- lib/trevl/core_ext/hash.rb
+- lib/trevl/data_source.rb
+- lib/trevl/data_source/api.rb
+- lib/trevl/data_source/base.rb
+- lib/trevl/data_source/cube.rb
+- lib/trevl/data_source/static.rb
+- lib/trevl/errors.rb
+- lib/trevl/highcharts_asset.rb
+- lib/trevl/html_renderer.rb
+- lib/trevl/notebook.rb
+- lib/trevl/notebook/display.rb
+- lib/trevl/processor.rb
+- lib/trevl/renderer.rb
+- lib/trevl/renderer/data_fetcher.rb
+- lib/trevl/renderer/ref_parser.rb
+- lib/trevl/renderer/transform.rb
+- lib/trevl/schema/component.json
+- lib/trevl/schema/document.json
+- lib/trevl/template_store.rb
+- lib/trevl/validator.rb
+- lib/trevl/version.rb
+- llms.txt
+- notebooks/demo.ipynb
+- notebooks/exploration.ipynb
+- scripts/generate_screenshots.rb
+homepage: https://trevl.trendence.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://trevl.trendence.com
+  source_code_uri: https://github.com/trendence/trevl
+  bug_tracker_uri: https://github.com/trendence/trevl/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: TREVL visualization language engine
+test_files: []