device_input 1.0.0.1 → 1.0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01a4b48883bd7c07006de058e16d3ff8ff1d9792b8905eb8abae64a82e577e5a
-  data.tar.gz: c61bb60b4f227a3718cf90c4704df38574a7a52797cd644549a15a0076b52175
+  metadata.gz: ad6579dcc34efa4420edde0db593da7023730451f37b805e98b438a271bfad36
+  data.tar.gz: d7dea2ee2567926f779fa0aca3bcccbbe6e84bce006dd51e275d8f3c163931b0
 SHA512:
-  metadata.gz: 6190ef1adafadaeadd24532e92ca1fa72bbdd72d00583165952b946538f55940cd211cf283171c7e467c705958038afba41c0c43224d0704e527d6ace4d8e89d
-  data.tar.gz: 9a3dcfacafc3487358f88f3796a477410225a4ebfa3e41df06b2afc3da48717e7f053b8ab51ec607f5644ca537b68a371179bade3588b2b3df441a780c7e7e30
+  metadata.gz: fa18a6a3d85040cc87a25be1556cf288bbe7b42154606fe1f17bd587d53236fab9bd11faa9491194067a515addea23b5514138f6e8c1a30dcf77b92592676858
+  data.tar.gz: 56c653f912cbdcb3a054f56e920066245c6859e4f9e51ed83bfe7c4afd3bcefb6dad91e14a39118797a0045529028428e659bb551df90ed628d824c94f5c62f4

data/README.md

@@ -58,7 +58,8 @@ executable code to assist in examining kernel input events.
 
 **REQUIREMENTS**
 
-* Ruby >= 2.0
+* Ruby >= 2.3
+* Earlier rubies are supported on pre-1.0 versions
 
 **DEPENDENCIES**
 
