script_tracker 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c4624d6b1fc0ede5e5691a6ec4b2ced79513620505434524b9d1d980e93d4ca
-  data.tar.gz: 427a3b57e4fe3436db63864e7a9d323f285c4ad5d1c763c15813a9da92c2d43d
+  metadata.gz: 1035933e320fe159fddb60f9f99e67f3d707250f8e6ba1901460973995df3567
+  data.tar.gz: 203bb6d7a9139e9e9069b0f98017cbe1e682a52c9f7fef67f6ccde5dc503a607
 SHA512:
-  metadata.gz: 776ff4218886ee763f1b93d8212dfae35c68fa2f685f89a2664d642b4934ace4a1a0c3260bd692b7688c3cfc58864dd812329f24161ac91462b5d2ee92cf183a
-  data.tar.gz: 1ce7a1b8dc3b65888dbe2e9117b4cb06b3e31d0ff24f195d2e4bdb66d9b1782a2bd2441df09b66ff2aa4e8cb9ace86068bd0bb5af9c81051b2a90d325f1be7cf
+  metadata.gz: 6a48bc5347dfdb40f412bff93e89a872e6a07756643e705f2f6a49232b5eed14ca742c229254ffd6759142b5444d57d1753d4ef74f2e74bf58d945baa051ed7e
+  data.tar.gz: 71a2e8e39d6a20d0da06517d43f190fe6811ca5164115a2c4171238b6900ecad0bebd2cdf3d93430e4161d171ba68219d0720a3464fba238a592681c813af05f

data/CHANGELOG.md

@@ -7,24 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.3] - 2025-01-17
+
+### Changed
+- Simplified and streamlined README documentation
+- Cleaned up CHANGELOG format
+
+## [0.1.2] - 2025-01-17
+
+### Fixed
+- Updated GitHub Actions workflows to use v4 actions
+- Fixed GitHub release permissions
+- Refactored workflows to match successful gem release pattern
+
+## [0.1.1] - 2025-01-17
+
+### Added
+- CI/CD workflows for automated testing and releases
+- GitHub Actions workflow for automatic releases on tag push
+- Manual release workflow via GitHub Actions UI
+- Local release script (`bin/release`)
+
 ## [0.1.0] - 2025-01-17
 
 ### Added
-- Initial release of ScriptTracker
+- Initial release
 - Script execution tracking with status management
 - Transaction support for script execution
 - Built-in logging and progress tracking
 - Batch processing helpers
 - Timeout support for long-running scripts
 - Stale script cleanup functionality
-- Rake tasks for managing scripts:
-  - `scripts:create` - Create new scripts
-  - `scripts:run` - Run pending scripts
-  - `scripts:status` - View script status
-  - `scripts:rollback` - Rollback scripts
-  - `scripts:cleanup` - Cleanup stale scripts
+- Rake tasks for managing scripts
 - Comprehensive RSpec test suite
-- Full documentation and examples
 
-[Unreleased]: https://github.com/blink-global/script_tracker/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/blink-global/script_tracker/releases/tag/v0.1.0
+[Unreleased]: https://github.com/a-abdellatif98/script_tracker/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/a-abdellatif98/script_tracker/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/a-abdellatif98/script_tracker/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/a-abdellatif98/script_tracker/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/a-abdellatif98/script_tracker/releases/tag/v0.1.0

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Blink
+Copyright (c) 2025 Ahmed Abd El-Latif
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,276 +1,167 @@
 # ScriptTracker
 
-ScriptTracker is a Ruby gem that provides a migration-like system for managing one-off scripts in Rails applications. It tracks script execution history, provides transaction support, and includes built-in logging and progress tracking.
+A Ruby gem that provides a migration-like system for managing one-off scripts in Rails applications with execution tracking, transaction support, and built-in logging.
 
 ## Features
 
-- **Execution Tracking**: Automatically tracks which scripts have been run and their status
-- **Transaction Support**: Wraps script execution in database transactions
-- **Status Management**: Track scripts as success, failed, running, or skipped
-- **Built-in Logging**: Convenient logging methods with timestamps
-- **Batch Processing**: Helper methods for processing large datasets efficiently
-- **Timeout Support**: Configure custom timeouts for long-running scripts
-- **Stale Script Cleanup**: Automatically identify and cleanup stuck scripts
-- **Migration Generator**: Generate timestamped script files with templates
+* **Execution Tracking** - Automatically tracks which scripts have been run and their status
+* **Transaction Support** - Wraps script execution in database transactions
+* **Status Management** - Track scripts as success, failed, running, or skipped
+* **Built-in Logging** - Convenient logging methods with timestamps
+* **Batch Processing** - Helper methods for processing large datasets efficiently
+* **Timeout Support** - Configure custom timeouts for long-running scripts
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add to your Gemfile:
 
 ```ruby
 gem 'script_tracker'
 ```
 
