cirron 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +11 -1
  3. data/cirron.gemspec +1 -1
  4. metadata +10 -10
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3f722ffc04b1680939ef3bcbfbd94ed787a3f43a0c439bb6b308b088ecdb0795
4
- data.tar.gz: 95ab67e0ecc02b80b355536fca9d6fef3fdc1c6e4d236e0bb1ab7c419cf7bf65
3
+ metadata.gz: 3c6c65fcba8e45502f5b64fc1ed150c3685ac487d788309d45c81be29a028da2
4
+ data.tar.gz: b3c3d949d138853c0f5a7bf46fd8fe9ebf83bb957d72d28087b059686a14a122
5
5
  SHA512:
6
- metadata.gz: d39a9e5c38ac51db99711cadf506761274b1013085e24ca64c2f1dff8eccb261bc66f6fb7eae8a8bb452904df130877fc8b3f73e5e7f221e8f4e6b9c95581e79
7
- data.tar.gz: 10f6f669dc6fc5be2937d3a0d02f365bbb51bef2cee037ff76e977f4ca767a1f3ef4e7017c71a8b5d813dd61b16c98a59377ba8c57e4ea566d512a06adba60f4
6
+ metadata.gz: c9f45039a22835fd70ada492f8ad3bf85358f8186d4088886e52cf7ba8bab3e65fab566c6992a6cc6602ce9b9c7a0b2e1426590a263d414b94aebcf0cffe2c94
7
+ data.tar.gz: 5aa6c080a082f99090f613f37455a3e3f4afeff43a4e04a303aff42e130fb49a8d413afb8b1223a110dc44087c7ee6dcdaeb7a8f0a08869f924035ba5a038cba
data/README.md CHANGED
@@ -1,17 +1,23 @@
1
- == Cirron
1
+ = Cirron
2
2
 
3
3
  Cirron measures a piece of Ruby code and reports back several performance counters:
4
4
  CPU instruction count, branch misses, page faults and time spent measuring.
5
5
  It uses the Linux perf events interface or @ibireme's KPC demo[https://gist.github.com/ibireme/173517c208c7dc333ba962c1f0d67d12] on OSX.
6
6
 
7
+ ---
8
+
7
9
  It can also trace syscalls using +strace+, Linux only!
8
10
 
11
+ ---
12
+
9
13
  == Prerequisites
10
14
 
11
15
  * Linux with perf events support / Apple ARM OSX
12
16
  * C++
13
17
  * Ruby 3.x
14
18
 
19
+ ---
20
+
15
21
  == Usage
16
22
 
17
23
  === Performance Counters
@@ -27,6 +33,8 @@ It can also trace syscalls using +strace+, Linux only!
27
33
  # Retrieve the metrics
28
34
  puts collector.counters
29
35
 
36
+ ---
37
+
30
38
  === Syscalls
31
39
 
32
40
  require 'cirron'
@@ -42,6 +50,8 @@ It can also trace syscalls using +strace+, Linux only!
42
50
  # Save the trace for ingesting to Perfetto
43
51
  File.write("/tmp/trace", Cirron.to_tef(trace))
44
52
 
53
+ ---
54
+
45
55
  == Additional Information
46
56
 
47
57
  For more detailed information, please visit the project's GitHub page: https://github.com/s7nfo/Cirron
data/cirron.gemspec CHANGED
@@ -6,7 +6,7 @@ require 'pathname'
6
6
 
7
7
  Gem::Specification.new do |spec|
8
8
  spec.name = "cirron"
9
- spec.version = "0.2.4"
9
+ spec.version = "0.2.6"
10
10
  spec.authors = ["Matt Stuchlik"]
11
11
  spec.email = ["matej.stuchlik@gmail.com"]
12
12
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: cirron
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.4
4
+ version: 0.2.6
5
5
  platform: ruby
6
6
  authors:
7
7
  - Matt Stuchlik
@@ -10,17 +10,17 @@ bindir: exe
10
10
  cert_chain: []
11
11
  date: 2024-07-06 00:00:00.000000000 Z
12
12
  dependencies: []
13
- description: "== Cirron\n\nCirron measures a piece of Ruby code and reports back several
13
+ description: "= Cirron\n\nCirron measures a piece of Ruby code and reports back several
14
14
  performance counters: \nCPU instruction count, branch misses, page faults and time
15
15
  spent measuring. \nIt uses the Linux perf events interface or @ibireme's KPC demo[https://gist.github.com/ibireme/173517c208c7dc333ba962c1f0d67d12]
16
- on OSX.\n\nIt can also trace syscalls using +strace+, Linux only!\n\n== Prerequisites\n\n*
17
- Linux with perf events support / Apple ARM OSX\n* C++\n* Ruby 3.x\n\n== Usage\n\n===
18
- Performance Counters\n\n require 'cirron'\n\n # Start collecting performance metrics\n
19
- \ Cirron::Collector.new do |collector|\n # Your code here\n # ...\n end\n\n
20
- \ # Retrieve the metrics\n puts collector.counters\n\n=== Syscalls\n\n require
21
- 'cirron'\n\n Cirron::Tracer.new do |tracer|\n # Your code here\n # ...\n
22
- \ end\n\n # Stop collecting and retrieve the trace\n puts tracer.trace\n\n #
23
- Save the trace for ingesting to Perfetto\n File.write(\"/tmp/trace\", Cirron.to_tef(trace))\n\n==
16
+ on OSX.\n\n---\n\nIt can also trace syscalls using +strace+, Linux only!\n\n---\n\n==
17
+ Prerequisites\n\n* Linux with perf events support / Apple ARM OSX\n* C++\n* Ruby
18
+ 3.x\n\n---\n\n== Usage\n\n=== Performance Counters\n\n require 'cirron'\n\n #
19
+ Start collecting performance metrics\n Cirron::Collector.new do |collector|\n #
20
+ Your code here\n # ...\n end\n\n # Retrieve the metrics\n puts collector.counters\n\n---\n\n===
21
+ Syscalls\n\n require 'cirron'\n\n Cirron::Tracer.new do |tracer|\n # Your code
22
+ here\n # ...\n end\n\n # Stop collecting and retrieve the trace\n puts tracer.trace\n\n
23
+ \ # Save the trace for ingesting to Perfetto\n File.write(\"/tmp/trace\", Cirron.to_tef(trace))\n\n---\n\n==
24
24
  Additional Information\n\nFor more detailed information, please visit the project's
25
25
  GitHub page: https://github.com/s7nfo/Cirron"
26
26
  email: