kanseishitsu 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25050a62712f4707b8f1b388647b618d7d722fc15f9a7713a6a2b06d504236d6
-  data.tar.gz: adf5c5eba9308caeb08cec65eefa966caf9f9ab6784eeef243d50030be5a0f79
+  metadata.gz: 76738d937dbb0737e7c75c45c902dd5738c5458983747152b8da87a69aa76b3f
+  data.tar.gz: 807fa8f7ac548fac96fcbdbdb447296a882c0213ddaa503878cc38419e59d33a
 SHA512:
-  metadata.gz: 1ec5b00e46746dbf649876030ca6b7825471c2e4d22ea1f8ba5af2ca7adbdc03328ae61be34b74f81537c99aa4cc75be9dcd60425f44a60584ec433121c6f8a2
-  data.tar.gz: 6f89365ab7c0d2cc4d724ec71fae360cc66d70bb94492b209b66dba2cb23f470d22fcb634b7eb1776190774c8aa36ea0131304c9060c35a7e569a69a54f80eda
+  metadata.gz: b14232a69f39ce7ce7454e4b04c9c8c3d1a7c4d229cdeebbb425d8a3a895c14a5388edd982d015f62ea0bf4215aaf3f0063a2cbd51333e14200e0267388e706e
+  data.tar.gz: 88070b3cd9c37891f816d841d118ec7488127849414ce01e23c605b5f60f7d1d48601f1530f9ca436feb63e3c5455c1c8c173774f57dd80fadaecf71258e0ef0

data/bin/login.rb

@@ -0,0 +1,27 @@
+#! /usr/bin/env ruby
+
+# encoding: utf-8
+# frozen_string_literal: false
+
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Copyright Nels Nelson 2024 but freely usable (see license)
+
+# Usage: watch.rb <path> [handler_program_path]
+#
+# Options:
+#         --show-all                   Show watchers
+#     -l, --list                       List launch agent labels
+#     -r, --remove=<label>             Remove a watcher by label
+#
+# Examples:
+#
+# watch.rb ~/Desktop ~/.local/usr/bin/desktop.rb
+# watch.rb --show-all
+# watch.rb --list
+# watch.rb --remove=com.local.desktop
+
+require_relative '../lib/kanseishitsu'
+
+Object.new.extend(Login).main

data/lib/kanseishitsu/launch_agent_manager.rb

@@ -172,7 +172,11 @@ module LaunchAgentManagementInstanceMethods
   def show_all_launch_agents
     Dir.glob(File.join(LAUNCH_AGENTS_DIR_PATH, '*.plist')).map do |plist_path|
       job = parse_plist(plist_path)
-      puts "#{job[:schedule]} #{job[:command]}"
+      if job[:command].empty?
+        puts "@disabled #{plist_path}"
+      else
+        puts "#{job[:schedule]} #{job[:command]}"
+      end
     end
   end
 

data/lib/kanseishitsu/login/argument_parser.rb

