starlined 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d9ab3da983ad9f964ebb269a39173a8399167d485d8e01beea227677a9040a8
-  data.tar.gz: fe0167c40eada1ac3944504db6caf3039db6f092a888f64fbb58fa46ce1dc358
+  metadata.gz: '08105cc16591e81bcd8f4b04173b0fb16154753fc2386433760fdc075444d797'
+  data.tar.gz: 2051129391c16c7eec09b2f676b119e7c76307f17c93a7d43213105c98af1f3e
 SHA512:
-  metadata.gz: b121573babef094896871fa3a7542dbef69084616d6ff514314d994ce0aa3309cd5c4fbe1cc3ee34a0339ec42bc386aeeb251f29d04df33f83665869eca4503d
-  data.tar.gz: 9005aeeca2e28607cb2eac4829401e28a2203a4f82d860fb90c2e5a6dc9975eb8a0b5af3d5df648e51d2c763e4dfc08123f1ad2a7d216abc0d098d08b6febe0a
+  metadata.gz: ec265f48d253cdb7bb169aec85e898307d9e4b32c75e46b8edac283fe2aee8c1af437ad6a343c7aaddacd9fd7c828da80dca2d7269f202193ff3155bf9aafb96
+  data.tar.gz: 1edc1a126b7efd1b8dbf7e975c1e1f34e33cd10e0ea02b30692ad5635287c58a46c3f4e60ca243dae9df8d0a257aaaaf85a8bc328c54ae0db180943d176904b0

data/Gemfile

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # especificación del gemspec
 gemspec
 
 group :development do
-  gem "pry"
-  gem "yard"
+  gem 'pry'
+  gem 'yard'
 end

data/README.md

@@ -52,28 +52,11 @@ threads.each(&:join)
 runner.stop
 ```
 
-### animation manipulation/control
-
-```ruby
-animation = Starlined::Animation.new("Processing", steps: 100)
-animation.start
-
-100.times do |i|
-  # do work
-  animation.increment_step
-  animation.add_alias("file_#{i}.txt")
-  sleep 0.1
-  animation.remove_alias("file_#{i}.txt")
-end
-
-animation.stop
-```
-
 ### custom configuration
 
 ```ruby
 Starlined.configure do |config|
-  config.vrbose = true         # show verbose messages
+  config.verbose = true        # show verbose messages
   config.sleep_time = 0.5      # animation speed
   config.msg_ljust = 40        # message padding
 end

data/Rakefile

@@ -1,31 +1,137 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require_relative 'lib/starlined/version'
 
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # rspec not available
+end
 
-desc "Run all examples"
+desc 'Run all examples'
 task :examples do
-  Dir["examples/*.rb"].each do |example|
+  Dir['examples/*.rb'].each do |example|
     puts "\n📝 Running: #{example}"
-    puts "=" * 50
+    puts '=' * 50
     system("ruby #{example}")
-    puts "=" * 50
+    puts '=' * 50
   end
 end
 
-desc "Open an interactive console with the gem loaded"
+desc 'Open an interactive console with the gem loaded'
 task :console do
-  require "pry"
-  require_relative "lib/starlined"
+  require 'pry'
+  require_relative 'lib/starlined'
   include Starlined::Messages
   runner = Starlined::Runner.new
-  puts "Starlined loaded! Available:"
-  puts "  - Messages module included (info, warn, error, success, etc.)"
-  puts "  - runner = Starlined::Runner.new"
-  puts "  - Starlined::Animation"
+  puts 'Starlined loaded! Available:'
+  puts '  - Messages module included (info, warn, error, success, etc.)'
+  puts '  - runner = Starlined::Runner.new'
+  puts '  - Starlined::Animation'
   Pry.start
 end
