graphina 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f570978e09506bff882553a4c39ab03e74af7cadd008513e0167b50493343cf
-  data.tar.gz: b2f5b74fb597d1935592f586856495189cce766c3c160003ed89632d0276dabd
+  metadata.gz: cca65e421a6d4a67744edd6f1acc65219c29f16b5d1decf0e886c9208e9d9906
+  data.tar.gz: ff1f2e42524b8eae0c6df646b010740bc312f8348d03727639a85b097835de4d
 SHA512:
-  metadata.gz: d4c746f79af45187c5a239ac8d6907420adb9aa315fedb9b8f37a5bc1e89c4a37d523a3152597f1e48229297787fe8d49e055e54397f420159e68d050fdb320b
-  data.tar.gz: e9a6465440a088a96e71eebd562982a91fb5641e9350345c4e0172cb474cce4be180e34ff6bd573a1b8a259f5bb241c35392629c70b66c7ac666f37343aed4e8
+  metadata.gz: 4fd6afb55759a51ff4b5d6d52723af3e7a29e888273784aa8b637be5591486093bc65fd9315c0a8c02eb83a4e7b53b604b19a1c809f0dc27cdcfd900f49370d0
+  data.tar.gz: f1ec824b10b71a579d9c10e9ffb5642943313952c46b85d199d2d903e60cc2d87b0911fbf9f32a8e54883b72e29b1306e3b64e0b5b141635df0834b0ed41c668

data/.utilsrc

@@ -0,0 +1,52 @@
+# vim: set ft=ruby:
+
+search do
+  prune_dirs /\A(\.svn|\.git|\.terraform|CVS|tmp|coverage|corpus|pkg|\.yardoc|doc)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.(log|fnm|jpg|jpeg|png|pdf|svg)\z|\A(tags|cscope\.out)\z|~\z)/i
+end
+
+discover do
+  prune_dirs /\A(\.svn|\.git|\.terraform|\.yardoc|CVS|tmp|coverage|corpus|pkg|\.yardoc|doc)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.log\z|~\z)/
+  index_expire_after 3_600
+end
+
+strip_spaces do
+  prune_dirs /\A(\..*|CVS|pkg|\.yardoc)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.log\z|~\z)/
+end
+
+probe do
+  test_framework :rspec
+end
+
+ssh_tunnel do
+  terminal_multiplexer :tmux
+  login_session "/home/#{ENV['USER']}"
+end
+
+classify do
+  shift_path_by_default 1
+end
+
+code_indexer do
+  verbose false
+
+  gems = %w[
+    amatch
+    const_conf
+    base64
+    bigdecimal
+    complex_config
+    date
+    json
+    ostruct
+    search_ui
+    term-ansicolor
+    tins
+  ]
+
+  paths {
+    %w[ lib ] + gems.map { `bundle show #{it}` }.map(&:chomp)
+  }
+end

data/README.md

@@ -5,11 +5,14 @@
 A Ruby gem for creating terminal-based data visualizations with real-time
 graphical displays using Unicode characters and ANSI styling 🎨📊
 
