console 1.8.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb8134534352969dd1f48e568f92e3ee1b6a8bcde97be1e44ef6e941e0437ead
-  data.tar.gz: 5992182d9ed1f729ee350703f7a591b67a5f8b101ef420159f8d35bb40c2e0d4
+  metadata.gz: 640269ce4b1afa8413ce60f657ab3c3ed01a036a32e554c8643aa599a0052422
+  data.tar.gz: b5fa60cc24de752c16af2160856fe0cfe3c038f24a409e9d3069d701afbfcb9b
 SHA512:
-  metadata.gz: 8f70f82899ad1e7fd31969ff98ca8b15604aff8b4749fdd31dafa5ae2a1959d6c507a0d1a9e048920c629aeea4990358bf6658baccd87bd656e691daa9b11a53
-  data.tar.gz: 2d590c94668bbdfcd29d2457c99dc169855aa3294c3ae3978b27f658cb99e98b41cb3a7faa8662f7d6ab1824dd2e2f7d6312c120e2db61c35480d58ebd0b9a35
+  metadata.gz: 78b6e1c53280b26a315a422a418f36d228a583f095b41a406a33c67808ac2c299ab33399641880d5d3b7753d0ad88262fc536deac6ddd1ef6c8edf970b7d591e
+  data.tar.gz: d24238b81168471f70c4404badf944b24f01a92101b841513cb0ced7c6998b4a63efabb88bad49c042e72c174b1c56f2cd51cf385f7814d41d709cde040e1ab3

data/bake/console.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# Increase the verbosity of the logger to info.
+def info
+	require_relative '../lib/console'
+	
+	Console.logger.info!
+end
+
+# Increase the verbosity of the logger to debug.
+def debug
+	require_relative '../lib/console'
+	
+	Console.logger.debug!
+end

data/lib/console.rb

@@ -21,64 +21,22 @@
 # THE SOFTWARE.
 
 require_relative 'console/logger'
-require_relative 'console/resolver'
-require_relative 'console/terminal/logger'
 
 module Console
-	class << self
-		attr_accessor :logger
-		
-		# Set the default log level based on `$DEBUG` and `$VERBOSE`.
-		# You can also specify CONSOLE_LEVEL=debug or CONSOLE_LEVEL=info in environment.
-		# https://mislav.net/2011/06/ruby-verbose-mode/ has more details about how it all fits together.
-		def default_log_level(env = ENV)
-			if level = (env['CONSOLE_LEVEL'] || env['CONSOLE_LOG_LEVEL'])
-				Logger::LEVELS[level.to_sym] || Logger.warn
-			elsif $DEBUG
-				Logger::DEBUG
-			elsif $VERBOSE.nil?
-				Logger::WARN
-			else
-				Logger::INFO
-			end
-		end
-		
-		def default_resolver(logger, env = ENV)
-			if names = env['CONSOLE_DEBUG']&.split(',')
-				resolver = Resolver.new
-				
-				resolver.bind(names) do |klass|
-					logger.enable(klass, Logger::DEBUG)
-				end
-				
-				return resolver
-			end
-		end
-		
-		# Controls verbose output using `$VERBOSE`.
-		def verbose?
-			!$VERBOSE.nil?
-		end
-		
-		def build(output, verbose: self.verbose?, level: self.default_log_level)
-			terminal = Terminal::Logger.new(output, verbose: verbose)
-			
-			logger = Logger.new(terminal, verbose: verbose, level: level)
-			
-			return logger
-		end
+	def self.logger
+		Logger.instance
 	end
 	
-	# Create the logger instance:
-	@logger = self.build($stderr)
-	@resolver = self.default_resolver(@logger)
+	def self.logger= instance
+		Logger.instance= instance
+	end
 	
 	def logger= logger
 		@logger = logger
 	end
 	
 	def logger
-		@logger || Console.logger
+		@logger || Logger.instance
 	end
 	
 	def self.extended(klass)

