crontinel-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2f623c18fd71a3225917bf9c97efb3325a562ddd6d35264e58031e3b29dba8e2
+  data.tar.gz: 27624c308a624b11536745fcc299bdc7cffbb3838ae43f1af42e5b043dcde00b
+SHA512:
+  metadata.gz: 4307c84a27cca9079cf2d737a2772679ff45a618ac9cebb5f8dfff5c3c547432710664b83ef29efde75e20df1ddc928fa60e0ff653b9da0ff669628f4cd85e3f
+  data.tar.gz: d9b700db533109e35d78f5538971747bc5b645072db40640c48d9273d704b77ecbd1f909827db659b2d8900b08f88ff6c659df0197cb1532aabcc362a6ad48c5

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [0.1.0] - 2026-04-18
+
+- Initial release
+- ActiveJob integration via around_perform
+- Sidekiq server middleware
+- Rails Railtie configuration
+- Minitest test suite

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harun R Rayhan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,82 @@
+# Crontinel Rails
+
+Rails integration for [Crontinel](https://crontinel.com) — open-source monitoring for cron jobs, background workers, and scheduled tasks.
+
+Unlike generic uptime tools, Crontinel knows when a job started but crashed silently, when a queue worker stopped processing, or when a cron fired but did nothing.
+
+## Installation
+
+Add to your `Gemfile`:
+
+```ruby
+gem "crontinel-rails", "~> 0.1"
+gem "crontinel", "~> 0.1"
+```
+
+```bash
+bundle install
+```
+
+## Configuration
+
+Create `config/initializers/crontinel.rb`:
+
+```ruby
+Crontinel.setup do |config|
+  config.api_key = ENV.fetch("CRONTINEL_API_KEY")
+  config.endpoint = "https://app.crontinel.com/api/v1" # optional
+end
+```
+
+Or via environment variables:
+
+```bash
+CRONTINEL_API_KEY=your_key_here
+CRONTINEL_ENDPOINT=https://app.crontinel.com/api/v1  # optional
+```
+
+## ActiveJob Integration
+
+Automatically tracks all ActiveJob.perform_later jobs:
+
+```ruby
+# Just include the module — it wraps around_perform automatically
+class MyJob < ApplicationJob
+  include Crontinel::Rails::ActiveJob
+
+  def perform(*args)
+    # your job work
+  end
+end
+```
+
+## Sidekiq Integration
+
+Automatically tracks Sidekiq jobs via middleware:
+
+```ruby
+# lib/crontinel_rails.rb
+require "crontinel/rails/sidekiq/server_middleware"
+
+Sidekiq.configure_server do |config|
+  config.server_middleware do |chain|
+    chain.add Crontinel::Rails::Sidekiq::ServerMiddleware
+  end
+end
+```
+
+## Manual Tracking
+
+```ruby
+Crontinel.client.task_started(name: "my-cron-job")
+# do work...
+Crontinel.client.task_finished(name: "my-cron-job", duration_ms: 150)
+```
+
+## Supported Rails Versions
+
+Rails 6.1+
+
+## License
+
+MIT © Harun R Rayhan

data/lib/crontinel/rails/active_job.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Crontinel
+  module Rails
+    module ActiveJob
+      extend ActiveSupport::Concern
+
+      included do
+        around_perform do |job, block|
+          client = Crontinel.client rescue nil
+          return block.call unless client
+
+          task_name = "#{job.class.name}-#{job.job_id}"
+          client.task_started(name: task_name)
+
+          start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          begin
+            block.call
+            duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).to_i
+            client.task_finished(name: task_name, duration_ms: duration_ms)
+          rescue => e
+            duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).to_i
+            client.task_failed(name: task_name, error: e.message, duration_ms: duration_ms)
+            raise
+          end
+        end
+      end
+    end
+  end
+end