@@ -0,0 +1,138 @@
+# encoding: utf-8
+# frozen_string_literal: false
+
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Copyright Nels Nelson 2024 but freely usable (see license)
+
+require 'optparse'
+
+require_relative '../which'
+require_relative '../version'
+
+# Define module Login
+module Login
+  # Define the ArgumentsParser class
+  class ArgumentsParser
+    UNDERSCORE_PATTERN = %r{_}
+    HYPHEN_STRING = '-'.freeze
+    FLAGS = %i[banner show_all list remove verbose].freeze
+    POSITIONAL = %i[watch_path executable_path_with_args].freeze
+    attr_reader :parser, :options
+
+    def initialize(parser = OptionParser.new)
+      @parser = parser
+      @options = {}
+      FLAGS.each { |method_name| self.method(method_name).call }
+    end
+
+    def banner
+      @parser.banner = "Usage: #{File.basename($PROGRAM_NAME)} " \
+        '<watch_path> <executable_path_with_args>'
+      @parser.separator ''
+      @parser.separator 'Options:'
+    end
+
+    def show_all
+      @parser.on('--show-all', 'Show login jobs') do
+        @options[:show_all] = true
+      end
+    end
+
+    def list
+      @parser.on('-l', '--list', 'List login job labels') do
+        @options[:list] = true
+      end
+    end
+
+    def remove
+      @parser.on('-r', '--remove=<label>', 'Remove a login job by label') do |label|
+        @options[:remove] = label
+      end
+    end
+
+    def verbose
+      @options[:log_level] ||= Logger::INFO
+      @parser.on_tail('-v', '--verbose', 'Increase verbosity') do
+        @options[:log_level] -= 1
+      end
+    end
+
+    def version
+      @parser.on_tail('--version', 'Show version') do
+        puts "#{File.basename($PROGRAM_NAME)} version #{Kanseishitsu::VERSION}"
+        exit
+      end
+    end
+
+    def watch_path(args)
+      return if (v = args.shift).nil?
+
+      watch_path = File.expand_path(v)
+      unless File.exist?(watch_path) &&
+          File.directory?(watch_path)
+        message = "Directory not found: #{watch_path}"
+        raise OptionParser::InvalidArgument, message
+      end
+      @options[:watch_path] = [watch_path]
+    end
+
+    def executable_path_with_args(args)
+      executable, *args = args
+      return if executable.nil?
+
+      executable_path = Object.new.extend(Which).which(executable)
+      if executable_path.nil?
+        message = "Executable not found: #{executable_path}"
+        raise OptionParser::InvalidArgument, message
+      end
+      @options[:executable_path_with_args] = [executable_path] + args
+    end
+
+    def demand(arg, positional: false)
+      return @options[arg] unless @options[arg].nil?
+
+      required_arg = if positional then "<#{arg}>"
+      else "--#{arg.to_s.gsub(UNDERSCORE_PATTERN, HYPHEN_STRING)}"
+      end
+      raise OptionParser::MissingArgument, "Required argument: #{required_arg}"
+    end
+
+    def positional!(args)
+      POSITIONAL.each do |opt|
+        self.method(opt).call(args)
+        self.demand(opt, positional: true)
+      end
+    end
+
+    def options?
+      ArgumentsParser::FLAGS.any? { |flag| @options.include?(flag) }
+    end
+
+    def usage!
+      puts @parser
+      exit
+    end
+
+    # rubocop: disable Metrics/MethodLength
+    def self.parse(args = ARGV, _file_path = ARGF, arguments_parser = ArgumentsParser.new)
+      arguments_parser.parser.parse!(args)
+      if !arguments_parser.options? && ARGV.length != 2
+        message = 'A directory and executable handler is required'
+        raise OptionParser::MissingArgument, message
+      elsif !args.empty?
+        arguments_parser.positional!(args)
+      end
+      arguments_parser.options
+    rescue OptionParser::AmbiguousOption => e
+      abort e.message
+    rescue OptionParser::ParseError => e
+      puts e.message
+      arguments_parser.usage!
+    end
+    # rubocop: enable Metrics/MethodLength
+  end
+  # class ArgumentsParser
+end
+# module Login

data/lib/kanseishitsu/plist_parser.rb

@@ -10,60 +10,6 @@ require 'rexml/document'
 
 require_relative 'cron'
 
