tiling 1.0

data/NEWS

@@ -0,0 +1,3 @@
+v1.0  2013-03-20
+
+  * Two layouts, vertical and horizontal

data/README.markdown

@@ -0,0 +1,105 @@
+TILING
+================
+
+Description
+----------------------
+**Tiling** provides a *simple window tiling* system for linux.
+This is for those who cannot (or don't want to) use a tiling window manager like
+awesome or Xmonad.
+
+There is no menu nor GUI in **tiling**. This is because I want to keep
+**tiling** as simple as possible. You just (optionaly) focus a window and
+press a keyboard shortcut and that's it: all windows in the current virtual
+desktop are tiled.
+
+For now **tiling** provides two layouts: horizontal and vertical, where a
+«master» window occupy the top, or the left, of the screen, while remaining
+windows share the rest of the screen.
+
+###Examples
+
+![Vertical, 2 windows](screenshots/Capture-3-small.png)
+
+![Horizontal, 2 windows](screenshots/Capture-4-small.png)
+
+![Vertical, 3 windows](screenshots/Capture-5-small.png)
+
+![Horizontal, 3 windows](screenshots/Capture-6-small.png)
+
+
+
+Install
+-------------------------
+
+### Installing the gem
+
+*Using rvm is highly recommended.*
+
+If your system ruby is at least 1.9.2 :
+
+    rvm use system
+    gem install tiling
+
+That's it, go to create keyboard shortcuts. But if your system ruby
+is older, you'll need the following trick.
+
+    rvm use 1.9.3@global
+    gem install tiling
+Now, copy the file shell/tiling.sh somewhere in your path (maybe in
+$HOME/bin) and **edit the last but one line** to reflect your rvm settings.
+
+### Create keyboard shortcuts
+
+In Debian, open System > Preferences > Keyboard shortcuts.
+Click Add to add a new shortcuts. In name, enter «Horizontal layout»,
+in command, enter «tiling -H» (uppercase H). If you are using tiling.sh,
+you have to enter «tiling.sh -H» instead of «tiling -H».
+
+Then close the dialog and make your shortcut, maybe Mod4+h, or Ctrl+Alt+h,
+or whatever you want.
+
+Do this again for a second shortcut. Name it «Vertical layout», enter the
+command «tiling -V» (or «tiling.sh -V») and make the shortcut you want.
+Note the uppercase V.
+
+Usage
+--------------------------
+
+Easy. Focus a window and type your shortcut.
+
+Dependencies
+--------------------------
+
+ruby >= 1.9.2
+
+License
+--------------------------
+
+MIT
+
+    Copyright (c) 2013 Xavier Nayrac
+
+    Permission is hereby granted, free of charge, to any person obtaining
+    a copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be included
+    in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Questions and/or Comments
+--------------------------
+
+Feel free to email [Xavier Nayrac](mailto:xavier.nayrac@gmail.com)
+with any questions.

data/Rakefile

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+
+
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc 'Test'
+task :default => :spec
+
+desc 'Test tiling with rspec'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ['--color']
+end
+
+desc 'Check for code smells'
+task :reek do
+  puts 'Checking for code smells...'
+  files = Dir.glob 'lib/**/*.rb'
+  # files.delete FILE_TO_EXCLUDE
+  args = files.join(' ')
+  sh "reek --quiet #{args} | ./reek.sed"
+end
+
+desc 'Check refactoring candidates'
+task :flay do
+  sh "flay lib/*.rb"
+end
+
+desc 'Build gem & install it'
+task :install do
+  sh "rm tiling*gem"
+  sh "gem build tiling.gemspec"
+	f = FileList['tiling*gem'].to_a
+	sh "gem install #{f.first}"
+end

data/TODO

@@ -0,0 +1,5 @@
+rubygem
+
+
+layout stack
+mosaic

data/VERSION

@@ -0,0 +1 @@
+1.0

data/bin/tiling

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# -*- encoding: utf-8 -*-
+
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+$TILING_PATH = File.expand_path(File.dirname(__FILE__)) + '/..'
+
+require 'tiling'
+
+Tiling.run
+

data/lib/tiling/frame_extents.rb

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+
+  # Public: Décoration de fenêtre.
+  class FrameExtents
+    attr_reader :left, :right, :top, :bottom
+
+    def initialize extents
+      @left = extents[0]
+      @right = extents[1]
+      @top = extents[2]
+      @bottom = extents[3]
+    end
+  end
+
+end

data/lib/tiling/horizontal_layout.rb

@@ -0,0 +1,47 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+
+  # Public: Met en place un layout horizontal.
+  class HorizontalLayout < Layout
+
+    private
+
+      def calculate_master
+        @master[:height_exterior] = (@workspace.height - @workspace.y) / 2
+        ext = FrameExtents.new(@master[:frame_extents])
+        @master[:height] = @master[:height_exterior] - ext.top - ext.bottom
+        @master[:width] = @workspace.width - ext.left - ext.right
+      end
+
+      def position_remaining_windows
+        @real_width = @workspace.width / @windows.count
+        @x = @workspace.x
+        @y = @workspace.y + @master[:height_exterior]
+        @windows.each { |win| position_window win }
+      end
+
+      def position_window win
+        @ext = FrameExtents.new(win[:frame_extents])
+        width = get_win_width
+        height = get_win_height
+        move_resize_window win, width, height
+        @x += @real_width
+      end
+
+      def get_win_width
+        @real_width - @ext.left- @ext.right
+      end
+
+      def get_win_height
+        tmp = @workspace.y + @master[:height_exterior]
+        @workspace.height - tmp - @ext.top - @ext.bottom
+      end
+
+      def move_resize_window win, width, height
+        Mover.move(win[:id], @x, @y, width, height)
+      end
+
+  end
+
+end

data/lib/tiling/layout.rb

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+
+  # Public: Classe de base pour les layouts.
+  class Layout
+
+    def initialize workspace, windows
+      @workspace = workspace
+      @windows = windows
+      @master = windows.master
+    end
+
+    def lay_master_window
+      calculate_master
+      Mover.move @master[:id], @workspace.x, @workspace.y, @master[:width],
+                 @master[:height]
+    end
+
+    def lay_remaining_windows
+      position_remaining_windows unless @windows.empty?
+    end
+
+  end
+
+end

data/lib/tiling/mover.rb

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+  # Move a window.
+  class Mover
+    def self.move id, x, y, width, height
+      WMCtrl.instance.action_window(id, :move_resize, 0, x, y, width, height)
+    end
+  end
+end

data/lib/tiling/option.rb

@@ -0,0 +1,52 @@
+# -*- encoding: utf-8 -*-
+
+require 'optparse'
+
+module Tiling
+
+  # Public: Set the options.
+  class Option
+
+    def initialize
+      @options = {horizontal: false, vertical: false, version: false }
+      optparse = OptionParser.new do|opts|
+        opts.on( '-H', '--horizontal', 'Horizontal layout' ) do
+          @options[:horizontal] = true
+        end
+        opts.on( '-V', '--vertical', 'Vertical layout' ) do
+          @options[:vertical] = true
+        end
+        opts.on( '-v', '--version', 'Print version number and exit' ) do
+          @options[:version] = true
+        end
+        opts.on( '-h', '--help', 'Display this screen' ) do
+          puts opts
+          exit
+        end
+      end
+
+      begin
+        optparse.parse!
+      rescue OptionParser::InvalidOption => e
+        puts e.to_s
+        exit 1
+      end
+
+      print_version if @options[:version]
+    end
+
+    def [](key)
+      @options[key]
+    end
+
+    private
+
+      def print_version
+        puts "wlayout #{File.read(File.join($WLAYOUT_PATH, 'VERSION')).strip}" 
+        exit
+      end
+
+  end
+
+end
+

data/lib/tiling/vertical_layout.rb

@@ -0,0 +1,48 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+
+  # Public: Met en place un layout vertical.
+  class VerticalLayout < Layout
+
+    private
+
+      def calculate_master
+        @master[:width_exterior] = (@workspace.width - @workspace.x) / 2
+        ext = FrameExtents.new(@master[:frame_extents])
+        @master[:width] = @master[:width_exterior] - ext.left - ext.right
+        @master[:height] = @workspace.height - ext.top - ext.bottom
+      end
+
+      def position_remaining_windows
+        @real_height = @workspace.height / @windows.count
+        @y = @workspace.y
+        @x = @workspace.x + @master[:width_exterior]
+        @windows.each { |win| position_window win }
+      end
+
+      def position_window win
+        @ext = FrameExtents.new(win[:frame_extents])
+        height = get_win_height
+        width = get_win_width
+        move_resize_window win, width, height
+        @y += @real_height
+      end
+
+      def get_win_height
+        @real_height - @ext.top - @ext.bottom
+      end
+
+      def get_win_width
+        tmp = @workspace.x + @master[:width_exterior]
+        @workspace.width - tmp - @ext.left - @ext.right
+      end
+
+      def move_resize_window win, width, height
+        Mover.move(win[:id], @x, @y, width, height)
+      end
+
+  end
+
+end
+

data/lib/tiling/windows.rb

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+
+  # Public: Find our windows.
+  class Windows
+
+    attr_reader :master
+
+    def initialize workspace
+      @workspace = workspace
+      @wm = WMCtrl.instance
+      find_windows
+    end
+
+    def empty?
+      @windows.empty?
+    end
+
+    def count
+      @windows.count
+    end
+
+    def each &block
+      @windows.each &block
+    end
+
+    private
+
+      def find_windows
+        @windows = windows_in_active_workspace
+        put_active_window_on_top
+        @master = get_master_window
+      end
+
+      def windows_in_active_workspace
+        @wm.windows.select { |win| win[:desktop] == @workspace.id }
+      end
+
+      def put_active_window_on_top
+        @windows.sort! { |x,y| y[:active] ? 1 : -1 }
+      end
+
+      def get_master_window
+        @windows.slice!(0)
+      end
+
+  end
+end

data/lib/tiling/workspace.rb

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8 -*-
+
+module Tiling
+  # Public: Current workspace (virtual desktop) state.
+  class Workspace
+
+    attr_reader :id
+
+    def initialize
+      @desktops = WMCtrl.instance.desktops
+      @desktops.each do |desktop|
+        if desktop[:current]
+          @id = desktop[:id]
+          break
+        end
+      end
+    end
+
+    def x
+      @desktops[@id][:workarea][0]
+    end
+
+    def y
+      @desktops[@id][:workarea][1]
+    end
+
+    def width
+      @desktops[@id][:workarea][2]
+    end
+
+    def height
+      @desktops[@id][:workarea][3]
+    end
+
+  end
+end

data/lib/tiling.rb

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+
+gem 'ruby-wmctrl', '0.0.5'
+require 'wmctrl'
+require 'tiling/workspace'
+require 'tiling/windows'
+require 'tiling/layout'
+require 'tiling/horizontal_layout'
+require 'tiling/vertical_layout'
+require 'tiling/mover'
+require 'tiling/option'
+require 'tiling/frame_extents'
+
+
+module Tiling
+  def self.run
+    options = Option.new
+    workspace = Workspace.new
+    windows = Windows.new workspace
+    exit if windows.empty?
+    if options[:vertical]
+      layout = VerticalLayout.new workspace, windows
+    else
+      layout = HorizontalLayout.new workspace, windows
+    end
+    layout.lay_master_window
+    layout.lay_remaining_windows
+  end
+end

data/shell/tiling.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Load RVM into a shell session *as a function*
+if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
+
+  # First try to load from a user install
+  source "$HOME/.rvm/scripts/rvm"
+
+elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
+
+  # Then try to load from a root install
+  source "/usr/local/rvm/scripts/rvm"
+
+else
+
+  printf "ERROR: An RVM installation was not found.\n"
+
+fi
+
+rvm use 1.9.3-p374@global
+tiling $1

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: tiling
+version: !ruby/object:Gem::Version
+  version: '1.0'
+  prerelease: 
+platform: ruby
+authors:
+- Xavier Nayrac
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-wmctrl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+description: ! 'Tiling provides a simple window tiling system for linux.
+
+  This is for those who cannot (or don''t want to) use a tiling window manager like
+
+  awesome or Xmonad.'
+email: xavier.nayrac@gmail.com
+executables:
+- tiling
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tiling/option.rb
+- lib/tiling/windows.rb
+- lib/tiling/frame_extents.rb
+- lib/tiling/vertical_layout.rb
+- lib/tiling/mover.rb
+- lib/tiling/workspace.rb
+- lib/tiling/horizontal_layout.rb
+- lib/tiling/layout.rb
+- lib/tiling.rb
+- bin/tiling
+- shell/tiling.sh
+- VERSION
+- NEWS
+- README.markdown
+- Rakefile
+- TODO
+homepage: https://github.com/lkdjiin/tiling
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Some windows layouts for (I hope so) any common linux desktop
+test_files: []