ruflet 0.0.7 → 0.0.9

data/lib/ruflet/cli/templates.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Ruflet
+  module CLI
+    MAIN_TEMPLATE = <<~RUBY
+    require "ruflet"
+    Ruflet.run do |page|
+      page.title = "Counter Demo"
+      count = 0
+      count_text = text(count.to_s, size: 40)
+      page.add(
+        container(
+          expand: true,
+          alignment: Ruflet::MainAxisAlignment::CENTER,
+          content: column(
+            alignment: Ruflet::MainAxisAlignment::CENTER,
+            horizontal_alignment: Ruflet::CrossAxisAlignment::CENTER,
+            children: [
+              text("You have pushed the button this many times:"),
+              count_text
+            ]
+          )
+        ),
+        floating_action_button: fab(
+          icon: Ruflet::MaterialIcons::ADD,
+          on_click: ->(_e) do
+            count += 1
+            page.update(count_text, value: count.to_s)
+          end
+        )
+      )
+    end
+
+    RUBY
+
+    GEMFILE_TEMPLATE = <<~GEMFILE
+      source "https://rubygems.org"
+
+      gem "ruflet_core", ">= 0.0.9"
+      gem "ruflet_server", ">= 0.0.9"
+    GEMFILE
+
+    README_TEMPLATE = <<~MD
+      # %<app_name>s
+
+      Ruflet app.
+
+      ## Setup
+
+      ```bash
+      bundle install
+      ```
+
+      ## Run
+
+      ```bash
+      bundle exec ruflet run main
+      ```
+
+      ## Build
+
+      ```bash
+      bundle exec ruflet build apk
+      bundle exec ruflet build ios
+      ```
+    MD
+  end
+end

data/lib/ruflet/cli/update_command.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module Ruflet
+  module CLI
+    module UpdateCommand
+      include RunCommand
+
+      VALID_UPDATE_PLATFORMS = %w[macos linux windows].freeze
+
+      def command_update(args)
+        options = {
+          web: false,
+          desktop: false,
+          check: false,
+          force: false,
+          platform: nil
+        }
+
+        parser = OptionParser.new do |o|
+          o.on("--web") { options[:web] = true }
+          o.on("--desktop") { options[:desktop] = true }
+          o.on("--check") { options[:check] = true }
+          o.on("--force") { options[:force] = true }
+          o.on("--platform PLATFORM") { |value| options[:platform] = value.to_s.downcase }
+        end
+        parser.parse!(args)
+
+        args.each do |arg|
+          case arg.to_s.downcase
+          when "web"
+            options[:web] = true
+          when "desktop"
+            options[:desktop] = true
+          when "all"
+            options[:web] = true
+            options[:desktop] = true
+          when "check"
+            options[:check] = true
+          else
+            warn "Unknown update target: #{arg}"
+            return 1
+          end
+        end
+
+        platform = options[:platform] || host_platform_name
+        if platform.nil? || !VALID_UPDATE_PLATFORMS.include?(platform)
+          warn "Unsupported or missing platform. Use --platform macos|linux|windows."
+          return 1
+        end
+
+        if !options[:web] && !options[:desktop]
+          options[:web] = true
+          options[:desktop] = true
+        end
+
+        targets = []
+        targets << :web if options[:web]
+        targets << :desktop if options[:desktop]
+
+        return check_client_updates(targets, platform: platform) if options[:check]
+
+        targets.each do |target|
+          root =
+            if target == :web
+              ensure_prebuilt_client(web: true, platform: platform, force: options[:force])
+            else
+              ensure_prebuilt_client(desktop: true, platform: platform, force: options[:force])
+            end
+          unless root
+            warn "Failed to update #{target} client for #{platform}"
+            return 1
+          end
+
+          manifest = read_client_manifest(root)
+          release_label = manifest && manifest["release_tag"] ? manifest["release_tag"] : "unknown release"
+          puts "Updated #{target} client for #{platform} at #{root} (#{release_label})"
+        end
+
+        0
+      end
+
+      private
+
+      def check_client_updates(targets, platform:)
+        root = client_cache_root_for(platform)
+        manifest = read_client_manifest(root)
+
+        puts "Ruflet client cache: #{root}"
+        puts "Platform: #{platform}"
+        puts "Ruflet version: #{ruflet_version}"
+        puts "Release tag: #{manifest && manifest['release_tag'] ? manifest['release_tag'] : 'not installed'}"
+
+        installed = true
+        targets.each do |target|
+          present =
+            if target == :web
+              File.file?(File.join(root, "web", "index.html"))
+            else
+              prebuilt_desktop_present?(root, platform: platform)
+            end
+          installed &&= present
+          puts "#{target}: #{present ? 'installed' : 'missing'}"
+        end
+
+        installed ? 0 : 1
+      end
+    end
+  end
+end