@@ -71,7 +72,7 @@ $ gem install device_input
 
 Or, if using [Bundler](http://bundler.io/), add to your `Gemfile`:
 ```ruby
-gem 'device_input', '~> 0.3'
+gem 'device_input', '~> 1.0'
 ```
 
 # Usage

data/Rakefile

@@ -0,0 +1,120 @@
+require 'rake/testtask'
+desc "Run tests"
+Rake::TestTask.new :test do |t|
+  t.pattern = 'test/*.rb'
+  t.warning = true
+end
+
+task default: :test
+
+
+#
+# METRICS
+#
+
+metrics_tasks = []
+
+begin
+  require 'flog_task'
+
+  # we want: flog --all --methods-only lib
+  # but: FlogTask doesn't support the equivalent of --all; oh well
+  methods_only = true
+  FlogTask.new(:flog, 200, ['lib'], nil, methods_only) do |t|
+    t.verbose = true
+  end
+  metrics_tasks << :flog
+rescue LoadError
+  warn 'flog_task unavailable'
+end
+
+begin
+  require 'flay_task'
+
+  # we want: flay --liberal lib
+  # but: FlayTask doesn't support the equivalent of --liberal; oh well
+  FlayTask.new do |t|
+    t.dirs = ['lib']
+    t.verbose = true
+  end
+  metrics_tasks << :flay
+rescue LoadError
+  warn 'flay_task unavailable'
+end
+
+begin
+  require 'roodi_task'
+  RoodiTask.new patterns: ['lib/**/*.rb']
+  metrics_tasks << :roodi
+rescue LoadError
+  warn 'roodi_task unavailable'
+end
+
+desc "Generate code metrics reports"
+task :code_metrics => metrics_tasks
+
+
+#
+# PROFILING
+#
+
+desc "Show current system load"
+task "loadavg" do
+  puts File.read "/proc/loadavg"
+end
+
+# make sure command is run against lib/ on the filesystem, not an installed gem
+def lib_sh(cmd)
+  sh "RUBYLIB=lib #{cmd}"
+end
+
+# set up script, args, and rprof_args the way ruby-prof wants them
+def rprof_sh(script, args, rprof_args = '')
+  lib_sh ['ruby-prof', rprof_args, script, '--', args].join(' ')
+end
+
+rprof_options = {
+  min_percent: 2,
+  printer: :graph,
+  mode: :process,
+  sort: :self,
+}.inject('') { |memo, (flag,val)| memo + "--#{flag}=#{val} " }
+
+evdump_options = {
+  count: 9999,
+  print: 'off',
+}.inject('') { |memo, (flag,val)| memo + "--#{flag} #{val} " } + '/dev/zero'
+
+desc "Run ruby-prof on bin/evdump (9999 events)"
+task "ruby-prof" => "loadavg" do
+  puts
+  rprof_sh 'bin/evdump', evdump_options, rprof_options
+end
+
+desc "Run ruby-prof with --exclude-common-cycles"
+task "ruby-prof-exclude" => "ruby-prof" do
+  puts
+  rprof_sh 'bin/evdump', evdump_options,
+           "#{rprof_options} --exclude-common-cycles"
+end
+
+task "no-prof" do
+  lib_sh "bin/evdump #{evdump_options}"
+end
+
+
+#
+# GEM BUILD / PUBLISH
+#
+
+begin
+  require 'buildar'
+
+  Buildar.new do |b|
+    b.gemspec_file = 'device_input.gemspec'
+    b.version_file = 'VERSION'
+    b.use_git = true
+  end
+rescue LoadError
+  # ok
+end

data/VERSION

@@ -1 +1 @@
-1.0.0.1
+1.0.1.1

data/device_input.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+  s.name = 'device_input'
+  s.summary = 'Read input events from e.g. /dev/input/event0'
+  s.description = <<EOF
+Pure ruby to read input events from the Linux kernel input device subsystem.
+No dependencies.  Ruby 2+ required
+EOF
+  s.authors = ["Rick Hull"]
+  s.homepage = 'https://github.com/rickhull/device_input'
+  s.license = 'GPL-3.0'
+
+  s.required_ruby_version = ">= 2.3"
+
+  s.version = File.read(File.join(__dir__, 'VERSION')).chomp
+
+  s.files  = %w[device_input.gemspec VERSION README.md Rakefile]
+  s.files += Dir['lib/**/*.rb']
+  s.files += Dir['test/**/*.rb']
+  s.files += Dir['bin/**/*.rb']
+
+  s.executables = ['evdump']
+
+  s.add_runtime_dependency 'slop', '~> 4.0'
+end

data/test/device_input.rb

@@ -0,0 +1,98 @@
+require_relative 'helper.rb'
+
+require 'device_input'
+
+describe DeviceInput::Event do
+  E = DeviceInput::Event
+
+  describe "type_labels" do
+    it "must return an array of strings" do
+      dne = E.type_labels(:does_not_exist)
+      expect(dne).must_be_instance_of(Array)
+      expect(dne.first).must_be_instance_of(String)
+      expect(dne.last).must_be_instance_of(String)
+
+      # 0 is EV_SYN
+      de = E.type_labels(0)
+      expect(de).must_be_instance_of(Array)
+      expect(de.first).must_be_instance_of(String)
+      expect(de.last).must_be_instance_of(String)
+    end
+  end
+
+  describe "code_labels" do
+    it "must return an array of strings" do
+      dne = E.code_labels(:does_not_exist, nil)
+      expect(dne).must_be_instance_of(Array)
+      expect(dne.first).must_be_instance_of(String)
+      expect(dne.last).must_be_instance_of(String)
+
+      # 0,0 = EV_SYN,SYN_REPORT
+      de = E.code_labels(0, 0)
+      expect(de).must_be_instance_of(Array)
+      expect(de.first).must_be_instance_of(String)
+      expect(de.last).must_be_instance_of(String)
+    end
+  end
+
+  describe "encode" do
+    it "must return a string" do
+      expect(E.encode(E::NULL_DATA)).must_be_instance_of(String)
+    end
+  end
+
+  describe "decode" do
+    it "must return a Data (struct)" do
+      expect(E.decode(E::NULL_MSG)).must_be_instance_of(E::Data)
+    end
+  end
+
+  describe "new instance" do
+    before do
+      @event = E.new(E::NULL_DATA)
+    end
+
+    it "must have data" do
+      expect(@event.data).must_be_instance_of(E::Data)
+    end
+
+    it "must have a timestamp" do
+      expect(@event.time).must_be_instance_of(Time)
+    end
+
+    it "must have a type" do
+      expect(@event.type).must_be_instance_of(String)
+    end
+
+    it "must have a code" do
+      expect(@event.code).must_be_instance_of(String)
+    end
+
+    it "must have a value" do
+      expect(@event.value).must_be_kind_of(Integer)
+    end
+
+    it "must have string representations" do
+      [:to_s, :pretty, :raw, :hex].each { |meth|
+        expect(@event.send(meth)).must_be_instance_of(String)
+      }
+    end
+  end
+end
+
+describe DeviceInput do
+  describe "read_loop" do
+    before do
+      @io = StringIO.new("\x00" * 64)
+    end
+
+    it "must read at least one message from an io with 64 bytes" do
+      events = []
+      DeviceInput.read_loop(@io) { |event|
+        events << event
+      }
+      expect(events).wont_be_empty
+      expect(events.first).must_be_instance_of(E)
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,51 @@
+if ENV['CODE_COVERAGE'] and
+  !%w[false no].include?(ENV['CODE_COVERAGE'].downcase)
+
+  require 'simplecov'
+  require 'simplecov_json_formatter'
+
+  class SimpleCov::Formatter::TextFormatter
+    FILENAME = 'metrics/coverage'
+
+    def format(result)
+      tot = result.files
+      rpt = ["Coverage: %0.1f%%" % tot.covered_percent,
+             "Strength: %0.2f" % tot.covered_strength,
+             "   Lines: %i" % tot.lines_of_code,
+             " Covered: %i" % tot.covered_lines,
+             "     N/A: %i" % tot.never_lines,
+            ]
+      if tot.missed_lines > 0
+        rpt << "Missed: %i" % tot.missed_lines
+      end
+      if tot.skipped_lines > 0
+        rpt << "Skipped: %i" % tot.skipped_lines
+      end
+      rpt << result.files.map { |sfile|
+        "%i%% (%i/%i)\t%s" % [sfile.covered_percent,
+                              sfile.covered_lines.length,
+                              sfile.lines_of_code,
+                              sfile.filename]
+      }.join("\n")
+      rpt = rpt.join("\n")
+
+      puts
+      puts rpt
+      if File.writable?(FILENAME)
+        File.open(FILENAME, 'w') { |f|
+          f.write(rpt + "\n")
+        }
+        puts "wrote #{FILENAME}"
+      end
+    end
+  end
+
+  SimpleCov.formatters = [
+    SimpleCov::Formatter::TextFormatter,
+    SimpleCov::Formatter::JSONFormatter,
+  ]
+
+  SimpleCov.start
+end
+
+require 'minitest/autorun'

metadata

@@ -1,43 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: device_input
 version: !ruby/object:Gem::Version
-  version: 1.0.0.1
+  version: 1.0.1.1
 platform: ruby
 authors:
 - Rick Hull
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-08 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: buildar
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2'
 - !ruby/object:Gem::Dependency
   name: slop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
-  type: :development
+        version: '4.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '4.0'
 description: |
   Pure ruby to read input events from the Linux kernel input device subsystem.
   No dependencies.  Ruby 2+ required
@@ -48,10 +34,14 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- Rakefile
 - VERSION
 - bin/evdump
+- device_input.gemspec
 - lib/device_input.rb
 - lib/device_input/labels.rb
+- test/device_input.rb
+- test/helper.rb
 homepage: https://github.com/rickhull/device_input
 licenses:
 - GPL-3.0
@@ -71,7 +61,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.26
+rubygems_version: 3.4.4
 signing_key:
 specification_version: 4
 summary: Read input events from e.g. /dev/input/event0