data/lib/console/capture.rb

@@ -21,15 +21,20 @@
 require_relative 'filter'
 
 module Console
+	# A general sink which captures all events into a buffer.
 	class Capture
 		def initialize
-			@events = []
+			@buffer = []
 		end
 		
-		attr :events
+		attr :buffer
 		
 		def last
-			@events.last
+			@buffer.last
+		end
+		
+		def clear
+			@buffer.clear
 		end
 		
 		def verbose!(value = true)
@@ -37,7 +42,7 @@ module Console
 		
 		def call(subject = nil, *arguments, severity: UNKNOWN, **options, &block)
 			message = {
-				time: Time.now.iso8601,
+				time: ::Time.now.iso8601,
 				severity: severity,
 				**options,
 			}
@@ -60,7 +65,7 @@ module Console
 				end
 			end
 			
-			@events << message
+			@buffer << message
 		end
 	end
 end

data/lib/console/event.rb

@@ -20,3 +20,5 @@
 
 require_relative 'event/spawn'
 require_relative 'event/failure'
+require_relative 'event/metric'
+require_relative 'event/progress'

data/lib/console/event/failure.rb

@@ -49,6 +49,10 @@ module Console
 				terminal[:exception_backtrace] ||= terminal.style(:red)
 			end
 			
+			def to_h
+				{exception: @exception, root: @root}
+			end
+			
 			def format(output, terminal, verbose)
 				format_exception(@exception, nil, output, terminal, verbose)
 			end

data/lib/console/event/generic.rb

@@ -24,6 +24,13 @@ module Console
 			def self.register(terminal)
 			end
 			
+			def to_h
+			end
+			
+			def as_json
+				to_h
+			end
+			
 			def format(buffer, terminal)
 			end
 		end

data/lib/console/event/metric.rb

@@ -0,0 +1,49 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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.
+
+require_relative 'generic'
+
+module Console
+	module Event
+		class Metric < Generic
+			def self.[](**parameters)
+				parameters.map(&self.method(:new))
+			end
+			
+			def initialize(name, value, **tags)
+				@name = name
+				@value = value
+				@tags = tags
+			end
+			
+			attr :name
+			attr :value
+			attr :tags
+			
+			def to_h
+				{name: @name, value: @value, tags: @tags}
+			end
+			
+			def format(output, terminal, verbose)
+				output.puts "#{@name}=#{@value} #{@tags.inspect}"
+			end
+		end
+	end
+end

data/lib/console/event/progress.rb

@@ -0,0 +1,75 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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.
+
+require_relative 'generic'
+
+module Console
+	module Event
+		class Progress < Generic
+			BLOCK = [
+				" ",
+				"▏",
+				"▎",
+				"▍",
+				"▌",
+				"▋",
+				"▊",
+				"▉",
+				"█",
+			]
+			
+			def initialize(current, total)
+				@current = current
+				@total = total
+			end
+			
+			attr :current
+			attr :total
+			
+			def value
+				@current.to_f / @total.to_f
+			end
+			
+			def bar(value = self.value, width = 70)
+				blocks = width * value
+				full_blocks = blocks.floor
+				partial_block = ((blocks - full_blocks) * BLOCK.size).floor
+				
+				if partial_block.zero?
+					BLOCK.last * full_blocks
+				else
+					"#{BLOCK.last * full_blocks}#{BLOCK[partial_block]}"
+				end.ljust(width)
+			end
+			
+			def self.register(terminal)
+				terminal[:progress_bar] ||= terminal.style(:blue, :white)
+			end
+			
+			def to_h
+				{current: @current, total: @total}
+			end
+			
+			def format(output, terminal, verbose)
+				output.puts "#{terminal[:progress_bar]}#{self.bar}#{terminal.reset} #{sprintf('%6.2f', self.value * 100)}%"
+			end
+		end
+	end
+end

data/lib/console/event/spawn.rb

