familia 2.0.0.pre17 → 2.0.0.pre19

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: familia
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre17
+  version: 2.0.0.pre19
 platform: ruby
 authors:
 - Delano Mandelbaum
@@ -153,6 +153,10 @@ files:
 - LICENSE.txt
 - README.md
 - bin/irb
+- changelog.d/20251011_012003_delano_159_datatype_transaction_pipeline_support.rst
+- changelog.d/20251011_203905_delano_next.rst
+- changelog.d/20251011_212633_delano_next.rst
+- changelog.d/20251011_221253_delano_next.rst
 - changelog.d/README.md
 - changelog.d/scriv.ini
 - docs/archive/.gitignore
@@ -184,14 +188,18 @@ files:
 - docs/migrating/v2.0.0-pre12.md
 - docs/migrating/v2.0.0-pre13.md
 - docs/migrating/v2.0.0-pre14.md
+- docs/migrating/v2.0.0-pre18.md
+- docs/migrating/v2.0.0-pre19.md
 - docs/migrating/v2.0.0-pre5.md
 - docs/migrating/v2.0.0-pre6.md
 - docs/migrating/v2.0.0-pre7.md
 - docs/overview.md
+- docs/qodo-merge-compliance.md
 - docs/reference/api-technical.md
 - examples/autoloader/mega_customer.rb
 - examples/autoloader/mega_customer/features/deprecated_fields.rb
 - examples/autoloader/mega_customer/safe_dump_fields.rb
+- examples/datatype_standalone.rb
 - examples/encrypted_fields.rb
 - examples/json_usage_patterns.rb
 - examples/relationships.rb
@@ -201,17 +209,18 @@ files:
 - lib/familia.rb
 - lib/familia/base.rb
 - lib/familia/connection.rb
+- lib/familia/connection/behavior.rb
 - lib/familia/connection/handlers.rb
 - lib/familia/connection/individual_command_proxy.rb
 - lib/familia/connection/middleware.rb
 - lib/familia/connection/operation_core.rb
 - lib/familia/connection/operations.rb
-- lib/familia/connection/pipeline_core.rb
+- lib/familia/connection/pipelined_core.rb
 - lib/familia/connection/transaction_core.rb
 - lib/familia/data_type.rb
 - lib/familia/data_type/class_methods.rb
-- lib/familia/data_type/commands.rb
 - lib/familia/data_type/connection.rb
+- lib/familia/data_type/database_commands.rb
 - lib/familia/data_type/serialization.rb
 - lib/familia/data_type/settings.rb
 - lib/familia/data_type/types/counter.rb
@@ -221,7 +230,6 @@ files:
 - lib/familia/data_type/types/sorted_set.rb
 - lib/familia/data_type/types/stringkey.rb
 - lib/familia/data_type/types/unsorted_set.rb
-- lib/familia/distinguisher.rb
 - lib/familia/encryption.rb
 - lib/familia/encryption/encrypted_data.rb
 - lib/familia/encryption/manager.rb
@@ -270,11 +278,11 @@ files:
 - lib/familia/horreum/serialization.rb
 - lib/familia/horreum/settings.rb
 - lib/familia/horreum/utils.rb
+- lib/familia/identifier_extractor.rb
 - lib/familia/json_serializer.rb
 - lib/familia/logging.rb
 - lib/familia/refinements.rb
 - lib/familia/refinements/dear_json.rb
-- lib/familia/refinements/logger_trace.rb
 - lib/familia/refinements/stylize_words.rb
 - lib/familia/refinements/time_literals.rb
 - lib/familia/secure_identifier.rb
@@ -282,90 +290,18 @@ files:
 - lib/familia/utils.rb
 - lib/familia/verifiable_identifier.rb
 - lib/familia/version.rb
-- lib/middleware/database_middleware.rb
+- lib/middleware/database_logger.rb
 - lib/multi_result.rb
