sysdo 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 526340346fe535a7a51c3b275c3453d65fa5eb99339bce3ad66112a30621622b
+  data.tar.gz: 7e6a04616a5cbb990b8ab38557dea1ffabd6cc6db7905f110ddd7d30fbf9af27
+SHA512:
+  metadata.gz: 826769e8392dcc22e31eb8d22f7a007a624c60142ed2b1e491f332f91b5ad926c58036cd7f90879ecbb20e17cca151b19adf92004426ac6890f37195093dbefa
+  data.tar.gz: 33159a9e470d42b229f92e3f5e886ebad3bb45a012297015849ab15e3c716d9cd3781d9ff018172d34794ce5d0e9ee7485bf1717f098e31db7752d52df85af14

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in parlour.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,37 @@
+PATH
+  remote: .
+  specs:
+    sysdo (0.0.1)
+      daemons (~> 1.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    daemons (1.3.1)
+    diff-lcs (1.4.4)
+    rake (13.0.3)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  rake (>= 12.3.3)
+  rspec (~> 3.0)
+  sysdo!
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,35 @@
+# Sysdo
+
+Sysdo is a tiny automation framework for gluing bits of your Linux system
+together. Sysdo provides events, and you write Ruby to do things automatically
+when the events fire.
+
+```ruby
+# If we're on the go, automatically switch to power-saving CPU frequency
+on Battery.charger_disconnected do
+  `cpupower frequency-set -g powersave`
+end
+
+# Don't let Steam eat all of your data allowance when tethering
+on Network.changed do |network|
+  if network.ssid == "Aaron's Phone"
+    `pkill -9 steam`
+  end
+end
+```
+
+If you've used Tasker on Android, or Shortcuts on iOS, or Automator on macOS,
+this is somewhat similar in the things you can achieve (albeit a bit more
+hands-on).
+
+This isn't really ready for proper usage yet, but with a bit more polish and a
+larger library of events, it's not far off!
+
+## Usage
+
+1. Install with `gem install sysdo`.
+2. Create a `sysdo` directory under your user config directory (defaults to
+`XDG_CONFIG_HOME`, or `~/.config` if that's unset).
+3. Put some Ruby scripts in there. You can create as many as you like and 
+   they'll all be loaded; the names don't matter as long as they end in `.rb`.
+4. Run `sysdo start` to launch the Sysdo daemon.

data/exe/sysdo

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+require 'sysdo'
+require 'fileutils'
+require 'thwait'
+require 'daemons'
+
+include Sysdo::SourceLibrary
+
+dsl = Sysdo::Dsl.new
+Sysdo::Cli.user_scripts.each do |file|
+  dsl.instance_eval(File.read(file))
+end
+
+Daemons.run_proc('sysdo') do
+  threads = dsl.event_sources.map do |src|
+    t = Thread.new { src.listen }
+    t.abort_on_exception = true
+    t
+  end
+
+  ThreadsWait.all_waits(*threads)
+end

data/lib/sysdo.rb

@@ -0,0 +1,10 @@
+require 'sysdo/source_library/usb'
+require 'sysdo/source_library/network'
+require 'sysdo/source_library/battery'
+require 'sysdo/event_source'
+require 'sysdo/event_source/polled_collection_change'
+require 'sysdo/event_source/polled_equal_change'
+require 'sysdo/event_source/polled_change'
+require 'sysdo/dsl'
+require 'sysdo/cli'
+require 'sysdo/version'

data/lib/sysdo/cli.rb

@@ -0,0 +1,17 @@
+module Sysdo
+  module Cli
+    CONFIG_DIRECTORY = File.join(
+      ENV['XDG_CONFIG_HOME'] || File.expand_path('~/.config'),
+      'sysdo',
+    )
+
+    def self.user_scripts
+      create_config_directory
+      Dir[File.join(CONFIG_DIRECTORY, '*.rb')]
+    end
+
+    def self.create_config_directory
+      FileUtils.mkdir_p(CONFIG_DIRECTORY)
+    end
+  end
+end

data/lib/sysdo/dsl.rb

@@ -0,0 +1,14 @@
+module Sysdo
+  class Dsl
+    attr_reader :event_sources
+
+    def initialize
+      @event_sources = []
+    end
+
+    def on(event_source, &action)
+      event_source.on_fire = action
+      @event_sources << event_source
+    end
+  end
+end

data/lib/sysdo/event_source.rb

@@ -0,0 +1,19 @@
+module Sysdo
+  class EventSource
+    attr_accessor :on_fire
+
+    def initialize(&listener)
+      @listener = listener
+      @on_fire = ->{}
+    end
+
+    def fire(*args, **kwargs)
+      @on_fire.(*args, **kwargs)
+    end
+
+    def listen
+      @listener.(self)
+      # TODO: what if this dies?
+    end
+  end
+end

data/lib/sysdo/event_source/polled_change.rb

@@ -0,0 +1,21 @@
+module Sysdo
+  class EventSource
+    class PolledChange < EventSource
+      def initialize(poll_rate = 1, &value)        
+        super() do |s|
+          last = value.()
+
+          loop do
+            now = value.()
+            if last != now
+              s.fire(now)
+            end
+            last = now
+
+            sleep poll_rate
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sysdo/event_source/polled_collection_change.rb

@@ -0,0 +1,32 @@
+module Sysdo
+  class EventSource
+    class PolledCollectionChange < EventSource
+      def initialize(change, poll_rate = 1, &collection)
+        raise "change parameter must be :add or :remove" \
+          unless change == :add || change == :remove
+        
+        super() do |s|
+          last = collection.()
+
+          loop do
+            now = collection.()
+            if last != now
+              if change == :add
+                relevant_items = now - last
+              elsif change == :remove
+                relevant_items = last - now
+              end
+
+              relevant_items.each do |new_item|
+                s.fire(new_item)
+              end unless relevant_items.empty?
+            end
+            last = now
+
+            sleep poll_rate
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sysdo/event_source/polled_equal_change.rb

@@ -0,0 +1,21 @@
+module Sysdo
+  class EventSource
+    class PolledEqualChange < EventSource
+      def initialize(equal, poll_rate = 1, &value)        
+        super() do |s|
+          last = value.()
+
+          loop do
+            now = value.()
+            if last != now && now == equal
+              s.fire(now)
+            end
+            last = now
+
+            sleep poll_rate
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sysdo/source_library/battery.rb

@@ -0,0 +1,29 @@
+module Sysdo
+  module SourceLibrary
+    module Battery
+      def self.charger_connected
+        EventSource::PolledEqualChange.new(true) { charger_connected? }
+      end
+
+      def self.charger_disconnected
+        EventSource::PolledEqualChange.new(false) { charger_connected? }
+      end
+
+      protected
+
+      BATTERY = '/org/freedesktop/UPower/devices/battery_BAT0'
+
+      def self.charger_connected?
+        # Can be "fully-charged" or "charging", so this is easier
+        battery_info['state'] != 'discharging'
+      end
+
+      def self.battery_info
+        # World's most naive upower parser
+        `upower -i "#{BATTERY}"`.each_line.map do |line|
+          [$~['key'], $~['value']] if /^\s*(?<key>.+):\s*(?<value>.+)$/ === line
+        end.compact.to_h
+      end
+    end
+  end
+end

data/lib/sysdo/source_library/network.rb

@@ -0,0 +1,27 @@
+module Sysdo
+  module SourceLibrary
+    # Only supports Wi-Fi
+    module Network
+      def self.changed
+        EventSource::PolledChange.new { network_status }
+      end
+
+      protected
+
+      NetworkStatus = Struct.new('NetworkStatus', :connected, :type, :ssid) do
+        def connected?
+          connected
+        end
+      end
+
+      def self.network_status
+        ssid = `iwgetid -r`.chomp
+        if $?.success?
+          NetworkStatus.new(true, :wifi, ssid)
+        else
+          NetworkStatus.new(false, nil, nil)
+        end
+      end
+    end
+  end
+end

data/lib/sysdo/source_library/usb.rb

@@ -0,0 +1,24 @@
+module Sysdo
+  module SourceLibrary
+    module Usb
+      def self.connected
+        EventSource::PolledCollectionChange.new(:add) { attached_devices }
+      end
+
+      def self.disconnected
+        EventSource::PolledCollectionChange.new(:remove) { attached_devices }
+      end
+
+      protected
+
+      UsbDevice = Struct.new('UsbDevice', :name, :id, :bus, :device)
+
+      def self.attached_devices
+        `lsusb`.each_line.map do |line|
+          UsbDevice.new($~['name'], $~['id'], $~['bus'].to_i, $~['device'].to_i) \
+            if /^Bus (?<bus>\d+) Device (?<device>\d+): ID (?<id>.{4}:.{4}) (?<name>.+)$/ === line.strip
+        end.compact
+      end
+    end
+  end
+end

data/lib/sysdo/version.rb

@@ -0,0 +1,3 @@
+module Sysdo
+  VERSION = '0.0.1'
+end

data/sysdo.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "sysdo"
+
+Gem::Specification.new do |spec|
+  spec.name          = "sysdo"
+  spec.version       = Sysdo::VERSION
+  spec.authors       = ["Aaron Christiansen"]
+  spec.email         = ["hello@aaronc.cc"]
+
+  spec.summary       = %q{Do things automatically}
+  spec.homepage      = "https://github.com/AaronC81/sysdo"
+  spec.license       = "MIT"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|sorbet)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "daemons", "~> 1.3"
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", ">= 12.3.3"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: sysdo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Aaron Christiansen
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2020-12-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: daemons
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: 12.3.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
+- !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:
+email:
+- hello@aaronc.cc
+executables:
+- sysdo
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- exe/sysdo
+- lib/sysdo.rb
+- lib/sysdo/cli.rb
+- lib/sysdo/dsl.rb
+- lib/sysdo/event_source.rb
+- lib/sysdo/event_source/polled_change.rb
+- lib/sysdo/event_source/polled_collection_change.rb
+- lib/sysdo/event_source/polled_equal_change.rb
+- lib/sysdo/source_library/battery.rb
+- lib/sysdo/source_library/network.rb
+- lib/sysdo/source_library/usb.rb
+- lib/sysdo/version.rb
+- sysdo.gemspec
+homepage: https://github.com/AaronC81/sysdo
+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.0.3
+signing_key:
+specification_version: 4
+summary: Do things automatically
+test_files: []