@@ -24,6 +24,7 @@ module Console
 	module Event
 		class Spawn < Generic
 			def self.for(*arguments, **options)
+				# Extract out the command environment:
 				if arguments.first.is_a?(Hash)
 					self.new(*arguments, **options)
 				else
@@ -51,6 +52,10 @@ module Console
 				terminal[:shell_command] ||= terminal.style(:blue, nil, :bold)
 			end
 			
+			def to_h
+				{environment: @environment, arguments: @arguments, options: @options}
+			end
+			
 			def format(output, terminal, verbose)
 				arguments = @arguments.flatten.collect(&:to_s)
 				

data/lib/console/filter.rb

@@ -46,7 +46,7 @@ module Console
 					end
 					
 					define_method("#{name}?") do
-						@level >= level
+						@level <= level
 					end
 				end
 			end

data/lib/console/logger.rb

@@ -19,13 +19,65 @@
 # THE SOFTWARE.
 
 require_relative 'filter'
+require_relative 'progress'
+
+require_relative 'resolver'
+require_relative 'terminal/logger'
+
+require 'fiber/local'
 
 module Console
 	class Logger < Filter[debug: 0, info: 1, warn: 2, error: 3, fatal: 4]
+		extend Fiber::Local
+		
+		# Set the default log level based on `$DEBUG` and `$VERBOSE`.
+		# You can also specify CONSOLE_LEVEL=debug or CONSOLE_LEVEL=info in environment.
+		# https://mislav.net/2011/06/ruby-verbose-mode/ has more details about how it all fits together.
+		def self.default_log_level(env = ENV)
+			if level = (env['CONSOLE_LEVEL'] || env['CONSOLE_LOG_LEVEL'])
+				LEVELS[level.to_sym] || level.to_i
+			elsif $DEBUG
+				DEBUG
+			elsif $VERBOSE.nil?
+				WARN
+			else
+				INFO
+			end
+		end
+		
+		# Controls verbose output using `$VERBOSE`.
+		def self.verbose?(env = ENV)
+			!$VERBOSE.nil? || env['CONSOLE_VERBOSE']
+		end
+		
+		def self.default_logger(output, verbose: self.verbose?, level: self.default_log_level)
+			terminal = Terminal::Logger.new(output, verbose: verbose)
+			
+			logger = self.new(terminal, verbose: verbose, level: level)
+			resolver = Resolver.default_resolver(logger)
+			
+			return logger
+		end
+		
+		def self.local
+			self.default_logger($stderr)
+		end
+		
 		DEFAULT_LEVEL = 1
 		
 		def initialize(output, **options)
 			super(output, **options)
 		end
+		
+		def progress(subject, total, **options)
+			Progress.new(self, subject, total, **options)
+		end
+		
+		# @deprecated Please use {progress}.
+		alias measure progress
+		
+		def failure(subject, exception, *arguments, &block)
+			fatal(subject, *arguments, Event::Failure.new(exception), &block)
+		end
 	end
 end

data/lib/console/progress.rb