data/lib/crontinel/rails/engine.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Crontinel
+  module Rails
+    class Engine < ::Rails::Engine
+      isolate_namespace Crontinel::Rails
+
+      config.crontinel = ActiveSupport::OrderedOptions.new
+
+      config.crontinel.api_key = ENV["CRONTINEL_API_KEY"]
+      config.crontinel.endpoint = ENV.fetch("CRONTINEL_ENDPOINT", "https://app.crontinel.com/api/v1")
+      config.crontinel.enabled = true
+      config.crontinel.log_level = :info
+
+      initializer "crontinel.configure_defaults" do |app|
+        next unless app.config.crontinel.enabled
+
+        app.config.crontinel.api_key ||= ENV["CRONTINEL_API_KEY"]
+        app.config.crontinel.endpoint ||= "https://app.crontinel.com/api/v1"
+
+        Crontinel.client(
+          api_key: app.config.crontinel.api_key,
+          endpoint: app.config.crontinel.endpoint
+        )
+      end
+
+      initializer "crontinel.rails.active_job" do
+        ActiveSupport.on_load(:active_job) do
+          include Crontinel::Rails::ActiveJob
+        end
+      end
+
+      initializer "crontinel.rails.sidekiq" do
+        next unless defined?(::Sidekiq) && defined?(::Sidekiq::Middleware)
+
+        Sidekiq.configure_server do |config|
+          config.server_middleware do |chain|
+            chain.add Crontinel::Rails::Sidekiq::ServerMiddleware
+          end
+        end
+      end
+    end
+  end
+end

data/lib/crontinel/rails/railtie.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Crontinel
+  module Rails
+    class Railtie < ::Rails::Railtie
+      config.crontinel = ActiveSupport::OrderedOptions.new
+
+      initializer "crontinel.configure" do |app|
+        api_key = app.config.crontinel.api_key || ENV["CRONTINEL_API_KEY"]
+        Crontinel.configure { |c| c.api_key = api_key } if api_key && defined?(Crontinel)
+      end
+
+      rake_tasks do
+        require "crontinel/rails/tasks"
+      end
+    end
+  end
+end

data/lib/crontinel/rails/sidekiq/server_middleware.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Crontinel
+  module Rails
+    module Sidekiq
+      class ServerMiddleware
+        def call(worker, msg, queue)
+          client = Crontinel.client rescue nil
+          task_name = "#{worker.class.name}-#{msg["jid"]}"
+
+          if client
+            client.task_started(name: task_name)
+          end
+
+          start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          begin
+            yield
+            if client
+              duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).to_i
+              client.task_finished(name: task_name, duration_ms: duration_ms)
+            end
+          rescue => e
+            if client
+              duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).to_i
+              client.task_failed(name: task_name, error: e.message, duration_ms: duration_ms)
+            end
+            raise
+          end
+        end
+      end
+    end
+  end
+end

data/lib/crontinel/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Crontinel
+  module Rails
+    VERSION = "0.1.0"
+  end
+end

data/lib/crontinel-rails.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "crontinel/rails/version"
+require "crontinel/rails/engine"
+require "crontinel/rails/railtie" if defined?(Rails::Railtie)
+
+module Crontinel
+  module Rails
+    autoload :Railtie, "crontinel/rails/railtie"
+    autoload :Middleware, "crontinel/rails/middleware"
+    autoload :ActiveJob, "crontinel/rails/active_job"
+    autoload :Sidekiq, "crontinel/rails/sidekiq"
+  end
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: crontinel-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Harun R Rayhan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: crontinel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+description: |
+  Rails integration for Crontinel — open-source monitoring for cron jobs,
+  background jobs, and scheduled tasks. Works with ActiveJob, Sidekiq, Rescue,
+  and any custom scheduler.
+email:
+- me@harunray.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/crontinel-rails.rb
+- lib/crontinel/rails/active_job.rb
+- lib/crontinel/rails/engine.rb
+- lib/crontinel/rails/railtie.rb
+- lib/crontinel/rails/sidekiq/server_middleware.rb
+- lib/crontinel/rails/version.rb
+homepage: https://crontinel.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://crontinel.com
+  source_code_uri: https://github.com/crontinel/ruby-on-rails
+  changelog_uri: https://github.com/crontinel/ruby-on-rails/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/crontinel/ruby-on-rails/issues
+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.0.3.1
+signing_key: 
+specification_version: 4
+summary: Crontinel integration for Ruby on Rails — monitor cron jobs and background
+  workers
+test_files: []