+
+# Version management tasks
+namespace :version do
+  desc 'Show current version'
+  task :current do
+    puts "Current version: #{Starlined::VERSION}"
+  end
+
+  def bump_version(type)
+    version_file = 'lib/starlined/version.rb'
+    content = File.read(version_file)
+
+    current_version = Starlined::VERSION
+    major, minor, patch = current_version.split('.').map(&:to_i)
+
+    case type
+    when :major
+      new_version = "#{major + 1}.0.0"
+    when :minor
+      new_version = "#{major}.#{minor + 1}.0"
+    when :patch
+      new_version = "#{major}.#{minor}.#{patch + 1}"
+    end
+
+    new_content = content.gsub(/VERSION = ['"]#{Regexp.escape(current_version)}['"]/, "VERSION = '#{new_version}'")
+    File.write(version_file, new_content)
+
+    puts "Version bumped from #{current_version} to #{new_version}"
+    new_version
+  end
+
+  desc 'Bump major version (x.0.0)'
+  task :major do
+    bump_version(:major)
+  end
+
+  desc 'Bump minor version (0.x.0)'
+  task :minor do
+    bump_version(:minor)
+  end
+
+  desc 'Bump patch version (0.0.x)'
+  task :patch do
+    bump_version(:patch)
+  end
+end
+
+# Release tasks
+namespace :release do
+  def release(type)
+    # Bump version
+    puts "📝 Bumping #{type} version..."
+    new_version = nil
+    Rake::Task["version:#{type}"].invoke
+
+    # Reload version
+    load 'lib/starlined/version.rb'
+    new_version = Starlined::VERSION
+
+    # Build gem
+    puts "\n📦 Building gem..."
+    system('gem build starlined.gemspec') or abort('Build failed!')
+
+    # Ask for confirmation before pushing
+    print "\n🚀 Push starlined-#{new_version}.gem to RubyGems? (y/n): "
+    response = STDIN.gets.chomp.downcase
+
+    if response == 'y'
+      puts 'Pushing to RubyGems...'
+      system("gem push starlined-#{new_version}.gem") or abort('Push failed!')
+      puts "\n✅ Successfully released version #{new_version}!"
+    else
+      puts '❌ Push cancelled. Gem built but not pushed.'
+      puts "   You can manually push with: gem push starlined-#{new_version}.gem"
+    end
+  end
+
+  desc 'Release new major version (x.0.0)'
+  task :major do
+    release(:major)
+  end
+
+  desc 'Release new minor version (0.x.0)'
+  task :minor do
+    release(:minor)
+  end
+
+  desc 'Release new patch version (0.0.x)'
+  task :patch do
+    release(:patch)
+  end
+end
+
+# Quick release aliases
+desc 'Release patch version (alias for release:patch)'
+task patch: 'release:patch'
+
+desc 'Release minor version (alias for release:minor)'
+task minor: 'release:minor'
+
+desc 'Release major version (alias for release:major)'
+task major: 'release:major'

data/examples/basic_messages.rb

@@ -19,10 +19,10 @@ sleep(1)
 
 # configurar modo verbose
 Starlined.configure do |config|
-  config.vrbose = true
+  config.verbose = true
 end
 
-vrbose("This verbose message is now visible")
+verbose("This verbose message is now visible")
 sleep(1)
 
 # ejemplo con error (comentado para no salir del programa)

data/lib/starlined/animation.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "colorize"
+require 'colorize'
 
 module Starlined
   class Animation
@@ -17,12 +17,13 @@ module Starlined
       @pos = [0, 1, 2]
       @move = 1
 
-      # manejo de alias
+      # manejo de aliases
       @aliases = []
       @alias_pointer = 0
       @alias_timer = 0
       @alias_semaphore = Mutex.new
 
+      # semáforo para pasos
       @steps_semaphore = Mutex.new
 
       @running = false
@@ -94,13 +95,13 @@ module Starlined
       config = Starlined.configuration
 
       config.stars_range.each do |i|
-        if !@pos.include?(i) # caso: posición vacía
-          stars += ' '
-        elsif i == @pos[1]   # caso: estrella central
-          stars += config.symbol.bold.red
-        else                 # caso: estrellas laterales
-          stars += config.symbol.yellow
-        end
+        stars += if !@pos.include?(i)
+                   ' '
+                 elsif i == @pos[1]
+                   '*'.bold.red
+                 else
+                   '*'.yellow
+                 end
       end
 
       stars
@@ -121,12 +122,12 @@ module Starlined
 
     def current_alias_string
       @alias_semaphore.synchronize do
-        return "" if @aliases.empty?
+        return '' if @aliases.empty?
 
         begin
           @aliases[@alias_pointer].to_s
         rescue NoMethodError, ArgumentError
-          @aliases.first.to_s if @aliases.length > 0
+          @aliases.first.to_s unless @aliases.empty?
         end
       end
     end
@@ -138,8 +139,11 @@ module Starlined
       @pos = @pos.map { |p| (p + @move) % config.stars_range.length }
 
       # cambiar el sentido de movimiento si se toca alguno de los bordes
-      @move = @pos.first == config.stars_range.first ? 1 :
-        @pos.last == config.stars_range.last ? -1 : @move
+      @move = if @pos.first == config.stars_range.first
+                1
+              else
+                @pos.last == config.stars_range.last ? -1 : @move
+              end
     end
 
     def update_alias_timer

data/lib/starlined/configuration.rb

@@ -3,16 +3,15 @@
 module Starlined
   class Configuration
     attr_accessor :sleep_time, :msg_ljust, :extra_rjust, :stars_range,
-                  :vrbose, :clear_line_string, :symbol
+                  :verbose, :clear_line_string
 
     def initialize
       @sleep_time = 0.75
       @msg_ljust = 30
       @extra_rjust = 8
       @stars_range = (0..5).to_a
-      @vrbose = false
+      @verbose = false
       @clear_line_string = "\33[2K"
-      @symbol = '*'
     end
   end
 end

data/lib/starlined/messages.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'colorize'
+require "colorize"
 
 module Starlined
   module Messages
@@ -8,42 +8,41 @@ module Starlined
 
     def error(message = nil, context = nil)
       clear_line
-      output = "\r[#{'FAILED'.red}] #{context || 'Operation failed'}"
+      output = "\r[#{"FAILED".red}] #{context || "Operation failed"}"
       output += " (#{message})" unless message.nil?
       puts output
     end
 
     def info(message)
       clear_line
-      puts "\r[ #{'INFO'.blue} ] #{message}"
+      puts "\r[ #{"INFO".blue} ] #{message}"
     end
 
     def warn(message)
       clear_line
-      puts "\r[ #{'WARN'.yellow} ] #{message}"
+      puts "\r[ #{"WARN".yellow} ] #{message}"
     end
 
     def success(message, time = nil)
       clear_line
-      output = "\r[  #{'OK'.green}  ] #{message}"
+      output = "\r[  #{"OK".green}  ] #{message}"
       if time
-        dots = '.' * [3, 36 - message.length - time.to_s.length].max
+        dots = "." * [3, 36 - message.length - time.to_s.length].max
         output += " #{dots.bold.gray} #{time}s"
       end
       puts output
     end
 
-    def vrbose(message)
-      return unless Starlined.configuration.vrbose
-
+    def verbose(message)
+      return unless Starlined.configuration.verbose
       clear_line
-      puts "\r[#{'VRBOSE'.light_black}] #{message}"
+      puts "\r[#{"VRBOSE".light_black}] #{message}"
     end
 
     def ask(prompt)
       clear_line
-      print "\r[  #{'??'.light_blue}  ] #{prompt}: "
-      $stdin.gets.chomp
+      print "\r[  #{"??".light_blue}  ] #{prompt}: "
+      STDIN.gets.chomp
     end
 
     private

data/lib/starlined/runner.rb

@@ -8,15 +8,14 @@ module Starlined
     attr_reader :animation
 
     def initialize
-      @run_instances = 0
+      @running_instances = 0
       @run_semaphore = Mutex.new
       @animation = nil
     end
 
     def start(message, steps: 0)
-      stop_animation if @animation
+      stop_animation
       @animation = Animation.new(message, steps)
-      @animation
     end
 
     def stop
@@ -26,38 +25,60 @@ module Starlined
       stop_animation
     end
 
-    # Función que se encarga de ejecutar comandos y mostrar animaciones por pantalla.
-    # Utiliza un hilo separado para las animaciones y comprueba el exitcode de los callbacks
-    # para detectar errores. Si se ejecutan múltiples instancias de manera simultánea
-    # (como cuando se ejecutan comandos en paralelo), se utiliza un semáforo para controlar
-    # que no se creen más de un hilo de animación. Si se ejecuta un comando que requiere
-    # permisos de sudo, detecta si necesita contraseña y para la animación según corresponda.
     def run(command, print_err: true, aka: nil, no_count: false)
-      handle_sudo if !!(command =~ /^sudo/)
+      needs_sudo = !!(command =~ /^sudo/)
+
+      execute(
+        -> { Open3.capture3(command) },
+        print_err,
+        aka: aka,
+        no_count: no_count,
+        sudo: needs_sudo
+      )
+    end
 
+    def pass_step
+      start_step
+    end
+
+    private
+
+    def start_step(aka: nil)
       @run_semaphore.synchronize do
         @animation&.add_alias(aka) unless aka.nil?
-        @animation.start if @run_instances.zero? && @animation
-        @run_instances += 1
+
+        @animation.start if @running_instances.zero? && @animation
+        @running_instances += 1
       end
 
-      result = -> { Open3.capture3(command) }.call
+      @running_instances
+    end
 
+    def end_step(aka: nil, no_count: false)
       @run_semaphore.synchronize do
-        @run_instances -= 1
+        @running_instances -= 1
         @animation&.increment_step unless no_count
         @animation&.remove_alias(aka) unless aka.nil?
-        @animation.stop if @run_instances.zero? && @animation
+
+        @animation.stop if @running_instances.zero? && @animation
       end
+    end
+
+    def execute(callback, print_err: true, aka: nil, no_count: false, sudo: false)
+      handle_sudo if sudo
+
+      start_step(aka: aka)
+      result = callback.call
+      end_step(aka: aka, no_count: no_count)
 
       handle_error(result, print_err) unless result.last.success?
 
       result
     end
 
-    private
-
     def stop_animation
+      return unless @animation
+
       @animation&.stop
       @animation = nil
     end
@@ -78,7 +99,7 @@ module Starlined
       result = system('sudo -v')
       raise 'Sudo privileges not granted' unless result
 
-      @animation&.start if @run_instances != 0
+      @animation&.start unless @running_instances.zero?
     end
 
     def handle_error(result, print_err)
@@ -86,9 +107,11 @@ module Starlined
 
       stop_animation
       Messages.error(nil, @animation&.message)
-      puts result[1].empty? ? result[0] : result[1] # stdout si stderr está vacío
 
-      Messages.vrbose("Exit code: #{result.last.exitstatus}")
+      puts result[1] # stderr
+      puts result[0] if result[1].empty? # stdout si stderr está vacío
+
+      Messages.verbose("Exit code: #{result.last.exitstatus}")
       exit 1
     end
   end

data/lib/starlined/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Starlined
-  VERSION = "0.1.2"
+  VERSION = '0.2.0'
 end

data/lib/starlined.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-require 'open3'
-require 'colorize'
+require "open3"
+require "colorize"
 
-require_relative 'starlined/version'
-require_relative 'starlined/configuration'
-require_relative 'starlined/animation'
-require_relative 'starlined/messages'
-require_relative 'starlined/runner'
+require_relative "starlined/version"
+require_relative "starlined/configuration"
+require_relative "starlined/animation"
+require_relative "starlined/messages"
+require_relative "starlined/runner"
 
 module Starlined
   class << self

data/starlined.gemspec

@@ -1,36 +1,36 @@
 # frozen_string_literal: true
 
-require_relative "lib/starlined/version"
+require_relative 'lib/starlined/version'
 
 Gem::Specification.new do |spec|
-  spec.name = "starlined"
+  spec.name = 'starlined'
   spec.version = Starlined::VERSION
-  spec.authors = ["mier"]
-  spec.email = ["ruby@mier.info"]
+  spec.authors = ['mier']
+  spec.email = ['ruby@mier.info']
 
-  spec.summary = "Terminal output utilities with animated progress indicators"
-  spec.homepage = "https://github.com/miermontoto/starlined"
-  spec.license = "CC-NC-BY-4.0"
-  spec.required_ruby_version = ">= 2.6.0"
+  spec.summary = 'Terminal output utilities with animated progress indicators'
+  spec.homepage = 'https://github.com/miermontoto/starlined'
+  spec.license = 'CC-NC-BY-4.0'
+  spec.required_ruby_version = '>= 2.6.0'
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
 
   # especificar qué archivos deben incluirse en el gem
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
   end
-  spec.bindir = "exe"
+  spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
   # dependencias en tiempo de ejecución
-  spec.add_dependency "colorize", ">= 0.8"
+  spec.add_dependency 'colorize', '>= 0.8'
 
   # dependencias de desarrollo
-  spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "rubocop", "~> 1.0"
-  spec.add_development_dependency "simplecov", "~> 0.21"
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 1.0'
+  spec.add_development_dependency 'simplecov', '~> 0.21'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: starlined
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - mier
@@ -101,7 +101,6 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - Gemfile
-- LICENSE.txt
 - README.md
 - Rakefile
 - examples/animated_commands.rb

data/LICENSE.txt

@@ -1 +0,0 @@
-Juan Mier <mier@mier.info>, CC-NC-BY-4.0