data/lib/ruflet/cli.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+require_relative "cli/templates"
+require_relative "cli/new_command"
+require_relative "cli/flutter_sdk"
+require_relative "cli/run_command"
+require_relative "cli/update_command"
+require_relative "cli/build_command"
+require_relative "cli/extra_command"
+require_relative "version"
+
+module Ruflet
+  module CLI
+    extend self
+    extend NewCommand
+    extend RunCommand
+    extend UpdateCommand
+    extend BuildCommand
+    extend ExtraCommand
+
+    def run(argv = ARGV)
+      command = (argv.shift || "help").downcase
+
+      case command
+      when "version", "-v", "--version"
+        puts version_string
+        0
+      when "create"
+        command_create(argv)
+      when "new", "bootstrap", "init"
+        command_new(argv)
+      when "run"
+        command_run(argv)
+      when "update"
+        command_update(argv)
+      when "debug"
+        command_debug(argv)
+      when "build"
+        command_build(argv)
+      when "devices"
+        command_devices(argv)
+      when "emulators"
+        command_emulators(argv)
+      when "doctor"
+        command_doctor(argv)
+      when "help", "-h", "--help"
+        print_help
+        0
+      else
+        warn "Unknown command: #{command}"
+        print_help
+        1
+      end
+    end
+
+    def print_help
+      puts <<~HELP
+        Ruflet CLI
+
+        Commands:
+          ruflet --version
+          ruflet create <appname>
+          ruflet new <appname>
+          ruflet run [scriptname|path] [--web|--desktop] [--port PORT]
+          ruflet update [web|desktop|all] [--check] [--force] [--platform PLATFORM]
+          ruflet debug [scriptname|path]
+          ruflet build <apk|android|ios|aab|web|macos|windows|linux>
+          ruflet devices
+          ruflet emulators
+          ruflet doctor
+      HELP
+    end
+
+    def bootstrap(path)
+      command_new([path || Dir.pwd])
+      0
+    end
+
+    def version_string
+      "ruflet #{Ruflet::VERSION}"
+    end
+  end
+end

data/lib/ruflet/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ruflet
-  VERSION = "0.0.7" unless const_defined?(:VERSION)
+  VERSION = "0.0.9" unless const_defined?(:VERSION)
 end

data/lib/ruflet_cli.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ruflet/cli"

metadata

@@ -1,93 +1,77 @@
 --- !ruby/object:Gem::Specification
 name: ruflet
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - AdamMusa
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: Ruflet is a library that allows building web, desktop and mobile applications
-  in Ruby without prior experience in frontend development.
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rqrcode
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: ruflet_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+- !ruby/object:Gem::Dependency
+  name: ruflet_server
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+description: Ruflet command line interface for creating, updating, building, and running
+  Ruflet apps.
 email:
 - adammusa2222@gmail.com
-executables: []
+executables:
+- ruflet
 extensions: []
 extra_rdoc_files: []
 files:
 - README.md
-- lib/ruflet.rb
-- lib/ruflet/manifest_compiler.rb
+- bin/ruflet
+- lib/ruflet/cli.rb
+- lib/ruflet/cli/build_command.rb
+- lib/ruflet/cli/extra_command.rb
+- lib/ruflet/cli/flutter_sdk.rb
+- lib/ruflet/cli/new_command.rb
+- lib/ruflet/cli/run_command.rb
+- lib/ruflet/cli/templates.rb
+- lib/ruflet/cli/update_command.rb
 - lib/ruflet/version.rb