-- try/configuration/scenarios_try.rb
-- try/connection/fiber_context_preservation_try.rb
-- try/connection/handler_constraints_try.rb
-- try/connection/operation_mode_guards_try.rb
-- try/connection/pipeline_fallback_integration_try.rb
-- try/connection/responsibility_chain_tracking_try.rb
-- try/connection/transaction_fallback_integration_try.rb
-- try/connection/transaction_mode_permissive_try.rb
-- try/connection/transaction_mode_strict_try.rb
-- try/connection/transaction_mode_warn_try.rb
-- try/connection/transaction_modes_try.rb
-- try/core/autoloader_try.rb
-- try/core/base_enhancements_try.rb
-- try/core/connection_try.rb
-- try/core/conventional_inheritance_try.rb
-- try/core/create_method_try.rb
-- try/core/database_consistency_try.rb
-- try/core/errors_try.rb
-- try/core/extensions_try.rb
-- try/core/familia_extended_try.rb
-- try/core/familia_members_methods_try.rb
-- try/core/familia_try.rb
-- try/core/isolated_dbclient_try.rb
-- try/core/middleware_try.rb
-- try/core/persistence_operations_try.rb
-- try/core/pools_try.rb
-- try/core/secure_identifier_try.rb
-- try/core/settings_try.rb
-- try/core/time_utils_try.rb
-- try/core/tools_try.rb
-- try/core/utils_try.rb
-- try/core/verifiable_identifier_try.rb
-- try/data_types/boolean_try.rb
-- try/data_types/counter_try.rb
-- try/data_types/datatype_base_try.rb
-- try/data_types/hash_try.rb
-- try/data_types/list_try.rb
-- try/data_types/lock_try.rb
-- try/data_types/sorted_set_try.rb
-- try/data_types/sorted_set_zadd_options_try.rb
-- try/data_types/string_try.rb
-- try/data_types/unsortedset_try.rb
-- try/debugging/README.md
-- try/debugging/cache_behavior_tracer.rb
-- try/debugging/debug_aad_process.rb
-- try/debugging/debug_concealed_internal.rb
-- try/debugging/debug_concealed_reveal.rb
-- try/debugging/debug_context_aad.rb
-- try/debugging/debug_context_simple.rb
-- try/debugging/debug_cross_context.rb
-- try/debugging/debug_database_load.rb
-- try/debugging/debug_encrypted_json_check.rb
-- try/debugging/debug_encrypted_json_step_by_step.rb
-- try/debugging/debug_exists_lifecycle.rb
-- try/debugging/debug_field_decrypt.rb
-- try/debugging/debug_fresh_cross_context.rb
-- try/debugging/debug_load_path.rb
-- try/debugging/debug_method_definition.rb
-- try/debugging/debug_method_resolution.rb
-- try/debugging/debug_minimal.rb
-- try/debugging/debug_provider.rb
-- try/debugging/debug_secure_behavior.rb
-- try/debugging/debug_string_class.rb
-- try/debugging/debug_test.rb
-- try/debugging/debug_test_design.rb
-- try/debugging/encryption_method_tracer.rb
-- try/debugging/provider_diagnostics.rb
+- pr_agent.toml
+- pr_compliance_checklist.yaml
 - try/edge_cases/empty_identifiers_try.rb
 - try/edge_cases/hash_symbolization_try.rb
 - try/edge_cases/json_serialization_try.rb
+- try/edge_cases/legacy_data_detection/deserialization_edge_cases_try.rb
 - try/edge_cases/race_conditions_try.rb
 - try/edge_cases/reserved_keywords_try.rb
 - try/edge_cases/string_coercion_try.rb
 - try/edge_cases/ttl_side_effects_try.rb
-- try/encryption/config_persistence_try.rb
-- try/encryption/encryption_core_try.rb
-- try/encryption/instance_variable_scope_try.rb
-- try/encryption/module_loading_try.rb
-- try/encryption/providers/aes_gcm_provider_try.rb
-- try/encryption/providers/xchacha20_poly1305_provider_try.rb
-- try/encryption/roundtrip_validation_try.rb
-- try/encryption/secure_memory_handling_try.rb
 - try/features/encrypted_fields/aad_protection_try.rb
 - try/features/encrypted_fields/concealed_string_core_try.rb
 - try/features/encrypted_fields/context_isolation_try.rb
@@ -383,6 +319,14 @@ files:
 - try/features/encrypted_fields/secure_by_default_behavior_try.rb
 - try/features/encrypted_fields/thread_safety_try.rb
 - try/features/encrypted_fields/universal_serialization_safety_try.rb
