qas 1.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: afc9a95cd6ed2302619ac4f6b3b2faa3c0697ab43b5294aa4e56b3b30e911d00
+  data.tar.gz: bc22a9f7fb23ac3e6ead7b641b9a728c483d36b36f1a96f557065fd1ed376405
+SHA512:
+  metadata.gz: d3e660ed349fd2e51698f908fcb8b3391b5e88ae9bb9d6f2a8bcb0709ddae2883a9095ba93602c473acdb09a843e273957c5a27d214a2d36d76cda7ad876d226
+  data.tar.gz: 113dade5770939ff258ca7f6586bfd92c9e7418085ce9f731fadd1c052cabc8beb41cb19ba498c9b0f5f2489eb6a00a0b3a732b06759434af262a5831ca58f4b

data/exe/qas

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/info'
+require_relative '../lib/qas'
+
+module Cli
+  attr_accessor :action, :args
+
+  def self.options
+    require 'optparse'
+
+    OptionParser.new do |parser|
+      parser.banner = Qas::DESCRIPTION
+
+      parser.on('-v', '--version', 'project information') do
+        print Qas::VERSION
+        exit!
+      end
+
+      parser.on('-g', '--grab', 'grab floss projects') do
+        @action = :grab
+      end
+
+      parser.on('-a', '--archive NAMES', Array, 'archive floss projects listed on NAMES') do |names|
+        @names = names
+        @action = :archive
+      end
+    end
+  end
+
+  def self.start
+    options.parse! ['--help'] if ARGV.empty?
+
+    begin
+      options.parse!
+    rescue OptionParser::MissingArgument
+      puts <<~ERROR
+        --archive NAMES
+
+        Missing NAMES of projects!'
+      ERROR
+      exit!
+    rescue OptionParser::InvalidOption
+      options.parse! ['--help']
+    end
+
+    Qas::Main.new(@action, @names).run
+  end
+end
+
+Cli.start

data/lib/info.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Easily manage floss repositories.
+module Qas
+  VERSION = '1.5.0'
+  DESCRIPTION = 'Easily manage floss repositories.'
+  URL = 'https://github.com/easbarba/qas'
+end

data/lib/qas/archive.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+# TODO: if project is not present, clone it!
+
+module Qas
+  # Archive FLOSS Projects
+  class Archive
+    # Format to be compressed
+    attr_reader :format
+
+    # FLOSS Projects elected to be archived
+    attr_reader :names
+
+    # project
+    attr_reader :project
+
+    # Folder to store compressed projects
+    ARCHIVED = Pathname.new(File.join(Dir.home, 'Downloads', 'archived'))
+
+    def initialize(project, names, fmt = 'tar')
+      @project = project
+      @names = names
+      @format = fmt
+      @fullpath = "#{ARCHIVED.join(project.name)}.#{@format}"
+    end
+
+    # Archiving FLOSS project
+    def archive
+      require 'git'
+
+      Utils.spin(project.name) do
+        repo = Git.open project.folder
+        repo.archive repo.current_branch, @fullpath, format: @format # TODO: fiber/multithread
+      end
+
+      puts # a bit more of space
+    end
+
+    # create archived folder
+    def mkfolder
+      require 'fileutils'
+      FileUtils.mkdir_p ARCHIVED unless ARCHIVED.exist?
+    end
+
+    def info
+      print "#{project.name} > #{@fullpath}"
+    end
+
+    def run
+      return unless names.include? project.name
+
+      mkfolder
+      info
+      archive
+    end
+  end
+end

data/lib/qas/config.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'csv'
+require 'pathname'
+require 'uri'
+
+# TODO: Delay parsing file till just finally needed
+# TODO: Check if file match expect structure
+# TODO: check if file is empty
+
+module Qas
+  # List all config available
+  class Config
+    def parse(file, lang)
+      [].tap do |x|
+        CSV.read(file, headers: true).by_row.each do |project|
+          name = project['name']
+          branch = project['branch']
+          url = URI project['url']
+
+          x << Info.new(name, branch, url, lang.to_s)
+        end
+      end
+    end
+
+    def found
+      files = Pathname.new(File.join(Dir.home, '.config', 'qas'))
+
+      [].tap do |x|
+        # Check if config does not exist if a symlink
+        files.children.each do |y|
+          x << y if y.exist?
+        end
+      end
+    end
+
+    # returns all parsed items
+    def items
+      {}.tap do |x|
+        found.each do |file|
+          lang = file.basename.sub_ext('').to_s.to_sym
+          x[lang] = parse file, lang
+        end
+      end
+    end
+  end
+end

