foghorn-logger 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 615404bf7ff107b827f75138fadaf00500525c06620a69e94f6e4ab1a2b3390a
+  data.tar.gz: d893624c31ee5c54c4a4df388ce55ef3736873bcb6ec5951e3ca029e31edbd37
+SHA512:
+  metadata.gz: eecda944787209cc6e1462e2e87733bf31ac250c028090ad5dd6d6f105f9639c82a020f50f1faa26a1f95fd53d448e1ea21c6bf9c97f42b004a426302157dea2
+  data.tar.gz: d8d5b0b1be8c7528176addef926b208e1a703ecfa0c025829817005ec43e36ac6c2a9707139b88ee35df89b45c70cb96294af6e4639d4707f20c98ca3389981a

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 egee
+
+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,63 @@
+# 🌫️ Foghorn
+
+A readable, terminal-friendly logger for Ruby!
+
+Foghorn gives you colored console output with optional dual-write to a plain-text log file. No monkey-patching, no enterprise bloat — just clear signals through the noise.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'foghorn'
+```
+
+## Usage
+
+```ruby
+require 'foghorn'
+
+Foghorn.info "Deploying to production..."
+Foghorn.success "All services healthy"
+Foghorn.warn "Memory at 72%"
+Foghorn.error "Connection refused"
+Foghorn.debug "Checking state..."    # only shown at debug level
+Foghorn.verbose "Detailed output..."  # shown at verbose or debug level
+```
+
+### Log Levels
+
+```ruby
+Foghorn.level = :quiet   # errors only
+Foghorn.level = :normal  # info, success, warn, error (default)
+Foghorn.level = :verbose # adds verbose messages
+Foghorn.level = :debug   # adds debug messages
+```
+
+### File Logging
+
+Dual-write to terminal (with color) and a plain-text log file (without color):
+
+```ruby
+Foghorn.enable_file_logging('production')
+# => Creates ./logs/production-20260218-183000.log
+
+# Custom log directory
+Foghorn.enable_file_logging('myapp', log_dir: '/var/log/myapp')
+
+# Close when done
+Foghorn.close_log
+```
+
+## Development
+
+```bash
+bundle install
+rake test     # lint + specs
+rake build    # build the gem
+rake release  # lint, test, bump, tag
+```
+
+## License
+
+MIT

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/foghorn.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'rainbow'
+require 'fileutils'
+
+# Foghorn — A readable, terminal-friendly logger for Ruby CLIs.
+# Provides colored console output with optional dual-write to a plain-text log file.
+module Foghorn
+  VERSION = File.read(File.join(__dir__, '..', 'VERSION')).strip
+
+  # Log levels (higher = more verbose)
+  LEVELS = {
+    quiet: 0,
+    normal: 1,
+    verbose: 2,
+    debug: 3
+  }.freeze
+
+  @level = :normal
+  @log_file = nil
+
+  class << self
+    attr_accessor :level
+
+    # Enable file logging. Creates a timestamped log file.
+    # All messages are written to both terminal (with color) and file (plain text).
+    def enable_file_logging(label, log_dir: File.join(Dir.pwd, 'logs'))
+      FileUtils.mkdir_p(log_dir)
+
+      timestamp = Time.now.strftime('%Y%m%d-%H%M%S')
+      log_path = File.join(log_dir, "#{label}-#{timestamp}.log")
+      @log_file = File.open(log_path, 'a')
+      @log_file.sync = true
+
+      info("Logging to #{log_path}")
+    end
+
+    def close_log
+      return unless @log_file
+
+      @log_file.close
+      @log_file = nil
+    end
+
+    def quiet?
+      @level == :quiet
+    end
+
+    def verbose?
+      @level == :verbose || @level == :debug
+    end
+
+    def debug?
+      @level == :debug
+    end
+
+    def info(message)
+      return if quiet?
+
+      puts message
+      log_to_file(message)
+    end
+
+    def success(message)
+      return if quiet?
+
+      puts Rainbow(message).green
+      log_to_file(message)
+    end
+
+    def warn(message)
+      return if quiet?
+
+      puts Rainbow(message).yellow
+      log_to_file("[WARN] #{message}")
+    end
+
+    def error(message)
+      # Always show errors, even in quiet mode
+      puts Rainbow(message).red
+      log_to_file("[ERROR] #{message}")
+    end
+
+    def debug(message)
+      return unless debug?
+
+      puts Rainbow("[DEBUG] #{message}").darkgray
+      log_to_file("[DEBUG] #{message}")
+    end
+
+    def verbose(message)
+      return unless verbose?
+
+      puts Rainbow(message).darkgray
+      log_to_file(message)
+    end
+
+    private
+
+    def log_to_file(message)
+      return unless @log_file
+
+      @log_file.puts("[#{Time.now.strftime('%H:%M:%S')}] #{message}")
+    end
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: foghorn-logger
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- egee
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: Foghorn provides colored console output with optional dual-write to a
+  plain-text log file. Built for CLI tools that need beautiful terminal output and
+  persistent logs without the complexity of enterprise logging.
+email:
+- egee@egee.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- VERSION
+- lib/foghorn.rb
+homepage: https://github.com/egeexyz/foghorn
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/egeexyz/foghorn
+  source_code_uri: https://github.com/egeexyz/foghorn
+  changelog_uri: https://github.com/egeexyz/foghorn/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A readable, terminal-friendly logger for Ruby CLIs
+test_files: []