Natuurlijk! Hier is een stapsgewijze gids om een Ruby-gem te ontwikkelen die applicatie-activiteiten logt met verschillende logniveaus, inclusief voorbeeldcode, dependencies en configuraties. --- ### 1. Gemstructuur opzetten Gebruik de RubyGems CLI om een nieuwe gem te maken: ```bash bundle gem activity_logger ``` ### 2. Gemspec aanpassen Open `activity_logger.gemspec` en voeg de benodigde dependencies toe. Aangezien je alleen de standaardbibliotheek `logger` wilt gebruiken, hoef je geen externe dependencies toe te voegen. ### 3. Implementatie van de logfunctie Maak in de map `lib/activity_logger.rb` een basisstructuur: ```ruby require 'logger' module ActivityLogger class << self attr_accessor :logger # Initialiseer de logger met een standaard logniveau def setup(output: $stdout, level: :info) @logger = Logger.new(output) @logger.level = log_level(level) end # Map symbolen naar Logger-niveaus def log_level(level) case level when :debug then Logger::DEBUG when :info then Logger::INFO when :warn then Logger::WARN when :error then Logger::ERROR when :fatal then Logger::FATAL else Logger::UNKNOWN end end # Log een bericht met een bepaald niveau def log(level, message) return unless @logger @logger.add(log_level(level), message) end # Gemakkelijke methoden voor elk logniveau def debug(message); log(:debug, message); end def info(message); log(:info, message); end def warn(message); log(:warn, message); end def error(message); log(:error, message); end def fatal(message); log(:fatal, message); end end end ``` ### 4. Documentatie toevoegen Maak een `README.md` met uitleg over het gebruik: ```markdown # ActivityLogger Een eenvoudige Ruby-gem voor het loggen van applicatie-activiteiten met verschillende logniveaus. ## Installatie Gebruik bundler of installeer de gem direct: ```bash gem install activity_logger ``` ## Gebruik ```ruby require 'activity_logger' # Setup met standaard logniveau (info) ActivityLogger.setup # Log berichten ActivityLogger.info("Dit is een informatief bericht") ActivityLogger.error("Dit is een foutmelding") # Setup met ander logniveau ActivityLogger.setup(level: :debug) ActivityLogger.debug("Debug informatie") ``` ## Configuratie Je kunt het logniveau aanpassen bij setup: ```ruby ActivityLogger.setup(level: :warn) ``` --- ### 5. Testen Voeg in `spec/activity_logger_spec.rb` tests toe (gebruik bijvoorbeeld RSpec). Voorbeeld: ```ruby require 'activity_logger' RSpec.describe ActivityLogger do it 'logt een info bericht' do expect { ActivityLogger.info("Test") }.not_to raise_error end it 'stelt het logniveau correct in' do ActivityLogger.setup(level: :debug) expect(ActivityLogger.logger.level).to eq(Logger::DEBUG) end end ``` ### 6. Gem publiceren Zorg dat de `gemspec` volledig is ingevuld, bouw de gem en publiceer: ```bash gem build activity_logger.gemspec gem push activity_logger-0.1.0.gem ``` --- ### Samenvatting - **Dependencies:** Alleen standaardbibliotheek `logger` - **Configuratie:** Via `ActivityLogger.setup(level: :niveau)` - **Gebruik:** Roep `ActivityLogger.info`, `ActivityLogger.error`, etc. - **Documentatie:** In `README.md` met installatie- en gebruiksinstructies --- Wil je dat ik een complete voorbeeldbestanden voor je genereer of aanvullende functionaliteiten toevoeg?

