window_arranger 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5e27210e52c0fe2db06876f1c2ae7908e96281b458beccd668d0e5feaa03682c
+  data.tar.gz: e0fc4319f856e702be92de0da484a9252fe3111e1833c3d822d345433925bc9f
+SHA512:
+  metadata.gz: 2d078426103f15269e6e70ce49f933ee6e92eed50cebb456ccd54a7a2cd87b1260c69116a1b6fbc2dd3f9cc8ac1eff61754f435a18f7662cad8187d19ff4398b
+  data.tar.gz: 4b0bfd32da7d138fd0e661521173f92daeac71968858009c992e95c91372b9f3bfc2f9468eefac66be3fac7c411beeefd96209019be4607945a1152591983628

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,134 @@
+AllCops:
+  Exclude:
+    - bin/*
+    - node_modules/**/*
+  NewCops: enable
+  TargetRubyVersion: 3.0
+
+Layout/CaseIndentation:
+  EnforcedStyle: end
+
+Layout/EndAlignment:
+  EnforcedStyleAlignWith: variable
+
+Layout/LineLength:
+  Enabled: false
+
+Layout/EmptyLinesAroundAccessModifier:
+  EnforcedStyle: only_before
+
+Layout/SpaceInLambdaLiteral:
+  EnforcedStyle: require_space
+
+Layout/SpaceInsideBlockBraces:
+  SpaceBeforeBlockParameters: false
+
+Layout/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Naming/HeredocDelimiterNaming:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Enabled: false
+
+Naming/PredicateName:
+  Enabled: false
+
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/EmptyCaseCondition:
+  Enabled: false
+
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/HashAsLastArrayItem:
+  Enabled: false
+
+Style/HashSyntax:
+  Exclude:
+    - Rakefile
+    - "**/*.rake"
+
+Style/Lambda:
+  EnforcedStyle: literal
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/KeywordParametersOrder:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/NumericPredicate:
+  Enabled: false
+
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%i': '()'
+    '%w': '()'
+    '%r': '()'
+
+Style/SpecialGlobalVars:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/SymbolArray:
+  Enabled: false
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: consistent_comma
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: consistent_comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: consistent_comma
+
+Style/ZeroLengthPredicate:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 3.1.0
+before_install: gem install bundler -v 2.1.2

data/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in window_arranger.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"
+
+gem "rubocop", "~> 1.65"
+
+gem "thor", "~> 1.3"
+
+gem "thor-zsh_completion", "~> 0.1.10"

data/Gemfile.lock

@@ -0,0 +1,69 @@
+PATH
+  remote: .
+  specs:
+    window_arranger (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    diff-lcs (1.5.1)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    parallel (1.26.3)
+    parser (3.3.4.2)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (12.3.3)
+    regexp_parser (2.9.2)
+    rexml (3.3.6)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.65.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.4, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.32.1)
+      parser (>= 3.3.1.0)
+    ruby-progressbar (1.13.0)
+    strscan (3.1.0)
+    thor (1.3.1)
+    thor-zsh_completion (0.1.10)
+      thor (< 2)
+    unicode-display_width (2.5.0)
+
+PLATFORMS
+  arm64-darwin-21
+  ruby
+
+DEPENDENCIES
+  rake (~> 12.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.65)
+  thor (~> 1.3)
+  thor-zsh_completion (~> 0.1.10)
+  window_arranger!
+
+BUNDLED WITH
+   2.5.16

data/README.md

@@ -0,0 +1,60 @@
+# window-arranger
+
+`window-arranger` is a command-line tool for macOS that allows you to manage your application windows by list their positions and sizes to a YAML format, and configuring them using a YAML format. This tool is useful for developers or streamers who want to automate their window layouts.
+
+## Requirements
+
+    Ruby (>= 3)
+
+## Installation
+
+    $ gem install window_arranger
+
+## Usage
+
+### List Window Layout
+
+You can list the current window layout to a YAML format with the following command:
+
+    $ window-arranger list
+
+### Update Window Layout
+
+To update a window layout from a YAML format, use:
+
+    $ cat windows.yml | window-arranger update
+
+
+### Example YAML Format
+
+Here’s an example of what the YAML string might look like:
+
+    ---
+    - appName: Arc # matches app named `Arc`
+      position:
+      - 0
+      - 25
+      size:
+      - 1280
+      - 1067
+    - appName:
+        regexp: ^Sla # matches app that has name starts widh `Sl` (eg. Slack)
+      position:
+      - 2560
+      - 25
+      size:
+      - 1280
+      - 1067
+
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/labocho/window_arranger.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "window_arranger"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/rubocop

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/window-arranger

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "window_arranger"
+
+WindowArranger::CLI.start(ARGV)

data/lib/window_arranger/cli.rb