@@ -0,0 +1,140 @@
+# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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.
+
+require_relative 'event/progress'
+
+module Console
+	class Progress
+		def self.now
+			Process.clock_gettime(Process::CLOCK_MONOTONIC)
+		end
+		
+		def initialize(output, subject, total = 0, minimum_output_duration: 1.0)
+			@output = output
+			@subject = subject
+			
+			@start_time = Progress.now
+			
+			@last_output_time = nil
+			@minimum_output_duration = 0.1
+			
+			@current = 0
+			@total = total
+		end
+		
+		attr :subject
+		attr :current
+		attr :total
+		
+		def duration
+			Progress.now - @start_time
+		end
+		
+		def progress
+			@current.to_f / @total.to_f
+		end
+		
+		def remaining
+			@total - @current
+		end
+		
+		def average_duration
+			if @current > 0
+				duration / @current
+			end
+		end
+		
+		def estimated_remaining_time
+			if average_duration = self.average_duration
+				average_duration * remaining
+			end
+		end
+		
+		def increment(amount = 1)
+			@current += amount
+			
+			if output?
+				@output.info(@subject, self) {Event::Progress.new(@current, @total)}
+				@last_output_time = Progress.now
+			end
+			
+			return self
+		end
+		
+		def resize(total)
+			@total = total
+			
+			@output.info(@subject, self) {Event::Progress.new(@current, @total)}
+			@last_output_time = Progress.now
+			
+			return self
+		end
+		
+		def mark(*arguments)
+			@output.info(@subject, *arguments)
+		end
+		
+		def to_s
+			if estimated_remaining_time = self.estimated_remaining_time
+				"#{@current}/#{@total} completed in #{self.formatted_duration self.duration}, #{self.formatted_duration estimated_remaining_time} remaining."
+			else
+				"#{@current}/#{@total} completed, waiting for estimate..."
+			end
+		end
+		
+		private
+		
+		def duration_since_last_output
+			if @last_output_time
+				Progress.now - @last_output_time
+			end
+		end
+		
+		def output?
+			if duration = duration_since_last_output
+				return duration > @minimum_output_duration
+			else
+				return true
+			end
+		end
+		
+		def formatted_duration(duration)
+			if duration < 60.0
+				return "#{duration.round(2)}s"
+			end
+			
+			duration /= 60.0
+			
+			if duration < 60.0
+				return "#{duration.round}m"
+			end
+			
+			duration /= 60.0
+			
+			if duration < 60.0
+				return "#{duration.round(1)}h"
+			end
+			
+			duration /= 24.0
+			
+			return "#{duration.round(1)}d"
+		end
+	end
+end

data/lib/console/resolver.rb

@@ -22,6 +22,36 @@ require_relative 'filter'
 
 module Console
 	class Resolver
+		# You can change the log level for different classes using CONSOLE_<LEVEL> env vars.
+		#
+		# e.g. `CONSOLE_WARN=Acorn,Banana CONSOLE_DEBUG=Cat` will set the log level for the classes Acorn and Banana to `warn` and Cat to `debug`. This overrides the default log level.
+		#
+		# @parameter logger [Logger] A logger instance to set the logging levels on.
+		# @parameter env [Hash] The environment to read levels from.
+		#
+		# @returns [Nil] If there were no custom logging levels specified in the environment.
+		# @returns [Resolver] If there were custom logging levels, then the created resolver is returned.
+		def self.default_resolver(logger, env = ENV)
+			# Find all CONSOLE_<LEVEL> variables from environment:
+			levels = Logger::LEVELS
+				.map{|label, level| [level, env["CONSOLE_#{label.upcase}"]&.split(',')]}
+				.to_h
+				.compact
+			
+			# If we have any levels, then create a class resolver, and each time a class is resolved, set the log level for that class to the specified level:
+			if levels.any?
+				resolver = Resolver.new
+				
+				levels.each do |level, names|
+					resolver.bind(names) do |klass|
+						logger.enable(klass, level)
+					end
+				end
+				
+				return resolver
+			end
+		end
+		
 		def initialize
 			@names = {}
 			

data/lib/console/terminal/logger.rb

@@ -24,6 +24,8 @@ require_relative '../event'
 require_relative 'text'
 require_relative 'xterm'
 
+require 'json'
+
 module Console
 	module Terminal
 		# This, and all related methods, is considered private.
@@ -77,7 +79,9 @@ module Console
 			end
 			
 			attr :io
+			
 			attr_accessor :verbose
+			
 			attr :start
 			attr :terminal
 			
@@ -94,7 +98,7 @@ module Console
 			
 			UNKNOWN = 'unknown'
 			
-			def call(subject = nil, *arguments, name: nil, severity: UNKNOWN, &block)
+			def call(subject = nil, *arguments, name: nil, severity: UNKNOWN, **options, &block)
 				prefix = build_prefix(name || severity.to_s)
 				indent = " " * prefix.size
 				