Zeker! Hier is een complete handleiding voor het ontwikkelen van je Ruby-gem voor applicatie-logging: ## Gem Structuur ``` activity_logger/ ├── lib/ │ ├── activity_logger/ │ │ └── version.rb │ └── activity_logger.rb ├── spec/ │ └── activity_logger_spec.rb ├── activity_logger.gemspec ├── Gemfile ├── Rakefile ├── README.md └── LICENSE.txt ``` ## Kernbestanden ### 1. lib/activity_logger.rb ```ruby require 'logger' require_relative 'activity_logger/version' module ActivityLogger class Configuration attr_accessor :log_level, :log_device, :progname, :datetime_format def initialize @log_level = Logger::INFO @log_device = STDOUT @progname = 'ActivityLogger' @datetime_format = '%Y-%m-%d %H:%M:%S' end end class Logger attr_reader :logger, :configuration def initialize @configuration = Configuration.new setup_logger end def configure yield(configuration) if block_given? setup_logger end def debug(message) @logger.debug(message) end def info(message) @logger.info(message) end def warn(message) @logger.warn(message) end def error(message) @logger.error(message) end def fatal(message) @logger.fatal(message) end private def setup_logger @logger = ::Logger.new(configuration.log_device) @logger.level = configuration.log_level @logger.progname = configuration.progname @logger.datetime_format = configuration.datetime_format end end def self.logger @logger ||= Logger.new end def self.configure yield(logger.configuration) if block_given? end end ``` ### 2. lib/activity_logger/version.rb ```ruby module ActivityLogger VERSION = '0.1.0' end ``` ### 3. activity_logger.gemspec ```ruby require_relative 'lib/activity_logger/version' Gem::Specification.new do |spec| spec.name = 'activity_logger' spec.version = ActivityLogger::VERSION spec.authors = ['Jouw Naam'] spec.email = ['jouw.email@voorbeeld.nl'] spec.summary = 'Een configureerbare logger voor applicatie-activiteiten' spec.description = 'Een Ruby gem voor het loggen van applicatie-activiteiten met verschillende logniveaus' spec.homepage = 'https://github.com/jouw-gebruikersnaam/activity_logger' spec.license = 'MIT' spec.required_ruby_version = '>= 2.6.0' spec.files = Dir['lib/**/*.rb'] + ['README.md', 'LICENSE.txt'] spec.require_paths = ['lib'] spec.add_dependency 'logger' spec.add_development_dependency 'rake', '~> 13.0' spec.add_development_dependency 'rspec', '~> 3.0' spec.add_development_dependency 'yard', '~> 0.9' end ``` ## Gebruik ### Installatie ```bash gem build activity_logger.gemspec gem install activity_logger-0.1.0.gem ``` ### In je Gemfile ```ruby gem 'activity_logger', '~> 0.1.0' ``` ### Basis gebruik ```ruby require 'activity_logger' # Standaard configuratie ActivityLogger.logger.info('Applicatie gestart') ActivityLogger.logger.error('Er ging iets mis') # Configureerbaar ActivityLogger.configure do |config| config.log_level = Logger::DEBUG config.progname = 'MijnApp' config.datetime_format = '%H:%M:%S' end # Loggen met verschillende niveaus ActivityLogger.logger.debug('Debug bericht') ActivityLogger.logger.warn('Waarschuwing') ``` ## Documentatie ### README.md Zorg voor een uitgebreide README met: - Installatie-instructies - Gebruiksvoorbeelden - Configuratie-opties - Logniveau beschrijvingen - Contributie-richtlijnen ### YARD documentatie ```ruby # YARD comments toevoegen class Logger # Logt een debug bericht # @param message [String] het bericht om te loggen def debug(message) @logger.debug(message) end end ``` ## Testen ```ruby # spec/activity_logger_spec.rb require 'spec_helper' require 'activity_logger' RSpec.describe ActivityLogger do describe '.logger' do it 'logt berichten correct' do expect { ActivityLogger.logger.info('test') }.to output(/test/).to_stdout end end end ``` ## Publicatie 1. Maak een account op RubyGems.org 2. Build de gem: `gem build activity_logger.gemspec` 3. Publiceren: `gem push activity_logger-0.1.0.gem` Deze structuur zorgt voor een professionele, goed gedocumenteerde gem die eenvoudig te gebruiken en te onderhouden is.