@@ -0,0 +1,28 @@
+require "thor"
+require "thor/zsh_completion"
+
+require "yaml"
+require "json"
+
+module WindowArranger
+  class CLI < Thor
+    include ZshCompletion::Command
+
+    desc "list", "List windows"
+    def list
+      windows = WindowArranger::Script.list_windows
+      puts windows.to_yaml
+    end
+
+    desc "Update", "Update size and position of windows"
+    def update
+      definitions = YAML.safe_load($stdin.read)
+      WindowArranger::Script.update_bounds(definitions).each do |log|
+        next unless log["type"] == "update"
+
+        puts "Updated: #{log["definition"]}"
+      end
+      puts "Done."
+    end
+  end
+end

data/lib/window_arranger/script.rb

@@ -0,0 +1,85 @@
+require "shellwords"
+require "open3"
+require "json"
+
+module WindowArranger
+  module Script
+    class ScriptError < ::WindowArranger::Error; end
+
+    module_function
+
+    def osascript(script, *args)
+      out, err, status = Open3.capture3("osascript", "-l", "JavaScript", "-e", script, *args)
+      unless status.success?
+        raise ScriptError, err
+      end
+
+      [out, err, status]
+    end
+
+    # 3s くらいかかる
+    def list_windows
+      script = <<~JS
+        function run(argv) {
+          var systemEvents = Application('System Events');
+          var allWindows = [];
+
+          systemEvents.processes().forEach(function(proc) {
+            proc.windows().forEach(function(win) {
+                allWindows.push({appName: proc.name(), appShortName: proc.shortName(), windowName: win.name(), position: win.position(), size: win.size()});
+            });
+          });
+
+          return JSON.stringify(allWindows);
+        }
+      JS
+
+      out, * = osascript(script)
+      JSON.parse(out)
+    end
+
+    # 3s くらいかかる
+    # definitions: [{appName: (String|{regexp: String}), appShortName: (String|{regexp: String}), windowName: (String|{regexp: String}), position: [x: Number, y: Number], size: [width: Number, height: Number]}]
+    def update_bounds(definitions)
+      script = <<~JS
+        function matchPattern(pattern, str) {
+          if (pattern.regexp) {
+            return new RegExp(pattern.regexp).test(str);
+          } else {
+            return pattern === str;
+          }
+        }
+        function match(attributes, definition) {
+          if (definition.appName && matchPattern(definition.appName, attributes.appName) !== true) return false;
+          if (definition.appShortName && matchPattern(definition.appShortName, attributes.appShortName) !== true) return false;
+          if (definition.windowName && matchPattern(definition.windowName, attributes.windowName) !== true) return false;
+          return true;
+        }
+        function run(argv) {
+          var definitions = JSON.parse(argv[0]);
+          var systemEvents = Application('System Events');
+          var logs = [];
+
+          systemEvents.processes().forEach(function(proc) {
+            proc.windows().forEach(function(win) {
+              var attrs = {appName: proc.name(), appShortName: proc.shortName(), windowName: win.name()};
+              definitions.forEach(function(definition) {
+                if (match(attrs, definition)) {
+                  if (definition.position) win.position = definition.position;
+                  if (definition.size) win.size = definition.size;
+                  logs.push({type: "update", attributes: attrs, definition: definition})
+                }
+              });
+            });
+          });
+
+          return JSON.stringify(logs);
+        }
+      JS
+
+      out, err, * = osascript(script, JSON.dump(definitions))
+      warn err unless err.empty?
+      JSON.parse(out)
+    end
+  end
+end

data/lib/window_arranger/version.rb

@@ -0,0 +1,3 @@
+module WindowArranger
+  VERSION = "0.1.0".freeze
+end

data/lib/window_arranger.rb

@@ -0,0 +1,9 @@
+require "window_arranger/version"
+
+module WindowArranger
+  class Error < StandardError; end
+  # Your code goes here...
+end
+
+require "window_arranger/cli"
+require "window_arranger/script"

data/window_arranger.gemspec

@@ -0,0 +1,27 @@
+require_relative "lib/window_arranger/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "window_arranger"
+  spec.version       = WindowArranger::VERSION
+  spec.authors       = ["labocho"]
+  spec.email         = ["labocho@penguinlab.jp"]
+
+  spec.summary       = "Arrange window positions on macOS"
+  spec.description   = "Arrange window positions on macOS"
+  spec.homepage      = "https://github.com/labocho/window_arranger"
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/labocho/window_arranger"
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # 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(__dir__)) do
+    `git ls-files -z`.split("\x0").reject {|f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r(^exe/)) {|f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  spec.metadata["rubygems_mfa_required"] = "true"
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: window_arranger
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- labocho
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-08-26 00:00:00.000000000 Z
+dependencies: []
+description: Arrange window positions on macOS
+email:
+- labocho@penguinlab.jp
+executables:
+- window-arranger
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/rubocop
+- bin/setup
+- exe/window-arranger
+- lib/window_arranger.rb
+- lib/window_arranger/cli.rb
+- lib/window_arranger/script.rb
+- lib/window_arranger/version.rb
+- window_arranger.gemspec
+homepage: https://github.com/labocho/window_arranger
+licenses: []
+metadata:
+  homepage_uri: https://github.com/labocho/window_arranger
+  source_code_uri: https://github.com/labocho/window_arranger
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: Arrange window positions on macOS
+test_files: []