@@ -104,6 +108,10 @@ module Console
 					format_subject(severity, prefix, subject, buffer)
 				end
 				
+				if options&.any?
+					format_options(options, buffer)
+				end
+				
 				arguments.each do |argument|
 					format_argument(argument, buffer)
 				end
@@ -121,6 +129,10 @@ module Console
 			
 			protected
 			
+			def format_options(options, output)
+				format_value(options.to_json, output)
+			end
+			
 			def format_argument(argument, output)
 				case argument
 				when Exception

data/lib/console/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Console
-	VERSION = "1.8.0"
+	VERSION = "1.10.0"
 end

metadata

@@ -1,17 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-02-01 00:00:00.000000000 Z
+date: 2020-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: covered
+  name: fiber-local
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: covered
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -66,30 +94,25 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: 
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".editorconfig"
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- Gemfile
-- README.md
-- Rakefile
-- console.gemspec
+- bake/console.rb
 - lib/console.rb
 - lib/console/buffer.rb
 - lib/console/capture.rb
 - lib/console/event.rb
 - lib/console/event/failure.rb
 - lib/console/event/generic.rb
+- lib/console/event/metric.rb
+- lib/console/event/progress.rb
 - lib/console/event/spawn.rb
 - lib/console/filter.rb
 - lib/console/logger.rb
+- lib/console/progress.rb
 - lib/console/resolver.rb
 - lib/console/serialized/logger.rb
 - lib/console/split.rb
@@ -98,12 +121,11 @@ files:
 - lib/console/terminal/text.rb
 - lib/console/terminal/xterm.rb
 - lib/console/version.rb
-- proposal.md
 homepage: https://github.com/socketry/console
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -111,7 +133,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -119,7 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.2
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Beautiful logging for Ruby.
 test_files: []

data/.editorconfig

@@ -1,6 +0,0 @@
-root = true
-
-[*]
-indent_style = tab
-indent_size = 2
-

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-Gemfile.lock
-.rspec_status
-.covered.db

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---color
---require spec_helper
---warnings

data/.travis.yml

@@ -1,19 +0,0 @@
-language: ruby
-dist: xenial
-cache: bundler
-
-matrix:
-  include:
-    - rvm: 2.4
-    - rvm: 2.5
-    - rvm: 2.6
-    - rvm: 2.7
-    - rvm: 2.6
-      env: COVERAGE=PartialSummary,Coveralls
-    - rvm: truffleruby
-    - rvm: jruby-head
-    - rvm: ruby-head
-  allow_failures:
-    - rvm: truffleruby
-    - rvm: ruby-head
-    - rvm: jruby-head

data/Gemfile

@@ -1,8 +0,0 @@
-source "https://rubygems.org"
-
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in console.gemspec
-gemspec
-
-gem "pry"

data/README.md