-# Define the PlistParser class
-# class PlistParser
-#   LOCAL_STRING_XPATH = './string'.freeze
-#   PROGRAM_ARGUMENTS_XPATH =
-#     '//key[text()="ProgramArguments"]/following-sibling::array[1]'.freeze
-#   LABEL_XPATH = '//key[text()="Label"]/following-sibling::*[1]'.freeze
-#   CALENDAR_XPATH = '//key[text()="StartCalendarInterval"]/following-sibling::*[1]'.freeze
-#   SCHEDULE_XPATH_TEMPLATE = './/key[text()="%<key>s"]/following-sibling::integer'.freeze
-#   ON_LOGIN = '@login'.freeze
-
-#   # Parse the Plist file at the given path
-#   def parse(plist_path)
-#     plist = {}
-#     doc = REXML::Document.new(File.read(plist_path))
-#     label = parse_plist_label(doc)
-#     command = parse_program_arguments(doc, label)
-#     cron_schedule = parse_calendar_interval(doc)
-#     plist[:label] = label unless label.nil?
-#     plist[:command] = command unless command.nil?
-#     plist[:schedule] = cron_schedule unless cron_schedule.nil?
-#     plist
-#   end
-
-#   # Parse the label from the Plist file document
-#   def parse_plist_label(doc)
-#     label_element = REXML::XPath.first(doc, LABEL_XPATH)
-#     return nil if label_element.nil?
-
-#     label = label_element.text
-#     return nil if label.empty?
-
-#     label
-#   end
-
-#   # Parse the program arguments from the Plist file document
-#   def parse_program_arguments(doc, label)
-#     program_args_elements = REXML::XPath.match(doc, PROGRAM_ARGUMENTS_XPATH)
-#     program_args = program_args_elements.flat_map do |node|
-#       REXML::XPath.match(node, LOCAL_STRING_XPATH).map(&:text)
-#     end
-#     program_args.empty? ? label : program_args.join(' ')
-#   end
-
-#   # Parse the calendar interval from the Plist file document
-#   def parse_calendar_interval(doc)
-#     intervals = doc.xpath(CALENDAR_XPATH).first
-#     return ON_LOGIN unless intervals
-
-#     Cron::INTERVALS.map do |interval|
-#       intervals.at_xpath(format(SCHEDULE_XPATH_TEMPLATE, key: interval)).text rescue '*'
-#     end.join(' ')
-#   end
-# end
-
 # Define class PlistParser
 class PlistParser
   EMPTY_STRING = ''.freeze

data/lib/kanseishitsu/version.rb

@@ -7,5 +7,5 @@
 # Copyright Nels Nelson 2024 but freely usable (see license)
 
 module Kanseishitsu
-  VERSION = '0.1.1'.freeze
+  VERSION = '0.1.2'.freeze
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: kanseishitsu
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Nels Nelson
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -24,7 +37,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.16.4
-  force_ruby_platform: false
 - !ruby/object:Gem::Dependency
   name: syslog
   requirement: !ruby/object:Gem::Requirement
@@ -39,12 +51,12 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.2
-  force_ruby_platform: false
-description: Simplified LaunchAgents management for macOS. This gem packageprovides
+description: Simplified LaunchAgents management for macOS. This gem package provides
   command-line tools for managing macOS launch agents.
 email: nels@nelsnelson.org
 executables:
 - cron.rb
+- login.rb
 - watch.rb
 extensions: []
 extra_rdoc_files: []
@@ -52,6 +64,7 @@ files:
 - LICENSE.md
 - README.md
 - bin/cron.rb
+- bin/login.rb
 - bin/watch.rb
 - lib/kanseishitsu.rb
 - lib/kanseishitsu/cron.rb
@@ -60,6 +73,7 @@ files:
 - lib/kanseishitsu/launch_agent_constants.rb
 - lib/kanseishitsu/launch_agent_manager.rb
 - lib/kanseishitsu/logging.rb
+- lib/kanseishitsu/login/argument_parser.rb
 - lib/kanseishitsu/plist_parser.rb
 - lib/kanseishitsu/version.rb
 - lib/kanseishitsu/watch.rb
@@ -74,7 +88,6 @@ metadata:
   source_code_uri: https://gitlab.com/nelsnelson/kanseishitsu
   bug_tracker_uri: https://gitlab.com/nelsnelson/kanseishitsu/issues
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -89,8 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.9
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Simplified LaunchAgents management for macOS packaged as a gem.
 test_files: []