-And then execute:
+Then run:
 
 ```bash
 bundle install
-```
-
-Or install it yourself as:
-
-```bash
-gem install script_tracker
-```
-
-## Setup
-
-1. Install the gem using the generator:
-
-```bash
 rails generate script_tracker:install
-```
-
-This will:
-- Create a migration for the `executed_scripts` table
-- Create the `lib/scripts` directory for your scripts
-
-2. Run the migration:
-
-```bash
 rails db:migrate
 ```
 
-3. (Optional) Configure the scripts directory in an initializer:
-
-```ruby
-# config/initializers/script_tracker.rb
-ScriptTracker.configure do |config|
-  config.scripts_path = Rails.root.join('lib', 'scripts')
-end
-```
-
-## Usage
-
-### Creating a New Script
+## Quick Start
 
-Generate a new script with a descriptive name:
+### Create a Script
 
 ```bash
 rake scripts:create["update user preferences"]
 ```
 
-This creates a timestamped script file in `lib/scripts/`:
+This creates a timestamped script file in `lib/scripts/` :
 
 ```ruby
-# lib/scripts/20231117120000_update_user_preferences.rb
 module Scripts
   class UpdateUserPreferences < ScriptTracker::Base
     def self.execute
-      log "Starting script: update user preferences"
-
-      # Your script logic here
+      log "Starting script"
+      
       User.find_each do |user|
         user.update!(preferences: { theme: 'dark' })
       end
-
-      log "Script completed successfully"
+      
+      log "Script completed"
     end
   end
 end
 ```
 
-### Running Scripts
-
-Run all pending (not yet executed) scripts:
-
-```bash
-rake scripts:run
-```
-
-### Checking Script Status
-
-View the status of all scripts:
-
-```bash
-rake scripts:status
-```
-
-Output:
-```
-Scripts:
-  [SUCCESS] 20231117120000_update_user_preferences.rb (2.5s)
-  [PENDING] 20231117130000_cleanup_old_data.rb
-```
-
-### Rolling Back a Script
-
-Remove a script from execution history (allows it to be run again):
-
-```bash
-rake scripts:rollback[20231117120000_update_user_preferences.rb]
-```
-
-### Cleaning Up Stale Scripts
-
-Mark scripts stuck in "running" status as failed:
+### Run Scripts
 
 ```bash
-rake scripts:cleanup
+rake scripts:run        # Run all pending scripts
+rake scripts:status     # View script status
+rake scripts:rollback[filename]  # Rollback a script
+rake scripts:cleanup    # Cleanup stale scripts
 ```
 
-## Advanced Features
-
-### Skipping Scripts
+## Advanced Usage
 
-Skip a script execution conditionally:
+### Skip Script Conditionally
 
 ```ruby
-module Scripts
-  class ConditionalUpdate < ScriptTracker::Base
-    def self.execute
-      if User.where(needs_update: true).count.zero?
-        skip! "No users need updating"
-      end
-
-      # Your script logic here
-    end
-  end
+def self.execute
+  skip! "No users need updating" if User.where(needs_update: true).count.zero?
+  # Your logic here
 end
 ```
 
 ### Custom Timeout
 
-Override the default 5-minute timeout:
-
 ```ruby
-module Scripts
-  class LongRunningScript < ScriptTracker::Base
-    def self.timeout
-      3600 # 1 hour in seconds
-    end
-
-    def self.execute
-      # Long-running logic here
-    end
-  end
+def self.timeout
+  3600 # 1 hour in seconds
 end
 ```
 
 ### Batch Processing
 
-Process large datasets efficiently:
-
 ```ruby
-module Scripts
-  class ProcessUsers < ScriptTracker::Base
-    def self.execute
-      users = User.where(processed: false)
-
-      process_in_batches(users, batch_size: 1000) do |user|
-        user.update!(processed: true)
-      end
-    end
+def self.execute
+  users = User.where(processed: false)
+  process_in_batches(users, batch_size: 1000) do |user|
+    user.update!(processed: true)
   end
 end
 ```
 
 ### Progress Logging
 
-Track progress during execution:
-
 ```ruby
-module Scripts
-  class DataMigration < ScriptTracker::Base
-    def self.execute
-      total = User.count
-      processed = 0
-
-      User.find_each do |user|
-        # Process user
-        processed += 1
-        log_progress(processed, total) if (processed % 100).zero?
-      end
-    end
+def self.execute
+  total = User.count
+  processed = 0
+  
+  User.find_each do |user|
+    # Process user
+    processed += 1
+    log_progress(processed, total) if (processed % 100).zero?
   end
 end
 ```
 
 ## API Reference
 
-### ScriptTracker::Base
-
-Base class for all scripts.
+### ScriptTracker:: Base
 
 **Class Methods:**
+* `execute` - Implement with your script logic (required)
+* `timeout` - Override to set custom timeout (default: 300 seconds)
+* `skip!(reason)` - Skip script execution
+* `log(message, level: :info)` - Log a message
+* `log_progress(current, total)` - Log progress percentage
+* `process_in_batches(relation, batch_size: 1000, &block)` - Process in batches
 
