zae 0.8.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7107716877c5697e0ad9e7d25ee266a8e22b8c6914b580398bbcca712c1a3f70
+  data.tar.gz: fea4655d21aaf270a3a554f436ef430bb7d8f2121cc4412e5e03e53632365c64
+SHA512:
+  metadata.gz: ca8aa654b9a5e689640b1e5c14f919f6c12b6b8f7728516cc5bd8daba75f8a6a0b0372be967556dc76abf6b56717f248b4dac5bac5af4c207ef000f2e3937c2c
+  data.tar.gz: b6002c33b403a78322abf47c57b30785b15ef2c6d9b3fbbfef92fec44cfb94518add7e506545c65530f088f955dbcc125e05953e638988732fa80990b95945bd

data/exe/zae

@@ -0,0 +1,113 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/zae'
+
+require 'gli'
+
+# Cli main parser
+class Cli
+  extend GLI::App
+
+  # cli options
+  subcommand_option_handling :normal
+  arguments :strict
+
+  # information
+  program_desc 'a handy runner of distributions packages manager commands. '
+  version Zae::VERSION
+
+  # commands base
+  COMMANDS = Zae::Commands.new
+
+  desc 'install package(s) from repositories'
+  arg_name 'package(s) name'
+  command :install do |c|
+    c.arg 'arguments'
+    c.action do |_, _, args|
+      p COMMANDS.install args
+    end
+  end
+
+  desc 'remove one or more installed packages'
+  arg_name 'package(s) name'
+  command :remove do |c|
+    c.action do |_, _, args|
+      COMMANDS.remove args
+    end
+  end
+
+  desc 'search for matching packages of term'
+  arg_name 'package name'
+  command :search do |c|
+    c.action do |_, _, args|
+      COMMANDS.search args
+    end
+  end
+
+  desc 'update database'
+  arg_name ''
+  command :update do |c|
+    c.action do
+      COMMANDS.update
+    end
+  end
+
+  desc 'upgrade packages'
+  arg_name ''
+  command :upgrade do |c|
+    c.arg 'arguments'
+    c.action do
+      COMMANDS.upgrade
+    end
+  end
+
+  desc 'auto remove system residual packages dependencies'
+  arg_name ''
+  command :autoremove do |c|
+    c.action do |_, _, args|
+      COMMANDS.autoremove args
+    end
+  end
+
+  desc 'download package binary'
+  arg_name 'package name'
+  command :download do |c|
+    c.action do |_, _, args|
+      COMMANDS.download args
+    end
+  end
+
+  desc 'list installed packages'
+  arg_name ''
+  command :installed do |c|
+    c.action do |_, _, args|
+      COMMANDS.installed args
+    end
+  end
+
+  desc 'view info about a specific package'
+  arg_name 'package name'
+  command :info do |c|
+    c.action do |_, _, args|
+      COMMANDS.info args
+    end
+  end
+
+  desc 'fix system package manager issues'
+  arg_name 'packages'
+  command :fix do |c|
+    c.action do |_, _, args|
+      COMMANDS.fix args
+    end
+  end
+
+  desc 'package manager version'
+  arg_name ''
+  command :fix do |c|
+    c.action do
+      COMMANDS.version
+    end
+  end
+end
+
+exit Cli.run(ARGV)

data/lib/zae/become.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+module Zae
+  # define how command should be run, either to become super user or not.
+  class Become
+    attr_accessor
+
+    SUDO_PATH = Pathname.new('/usr/bin/sudo')
+    DOAS_PATH = Pathname.new('/usr/bin/doas')
+
+    def initialize(action, config)
+      @action = action
+      @config = config
+    end
+
+    def need?
+      return false if @config[:become].nil?
+
+      if @config[:become].key?(@action)
+        true
+      else
+        false
+      end
+    end
+
+    # query which become methods are available on user system
+    def exec
+      if SUDO_PATH.exist?
+        SUDO_PATH
+      elsif DOAS_PATH.exist?
+        DOAS_PATH
+      else
+        'unknown'
+      end
+    end
+  end
+end

data/lib/zae/commands.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Zae
+  # Feature requirement:
+  class Commands
+    # update repository database
+    def update
+      exec :update
+    end
+
+    # upgrade system package(s)
+    def upgrade
+      exec :upgrade
+    end
+
+    def deps
+      exec :deps
+    end
+
+    def autoremove(...)
+      exec(:autoremove, ...)
+    end
+
+    def depends
+      exec :depends
+    end
+
+    def install(...)
+      exec(:install, ...)
+    end
+
+    def installed(...)
+      exec(:installed, ...)
+    end
+
+    def remove(...)
+      exec(:remove, ...)
+    end
+
+    def download(...)
+      exec(:download, ...)
+    end
+
+    def fix(...)
+      exec(:fix, ...)
+    end
+
+    # search for given package
+    def search(...)
+      exec(:search, ...)
+    end
+
+    # provide user with manual information
+    def help
+      exec :help
+    end
+
+    # show package information
+    def show
+      exec :show
+    end
+
+    def info(...)
+      exec(:info, ...)
+    end
+
+    # packager current version
+    def version
+      exec :version
+    end
+
+    private
+
+    def exec(...)
+      print_run = lambda { |cmd|
+        puts "command: #{cmd}"
+        system cmd
+      }
+
+      Translate.new(...)
+               .to_str
+               .yield_self(&print_run)
+    end
+  end
+end

