mucks 0.0.0.alpha.1 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5f54c819c52e06392254f4903bf2792723a7464d
-  data.tar.gz: ac4d6142b5a84bdcefc8cc0db8eef815bea7efb1
+  metadata.gz: b34c0969733ec94dcf1a1c39fdf9a813797b94ff
+  data.tar.gz: b47e4254c6736e6615346ed1da99f40b197c0ac0
 SHA512:
-  metadata.gz: 84d2c37139c67cb50199bcfd86173293667064c546450843308a4a2300aabf6c9a4782341d2a4bd1e1a3ce07a39186528700d4e123473296d062d3bdfe150ae8
-  data.tar.gz: 56d98b384e6c4135900177646b99100825d6261d21baf37c5c08b1a63f28c99b99978f8e07020ef248dcbfbd506d3314bc28960fb2eeeebaa7b8468e98beff33
+  metadata.gz: df80b113e6bd6efc24cc3180f438c12b19200bcd9286124d606f9c252820049c2bce3a0d38e8a08017826dddce92b0e61a0352d3a84540b78f60d5664f4c56b7
+  data.tar.gz: 2a97e9bfc3ec9f213b24a39aa825398ead6c92ac1b852d15b3d0568589c99b7b9a69987b9b2fb0980d6ed649e263832b14c862326e18f652589e635ef61e4e7f

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+�@�w��|q|*
+��u|q�:\�@��Ԛ����V��˦]]����l�El唍�����4d��� '�p�>�Vt�j�����#�s�������@)Z�?}�ż�M0H�XW@��yoE覌4

data/README.md

@@ -0,0 +1,163 @@
+# Mucks
+
+Assists with environment management when using tmux.
+
+
+## Installation
+
+	$ gem install mucks
+
+
+## Configuration
+
+Two configuraiton files are required.
+They are expected to exist in `~/.mucks`
+
+
+### Session (sessions.yaml)
+
+This file contains a list of sessions,
+which may then contain values for one of two options.
+These options are mutually exclusive.
+
+	1. A list of other sessions to open.
+	2. A path and layout.
+		* The path is the path that will be used in the session.
+		* The layout is which layout will be used from the layout configuration.
+
+A `sessions.yaml` might look something like this:
+
+	all:
+	  - user
+	  - mucks
+	user:
+	  path: '~'
+	  layout: base
+	mucks:
+	  path: ~/source/gems/mucks
+	  layout: mucks
+
+This provides 3 sessions (`all`, `user`, and `mucks`).
+
+* `all` - A session comprised of other sessions (`user` and `mucks`)
+* `user` - A session that will have the user's home folder as the root
+and use the `base` layout.
+* `mucks` - A session that will have the user's home folder as the root
+and use the `mucks` layout.
+
+
+### Layout (layouts.yaml)
+
+This file contains a list of layouts, which themselves may contain layouts.
+
+These layouts are simply commands that will be run
+upon successful creation of a session.
+
+A `layouts.yaml` might look something like this:
+
+	base:
+	  - tmux split-window -h -p 66
+
+	hg_layout:
+	  - tmux send-keys 'hg inall' C-m
+	  - tmux send-keys 'hg outall' C-m
+	  - tmux send-keys 'hg status' C-m
+
+	  - base
+	  - tmux select-pane  -t 1
+	  - tmux send-keys 'ruby ~/.vim/bundle/vim_test_runner/test_runner' C-m
+	  - tmux split-window -v -p 25
+	  - tmux select-pane  -t 3
+
+	mucks:
+	  - hg_layout
+	  - tmux send-keys 'vi ~/.mucks/layouts.yaml' C-m
+	  - tmux send-keys ':vsp ~/.mucks/sessions.yaml' C-m
+	  - tmux send-keys ':vsp lib/mucks/mucks.rb' C-m
+
+Only `base` and `mucks` are used by `sessions.yaml`,
+but `mucks` references `hg_layout`, which in turn references `base`.
+These will all get interpolated when it is time to run the commands.
+`mucks all -n` would show the exact commands that would be executed.
+
+
+## Running
+
+You may chain sessions together or run them one at a time:
+
+	$ mucks foo bar -d
+
+will do the same thing as:
+
+	$ mucks foo -d
+	$ mucks bar -d
+
+By default, the user will be taken to the last session that is started.
+To prevent this, use the `-d` flag.
+
+
+### Command Line Options
+
+* `-d` (Detach) Do not attach to the last session in the list.
+* `-v` (Verbose) Detailed output about what is happening.
+* `-n` (Dry-Run) Do net execute any commands, simply output them to STDOUT.
+* `-ls` (List) List all sessions that are in `sessions.yaml`.
+
+These commands may be used together in any combination, in any order,
+with the exception of `-ls`
+(it short-circuits, so any specified sessions will not be started).
+
+You may also put them together in one chain (`-dvn` is the same as `-d -v -n`).
+
+
+## Did You Just Re-Invent Tmuxinator?
+
+
+### No.
+
+To be fair, there was a point when I thought that's what I was doing.
+Mucks started as a teeny, tiny, lightweight script that was highly customized
+to my configuration and workflow, but it grew into something more useful
+as I DRY'd things up and wanted to use my tiny script across devices.
+
+... so I packaged it up in a gem.
+
+
+### Disambiguation
+
+I looked into using Tmuxinator prior to doing the work to make Mucks into a gem.
+
+At that time, there was what I considered to be a major flaw.
+I have tried a number of layouts and will likely continue to try more.
+Tmuxinator makes it (too) hard to customize layouts, in my opinion.
+To get the same layout specified in `hg_layout` above,
+Tmuxinator would have you do this:
+
+	layout: e388,374x104,0,0{127x104,0,0[127x77,0,0,0,127x26,0,78,2],246x104,128,0,1}
+
+At the time that Mucks was published,
+the [Tmuxinator readme][tmuxinator-readme] pointed to
+[this link on StackOverflow][so-layouts] explaining
+how to generate these values for custom layouts.
+
+I have no idea what that line means or how to make minor adjustments to it.
+I know exactly what every line in `layouts.yaml` means
+and exactly how to change it to suit my whims.
+
+
+### Final Thought
+
+I have outlined how to use Mucks and what I believe the major difference is
+between Mucks and Tmuxinator, but ultimately,
+it is up to you to determine which tool suits your needs best.
+
+
+## Contributions
+
+The [main repo][mucks] is on Bitbucket, NOT on Github.
+Please open issues and make pull requests there.
+
+
+[mucks]:             https://bitbucket.org/ToadJamb/gems_mucks
+[tmuxinator-readme]: https://github.com/tmuxinator/tmuxinator#panes
+[so-layouts]:        http://stackoverflow.com/a/9976282/183537

