.bin

Becoming craftsman.

Installation

export PATH=~/.bin:$PATH
mkdir ~/.bin
echo "echo 'Hello world'" > ~/.bin/hello_world
echo "#\!/bin/sh\necho 'Hello world\!'" > ~/.bin/hello_world
chmod +x ~/.bin/hello_world
hello_world
#=> Hello world!

Using symlinks

Looking for easy way to add bin's into PATH?

ln -s $(pwd)/bin/coffee ~/.bin/rcoffee
chmod +x ~/.bin/rcoffee
rcoffee
#=> coffee>

We need to go deeper

Let's create script for making symlinks (~/.bin/binl):

#!/usr/bin/env ruby

require 'rubygems'
require 'main'

Main {
  def run
    path     = ARGV[0]
    bin_name = ARGV[1] || ARGV[0].match(/([^\/]+)$/)[1]
    bin_path = "~/.bin/#{bin_name}"
    
    `ln -s $(pwd)/#{path} #{bin_path}`
    `chmod +x #{bin_path}`
    
    puts "Done, now you can run #{bin_name}"
  end
}

Now you can:

binl ./bin/coffee
which coffee
#=> /Users/koss/.bin/coffee

... or:

binl ./bin/coffee coffee_redux
which coffee_redux
#=> /Users/koss/.bin/coffee_redux

Advanced example of usage

Like pomodoro technique? Awesome, me too. Let's build our own pomodoro timer.

Preparing

Let's create blank ruby script (~/.bin/pomo):

#!/usr/bin/env ruby
puts 'Hello world!'

Make it executable:

chmod +x ~/.bin/pomo

Let's write some code

We need to write prototype for 5 minutes. Let's do it:

#!/usr/bin/env ruby

require 'rubygems'
require 'main'

MINUTES = 60

Main {
  def run
    while true
      puts 'Lets work!'
      
      rules.each do |rule|
        puts rule[:title]
        
        rule[:minutes] do |minutes_pass|
          minutes_left = rule[:minutes] - minutes_pass
          puts "#{minutes_left} left"
          sleep MINUTE
        end
      end
    end
  end

  def rules
    [{ title: "Let's work", minutes: 25 },
     { title: "Let's rest", minutes: 5 }]
  end
}

Improve it

Now things get compicated:

#!/usr/bin/env ruby

require 'rubygems'
require 'main'
require 'talks'

MINUTE = 60

class Timer
  class << self
    def start!(minutes, &draw)
      minutes_left = minutes

      while minutes_left > 0 do
        draw.call(minutes_left) if block_given?
        minutes_left -= 1
        sleep MINUTE
      end
    end
  end
end

Main {
  def run
    while true
      rules.each do |rule|
        puts rule[:title]

        Timer.start!(rule[:minutes]) do |minutes_left|
          timer_report minutes_left
        end
      end
    end
  end

  def rules
    [{ title: "Let's work", minutes: 25 },
     { title: "Let's rest", minutes: 5 }] * 4 +
    [{ title: "Let's walk for 15 minutes", minutes: 15 }]
  end

  def say(text)
    puts text
    Talks.say text
  end

  def timer_report(minutes_left)
    say minutes_left

    File.open(File.expand_path('~/.pomo_stat'), 'w') do |f|
      f.write("#{minutes_left} minutes left")
    end
  end
}

Done.

Now you have to go and do some awesome work using brand new tool.

License

Anything you want. But I'm not responsible.