+## Screenshots (run in tmux)
+
+![graphina Screenshot](./img/graphina.png "graphina Screenshot")
+
 ## Documentation
 
 Complete API documentation is available at: [GitHub.io](https://flori.github.io/graphina/)
 
-
 ## Features
 
 - **Real-time Data Visualization**: Create dynamic, continuously updating
@@ -51,12 +54,47 @@ Or install the gem directly:
 gem install graphina
 ```
 
+## Panel Configuration Setup
+
+Graphina now supports predefined panel configurations. You can create a
+`panels.yml` file in your configuration directory
+(`"$XDG_CONFIG_HOME/graphina"`, usually `~/.config/graphina/panels.yml`) to
+define reusable panel setups.
+
+To install one of the included defaults you can try
+```bash
+graphina -S default
+```
+
+which attempts to infer a default config for your platform.
+
+
+Currently these platforms are included:
+
+  - MacOS x86 64 see [x86_64-darwin](lib/graphina/panel/defaults/x86_64-darwin.yml).
+  - Linux x86 64 see [x86_64-linux](lib/graphina/panel/defaults/x86_64-linux.yml).
+
+These can be installed eplicitly via:
+```bash
+graphina -S x86_64-darwin
+```
+
+Then to use a specific panel:
+```bash
+graphina -P cpu_usage_percentage
+```
+
+To see all available panels:
+```bash
+graphina
+```
+
 ## Usage
 
 ### 1. Basic Usage with Random Data
 
 ```bash
-# Simple usage with random data
+# Simple usage with random data or interactive panel selection
 graphina
 ```
 
@@ -71,19 +109,22 @@ graphina -t "CPU Usage (faked)" -f blue -b black
 
 ```bash
 # Monitor CPU usage in real-time
-graphina -t 'CPU Usage' -n 1 -F as_percent -e "top -l 1 -n 0 | grep 'CPU usage' | awk '{print \$3+\$5}' | sed 's/%//'"
+graphina -t 'CPU Usage' -n 1 -F as_percent -e "top -l 1 -n 0 | grep 'CPU usage' | awk '{print \$3+\$5}'"
 ```
 
 ### 4. Using Predefined Panels
 
 ```bash
 # Use a predefined panel configuration
-graphina -P cpu
+graphina -P cpu_usage_percentage
 
 # Interactive panel selection
 graphina
 ```
 
+See below under **Panel Configuration** how to setup these panel configurations
+on your system.
+
 ### 5. Custom Data Source
 
 ```ruby
@@ -113,38 +154,6 @@ graph = Graphina::Graph.new(
 graph.start
 ```
 
-## Panel Configuration
-
-Graphina now supports predefined panel configurations. Create a `panels.yml`
-file in your configuration directory (`"$XDG_CONFIG_HOME/graphina"`, usually
-`~/.config/graphina/panels.yml`) to define reusable panel setups:
-
-```yaml
-cpu:
-  title: "CPU Usage (%)"
-  interval: 1
-  command: "top -l 1 -n 0 | awk '/^CPU usage:/ { print \$3 + \$5 }'"
-  format_value: as_percent
-  color: '#ff5f00'
-memory:
-  title: "Memory Usage"
-  interval: 1
-  command: "free -b | awk '/^Mem:/ { print \$4 }'"
-  format_value: as_bytes
-  color: '#87d700'
-  color_secondary: '#d7ff00'
-```
-
-To use a specific panel:
-```bash
-graphina -P cpu
-```
-
-To see all available panels:
-```bash
-graphina
-```
-
 ## Command Line Options
 
 ```
@@ -160,8 +169,9 @@ Usage: graphina [OPTIONS]
     -c COLOR      Primary color (default: derived from title)
     -C COLOR      Secondary color (default: derived from primary)
     -F FORMAT     Format function (:as_bytes, :as_hertz, :as_celsius, :as_percent, :as_default, default: :as_default)
+    -P PANEL      Use predefined panel configuration (default: interactive selection)
+    -S CONFIG     Setup panel config (default infers from OS)
     -e COMMAND    External command to execute for data values (default: random data)
-    -P PANEL      Panel name to use from configuration (default: interactive selection)
     -h            this help
 ```
 

data/Rakefile

@@ -20,7 +20,7 @@ GemHadar do
   EOT
   test_dir    'spec'
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble', '.bundle',
-    '.yardoc', 'tags', 'doc'
+    '.yardoc', 'tags', 'doc', 'cscope.out'
   package_ignore '.gitignore', '.contexts', '.github'
 
   readme      'README.md'

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/bin/graphina

@@ -20,6 +20,7 @@ def usage
       -C COLOR      Secondary color (default: derived from primary)
       -F FORMAT     Format function (:as_bytes, :as_hertz, :as_celsius, :as_percent, :as_default, default: :as_default)
       -P PANEL      Use predefined panel configuration (default: interactive selection)
+      -S CONFIG     Setup panel config (default infers from OS)
       -e COMMAND    External command to execute for data values (default: random data)
       -h            this help
 
@@ -37,9 +38,14 @@ def usage
   0
 end
 
-$opts = go 't:n:r:f:b:c:C:F:e:P:h'
+$opts = go 't:n:r:f:b:c:C:F:e:P:S:h'
 
 $opts[?h] and exit usage
+if $opts[?S]
+  setup = Graphina::Setup.new(default_panels_name: $opts[?S])
+  setup.install_default_panels
+  exit
+end
 
 panel = Graphina::Panel.new
 case

data/graphina.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: graphina 0.1.0 ruby lib
+# stub: graphina 0.2.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "graphina".freeze
-  s.version = "0.1.0".freeze
+  s.version = "0.2.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
   s.description = "Gem that provides terminal-based data visualization capabilities, enabling\ndevelopers to create dynamic, real-time graphical displays of numerical data\ndirectly within terminal environments using Unicode characters and ANSI\nstyling.\n".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["graphina".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/graphina.rb".freeze, "lib/graphina/graph.rb".freeze, "lib/graphina/graph/display.rb".freeze, "lib/graphina/graph/display/cell.rb".freeze, "lib/graphina/graph/formatters.rb".freeze, "lib/graphina/graphina_config.rb".freeze, "lib/graphina/panel.rb".freeze, "lib/graphina/panel/chooser.rb".freeze, "lib/graphina/version.rb".freeze]
-  s.files = ["Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/graphina".freeze, "graphina.gemspec".freeze, "lib/graphina.rb".freeze, "lib/graphina/graph.rb".freeze, "lib/graphina/graph/display.rb".freeze, "lib/graphina/graph/display/cell.rb".freeze, "lib/graphina/graph/formatters.rb".freeze, "lib/graphina/graphina_config.rb".freeze, "lib/graphina/panel.rb".freeze, "lib/graphina/panel/chooser.rb".freeze, "lib/graphina/version.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/graphina.rb".freeze, "lib/graphina/graph.rb".freeze, "lib/graphina/graph/display.rb".freeze, "lib/graphina/graph/display/cell.rb".freeze, "lib/graphina/graph/formatters.rb".freeze, "lib/graphina/graphina_config.rb".freeze, "lib/graphina/panel.rb".freeze, "lib/graphina/panel/chooser.rb".freeze, "lib/graphina/setup.rb".freeze, "lib/graphina/version.rb".freeze]
+  s.files = [".utilsrc".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/graphina".freeze, "graphina.gemspec".freeze, "img/graphina.png".freeze, "lib/graphina.rb".freeze, "lib/graphina/graph.rb".freeze, "lib/graphina/graph/display.rb".freeze, "lib/graphina/graph/display/cell.rb".freeze, "lib/graphina/graph/formatters.rb".freeze, "lib/graphina/graphina_config.rb".freeze, "lib/graphina/panel.rb".freeze, "lib/graphina/panel/chooser.rb".freeze, "lib/graphina/panel/defaults/x86_64-darwin.yml".freeze, "lib/graphina/panel/defaults/x86_64-linux.yml".freeze, "lib/graphina/setup.rb".freeze, "lib/graphina/version.rb".freeze]
   s.homepage = "https://github.com/flori/graphina".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "Graphina - Gem for creating terminal-based data visualizations with real-time\ngraphical displays using Unicode characters and ANSI styling.\n".freeze, "--main".freeze, "README.md".freeze]

data/lib/graphina/graph/formatters.rb

@@ -62,7 +62,7 @@ class Graphina::Graph
     #
     # @return [ String ] the temperature value formatted with a degree Celsius symbol
     def as_celsius(value)
-      "#{value}°"
+      "#{value}℃"
     end
 
     # The as_percent method formats a numeric value as a percentage string

data/lib/graphina/panel/defaults/x86_64-darwin.yml

@@ -0,0 +1,35 @@
+cpu_usage_percentage:
+  title: "CPU Usage (%)"
+  interval: 1
+  command: |
+    top -l 1 -n 0 | awk '/^CPU usage:/ { printf "%.1f", $3 + $5 }'
+  format_value: as_percent
+  color: '#fe8019'
+cpu_temperature:
+  title: "CPU Temperature (℃) "
+  interval: 1
+  command: |
+    osx-cpu-temp -C | tr -dc '0-9.'
+  format_value: as_celsius
+  color: '#fb4934'
+cpu_clock_average:
+  title: "CPU Clock Speed (MHz)"
+  interval: 1
+  command: |
+    sudo bash -c 'powermetrics --show-usage-summary -s cpu_power & pid=$!; sleep 1; kill $pid'| awk '/CPU Average/ { count++; gsub(/.*\(/, ""); gsub(/\ .*/, ""); sum += $0 } END { if (count > 0) { print 1000000*sum/count } else { print 0 } }'
+  format_value: as_hertz
+  color: '#b8bb26'
+memory_usage:
+  title: "Memory Usage"
+  interval: 1
+  command: |
+    free -b | awk '/^Mem:/ { print $4 }'
+  format_value: as_bytes
+  color: '#689d6a'
+memory_usage_percentage:
+  title: "Memory Usage (%)"
+  interval: 1
+  command: |
+    free -b | awk '/^Mem:/ { printf "%.1f", 100 * $4 / $2 }'
+  format_value: as_percent
+  color: '#689d6a'

data/lib/graphina/panel/defaults/x86_64-linux.yml

@@ -0,0 +1,35 @@
+cpu_usage_percentage:
+  title: "CPU Usage (%)"
+  interval: 1
+  command: |
+    top -b -n 1 | awk '/^%Cpu\(s\)/ { print $2 + $4 + $6 }'
+  format_value: as_percent
+  color: '#fe8019'
+cpu_temperature:
+  title: "CPU Temperature (℃) "
+  interval: 1
+  command: |
+    sensors | awk '/^Tctl:/ { print $2 }' | tr -dc '0-9.'
+  format_value: as_celsius
+  color: '#fb4934'
+cpu_clock_average:
+  title: "CPU Clock Speed (MHz)"
+  interval: 1
+  command: |
+    awk '/cpu MHz/ {sum += $4; count++} END {if (count > 0) print 1000000 * sum/count}' /proc/cpuinfo
+  format_value: as_hertz
+  color: '#b8bb26'
+memory_usage:
+  title: "Memory Usage"
+  interval: 1
+  command: |
+    free -b | awk '/^Mem:/ { print $3 }'
+  format_value: as_bytes
+  color: '#689d6a'
+memory_usage_percentage:
+  title: "Memory Usage (%)"
+  interval: 1
+  command: |
+    free -b | awk '/^Mem:/ { printf \"%.1f\", 100 * $3 / $2 }'
+  format_value: as_percent
+  color: '#689d6a'

data/lib/graphina/setup.rb

@@ -0,0 +1,112 @@
+require 'fileutils'
+
+# A class that handles the setup and configuration of Graphina
+#
+# The Setup class provides functionality for installing default panel
+# configurations into the user's configuration directory. It manages the
+# detection of platform-specific default configurations and facilitates the
+# copying of these configurations to the appropriate location for use with the
+# Graphina application
+#
+# @example
+#   setup = Graphina::Setup.new(default_panels_name: 'c64-linux')
+#   setup.install_default_panels
+class Graphina::Setup
+  include FileUtils::Verbose
+
+  # The initialize method sets up a Setup instance with the specified default
+  # panel name
+  #
+  # This method configures a new setup object with a default panel name,
+  # handling the special case where the name is 'default' by setting it to nil
+  # instead
+  #
+  # @param default_panels_name [ String ] the name of the default panels to use
+  #
+  # @return [ Graphina::Setup ] returns the initialized Setup instance
+  def initialize(default_panels_name:)
+    default_panels_name == 'default' and default_panels_name = nil
+    @default_panels_name = default_panels_name
+  end
+
+  # The infer_default_panels_path_from_platform method attempts to determine
+  # the appropriate default panel configuration file path based on the current
+  # platform
+  #
+  # This method checks the RUBY_PLATFORM environment variable to identify
+  # whether the system is running on an x86_64 Darwin (macOS) or x86_64 Linux
+  # platform
+  #
+  # @return [ Pathname, nil ] returns a Pathname object pointing to the
+  #   detected default panels configuration file if the platform is supported and
+  #   the file exists, or nil if the platform is not supported or the file does
+  #   not exist
+  def infer_default_panels_path_from_platform
+    case RUBY_PLATFORM
+    when /\Ax86_64-darwin/, /\Ax86_64-linux/
+      path = default_panels_path($&)
+      if path.exist?
+        path
+      end
+    else
+      STDERR.puts "Default panel configuration cannot be inferred for platform!"
+      nil
+    end
+  end
+
+  # The default_panels_path method constructs and returns a Pathname object
+  # for a default panels configuration file
+  #
+  # This method takes a panel name parameter and uses it to build a file path
+  # pointing to a default panels configuration file
+  # located in the panel defaults directory. It checks if the constructed path
+  # exists and returns it if so, or nil if the file doesn't exist
+  #
+  # @param panels_name [ String ] the name of the panels configuration to look up
+  #
+  # @return [ Pathname, nil ] a Pathname object pointing to the default panels
+  #   configuration file if it exists, or nil if it doesn't exist
+  def default_panels_path(panels_name)
+    path = Pathname.new(__FILE__).dirname + 'panel' + 'defaults' + (panels_name + '.yml')
+    if path.exist?
+      path
+    end
+  end
+
+  # The panels_path_exist? method checks whether the panel configuration file
+  # path exists in the user's configuration directory
+  #
+  # This method verifies the existence of the panels configuration file by
+  # querying the predefined path in the Graphina configuration module
+  #
+  # @return [ Boolean ] true if the panels configuration file exists at the
+  #   expected location, false otherwise
+  def panels_path_exist?
+    Graphina::GraphinaConfig::PANELS_PATH.exist?
+  end
+
+  # The install_default_panels method installs default panel configurations
+  # into the user's configuration directory
+  #
+  # This method checks if a panel configuration file already exists in the
+  # user's configuration directory and, if not, attempts to determine the
+  # appropriate default panel configuration based on the platform or the
+  # specified default panel name, then copies the default configuration file to
+  # the user's configuration directory
+  def install_default_panels
+    if panels_path_exist?
+      STDOUT.print "#{Graphina::GraphinaConfig::PANELS_PATH.to_s.inspect} exists. Overwrite (y/n)? "
+      STDIN.gets !~ /\Ay/i and return
+    end
+    default_path = @default_panels_name ?
+      default_panels_path(@default_panels_name) :
+      infer_default_panels_path_from_platform
+    if default_path
+      mkdir_p Graphina::GraphinaConfig::CONFIG_DIR
+      cp default_path, Graphina::GraphinaConfig::PANELS_PATH
+      STDOUT.puts "Default panels from #{default_path.to_s.inspect} have been installed."
+    else
+      STDERR.puts "Default panels for #{@default_panels_name.inspect} could not be installed."
+    end
+  end
+end

data/lib/graphina/version.rb

@@ -1,6 +1,6 @@
 module Graphina
   # Graphina version
-  VERSION         = '0.1.0'
+  VERSION         = '0.2.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/graphina.rb

@@ -13,6 +13,7 @@ require 'tins'
 module Graphina
 end
 require 'graphina/version'
+require 'graphina/setup'
 require 'graphina/graphina_config'
 require 'graphina/panel'
 require 'graphina/graph'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: graphina
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Florian Frank
@@ -132,8 +132,10 @@ extra_rdoc_files:
 - lib/graphina/graphina_config.rb
 - lib/graphina/panel.rb
 - lib/graphina/panel/chooser.rb
+- lib/graphina/setup.rb
 - lib/graphina/version.rb
 files:
+- ".utilsrc"
 - Gemfile
 - LICENSE
 - README.md
@@ -141,6 +143,7 @@ files:
 - VERSION
 - bin/graphina
 - graphina.gemspec
+- img/graphina.png
 - lib/graphina.rb
 - lib/graphina/graph.rb
 - lib/graphina/graph/display.rb
@@ -149,6 +152,9 @@ files:
 - lib/graphina/graphina_config.rb
 - lib/graphina/panel.rb
 - lib/graphina/panel/chooser.rb
+- lib/graphina/panel/defaults/x86_64-darwin.yml
+- lib/graphina/panel/defaults/x86_64-linux.yml
+- lib/graphina/setup.rb
 - lib/graphina/version.rb
 homepage: https://github.com/flori/graphina
 licenses: