clogs 0.1.0

data/lib/clogs.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "shoes"
+
+require_relative "clogs/log"
+
+# Lacci expects a logging implementation to be plugged in before any Shoes
+# object is built.
+Shoes::Log.instance = Clogs::Log.new
+Shoes::Log.configure_logger(ENV["SCARPE_DEBUG"] ? Shoes::Log::DEFAULT_DEBUG_LOG_CONFIG : Shoes::Log::DEFAULT_LOG_CONFIG)
+
+require_relative "clogs/version"
+require_relative "clogs/ui"
+require_relative "clogs/style"
+require_relative "clogs/painter"
+require_relative "clogs/text"
+require_relative "clogs/paragraph"
+require_relative "clogs/canvas"
+require_relative "clogs/clipboard"
+require_relative "clogs/dialogs"
+require_relative "clogs/drawable"
+
+# Clogs: Shoes, worn over libui.
+#
+# Shoes is _why the lucky stiff's tiny Ruby GUI toolkit. Clogs implements the
+# Shoes drawing and layout model on top of libui, a small cross-platform native
+# widget library, so Shoes programs run on plain CRuby -- no browser engine, no
+# JVM, one small native dependency.
+#
+# The Shoes API itself comes from Lacci, the display-independent half of
+# Scarpe. Clogs is a Lacci *display service*: Lacci owns the DSL and the
+# drawable tree, Clogs owns the pixels. Run an app with:
+#
+#     SCARPE_DISPLAY_SERVICE=clogs ruby my_app.rb
+#
+# or simply `require "clogs"` before `Shoes.app`.
+module Clogs
+  class << self
+    # libui takes a font *family* name and resolves it per platform.
+    def default_font_family
+      @default_font_family ||= case RUBY_PLATFORM
+      when /darwin/ then "Helvetica"
+      when /mingw|mswin/ then "Segoe UI"
+      else "Sans"
+      end
+    end
+
+    attr_writer :default_font_family
+
+    def default_font_size
+      @default_font_size ||= 14
+    end
+
+    attr_writer :default_font_size
+
+    def monospace_font_family
+      @monospace_font_family ||= case RUBY_PLATFORM
+      when /darwin/ then "Monaco"
+      when /mingw|mswin/ then "Consolas"
+      else "Monospace"
+      end
+    end
+
+    attr_writer :monospace_font_family
+  end
+end
+
+require_relative "clogs/drawables/slot"
+require_relative "clogs/drawables/text"
+require_relative "clogs/drawables/shapes"
+require_relative "clogs/drawables/controls"
+require_relative "clogs/drawables/image"
+require_relative "clogs/drawables/misc"
+require_relative "clogs/app"
+require_relative "clogs/display_service"
+require_relative "clogs/lacci_compat"
+
+Shoes::DisplayService.set_display_service_class(Clogs::DisplayService)
+
+# Lacci 0.5.0's builtins (`ask`, `confirm`, `ask_open_file`, ...) always return
+# nil: there is no channel for a display service to answer. Shoes programs very
+# much expect an answer, so Clogs supplies one. Newer Lacci versions have their
+# own response mechanism, and we leave those alone.
+unless Shoes::DisplayService.respond_to?(:consume_builtin_response)
+  module Shoes::Builtins
+    def shoes_builtin(cmd_name, *args)
+      Clogs::App.builtin_response = nil
+      Shoes::DisplayService.dispatch_event("builtin", nil, cmd_name, args)
+      Clogs::App.builtin_response
+    end
+  end
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: clogs
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Hackety Hack contributors
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lacci
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: libui
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: |
+  Clogs runs Shoes programs on plain CRuby using libui, a small
+  cross-platform native widget library. It implements the Shoes drawing and
+  layout model as a display service for Lacci, the display-independent half
+  of Scarpe, so it needs neither a browser engine nor a JVM.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- examples/kitchen_sink.rb
+- lib/clogs.rb
+- lib/clogs/app.rb
+- lib/clogs/canvas.rb
+- lib/clogs/clipboard.rb
+- lib/clogs/dialogs.rb
+- lib/clogs/display_service.rb
+- lib/clogs/drawable.rb
+- lib/clogs/drawables/controls.rb
+- lib/clogs/drawables/image.rb
+- lib/clogs/drawables/misc.rb
+- lib/clogs/drawables/shapes.rb
+- lib/clogs/drawables/slot.rb
+- lib/clogs/drawables/text.rb
+- lib/clogs/lacci_compat.rb
+- lib/clogs/log.rb
+- lib/clogs/painter.rb
+- lib/clogs/paragraph.rb
+- lib/clogs/style.rb
+- lib/clogs/text.rb
+- lib/clogs/ui.rb
+- lib/clogs/version.rb
+homepage: https://github.com/largo/hacketyhack
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/largo/hacketyhack
+  source_code_uri: https://github.com/largo/hacketyhack/tree/main/clogs
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: 'Shoes, worn over libui: a native display service for the Shoes GUI DSL'
+test_files: []