ticktok 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 125177ca8bc16964942ee6048b6faf7ee0724d807925a476fd02c1f69ac12063
+  data.tar.gz: 74bd4d419eb751f6fbc98ceff4665738ae9426a72b76947eba533e70e4a5d3cb
+SHA512:
+  metadata.gz: 651eda14274678a9eca87769807f423d1129d7a522fb2ad1ca1c66e39818250d18856a1d74a5b4777ba8b85a9281714dfab94507d02203d27284bad43f55d47e
+  data.tar.gz: 2297515a85935bfc6f27730f66c4369f979d83400ac9943e89c3ed0ff784051ede30051b7518c9630e9f5c65f81e90bd61a048400e42c10ea935c81213dbcb70

data/README.md

@@ -0,0 +1,66 @@
+# Ticktok
+
+A simple Ruby gem for tracking execution time of code blocks.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ticktok'
+```
+
+And then execute:
+
+```
+$ bundle install
+```
+
+Or install it yourself as:
+
+```
+$ gem install ticktok
+```
+
+## Usage
+
+```ruby
+require 'ticktok'
+
+# Track execution time of a code block with a name
+Ticktok.track(:operation_1) do
+  # Your code here
+  sleep(1)
+end
+
+# Track another operation
+Ticktok.track(:operation_2) do
+  # Some other code
+  sleep(0.5)
+end
+
+# Track the first operation again
+Ticktok.track(:operation_1) do
+  # More code
+  sleep(1.5)
+end
+
+# Get all timers with total times
+Ticktok.timers
+# => {:operation_1=>2.5, :operation_2=>0.5}
+
+# Get detailed stats for all timers
+Ticktok.detailed_timers
+# => {:operation_1=>{:total=>2.5, :count=>2, :average=>1.25}, :operation_2=>{:total=>0.5, :count=>1, :average=>0.5}}
+
+# Reset all timers
+Ticktok.reset
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mumenmusa/ticktok.
+
+## License
+
+The gem is available as open source under the terms of the MIT License.

data/lib/ticktok/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Ticktok
+  VERSION = "0.1.0"
+end

data/lib/ticktok.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "ticktok/version"
+
+module Ticktok
+  class Timer
+    attr_reader :total_time, :count
+
+    def initialize
+      @total_time = 0
+      @count = 0
+    end
+
+    def add(elapsed)
+      @total_time += elapsed
+      @count += 1
+    end
+
+    def average
+      return 0 if @count == 0
+      @total_time / @count
+    end
+  end
+
+  @timers = {}
+
+  class << self
+    def track(name)
+      start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      result = yield if block_given?
+      end_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      elapsed = end_time - start_time
+
+      @timers[name] ||= Timer.new
+      @timers[name].add(elapsed)
+
+      result
+    end
+
+    def timers
+      @timers.transform_values(&:total_time)
+    end
+
+    def detailed_timers
+      result = {}
+      @timers.each do |name, timer|
+        result[name] = {
+          total: timer.total_time,
+          count: timer.count,
+          average: timer.average
+        }
+      end
+      result
+    end
+
+    def reset
+      @timers = {}
+    end
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: ticktok
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mumen Musa
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-04-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ticktok provides a simple way to measure and track execution time in
+  your Ruby code
+email:
+- mumen@musa.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/ticktok.rb
+- lib/ticktok/version.rb
+homepage: https://github.com/mumenmusa/ticktok
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: A gem for tracking time for benchmarks
+test_files: []