alm 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31c1dfda6cae9629b240bd083ffc64a68565095c268622b6ecb990e76c220c89
-  data.tar.gz: e2ab3c276039a2086524e18e500873d99b29e71f49ac0c9088cc08dfedd214f3
+  metadata.gz: 5f0966f2e3830ad0633d813fa97e82b3df87a5396e2147fd9255cf01c75768eb
+  data.tar.gz: 8a4269db1f99047e700d1a0940770825d37015f8696bf9648973f94dcdfa502b
 SHA512:
-  metadata.gz: 37ce126b7de676fb89ccc5e03df27ce28c6348e3165f6885865c2b2c63da8d2bdbbfd387b3148d2a886a27d45eb5dab249401ebfced5f0710439b45f7f572daa
-  data.tar.gz: ff456a7d8377eb846e195999966562005b717765e9a618cac0a1cc2855216d4652f94bf7c7b8a1d6815ddde35fdc0d1dad527a3c8f47e0551fb3127d428d4d41
+  metadata.gz: 6bc079b8c3bafc3ebd304c2c75c78a4a04cbe4e502b9171874bf668b8a37a20dfb777472426107db23cd14fd9a5dbd40afee37bf2cb798f03da09d208d4b812d
+  data.tar.gz: d867de2371f06d7e09cc9b8357a65734214cc49926f6aea566b15f2de60be0f64d7d7cead91404ebc139608ca8a736324a934438afb8b78f3cb21c4520ed1582

data/README.md

@@ -1,39 +1,47 @@
-# Alm
+# ALM (Appimage Linux Manager)
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/alm`. To experiment with that code, run `bin/console` for an interactive prompt.
+Alm is a lightweight Ruby CLI tool to manage AppImage files easily by adding or removing them from a user-local directory (`~/.local/appimage`). It automates permission granting and file moving without requiring root access, simplifying the handling of AppImages on Linux systems.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
-Install the gem and add to the application's Gemfile by executing:
+You can install the gem from RubyGems after its release by running:
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+gem install alm
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or add it to your application's Gemfile with:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+bundle add alm
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
+The alm command accepts two main flags:
+
+- ``--add <file>`` - Adds an AppImage file by moving it to ~/.local/appimage, granting it executable permissions automatically.
+
+- ``--remove <file>`` - Removes an AppImage file from the ~/.local/appimage directory.
+
+## Notes
 
-## Development
+The tool creates the directory ``~/.local/appimage`` if it doesn't exist.
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+**No root (sudo) permissions are required** as long as the destination directory is writable by the user.
+
+To run AppImages directly, consider adding ``~/.local/appimage`` to your system PATH:
+
+```bash
+export PATH="$HOME/.local/appimage:$PATH"
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Add this line to your shell config (~/.bashrc, ~/.zshrc, etc.) to persist the change.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/alm.
+Bug reports and pull requests are welcome on GitHub at https://github.com/mvguest/alm.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT)

data/exe/alm

@@ -26,14 +26,14 @@ end
 begin
   parser.parse!
 rescue OptionParser::InvalidOption => e
-  puts "[ERROR | OPT_PARSER] - alm: #{e.message}"
+  puts "\e[31m[ERROR | OPT_PARSER] - alm: #{e.message}\e[0m"
   puts parser
   exit 1
 end
 
 # Post-Processing Verification (PPV)
 unless options[:file]
-  puts "[ERROR | PPV] - alm: No file passed"
+  puts "\e[31m[ERROR | PPV] - alm: No file passed\n\e[0m"
   puts parser
   exit 1
 end
@@ -41,24 +41,35 @@ end
 file = options[:file]
 file_path = File.expand_path(file, Dir.pwd)
 
+appimg_dir = File.expand_path(file, "#{Dir.home}/.local/appimage")
+
 case options[:action]
 when :add
   # ADD VERIFICATION PROCESS
-  avp_verification = Verifications::AVP.process(file_path)
+  avp_verification = Verifications::AVP.process(appimg_dir)
   case avp_verification
   when :AVP_PPR
     Modules::ADD.start([file])
   when :AVP_NEXIST
-    puts "[ERROR | AVP_NEXIST ] - alm: The file #{file} was NOT found in the current directory"
+    puts "\e[31m[ERROR | AVP_NEXIST ] - alm: The file #{file} was NOT found in the current directory\e[0m"
   when :AVP_NAPPIMG
-    puts "[ERROR | AVP_NAPPIMG] - alm: The passed file is NOT an .AppImage file"
+    puts "\e[31m[ERROR | AVP_NAPPIMG] - alm: The passed file is NOT an .AppImage file\e[0m"
   else
-    puts "[ERROR | AVP_FAILED ] - alm: AVP Verification failed unexpectedly."
+    puts "\e[31m[ERROR | AVP_FAILED ] - alm: AVP Verification failed unexpectedly\e[0m"
   end
 when :remove
-  Modules::REMOVE.start([file])
+  # REMOVE VERIFICATION PROCESS
+  rvp_verification = Verifications::RVP.process(file_path)
+  case rvp_verification
+  when :RVP_PPR
+    Modules::REMOVE.start([file])
+  when :RVP_NEXIST
+    puts "\e[31m[ERROR | RVP_NEXIST ] - alm: File #{file} not found in the AppImage directory\e[0m"
+  else
+    puts "\e[31m[ERROR | RVP_FAILED ] - alm: RVP Verification failed unexpectedly\e[0m"
+  end
 else
-  puts "[ERROR | CMD] - alm: No valid action (--add or --remove) provided"
+  puts "\e[31m[ERROR | CMD] - alm: No valid action (--add or --remove) provided\e[0m"
   puts parser
   exit 1
 end

data/lib/alm/modules.rb

@@ -31,11 +31,10 @@ module Modules
         end
 
         if system("mv '#{file_path}' '#{appimg_path}'")
-          puts "\n>>> - alm: #{file_arg} successfully added to #{appimg_path}\n"
+          puts ">>> - alm: #{file_arg} successfully added to #{appimg_path}\n"
         else
           puts "\e[31m[ERROR | RUNTIME_ERROR] - alm: Failed to move #{file_arg} to #{appimg_path}\e[0m"
         end
-
       rescue Errno::EACCES
         puts "\e[31m[ERROR | PERMISSION] - alm: Permission denied while accessing #{appimg_path}\e[0m"
       rescue => e
@@ -53,12 +52,8 @@ module Modules
       file_path = File.join(appimg_path, File.basename(file_arg))
 
       begin
-        if File.exist?(file_path)
-          File.delete(file_path)
-          puts "\n>>> - alm: #{File.basename(file_arg)} successfully removed from #{appimg_path}\n"
-        else
-          puts "\e[31m[ERROR] - alm: File #{File.basename(file_arg)} not found in #{appimg_path}\e[0m"
-        end
+        File.delete(file_path)
+        puts "\n>>> - alm: #{File.basename(file_arg)} successfully removed from #{appimg_path}\n"
       rescue Errno::EACCES
         puts "\e[31m[ERROR | PERMISSION] - alm: Permission denied while trying to delete #{file_path}\e[0m"
       rescue => e

data/lib/alm/verifications.rb

@@ -7,4 +7,11 @@ module Verifications
       :AVP_PPR # Add Verification Process (Positive Process Return)
     end
   end
+
+  class RVP
+    def self.process(path)
+      return :RVP_NEXIST unless File.exist?(path)
+      :RVP_PPR # Remove Verification Process (Positive Process Return)
+    end
+  end
 end

data/lib/alm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Alm
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: alm
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - mvguest