-- lib/ruflet_protocol.rb
-- lib/ruflet_protocol/ruflet/protocol.rb
-- lib/ruflet_ui.rb
-- lib/ruflet_ui/ruflet/app.rb
-- lib/ruflet_ui/ruflet/colors.rb
-- lib/ruflet_ui/ruflet/control.rb
-- lib/ruflet_ui/ruflet/dsl.rb
-- lib/ruflet_ui/ruflet/event.rb
-- lib/ruflet_ui/ruflet/icon_data.rb
-- lib/ruflet_ui/ruflet/icons/cupertino/cupertino_icons.rb
-- lib/ruflet_ui/ruflet/icons/cupertino_icon_lookup.rb
-- lib/ruflet_ui/ruflet/icons/material_icon_lookup.rb
-- lib/ruflet_ui/ruflet/icons/material_icons.rb
-- lib/ruflet_ui/ruflet/page.rb
-- lib/ruflet_ui/ruflet/ui/control_factory.rb
-- lib/ruflet_ui/ruflet/ui/control_methods.rb
-- lib/ruflet_ui/ruflet/ui/control_registry.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_action_sheet_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_alert_dialog_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_dialog_action_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_filled_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_navigation_bar_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_slider_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_switch_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/cupertino/cupertino_text_field_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/alert_dialog_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/app_bar_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/bottom_sheet_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/checkbox_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/column_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/container_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/drag_target_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/draggable_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/elevated_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/filled_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/floating_action_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/gesture_detector_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/grid_view_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/icon_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/icon_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/image_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/markdown_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/navigation_bar_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/navigation_bar_destination_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/radio_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/radio_group_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/row_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/snack_bar_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/stack_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/tab_bar_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/tab_bar_view_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/tab_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/tabs_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/text_button_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/text_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/text_field_control.rb
-- lib/ruflet_ui/ruflet/ui/controls/material/view_control.rb
-- lib/ruflet_ui/ruflet/ui/cupertino_control_factory.rb
-- lib/ruflet_ui/ruflet/ui/cupertino_control_methods.rb
-- lib/ruflet_ui/ruflet/ui/cupertino_control_registry.rb
-- lib/ruflet_ui/ruflet/ui/material_control_factory.rb
-- lib/ruflet_ui/ruflet/ui/material_control_methods.rb
-- lib/ruflet_ui/ruflet/ui/material_control_registry.rb
-- lib/ruflet_ui/ruflet/ui/shared_control_forwarders.rb
-- lib/ruflet_ui/ruflet/ui/widget_builder.rb
+- lib/ruflet_cli.rb
 homepage: https://github.com/AdamMusa/Ruflet
 licenses: []
 metadata: {}
@@ -107,5 +91,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.7.2
 specification_version: 4
-summary: Ruflet umbrella package.
+summary: Ruflet command line interface package.
 test_files: []

data/lib/ruflet/manifest_compiler.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "time"
-
-module Ruflet
-  module ManifestCompiler
-    module_function
-
-    def compile_app(app, route: "/")
-      messages = []
-      sender = lambda do |action, payload|
-        messages << { "action" => action, "payload" => payload }
-      end
-
-      page = Ruflet::Page.new(
-        session_id: "manifest",
-        client_details: { "route" => route.to_s.empty? ? "/" : route.to_s },
-        sender: sender
-      )
-
-      app.view(page)
-      page.update
-
-      compacted = compact_messages(messages)
-
-      {
-        "schema" => "ruflet_manifest/v1",
-        "generated_at" => Time.now.utc.iso8601,
-        "route" => page.route || "/",
-        "messages" => compacted
-      }
-    end
-
-    def write_file(path, manifest)
-      File.write(path, JSON.pretty_generate(manifest))
-      path
-    end
-
-    def read_file(path)
-      JSON.parse(File.read(path.to_s))
-    end
-
-    def compact_messages(messages)
-      full_patch_index = nil
-      messages.each_with_index do |message, idx|
-        next unless message["action"] == Ruflet::Protocol::ACTIONS[:patch_control]
-
-        payload = message["payload"] || {}
-        next unless payload["id"] == 1
-
-        patch = payload["patch"]
-        next unless patch.is_a?(Array) && patch.any? { |op| op.is_a?(Array) && op[2] == "views" }
-
-        full_patch_index = idx
-      end
-      return messages if full_patch_index.nil?
-
-      [messages[full_patch_index]]
-    end
-  end
-end

data/lib/ruflet.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-require "thread"
-require "ruflet_protocol"
-require "ruflet_ui"
-
-module Ruflet
-  @run_interceptors = []
-  @run_interceptors_mutex = Mutex.new
-
-  module_function
-
-  def run(entrypoint = nil, host: "0.0.0.0", port: 8550, &block)
-    callback = entrypoint || block
-    raise ArgumentError, "Ruflet.run requires a callable entrypoint or block" unless callback.respond_to?(:call)
-
-    interceptor = @run_interceptors_mutex.synchronize { @run_interceptors.last }
-    if interceptor
-      result = interceptor.call(entrypoint: callback, host: host, port: port)
-      return result unless result == :pass
-    end
-
-    begin
-      require "ruflet_server"
-    rescue LoadError => e
-      raise LoadError, "Ruflet.run requires the 'ruflet_server' gem unless a run interceptor handles execution.", e.backtrace
-    end
-
-    Server.new(host: host, port: port) do |page|
-      callback.call(page)
-    end.start
-  end
-
-  def with_run_interceptor(interceptor)
-    @run_interceptors_mutex.synchronize { @run_interceptors << interceptor }
-    yield
-  ensure
-    @run_interceptors_mutex.synchronize { @run_interceptors.delete(interceptor) }
-  end
-end

data/lib/ruflet_protocol/ruflet/protocol.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-module Ruflet
-  module Protocol
-    ACTIONS = {
-      register_client: 1,
-      patch_control: 2,
-      control_event: 3,
-      update_control: 4,
-      invoke_control_method: 5,
-      session_crashed: 6,
-
-      # Legacy JSON protocol aliases kept for compatibility.
-      register_web_client: "registerWebClient",
-      page_event_from_web: "pageEventFromWeb",
-      update_control_props: "updateControlProps"
-    }.freeze
-
-    module_function
-
-    def pack_message(action:, payload:)
-      [action, payload]
-    end
-
-    def normalize_register_payload(payload)
-      page = payload["page"] || {}
-      {
-        "session_id" => payload["session_id"],
-        "page_name" => payload["page_name"] || "",
-        "route" => page["route"] || "/",
-        "width" => page["width"],
-        "height" => page["height"],
-        "platform" => page["platform"],
-        "platform_brightness" => page["platform_brightness"],
-        "media" => page["media"] || {}
-      }
-    end
-
-    def normalize_control_event_payload(payload)
-      {
-        "target" => payload["target"] || payload["eventTarget"],
-        "name" => payload["name"] || payload["eventName"],
-        "data" => payload["data"] || payload["eventData"]
-      }
-    end
-
-    def normalize_update_control_payload(payload)
-      {
-        "id" => payload["id"] || payload["target"] || payload["eventTarget"],
-        "props" => payload["props"].is_a?(Hash) ? payload["props"] : {}
-      }
-    end
-
-    def register_response(session_id:)
-      {
-        "session_id" => session_id,
-        "page_patch" => {},
-        "error" => nil
-      }
-    end
-  end
-end

data/lib/ruflet_protocol.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "ruflet/version"
-require_relative "ruflet_protocol/ruflet/protocol"

data/lib/ruflet_ui/ruflet/app.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-require_relative "../../ruflet/manifest_compiler"
-
-module Ruflet
-  class App
-    def initialize(host: "0.0.0.0", port: 8550)
-      @host = host
-      @port = port
-    end
-
-    def run
-      manifest_out = ENV["RUFLET_MANIFEST_OUT"].to_s
-      unless manifest_out.empty?
-        route = ENV["RUFLET_MANIFEST_ROUTE"].to_s
-        route = "/" if route.empty?
-        manifest = Ruflet::ManifestCompiler.compile_app(self, route: route)
-        Ruflet::ManifestCompiler.write_file(manifest_out, manifest)
-        puts manifest_out
-        return manifest_out
-      end
-
-      Ruflet.run(host: @host, port: @port) do |page|
-        view(page)
-      end
-    end
-
-    def view(_page)
-      raise NotImplementedError, "#{self.class} must implement #view(page)"
-    end
-  end
-end