data/lib/zae/config.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+module Zae
+  # Query for configuration files and returns matching ones
+  class Config
+    CFG_FOLDER = Pathname.new(File.join(Dir.home, '.config', 'zae'))
+
+    # package manager found
+    attr_accessor :found
+
+    def initialize
+      @found = discovered || files[executable]
+    end
+
+    # config files folder location
+    def folder
+      xdg_config_folder || CFG_FOLDER
+    end
+
+    # package manager executable location
+    def executable
+      return Pathname.new(discovered[:exec]).basename.to_path.to_sym if discovered?
+
+      # get all availables executables
+      exec = files.each_value.find { |cfg| Config.executable? cfg[:exec] }[:exec]
+      Pathname.new(exec).basename.to_path.to_sym
+    end
+
+    # active package manager executable
+    alias active executable
+
+    # once executable is discovered create a new file w/ its path or name in
+    # $HOME so to avoid probing for it in every startup
+    def discovered
+      exec = folder.join('.discovered').read.chop.to_sym if discovered?
+
+      files[exec] || nil
+    end
+
+    # is there any configuration available?
+    def any?
+      files.any?
+      # - config folder do exist?
+      # - any yaml config file?
+      # - .discovered do exist?
+    end
+
+    private
+
+    # executable exist?
+    def self.executable?(exec)
+      File.executable? exec.to_s
+    end
+
+    # Get all Configuration files
+    def files
+      # return if any?
+
+      {}.tap do |elem|
+        folder.each_child do |file|
+          name = file.sub_ext('').basename.to_s.to_sym
+          elem[name] = load_config(file)
+        end
+      end
+    end
+
+    # once executable is discovered create a new file w/ its path or name in
+    # $HOME to avoid probing everytime run
+    def discovered?
+      folder.join('.discovered').exist?
+    end
+
+    #  when xdg config is set, defaults to it to probe for configuration fiels
+    def xdg_config_folder
+      Pathname.new(File.join(ENV['XDG_CONFIG_HOME'], 'zae')) if ENV['XDG_CONFIG_HOME']
+    end
+
+    # Load file with famous serialization formats
+    def load_config(file)
+      require 'yaml'
+      YAML.load_file(file, symbolize_names: true)
+    end
+  end
+end

data/lib/zae/engage.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Zae
+  # make it so
+  class Engage
+    def commands
+      Commands.new
+    end
+  end
+end

data/lib/zae/translate.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Zae
+  # translate action to final command
+  class Translate
+    def initialize(action, args = [], config = Config.new.found,
+                   become: Become.new(action, config))
+      @args = args
+      @action = action
+
+      @config = config
+      @become = become
+    end
+
+    def to_str
+      cmd = @become.need? ? @config[:become][@action] : @config[:user][@action]
+      command cmd
+    end
+
+    private
+
+    # TODO: raise 'command was not provided' and return if command.nil?
+    # query for final command composition
+    def command(action)
+      executable = @config[:exec]
+
+      [].tap do |el|
+        el << @become.exec if @become.need?
+        el << executable
+        el << action
+      end
+        .+(@args)
+        .join(' ')
+    end
+  end
+end

data/lib/zae/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Zae
+  VERSION = '0.8.3'
+end

data/lib/zae.rb

@@ -0,0 +1,10 @@
+require_relative 'zae/become'
+require_relative 'zae/commands'
+require_relative 'zae/config'
+require_relative 'zae/translate'
+require_relative 'zae/version'
+
+# a handy runner of distributions packages manager commands.
+module Zae
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: zae
+version: !ruby/object:Gem::Version
+  version: 0.8.3
+platform: ruby
+authors:
+- easbarba
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.0.6
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+- !ruby/object:Gem::Dependency
+  name: rufo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.13.0
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.21'
+description: 
+email: 
+executables:
+- zae
+extensions: []
+extra_rdoc_files: []
+files:
+- exe/zae
+- lib/zae.rb
+- lib/zae/become.rb
+- lib/zae/commands.rb
+- lib/zae/config.rb
+- lib/zae/engage.rb
+- lib/zae/translate.rb
+- lib/zae/version.rb
+homepage: https://github.com/easbarba/zae
+licenses:
+- gpl-v3
+metadata:
+  homepage_uri: https://github.com/easbarba/zae
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.5
+signing_key: 
+specification_version: 4
+summary: a handy runner of distributions packages manager commands
+test_files: []