+- try/features/encryption/config_persistence_try.rb
+- try/features/encryption/core_try.rb
+- try/features/encryption/instance_variable_scope_try.rb
+- try/features/encryption/module_loading_try.rb
+- try/features/encryption/providers/aes_gcm_provider_try.rb
+- try/features/encryption/providers/xchacha20_poly1305_provider_try.rb
+- try/features/encryption/roundtrip_validation_try.rb
+- try/features/encryption/secure_memory_handling_try.rb
 - try/features/expiration/expiration_try.rb
 - try/features/external_identifier/external_identifier_try.rb
 - try/features/feature_dependencies_try.rb
@@ -413,53 +357,130 @@ files:
 - try/features/transient_fields/single_use_redacted_string_try.rb
 - try/features/transient_fields/transient_fields_core_try.rb
 - try/features/transient_fields/transient_fields_integration_try.rb
-- try/helpers/test_cleanup.rb
-- try/helpers/test_helpers.rb
-- try/horreum/auto_indexing_on_save_try.rb
-- try/horreum/base_try.rb
-- try/horreum/class_methods_try.rb
-- try/horreum/commands_try.rb
-- try/horreum/defensive_initialization_try.rb
-- try/horreum/destroy_related_fields_cleanup_try.rb
-- try/horreum/enhanced_conflict_handling_try.rb
-- try/horreum/field_categories_try.rb
-- try/horreum/field_definition_try.rb
-- try/horreum/initialization_try.rb
-- try/horreum/relations_try.rb
-- try/horreum/serialization_persistent_fields_try.rb
-- try/horreum/serialization_try.rb
-- try/horreum/settings_try.rb
+- try/integration/connection/fiber_context_preservation_try.rb
+- try/integration/connection/handler_constraints_try.rb
+- try/integration/connection/isolated_dbclient_try.rb
+- try/integration/connection/middleware_reconnect_try.rb
+- try/integration/connection/operation_mode_guards_try.rb
+- try/integration/connection/pipeline_fallback_integration_try.rb
+- try/integration/connection/pools_try.rb
+- try/integration/connection/responsibility_chain_tracking_try.rb
+- try/integration/connection/transaction_fallback_integration_try.rb
+- try/integration/connection/transaction_mode_permissive_try.rb
+- try/integration/connection/transaction_mode_strict_try.rb
+- try/integration/connection/transaction_mode_warn_try.rb
+- try/integration/connection/transaction_modes_try.rb
+- try/integration/conventional_inheritance_try.rb
+- try/integration/create_method_try.rb
 - try/integration/cross_component_try.rb
-- try/memory/memory_basic_test.rb
-- try/memory/memory_detailed_test.rb
-- try/memory/memory_docker_ruby_dump.sh
-- try/memory/memory_search_for_string.rb
-- try/memory/test_actual_redactedstring_protection.rb
-- try/models/customer_safe_dump_try.rb
-- try/models/customer_try.rb
-- try/models/datatype_base_try.rb
-- try/models/familia_object_try.rb
+- try/integration/data_types/datatype_pipelines_try.rb
+- try/integration/data_types/datatype_transactions_try.rb
+- try/integration/database_consistency_try.rb
+- try/integration/familia_extended_try.rb
+- try/integration/familia_members_methods_try.rb
+- try/integration/models/customer_safe_dump_try.rb
+- try/integration/models/customer_try.rb
+- try/integration/models/datatype_base_try.rb
+- try/integration/models/familia_object_try.rb
+- try/integration/persistence_operations_try.rb
+- try/integration/relationships_persistence_round_trip_try.rb
+- try/integration/scenarios_try.rb
+- try/integration/secure_identifier_try.rb
+- try/integration/verifiable_identifier_try.rb
 - try/performance/benchmarks_try.rb
