rails_api_guard 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff2c4a75442207f09d733b09cb7cbf2cfc81a8837be142485b5e9ca34ad0314e
-  data.tar.gz: 3fc2814cfd88a03b7230e780fa39fea656a7ea93fc757fca1900c32d5f7d9fe5
+  metadata.gz: a7b4d8d394e924a76d3aa00b2fdb2fdf782747545d8ffc2542506bc854ea6a65
+  data.tar.gz: 9dfa228e433502c43df3e0ed50348af2581c73cfa7376d88e1a491310ca8eac5
 SHA512:
-  metadata.gz: 9d3fdc1f9a02bc18d4f7c71050121b572d47c1d9bbed33067c559a821773323b5882ec5a8fac97ed20c6599dc8a1573896fc26a7884a5d1b06d0de73c3ada67a
-  data.tar.gz: eeb6d2a72fead98a52ad278ec089fafdb69897d9fb03f0f4097f56c729297dced6dc76a00a01cf6abd8b73b658852f46c2f632a89fd7d67b1a636c9e6a71e726
+  metadata.gz: dc940368929aa36574ff9fac9326eaf2c2d6a104c42081491bf0552857becbfb5ae9dbe51f2fc63f518f5ad771e59f63ac3ed1c0b8f37fdf20c91de17ca06906
+  data.tar.gz: 94144edae5b36b29d9319d152a1d80b95d524f9e66e9b22d8880805baf74f692e6645cf051e352442a4b698698d7056011d9a0263cafaeed502d75e5c3977791

data/README.md

@@ -1,19 +1,18 @@
 # RailsApiGuard
-Short description and motivation.
 
-## Usage
-How to use my plugin.
+A pluggable, configurable rate limiting middleware for Rails APIs with Redis backend, Slack alerts, and endpoint exclusions.
+
+## 🚀 Installation
 
-## Installation
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "rails_api_guard"
+gem 'rails_api_guard'
 ```
 
 And then execute:
 ```bash
-$ bundle
+$ bundle install
 ```
 
 Or install it yourself as:
@@ -21,8 +20,16 @@ Or install it yourself as:
 $ gem install rails_api_guard
 ```
 
+## Generate the Initializer
+```bash
+rails generate rails_api_guard:install
+```
+
+## Configuration
+Edit `config/initializers/rails_api_guard.rb` to set request limits, expiry time, Slack alerts, and excluded endpoint patterns.
+
 ## Contributing
-Contribution directions go here.
+Contribution directions are yet to add.
 
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/rails_api_guard/generators/install/install_generator.rb

@@ -0,0 +1,15 @@
+require "rails/generators"
+
+module RailsApiGuard
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a RailsApiGuard initializer file."
+
+      def copy_initializer
+        template "rails_api_guard_initializer.rb", "config/initializers/rails_api_guard.rb"
+      end
+    end
+  end
+end

data/lib/rails_api_guard/generators/install/templates/rails_api_guard_initializer.rb

@@ -0,0 +1,41 @@
+# config/initializers/rails_api_guard.rb
+
+# RailsApiGuard configuration initializer
+#
+# This file allows you to customize rate limiting behavior for your Rails API.
+# You can adjust request limits, expiry time, Slack notifications, and exclusion rules
+# for specific endpoints from rate limiting.
+#
+# You can safely add, remove, or modify these settings as per your application needs.
+
+RailsApiGuard.configure do |config|
+  # 🚦 Maximum number of allowed requests within the expiry_time window per IP (or per key)
+  config.limit = 5
+
+  # 🕒 Expiry time (in seconds) for the rate limiting window.
+  # After this time window passes, the request count for an IP or key resets.
+  config.expiry_time = 60
+
+  # 🔔 Slack webhook URL for sending alerts when a client exceeds the rate limit.
+  # Best practice: set this securely via environment variables.
+  config.slack_webhook_url = ENV['SLACK_WEBHOOK_URL']
+
+  # 🚫 List of endpoint patterns to be excluded from rate limiting.
+  #
+  # Supports:
+  # - Exact string paths (e.g. '/healthcheck')
+  # - Wildcard patterns (e.g. '/public/*')
+  # - Regular expressions (must start with '^', e.g. '^/user/\d+/document/\w+$')
+  #
+  # 👉 This list is **fully extendable** — feel free to add any additional paths
+  # or dynamic route patterns you want to bypass the rate limiter.
+  #
+  # Example:
+  # config.excluded_patterns << '/open-api/*'
+  #
+  config.excluded_patterns = [
+    '/healthcheck',
+    '/public/*',
+    '^/user/\\d+/document/\\w+$'
+  ]
+end

data/lib/rails_api_guard/version.rb

@@ -1,3 +1,3 @@
 module RailsApiGuard
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/rails_api_guard.rb

@@ -3,14 +3,17 @@ require "rails_api_guard/engine"
 require "rails_api_guard/middleware/rate_limiter"
 require "rails_api_guard/config"
 require "redis"
+require "rails_api_guard/generators/install/install_generator"
+
 
 module RailsApiGuard
   class << self
     attr_accessor :config
   end
 
+  self.config ||= Config.new
+
   def self.configure
-    self.config ||= Config.new
-    yield(config)
+    yield(config) if block_given?
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_api_guard
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - sugat dhole
@@ -80,8 +80,9 @@ files:
 - config/routes.rb
 - lib/rails_api_guard.rb
 - lib/rails_api_guard/config.rb
-- lib/rails_api_guard/config_manager.rb
 - lib/rails_api_guard/engine.rb
+- lib/rails_api_guard/generators/install/install_generator.rb
+- lib/rails_api_guard/generators/install/templates/rails_api_guard_initializer.rb
 - lib/rails_api_guard/middleware/rate_limiter.rb
 - lib/rails_api_guard/services/exclusion_checker.rb
 - lib/rails_api_guard/services/rate_limit_store.rb
@@ -95,6 +96,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/sudo0809/rails_api_guard
   source_code_uri: https://github.com/sudo0809/rails_api_guard
+  changelog_uri: https://github.com/sudo0809/rails_api_guard/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -103,7 +105,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/rails_api_guard/config_manager.rb

@@ -1,39 +0,0 @@
-require "yaml"
-
-module RailsApiGuard
-  class ConfigManager
-    def self.excluded_patterns
-      config["excluded_patterns"] || []
-    end
-
-    def self.limit
-      config["limit"] || 5
-    end
-
-    def self.expiry_time
-      config["expiry_time"] || 60
-    end
-
-    def self.slack_webhook_url
-      config["slack_webhook_url"]
-    end
-
-    def self.config
-      @config ||= load_config
-    end
-
-    def self.load_config
-      config_file = Rails.root.join("config/rails_api_guard.yml")
-      unless File.exist?(config_file)
-        Rails.logger.warn "⚠️ Rails API Guard config file missing at #{config_file}"
-        return {}
-      end
-
-      YAML.load_file(config_file) || {}
-    end
-
-    def self.reload!
-      @config = load_config
-    end
-  end
-end