nautilfer 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fc027969725b3e916bbfebc596676e05d3c0a698f182a5838ede547da8b016a
-  data.tar.gz: 531ea3a97fae61b2c7ee5f1958861f7e997daca78e9fe4fda76aeb95015a5672
+  metadata.gz: f026890d209390f607032ea3ac7f6c30375600b711f2377c3df67b68bbd050e7
+  data.tar.gz: 943ed91b71baaa172ba03f7e861ccf41f65ecdd18ecdeec511cf4d26f0592ad2
 SHA512:
-  metadata.gz: e57b2c398f43fc49ec46f6ae5ef014641bdaa1b6debcb2905d89971010420f9e4e8413c1fe9fe55268e533786e9dfb6beccc2d38a01dd2bbb35a885246462981
-  data.tar.gz: 7be68f6112a193024924eb3069e8659a02daa63da94475035b1cf44b4f9e29bcfb082eeebe7cc1dc98e2d5b8acd4c4f3738b586230b8a2d3e49ff9b7371e1c25
+  metadata.gz: 580405d5b98669d458560cc4a84abb99501eaed169eebfad4a0a27ff2496055125534379dbc5c144ddd76a30f96d3d17a73605493ccea3a8404d77a36ebcd37e
+  data.tar.gz: 46500be06ccc88b586feddc3cad131bbe5ea9701be8df3a4ff67f9ad73d7b12dab6c1b8eeea9ee1bc51a654586f1dddd17aca9378aa8d7ab7e5de781889ff744

data/README.md