-- try/prototypes/atomic_saves_v1_context_proxy.rb
-- try/prototypes/atomic_saves_v2_connection_switching.rb
-- try/prototypes/atomic_saves_v3_connection_pool.rb
-- try/prototypes/atomic_saves_v4.rb
-- try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
-- try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
-- try/prototypes/pooling/README.md
-- try/prototypes/pooling/configurable_stress_test.rb
-- try/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
-- try/prototypes/pooling/lib/connection_pool_metrics.rb
-- try/prototypes/pooling/lib/connection_pool_stress_test.rb
-- try/prototypes/pooling/lib/connection_pool_threading_models.rb
-- try/prototypes/pooling/lib/visualize_stress_results.rb
-- try/prototypes/pooling/pool_siege.rb
-- try/prototypes/pooling/run_stress_tests.rb
-- try/refinements/dear_json_array_methods_try.rb
-- try/refinements/dear_json_hash_methods_try.rb
-- try/refinements/logger_trace_methods_try.rb
-- try/refinements/time_literals_numeric_methods_try.rb
-- try/refinements/time_literals_string_methods_try.rb
+- try/support/benchmarks/deserialization_benchmark.rb
+- try/support/benchmarks/deserialization_correctness_test.rb
+- try/support/debugging/README.md
+- try/support/debugging/cache_behavior_tracer.rb
+- try/support/debugging/debug_aad_process.rb
+- try/support/debugging/debug_concealed_internal.rb
+- try/support/debugging/debug_concealed_reveal.rb
+- try/support/debugging/debug_context_aad.rb
+- try/support/debugging/debug_context_simple.rb
+- try/support/debugging/debug_cross_context.rb
+- try/support/debugging/debug_database_load.rb
+- try/support/debugging/debug_encrypted_json_check.rb
+- try/support/debugging/debug_encrypted_json_step_by_step.rb
+- try/support/debugging/debug_exists_lifecycle.rb
+- try/support/debugging/debug_field_decrypt.rb
+- try/support/debugging/debug_fresh_cross_context.rb
+- try/support/debugging/debug_load_path.rb
+- try/support/debugging/debug_method_definition.rb
+- try/support/debugging/debug_method_resolution.rb
+- try/support/debugging/debug_minimal.rb
+- try/support/debugging/debug_provider.rb
+- try/support/debugging/debug_secure_behavior.rb
+- try/support/debugging/debug_string_class.rb
+- try/support/debugging/debug_test.rb
+- try/support/debugging/debug_test_design.rb
+- try/support/debugging/encryption_method_tracer.rb
+- try/support/debugging/provider_diagnostics.rb
+- try/support/helpers/test_cleanup.rb
+- try/support/helpers/test_helpers.rb
+- try/support/memory/memory_basic_test.rb
+- try/support/memory/memory_detailed_test.rb
+- try/support/memory/memory_docker_ruby_dump.sh
+- try/support/memory/memory_search_for_string.rb
+- try/support/memory/test_actual_redactedstring_protection.rb
+- try/support/prototypes/atomic_saves_v1_context_proxy.rb
+- try/support/prototypes/atomic_saves_v2_connection_switching.rb
+- try/support/prototypes/atomic_saves_v3_connection_pool.rb
+- try/support/prototypes/atomic_saves_v4.rb
+- try/support/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
+- try/support/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
+- try/support/prototypes/pooling/README.md
+- try/support/prototypes/pooling/configurable_stress_test.rb
+- try/support/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
+- try/support/prototypes/pooling/lib/connection_pool_metrics.rb
+- try/support/prototypes/pooling/lib/connection_pool_stress_test.rb
+- try/support/prototypes/pooling/lib/connection_pool_threading_models.rb
+- try/support/prototypes/pooling/lib/visualize_stress_results.rb
+- try/support/prototypes/pooling/pool_siege.rb
+- try/support/prototypes/pooling/run_stress_tests.rb
+- try/unit/core/autoloader_try.rb
+- try/unit/core/base_enhancements_try.rb
+- try/unit/core/connection_try.rb
+- try/unit/core/errors_try.rb
+- try/unit/core/extensions_try.rb
+- try/unit/core/familia_logger_try.rb
+- try/unit/core/familia_try.rb
+- try/unit/core/middleware_try.rb
+- try/unit/core/settings_try.rb
+- try/unit/core/time_utils_try.rb
+- try/unit/core/tools_try.rb
+- try/unit/core/utils_try.rb
+- try/unit/data_types/boolean_try.rb
+- try/unit/data_types/counter_try.rb
+- try/unit/data_types/datatype_base_try.rb
+- try/unit/data_types/hash_try.rb
+- try/unit/data_types/list_try.rb
+- try/unit/data_types/lock_try.rb
+- try/unit/data_types/sorted_set_try.rb
+- try/unit/data_types/sorted_set_zadd_options_try.rb
+- try/unit/data_types/string_try.rb
+- try/unit/data_types/unsortedset_try.rb
+- try/unit/horreum/auto_indexing_on_save_try.rb
+- try/unit/horreum/automatic_index_validation_try.rb
+- try/unit/horreum/base_try.rb
+- try/unit/horreum/class_methods_try.rb
+- try/unit/horreum/commands_try.rb
+- try/unit/horreum/defensive_initialization_try.rb
+- try/unit/horreum/destroy_related_fields_cleanup_try.rb
+- try/unit/horreum/enhanced_conflict_handling_try.rb
+- try/unit/horreum/field_categories_try.rb
+- try/unit/horreum/field_definition_try.rb
+- try/unit/horreum/initialization_try.rb
+- try/unit/horreum/json_type_preservation_try.rb
+- try/unit/horreum/relations_try.rb
+- try/unit/horreum/serialization_persistent_fields_try.rb
+- try/unit/horreum/serialization_try.rb
+- try/unit/horreum/settings_try.rb
+- try/unit/horreum/unique_index_edge_cases_try.rb
+- try/unit/horreum/unique_index_guard_validation_try.rb
+- try/unit/refinements/dear_json_array_methods_try.rb
+- try/unit/refinements/dear_json_hash_methods_try.rb
+- try/unit/refinements/time_literals_numeric_methods_try.rb
+- try/unit/refinements/time_literals_string_methods_try.rb
 - try/valkey.conf
 homepage: https://github.com/delano/familia
 licenses:

data/lib/familia/distinguisher.rb

@@ -1,85 +0,0 @@
-# lib/familia/distinguisher.rb
-
-module Familia
-  module Distinguisher
-    # This method determines the appropriate transformation to apply based on
-    # the class of the input argument.
-    #
-    # @param [Object] value_to_distinguish The value to be processed. Keep in
-    #   mind that all data is stored as a string so whatever the type
-    #   of the value, it will be converted to a string.
-    # @param [Boolean] strict_values Whether to enforce strict value handling.
-    #   Defaults to true.
-    # @return [String, nil] The processed value as a string or nil for unsupported
-    #   classes.
-    #
-    # The method uses a case statement to handle different classes:
-    # - For `Symbol`, `String`, `Integer`, and `Float` classes, it traces the
-    #   operation and converts the value to a string.
-    # - For `Familia::Horreum` class, it traces the operation and returns the
-    #   identifier of the value.
-    # - For `TrueClass`, `FalseClass`, and `NilClass`, it traces the operation and
-    #   converts the value to a string ("true", "false", or "").
-    # - For any other class, it traces the operation and returns nil.
-    #
-    # Alternative names for `value_to_distinguish` could be `input_value`, `value`,
-    # or `object`.
-    #
-    def distinguisher(value_to_distinguish, strict_values: true)
-      case value_to_distinguish
-      when ::Symbol, ::String, ::Integer, ::Float
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'string' if Familia.debug?
-
-        # Symbols and numerics are naturally serializable to strings
-        # so it's a relatively low risk operation.
-        value_to_distinguish.to_s
-
-      when ::TrueClass, ::FalseClass, ::NilClass
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'true/false/nil' if Familia.debug?
-
-        # TrueClass, FalseClass, and NilClass are considered high risk because their
-        # original types cannot be reliably determined from their serialized string
-        # representations. This can lead to unexpected behavior during deserialization.
-        # For instance, a TrueClass value serialized as "true" might be deserialized as
-        # a String, causing application errors. Even more problematic, a NilClass value
-        # serialized as an empty string makes it impossible to distinguish between a
-        # nil value and an empty string upon deserialization. Such scenarios can result
-        # in subtle, hard-to-diagnose bugs. To mitigate these risks, we raise an
-        # exception when encountering these types unless the strict_values option is
-        # explicitly set to false.
-        #
-        raise Familia::NotDistinguishableError, value_to_distinguish if strict_values
-
-        value_to_distinguish.to_s #=> "true", "false", ""
-
-      when Familia::Base, Class
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'base' if Familia.debug?
-
-        # When called with a class we simply transform it to its name. For
-        # instances of Familia class, we store the identifier.
-        if value_to_distinguish.is_a?(Class)
-          value_to_distinguish.name
-        else
-          value_to_distinguish.identifier
-        end
-
-      else
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, "else1 #{strict_values}" if Familia.debug?
-
-        if value_to_distinguish.class.ancestors.member?(Familia::Base)
-          Familia.trace :TOREDIS_DISTINGUISHER, nil, 'isabase' if Familia.debug?
-
-          value_to_distinguish.identifier
-
-        else
-          Familia.trace :TOREDIS_DISTINGUISHER, nil, "else2 #{strict_values}" if Familia.debug?
-          raise Familia::NotDistinguishableError, value_to_distinguish if strict_values
-
-          nil
-        end
-      end
-    end
-  end
-
-  extend Distinguisher
-end

