metrics 0.5.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e702c99fcc40f6be98ab5cab1d6ff490fbcd6bd6cf1d792a643f45573c4cd710
-  data.tar.gz: 35ec716809e70775717f18bc10a4f70165cad91a1bbd076b200f847c812c764c
+  metadata.gz: 97bd0f590ab9a19775a10d083f0fd136eb9df4983dcaf414377775d6f9b7a3ca
+  data.tar.gz: ab0c2c11a0a747c3eaeaa7702e726b1818dd650b553406a692db7ba88223b21d
 SHA512:
-  metadata.gz: bc4627290512e876360564aae30dc4319cd0568a31826c3b28b2773a981121d684a4494f49fc2d8d2b3bd16d19807b9b22440505cb58e8b95fd4f4a68cd60c4c
-  data.tar.gz: fc270ec8d5d3afea0358482e981329f74639a27bdaf5e66a1b6e3b2d014e6dbc8f0602584ed5446e39d9ad4cd33dad68539821b276b3ec817696d0efca661029
+  metadata.gz: bb45133a3c85cf82a4965c1aa85845c0126c1dd00916dd277d3c08c91dd2136c6516447fb513fa6b7e9664ed9d889f70bafa922898da0eb23501b1627b06d4b0
+  data.tar.gz: f7675759c9ac7d8b908a400ee72a79ae48f269a63554330635dcc4468988bbf9a1c06dc7a33774c27228a5733d1c26f5ddc13d2ec7323930cc1522a442388620

data/bake/metrics/capture.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023, by Samuel Williams.
+
+def capture
+	ENV['METRICS_BACKEND'] = 'metrics/backend/capture'
+	require 'metrics'
+end
+
+# Generate a list of metrics using the document backend.
+def list
+	Metrics::Backend::Capture.metrics.sort_by!{|metric| metric.name}
+end

data/lib/metrics/backend/capture.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2021-2022, by Samuel Williams.
+
+require 'console'
+require_relative '../metric'
+
+module Metrics
+	module Backend
+		module Capture
+			class Metric < Metrics::Metric
+				def initialize(...)
+					super
+					
+					@values = []
+					@tags = Set.new
+					@sample_rates = []
+				end
+				
+				attr :values
+				attr :tags
+				attr :sample_rates
+				
+				def emit(value, tags: nil, sample_rate: 1.0)
+					@values << value
+					@tags.merge(tags) if tags
+					@sample_rates << sample_rate
+				end
+				
+				def as_json
+					{
+						name: @name,
+						type: @type,
+						description: @description,
+						unit: @unit,
+						values: @values,
+						tags: @tags.to_a.sort,
+						sample_rates: @sample_rates.sort.uniq
+					}
+				end
+				
+				def to_json(...)
+					as_json.to_json(...)
+				end
+			end
+			
+			def self.metrics
+				@metrics ||= []
+			end
+			
+			module Interface
+				def metric(name, type, description: nil, unit: nil, &block)
+					metric = Metric.new(name, type, description, unit)
+					
+					Capture.metrics << metric
+					
+					return metric
+				end
+			end
+		end
+		
+		Interface = Capture::Interface
+	end
+end

data/lib/metrics/backend/console.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require 'console'
 require_relative '../metric'
@@ -34,4 +34,3 @@ module Metrics
 		Interface = Console::Interface
 	end
 end
-

data/lib/metrics/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2022, by Samuel Williams.
 
 module Metrics
-	VERSION = "0.5.0"
+	VERSION = "0.6.1"
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2021-2022, by Samuel Williams.  
+Copyright, 2021-2023, by Samuel Williams.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -27,27 +27,3 @@ We welcome contributions to this project.
 
   - [metrics-backend-datadog](https://github.com/socketry/metrics-backend-datadog) — A Metrics backend for Datadog.
   - [traces](https://github.com/socketry/traces) — A code tracing interface which follows a similar pattern.
-
-## License
-
-Released under the MIT license.
-
-Copyright, 2021, 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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: metrics
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2022-11-09 00:00:00.000000000 Z
+date: 2023-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bake-test
@@ -101,8 +101,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- bake/metrics/capture.rb
 - lib/metrics.rb
 - lib/metrics/backend.rb
+- lib/metrics/backend/capture.rb
 - lib/metrics/backend/console.rb
 - lib/metrics/backend/test.rb
 - lib/metrics/metric.rb
@@ -130,7 +132,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.7
 signing_key:
 specification_version: 4
 summary: Application metrics and instrumentation.