data/lib/qas/grab.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'git'
+
+module Qas
+  # Grab FLOSS Projects
+  class Grab
+    attr_reader :project
+
+    def initialize(project)
+      @project = project
+    end
+
+    def pull
+      Utils.spin(project.name) do
+        repo = Git.open project.folder
+        repo.pull 'origin', repo.current_branch
+      end
+    end
+
+    def clone
+      Utils.spin(project.name) do
+        Git.clone project.url, project.folder
+      end
+    end
+
+    # Cloning/Pulling FLOSS Project
+    def run
+      project.folder.join('.git').exist? ? pull : clone
+    end
+  end
+end

data/lib/qas/info.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+module Qas
+  # Project Information
+  class Info
+    ROOT = Pathname.new(File.join(Dir.home, 'Projects'))
+
+    # project name
+    attr_reader :name
+
+    # project git branch
+    attr_reader :branch
+
+    # project uri
+    attr_reader :url
+
+    # project folder
+    attr_reader :folder
+
+    def initialize(name, branch, url, language)
+      @name = name
+      @branch = branch
+      @url = url
+      @folder = ROOT.join(language, name)
+    end
+
+    def to_s
+      <<~INFO
+        #{name}
+      INFO
+    end
+  end
+end

data/lib/qas/main.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Qas
+  # Main start point
+  class Main
+    class GitMustBeAvailable < StandardError; end
+
+    attr_reader :folders, :utils, :command, :projects
+
+    def initialize(command, names = nil)
+      @command = command
+      @names = names
+    end
+
+    def projects
+      c = Config.new
+      c.items
+    end
+
+    def current_project
+      projects.each do |_, repos|
+        repos.each do |project|
+          yield project if block_given?
+        end
+      end
+    end
+
+    def actions
+      {
+        grab: ->(project) { Grab.new(project) }.curry,
+        archive: ->(project) { Archive.new(project, @names) }.curry
+      }
+    end
+
+    def run
+      raise GitMustBeAvailable, 'Git was not found!' unless Utils.which?('git').any?
+
+      current_project do |project|
+        actions[command].call(project).run
+      end
+    end
+  end
+end

data/lib/qas/utils.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Qas
+  # General Utilities.
+  module Utils
+    # Spin for me, dear.
+    def self.spin(project)
+      require 'tty-spinner'
+
+      spinner = TTY::Spinner.new("#{project} :spinner ", format: :dots_6)
+      spinner.auto_spin
+
+      yield
+
+      spinner.success
+    end
+
+    # prints external executable location
+    def self.which?(executable)
+      require 'pathname'
+
+      [].tap do |x|
+        ENV['PATH'].split(File::PATH_SEPARATOR) do |directory|
+          exec = Pathname.new(directory).join executable.to_s
+
+          x << exec.to_path if exec.file?
+        end
+      end.uniq
+    end
+  end
+end

data/lib/qas.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'qas/archive'
+require_relative 'qas/grab'
+require_relative 'qas/main'
+require_relative 'qas/info'
+require_relative 'qas/config'
+require_relative 'qas/utils'

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: qas
+version: !ruby/object:Gem::Version
+  version: 1.5.0
+platform: ruby
+authors:
+- easbarba
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-05-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+- !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'
+    - - ">="
+      - !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'
+    - - ">="
+      - !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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+- !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
+description: 
+email:
+- easbarba@outlook.com
+executables:
+- qas
+extensions: []
+extra_rdoc_files: []
+files:
+- exe/qas
+- lib/info.rb
+- lib/qas.rb
+- lib/qas/archive.rb
+- lib/qas/config.rb
+- lib/qas/grab.rb
+- lib/qas/info.rb
+- lib/qas/main.rb
+- lib/qas/utils.rb
+homepage: https://github.com/easbarba/qas
+licenses:
+- gpl-v3
+metadata:
+  homepage_uri: https://github.com/easbarba/qas
+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: Easily manage floss repositories.
+test_files: []