data/lib/familia/refinements/logger_trace.rb

@@ -1,60 +0,0 @@
-# lib/familia/refinements/logger_trace.rb
-
-require 'pathname'
-require 'logger'
-
-# Controls whether tracing is enabled via an environment variable
-FAMILIA_TRACE = ENV.fetch('FAMILIA_TRACE', 'false').downcase
-
-# Familia::Refinements::LoggerTrace
-#
-# This module adds a 'trace' log level to the Ruby Logger class.
-# It is enabled when the FAMILIA_TRACE environment variable is set to
-# '1', 'true', or 'yes' (case-insensitive).
-#
-# @example Enabling trace logging
-#   # UnsortedSet environment variable
-#   ENV['FAMILIA_TRACE'] = 'true'
-#
-#   # In your Ruby code
-#   require 'logger'
-#   using Familia::Refinements::LoggerTrace
-#
-#   logger = Logger.new(STDOUT)
-#   logger.trace("This is a trace message")
-#
-module Familia
-  module Refinements
-    # Familia::Refinements::LoggerTrace
-    module LoggerTraceMethods
-      ##
-      # Logs a message at the TRACE level.
-      #
-      # @param progname [String] The program name to include in the log message
-      # @yield A block that evaluates to the message to log
-      # @return [true] Always returns true
-      #
-      # @example Logging a trace message
-      #   logger.trace("MyApp") { "Detailed trace information" }
-      def trace(progname = nil, &)
-        Fiber[:severity_letter] = 'T'
-        add(Familia::Refinements::LoggerTrace::TRACE, nil, progname, &)
-      ensure
-        Fiber[:severity_letter] = nil
-      end
-    end
-
-    module LoggerTrace
-      unless defined?(ENABLED)
-        # Indicates whether trace logging is enabled
-        ENABLED = %w[1 true yes].include?(FAMILIA_TRACE).freeze
-        # The numeric level for trace logging (same as DEBUG)
-        TRACE = 0
-      end
-
-      refine Logger do
-        import_methods LoggerTraceMethods
-      end
-    end
-  end
-end

data/try/refinements/logger_trace_methods_try.rb

@@ -1,44 +0,0 @@
-# try/refinements/logger_trace_methods_try.rb
-
-require_relative '../helpers/test_helpers'
-require 'logger'
-require 'stringio'
-
-class TestLoggerWithTrace < Logger
-  include Familia::Refinements::LoggerTraceMethods
-end
-
-## Can create a logger with trace methods
-output = StringIO.new
-logger = TestLoggerWithTrace.new(output)
-logger.respond_to?(:trace)
-#=> true
-
-## trace method logs with TRACE level
-output = StringIO.new
-logger = TestLoggerWithTrace.new(output)
-logger.trace('Test message')
-output.string
-#=~> /Test message/
-
-## trace method sets and clears severity letter
-output = StringIO.new
-logger = TestLoggerWithTrace.new(output)
-logger.trace('Test message')
-Fiber[:severity_letter]
-#=> nil
-
-## trace method accepts progname parameter
-output = StringIO.new
-logger = TestLoggerWithTrace.new(output)
-logger.trace('MyApp') { 'Test message' }
-output.string
-#=~> /MyApp/
-#=~> /Test message/
-
-## trace method accepts block for message
-output = StringIO.new
-logger = TestLoggerWithTrace.new(output)
-logger.trace { 'Block message' }
-output.string
-#=~> /Block message/