-- `execute` - Implement this method with your script logic (required)
-- `run` - Execute the script with transaction and error handling
-- `timeout` - Override to set custom timeout (default: 300 seconds)
-- `skip!(reason)` - Skip script execution with optional reason
-- `log(message, level: :info)` - Log a message with timestamp
-- `log_progress(current, total, message = nil)` - Log progress percentage
-- `process_in_batches(relation, batch_size: 1000, &block)` - Process records in batches
+### ScriptTracker:: ExecutedScript
 
-### ScriptTracker::ExecutedScript
+**Scopes:** `successful` , `failed` , `running` , `skipped` , `completed` , `ordered` , `recent_first`
 
-ActiveRecord model for tracking script execution.
+**Class Methods:**
+* `executed?(filename)` - Check if script has been executed
+* `cleanup_stale_running_scripts(older_than: 1.hour.ago)` - Clean up stale scripts
 
-**Scopes:**
+## Rake Tasks
 
-- `successful` - Scripts that completed successfully
-- `failed` - Scripts that failed
-- `running` - Scripts currently running
-- `skipped` - Scripts that were skipped
-- `completed` - Scripts that finished (success or failed)
-- `ordered` - Order by execution time ascending
-- `recent_first` - Order by execution time descending
+* `rake scripts:create[description]` - Create a new script
+* `rake scripts:run` - Run all pending scripts
+* `rake scripts:status` - Show status of all scripts
+* `rake scripts:rollback[filename]` - Rollback a script
+* `rake scripts:cleanup` - Cleanup stale running scripts
 
-**Class Methods:**
+## Releasing
 
-- `executed?(filename)` - Check if a script has been executed
-- `mark_as_running(filename)` - Mark a script as running
-- `cleanup_stale_running_scripts(older_than: 1.hour.ago)` - Clean up stale scripts
+### GitHub Actions (Recommended)
 
-**Instance Methods:**
+1. Go to **Actions** → **Release** workflow
+2. Click **Run workflow**
+3. Enter version number (e.g., `0.1.3`)
 
-- `mark_success!(output, duration)` - Mark as successful
-- `mark_failed!(error, duration)` - Mark as failed
-- `mark_skipped!(output, duration)` - Mark as skipped
-- `success?`, `failed?`, `running?`, `skipped?` - Status predicates
-- `formatted_duration` - Human-readable duration
-- `formatted_output` - Truncated output text
-- `timeout_seconds` - Get timeout value
-- `timed_out?` - Check if script has timed out
-
-## Rake Tasks
+Or push a tag:
 
-- `rake scripts:create[description]` - Create a new script
-- `rake scripts:run` - Run all pending scripts
-- `rake scripts:status` - Show status of all scripts
-- `rake scripts:rollback[filename]` - Rollback a script
-- `rake scripts:cleanup` - Cleanup stale running scripts
+```bash
+git tag -a v0.1.3 -m "Release version 0.1.3"
+git push origin v0.1.3
+```
 
-## Development
+**Required:** Set `RUBYGEMS_AUTH_TOKEN` in GitHub repository secrets.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+### Local Release
 
-To install this gem onto your local machine, run `bundle exec rake install`.
+```bash
+bin/release 0.1.3
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/blink-global/script_tracker.
+Bug reports and pull requests welcome at https://github.com/a-abdellatif98/script_tracker.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+MIT License - see LICENSE file for details.

data/lib/script_tracker/generators/templates/README

@@ -17,6 +17,6 @@ Next steps:
    rake scripts:status
 
 For more information, visit:
-https://github.com/blink-global/script_tracker
+https://github.com/a-abdellatif98/script_tracker
 
 ===============================================================================

data/lib/script_tracker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ScriptTracker
-  VERSION = "0.1.0"
+  VERSION = '0.1.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: script_tracker
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Ahmed Abd El-Latif
@@ -98,7 +98,7 @@ description: ScriptTracker provides a migration-like system for managing one-off
   with execution tracking, transaction support, and built-in logging. Perfect for
   data migrations, cleanup tasks, and administrative scripts.
 email:
-- ahmed.abdelatif@blink.com
+- ahmed.abdelatife@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -117,11 +117,11 @@ files:
 - lib/script_tracker/version.rb
 - tasks/script_tracker.rake
 - templates/script_template.rb
-homepage: https://github.com/blink-global/script_tracker
+homepage: https://github.com/a-abdellatif98/script_tracker
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/blink-global/script_tracker
+  homepage_uri: https://github.com/a-abdellatif98/script_tracker
   source_code_uri: https://github.com/a-abdellatif98/script_tracker
   changelog_uri: https://github.com/a-abdellatif98/script_tracker/blob/main/CHANGELOG.md
 post_install_message:
@@ -139,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: A Ruby gem for tracking and managing one-off script executions in Rails applications