@@ -74,6 +74,50 @@ slack_notifier = Nautilfer.new(endpoint: "#{slack_webhook_url}", adapter: :slack
 slack_notifier.notify("Deployment completed")
 ```
 
+### Control notifications by environment
+
+Use the environment controls to avoid sending notifications in non-production environments. The notifier checks the `environment` you pass in (defaulting to `ENV['NAUTILFER_ENV']`, `ENV['RAILS_ENV']`, or `ENV['RACK_ENV']`) and will only send messages when the environment is allowed.
+
+Enable notifications only in specific environments:
+
+```ruby
+Nautilfer.to_teams(
+  message: "Release deployed",
+  endpoint: "#{workflow_endpoint}",
+  environment: 'production',
+  enabled_environments: ['production']
+)
+```
+
+Or disable notifications for certain environments:
+
+```ruby
+Nautilfer.to_slack(
+  message: "Smoke tests running",
+  endpoint: "#{slack_webhook_url}",
+  environment: 'test',
+  disabled_environments: ['test', 'development']
+)
+```
+
+### Configure defaults once
+
+Persist your environment preferences by configuring defaults up front. New instances and helper calls will reuse these values unless you override them per call.
+
+```ruby
+Nautilfer.configure do |config|
+  config.environment = ENV['NAUTILFER_ENV']
+  config.enabled_environments = ['production']
+  config.disabled_environments = ['test']
+end
+
+notifier = Nautilfer.new(endpoint: "#{workflow_endpoint}", adapter: :teams)
+notifier.notify("Deployment finished")
+
+# Helpers will also reuse the configured defaults
+Nautilfer.to_slack(message: "Deployment finished", endpoint: "#{slack_webhook_url}")
+```
+
 ## Chatwork Notification Integration
 
 To enable Chatwork notifications, configure the API token and room ID:

data/lib/nautilfer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Nautilfer
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/lib/nautilfer.rb

@@ -8,27 +8,78 @@ require "uri"
 class Nautilfer
   class Error < StandardError; end
 
-  def initialize(endpoint:, adapter: :teams)
+  class Configuration
+    attr_accessor :environment, :enabled_environments, :disabled_environments
+
+    def initialize
+      @enabled_environments = []
+      @disabled_environments = []
+    end
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+
+  def self.reset_configuration!
+    @configuration = Configuration.new
+  end
+
+  def initialize(endpoint:, adapter: :teams, environment: nil, enabled_environments: nil, disabled_environments: nil)
+    config = self.class.configuration
+
     @endpoint = URI.parse(endpoint)
     @adapter = adapter
+    @environment = environment || config.environment || ENV['NAUTILFER_ENV'] || ENV['RAILS_ENV'] || ENV['RACK_ENV']
+    @enabled_environments = normalize_env_list(enabled_environments, config.enabled_environments)
+    @disabled_environments = normalize_env_list(disabled_environments, config.disabled_environments)
   end
 
   def notify(message)
+    return if notifications_disabled?
+
     payload, headers = build_payload(message)
     perform_request(payload, headers)
   end
 
-  def self.to_teams(message:, endpoint:)
-    new(endpoint: endpoint, adapter: :teams).notify(message)
+  def self.to_teams(message:, endpoint:, environment: nil, enabled_environments: nil, disabled_environments: nil)
+    new(
+      endpoint: endpoint,
+      adapter: :teams,
+      environment: environment,
+      enabled_environments: enabled_environments,
+      disabled_environments: disabled_environments
+    ).notify(message)
   end
 
-  def self.to_slack(message:, endpoint:)
-    new(endpoint: endpoint, adapter: :slack).notify(message)
+  def self.to_slack(message:, endpoint:, environment: nil, enabled_environments: nil, disabled_environments: nil)
+    new(
+      endpoint: endpoint,
+      adapter: :slack,
+      environment: environment,
+      enabled_environments: enabled_environments,
+      disabled_environments: disabled_environments
+    ).notify(message)
   end
 
   private
 
-  attr_reader :endpoint, :adapter
+  attr_reader :endpoint, :adapter, :environment, :enabled_environments, :disabled_environments
+
+  def normalize_env_list(custom_value, configured_value)
+    Array(custom_value.nil? ? configured_value : custom_value).compact
+  end
+
+  def notifications_disabled?
+    return true if disabled_environments.include?(environment)
+    return false if enabled_environments.empty?
+
+    !enabled_environments.include?(environment)
+  end
 
   def build_payload(message)
     case adapter

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nautilfer
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Yusuke Abe
 bindir: exe
 cert_chain: []
-date: 2025-11-11 00:00:00.000000000 Z
+date: 2025-11-16 00:00:00.000000000 Z
 dependencies: []
 description: Nautilfer provides a robust and flexible way to send notifications to
   Microsoft Teams using workflow integrations.
@@ -23,7 +23,6 @@ files:
 - CODE_OF_CONDUCT.md
 - Dockerfile
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile

data/Gemfile.lock

@@ -1,74 +0,0 @@
-PATH
-  remote: .
-  specs:
-    nautilfer (0.3.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    ast (2.4.2)
-    bigdecimal (3.1.8)
-    crack (1.0.0)
-      bigdecimal
-      rexml
-    diff-lcs (1.5.1)
-    hashdiff (1.1.1)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
-    parallel (1.26.3)
-    parser (3.3.4.2)
-      ast (~> 2.4.1)
-      racc
-    public_suffix (6.0.1)
-    racc (1.8.1)
-    rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.9.2)
-    rexml (3.4.2)
-    rspec (3.13.0)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.66.0)
-      json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.4, < 3.0)
-      rubocop-ast (>= 1.32.1, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.32.1)
-      parser (>= 3.3.1.0)
-    ruby-progressbar (1.13.0)
-    unicode-display_width (2.5.0)
-    webmock (3.23.1)
-      addressable (>= 2.8.0)
-      crack (>= 0.3.2)
-      hashdiff (>= 0.4.0, < 2.0.0)
-
-PLATFORMS
-  ruby
-  x86_64-linux
-
-DEPENDENCIES
-  nautilfer!
-  rake (~> 13.0)
-  rspec (~> 3.0)
-  rubocop (~> 1.21)
-  webmock (~> 3.23)
-
-BUNDLED WITH
-   2.7.1