data/bin/mucks

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require_relative '../lib/mucks'
+Mucks.muckity_muck ARGV

metadata

@@ -1,23 +1,78 @@
 --- !ruby/object:Gem::Specification
 name: mucks
 version: !ruby/object:Gem::Version
-  version: 0.0.0.alpha.1
+  version: 0.0.1
 platform: ruby
 authors:
 - Travis Herrick
 autorequire: 
 bindir: bin
-cert_chain: []
-date: 2014-08-04 00:00:00.000000000 Z
-dependencies: []
-description: 
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDcjCCAlqgAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAh0dGhl
+  dG9hZDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MCAXDTE0MDgwOTAzNTY0OFoYDzIxMTQwODA5MDM1NjQ4WjA/MREwDwYDVQQDDAh0
+  dGhldG9hZDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYD
+  Y29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6kkcaif6ZkAIw6Ki
+  3R6zqLB/psWS+sKuL8W9TqQ6Qreu3sz9ZhSHpN5e1ZaUSMq0klkIIW5f8vN3n58/
+  SwnBLCFIrYKGeo37Sknu5w1j4PXdHY4ggsXPIvZ93/NuF1sobsgaAO4OvZX7chzx
+  boZF1WdB6LitRK4894x+X2tD3/z24ywJ7oZoZ3iM8YP6l2ch6D96ur3DNXMRjuMl
+  edgLQV6Htu3sueDm2J4mX2f9WKbuRVtP3crD/DU4IzM924tnLq4aH33DcQbRK+Go
+  m8eM/lMOs8Vy6woPRdUyH3MhalL1z7jv1AO74q8GCQK2jIoIYA492rzEWu4Nakc5
+  rGrpHQIDAQABo3cwdTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU
+  lb7h/PSpwDA3wstwt75LFVNU7swwHQYDVR0RBBYwFIESdHRoZXRvYWRAZ21haWwu
+  Y29tMB0GA1UdEgQWMBSBEnR0aGV0b2FkQGdtYWlsLmNvbTANBgkqhkiG9w0BAQUF
+  AAOCAQEAU0AUOukpg8PTuSO6fxg5AYXzov/un1wz7pX9fvPodXLtb1+NdUl1rWjc
+  vlcV1dy0uIcwP1Q/WKL8AYuwmNSKgI24T0SqQl7gw/1ctMbqwhB/SXkLvB84a/9R
+  aWrUh9/kRyfTkrLS4sltuyGhGZPYGFqFeOOXfM2c43/3qwjHU0rJNPEf2fAoZG9E
+  at+NN+vUGIi00xlgYc9uzmTlFXyr3tfhYhrIZnyd02xsDkN3gMbs/KTGYPQYMTZQ
+  dFfJVAFuyqXRLmrl1YroL9qLu8nKUUiKEcrRbc44Bd84Ti0VdHms+c7SZXqW+VUV
+  kMsvl643w+TJ2BmsFnWZ4JMvHdZ8oQ==
+  -----END CERTIFICATE-----
+date: 2014-08-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Environment management system that was born out of managing tmux sessions.
 email: tthetoad@gmail.com
-executables: []
+executables:
+- mucks
 extensions: []
-extra_rdoc_files: []
-files: []
+extra_rdoc_files:
+- README.md
+files:
+- README.md
+- bin/mucks
 homepage: http://www.bitbucket.org/ToadJamb/gems_mucks
-licenses: []
+licenses:
+- LGPLV3
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -30,13 +85,13 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Tmux configuration management
+summary: Console development environment management
 test_files: []