@@ -1,212 +0,0 @@
-# Console
-
-Provides beautiful console logging for Ruby applications. Implements fast, buffered log output.
-
-[![Build Status](https://travis-ci.com/socketry/console.svg)](http://travis-ci.com/socketry/console)
-[![Coverage Status](https://coveralls.io/repos/socketry/console/badge.svg)](https://coveralls.io/r/socketry/console)
-
-## Motivation
-
-When Ruby decided to reverse the order of exception backtraces, I finally gave up using the built in logging and decided restore sanity to the output of my programs once and for all!
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'console'
-```
-
-And then execute:
-
-	$ bundle
-
-## Usage
-
-As your code executes, it generates interesting events which you want to know about. The general approach is to use an `Console::Logger` which outputs text to the terminal. The text is generated by inspecting the console that occurred.
-
-Capturing structured information allows it to be used in different ways. These events can be sent to a logger or some other system (e.g. web browser, syslog) and analysed in more detail.
-
-### Default Logger
-
-Generally speaking, use `Console.logger` which is suitable for logging to the user's terminal.
-
-### Environment Variables
-
-#### `CONSOLE_LEVEL=debug`
-
-Control the default logger level. You can set it to any of the supported log levels: `debug`, `info`, `warn`, `error`, `fatal`.
-
-#### `CONSOLE_DEBUG=MyClass,MyModule::MyClass`
-
-Enable debug logging for the specified class names. You can specify one or more class names which will be resolved at runtime.
-
-### Module Integration
-
-```ruby
-require 'console'
-
-# Set the log level:
-Console.logger.debug!
-
-module MyModule
-	extend Console
-	
-	def self.test_logger
-		logger.debug "GOTO LINE 1."
-		logger.info "5 things your doctor won't tell you!"
-		logger.warn "Something didn't work as expected!"
-		logger.error "The matrix has two cats!"
-	end
-	
-	test_logger
-end
-```
-
-### Class Integration
-
-```ruby
-require 'console'
-
-# Set the log level:
-Console.logger.debug!
-
-class MyObject
-	include Console
-
-	def test_logger
-		logger.debug "GOTO LINE 1."
-		logger.info "5 things your doctor won't tell you!"
-		logger.warn "Something didn't work as expected!"
-		logger.error "The matrix has two cats!"
-	end
-end
-
-MyObject.new.test_logger
-```
-
-### Subject Logging
-
-The first argument to the log method is the subject.
-
-```ruby
-class Thing
-	def call
-		Console.logger.info(self) {"Something is going on"}
-	end
-end
-```
-
-Using this approach, you can turn on and off specific subjects by using the class name:
-
-```ruby
-$ CONSOLE_DEBUG=Thing ./script.rb
-```
-
-This will conditionally enable all log statements which have a subject of class `Thing`.
-
-### Console Formatting
-
-Console classes are used to wrap data which can generate structured log messages:
-
-```ruby
-require 'console'
-
-class MyConsole < Console::Generic
-	def format(output, terminal, verbose)
-		output.puts "My console text!"
-	end
-end
-
-Console.logger.info("My Console", MyConsole.new)
-```
-
-#### Failure Events
-
-`Console::Event::Failure` represents an exception and will log the message and backtrace recursively.
-
-#### Spawn Events
-
-`Console::Event::Spawn` represents the execution of a command, and will log the environment, arguments and options used to execute it.
-
-### Custom Log Levels
-
-`Console::Filter` implements support for multiple log levels.
-
-```ruby
-require 'console'
-
-MyLogger = Console::Filter[noise: 0, stuff: 1, broken: 2]
-
-# verbose: true - log severity/name/pid etc.
-logger = MyLogger.new(Console.logger, name: "Java", verbose: true)
-
-logger.broken("It's so janky.")
-```
-
-### Multiple Outputs
-
-Use `Console::Split` to log to multiple destinations.
-
-```ruby
-require 'console/terminal'
-require 'console/serialized/logger'
-require 'console/logger'
-require 'console/split'
-
-terminal = Console::Terminal::Logger.new
-file = Console::Serialized::Logger.new(File.open("log.json", "a"))
-
-logger = Console::Logger.new(Console::Split[terminal, file])
-
-logger.info "I can go everywhere!"
-```
-
-### Custom Logger Output
-
-`Console::Logger` provides a default interface which is a drop in replacemnet for `Logger` and other similar implementations. The only method required for output is `#call(*arguments, **options, &block)`.
-
-```ruby
-require 'console/logger'
-
-output = proc do |*arguments, **options, &block|
-	puts "arguments: #{arguments.inspect} options: #{options.inspect} block: #{block.call}"
-end
-
-logger = Console::Logger.new(output)
-
-logger.info("Hello World!", meta: "data") {"block"}
-# => arguments: ["Hello World!"] options: {:severity=>:info, :meta=>"data"} block: block
-```
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-## License
-
-Released under the MIT license.
-
-Copyright, 2019, by [Samuel Williams](https://www.codeotaku.com).
-
-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/Rakefile

@@ -1,13 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-task :default => :spec
-
-task :console do
-	require 'pry'
-	require 'console'
-	
-	binding.pry
-end

data/console.gemspec

@@ -1,25 +0,0 @@
-
-require_relative "lib/console/version"
-
-Gem::Specification.new do |spec|
-	spec.name = "console"
-	spec.version = Console::VERSION
-	spec.licenses = ["MIT"]
-	spec.authors = ["Samuel Williams"]
-	spec.email = ["samuel.williams@oriontransfer.co.nz"]
-	
-	spec.summary = "Beautiful logging for Ruby."
-	spec.homepage = "https://github.com/socketry/console"
-	
-	spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
-		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-	end
-	
-	spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-	spec.require_paths = ["lib"]
-	
-	spec.add_development_dependency "covered"
-	spec.add_development_dependency "bundler"
-	spec.add_development_dependency "rake", "~> 10.0"
-	spec.add_development_dependency "rspec", "~> 3.0"
-end

data/proposal.md

@@ -1,84 +0,0 @@
-# Global Logger
-
-Configure what logging looks like globally:
-
-```ruby
-Console.logger
-```
-
-Other logger instances would inherit their initial configuration from the global logger.
-
-Rather than the output being configurable on the global logger, it would always route to `$stdout`. _Or perhaps no destinations should exist and you add one; there must be a way to attach a formatter to even the default destination._
-
-# Adding Destinations
-
-The global logger or any instance could log to multiple destinations:
-
-```ruby
-Console.add(some_io, formatter: some_formatter)
-```
-
-I _think_ that formatters would be defined on destinations. This would allow for writing in one format to `$stdout` and another to `syslog`, for example.
-
-# Logger Instances
-
-Named instances could be created with a given output:
-
-```ruby
-connection_logger = Console.new(:connection, output: ...)
-```
-
-Outputs would not reference an io object, but rather another named instance (defaulting to global). Again, Destinations + Formatters could be added to any instance. This would allow outputs to be chained.
-
-## Instances As Subjects
-
-Perhaps an interesting idea is letting logger instance names be subjects, controllable from the global logger. In the example above, `:connection` would become a known subject that could be enabled/disabled from the global logger:
-
-```ruby
-Console.disable(:connection)
-```
-
-This lets us very easily disable the logging of events of a particular type.
-
----
-
-In [Pakyow's logger](https://gist.github.com/bryanp/0329d58c753f1fa6e99d970960ad006d#file-logger-rb), instances are created in these cases:
-
-* Environment: Single logger for the environment, named `:pkyw`.
-* Connection: Per-Request logger containing the connection id, named `:http`.
-* WebSocket: Per-WebSocket logger containing the WebSocket id, named `:sock`.
-* Async: The logger that async is configured with, named `:asnc`.
-
-Instances could be initialized with metadata that is passed with the console to the formatter:
-
-```ruby
-connection_logger = Console.new(:http, output: ..., connection_id: "123")
-```
-
-# Formatters
-
-Just a class with a `format` method that accepts an `console`, which is a hash or simple object containing the console data along with attached metadata (e.g. timestamp, metadata from the instance). Returns a string, and/or writes directly to the buffer.
-
-# Custom Levels
-
-Pakyow's logger uses the following levels:
-
-* all
-* verbose
-* debug
-* info
-* warn
-* error
-* fatal
-* unknown
-* off
-
-`all` and `off` aren't turned into logging methods in `Pakyow::Logger`, but rather the log level can be set to either one as an easy way to guarantee that all or no logs will be written, without knowing what the lowest and highest level of logging are in the system.
-
-Projects often have different needs, so making this easily configurable on both the global logger and individual logger instances would be amazing:
-
-```ruby
-Console.levels(
-  %i(all verbose debug info warn error fatal unknown off)
-)
-```