hp12c

Rubyによる暗黙のFizzBuzzの世界

2015-02-19T00:00:00+09:00

Rubyによる不適切なFizzBuzzの世界 - Qiitaが、FizzBuzzerを刺激するから…。

1. FizzBuzz with to_proc

class FizzBuzz
  def self.to_proc
    ->n{ 
      case 0
      when n % 15 then :FizzBuzz
      when n % 3  then :Fizz
      when n % 5  then :Buzz
      else n
      end
    }
  end
end

puts (1..100).map(&FizzBuzz) # => [1, 2, :Fizz, 4, :Buzz, :Fizz, 7, 8, :Fizz, :Buzz, 11, :Fizz, 13, 14, :FizzBuzz, 16, 17, :Fizz, 19, :Buzz, :Fizz, 22, 23, :Fizz, :Buzz, 26, :Fizz, 28, 29, :FizzBuzz, 31, 32, :Fizz, 34, :Buzz, :Fizz, 37, 38, :Fizz, :Buzz, 41, :Fizz, 43, 44, :FizzBuzz, 46, 47, :Fizz, 49, :Buzz, :Fizz, 52, 53, :Fizz, :Buzz, 56, :Fizz, 58, 59, :FizzBuzz, 61, 62, :Fizz, 64, :Buzz, :Fizz, 67, 68, :Fizz, :Buzz, 71, :Fizz, 73, 74, :FizzBuzz, 76, 77, :Fizz, 79, :Buzz, :Fizz, 82, 83, :Fizz, :Buzz, 86, :Fizz, 88, 89, :FizzBuzz, 91, 92, :Fizz, 94, :Buzz, :Fizz, 97, 98, :Fizz, :Buzz]

2. FizzBuzz with coerce

module Base
  def div_by(base, n)
    !n.is_a?(Fixnum) || (n % base).zero? ? self : n
  end

  def coerce(n)
    [self, n]
  end
end

class FizzBuzz
  extend Base
  class << self
    def |(n)
      div_by(15, n)
    end
  end
end

class Fizz
  extend Base
  class << self
    def |(n)
      div_by(3, n)
    end
  end
end

class Buzz
  extend Base
  class << self
    def |(n)
      div_by(5, n)
    end
  end
end

puts (1..100).map { |n| n | FizzBuzz | Fizz | Buzz  } # => [1, 2, Fizz, 4, Buzz, Fizz, 7, 8, Fizz, Buzz, 11, Fizz, 13, 14, FizzBuzz, 16, 17, Fizz, 19, Buzz, Fizz, 22, 23, Fizz, Buzz, 26, Fizz, 28, 29, FizzBuzz, 31, 32, Fizz, 34, Buzz, Fizz, 37, 38, Fizz, Buzz, 41, Fizz, 43, 44, FizzBuzz, 46, 47, Fizz, 49, Buzz, Fizz, 52, 53, Fizz, Buzz, 56, Fizz, 58, 59, FizzBuzz, 61, 62, Fizz, 64, Buzz, Fizz, 67, 68, Fizz, Buzz, 71, Fizz, 73, 74, FizzBuzz, 76, 77, Fizz, 79, Buzz, Fizz, 82, 83, Fizz, Buzz, 86, Fizz, 88, 89, FizzBuzz, 91, 92, Fizz, 94, Buzz, Fizz, 97, 98, Fizz, Buzz]

ちょっと挙動がユニークだけど…

変態度が足りませんでしたm(__)m

(追記：2015-02-20)　親切な解説を追加しました。

FizzBuzz with to_procの親切な解説

Rubyではメソッドに引数を渡すとき、&を前置するとそれをProcオブジェクトと理解しメソッドの実体に渡します。

def do_proc(&proc)
  proc.call
end

# または、
def do_proc
  yield
end

proc = ->{ 'hey!' }

do_proc(&proc) # => "hey!"

&を前置してProcオブジェクト以外のものを渡してみます。

def do_proc(&proc)
  proc.call
end

proc = 'hey!'

do_proc(&proc) # => 
# ~> -:12:in `<main>': wrong argument type String (expected Proc) (TypeError)

Procが期待されているとのエラーが吐かれました。

しかしRubyではそれを単に拒絶するのではなく、まずは渡されたオブジェクトがProcオブジェクトになり得るかを試す、つまりそのオブジェクトのto_procメソッドを暗黙的にコールするのです。

‘hey!’オブジェクトにto_procを定義して再度試してみます。

proc = 'hey!'

def proc.to_proc
  ->{ self }
end

do_proc(&proc) # => "hey!"

うまくいきました。

FizzBuzz with to_procではRubyのこの仕組みを利用しています。

FizzBuzz.to_procの中身は、@supermomongaさんによるcase 0を使わせてもらいました。エレガントです。解説は次の記事を参照して下さい。

Rubyによる不適切なFizzBuzzの世界 - Qiita

FizzBuzz with coerceの親切な解説

Rubyにおいて演算子の多くはメソッド呼び出しです。

つまりこれらは、

1 + 2 # => 3
3 - 4 # => -1
5 * 6 # => 30
7 / 8 # => 0

以下のシンタックスシュガーです。

1.+(2) # => 3
3.-(4) # => -1
5.*(6) # => 30
7./(8) # => 0

次のコードは、Rubyにおけるビット二項演算で論理和を求めるものですが、

1 | 0 # => 1
0 | 1 # => 1
1 | 1 # => 1
0 | 0 # => 0

これはFixnum#|として実装されています。

FizzBuzz with coerceではこのFixnum#|を呼んでいます。

puts (1..100).map { |n| n | FizzBuzz | Fizz | Buzz  }

mapのブロックの中で、最初にnとFizzBuzzクラスオブジェクトの論理和を求めています。

通常、Fixnum#|はその引数としてFixnumを期待しますが、それ以外のオブジェクトを渡すとどうなるかやってみます。

class FizzBuzz

end

3 | FizzBuzz # => 
# ~> -:22:in `|': Class can't be coerced into Fixnum (TypeError)
# ~> 	from -:22:in `<main>'

クラスはFixnumにcoerce（強制型変換）できないとのエラーが吐かれました。

これでRubyがFizzBuzzクラスオブジェクトをFixnumに型変換、つまりFizzBuzz.coerceを暗黙的にコールしていることが分かりました。

これを実装してみます。

class FizzBuzz
  def self.coerce(n)
    return n, 4
  end
end

3 | FizzBuzz # => 7

coerceでは、呼び出し元のオブジェクトを引数に取って、演算子の２つのオペランドが返るようにします。これによりFixnum#|はこれらの値で実行されることになります。

ここでcoerceの最初の返り値に別のオブジェクトを渡すと、Fixnum#|の代わりにそのオブジェクトの|メソッドが呼ばれる、つまりa_object#|が実行されるようになります。

FizzBuzz.|を定義して、やってみます。

class FizzBuzz
  def self.|(n)
    "#{n} received!"
  end

  def self.coerce(n)
    return self, n
  end
end

3 | FizzBuzz # => "3 received!"

FizzBuzz with coerceではこのテクニックを使って、Fixnum#|の代わりにFizzBuzz.|が呼ばれるようにしています。

さて、次にFizzBuzz with coerceにおけるFizzBuzz.|の実装を見てみます。

class FizzBuzz
  def self.|(n)
    !n.is_a?(Fixnum) || (n%15).zero? ? self : n
  end

  def self.coerce(n)
    return self, n
  end
end

3 | FizzBuzz # => 3
5 | FizzBuzz # => 5
15 | FizzBuzz # => FizzBuzz

nが１５で割り切れる場合はFizzBuzzクラスが、それ以外の場合はnが返ります。そしてFizzBuzz with coerceではこの値は次の段、つまりFizzとの演算に渡されます。

3 | Fizz # => Fizz
5 | Fizz # => 5
FizzBuzz | Fizz # => FizzBuzz

Fizzクラスの実装は除算の基数が３である以外はFizzBuzzと同じです。よって、上の２つの場合は、FizzBuzzクラスと同様に動作し、nが３で割り切れる場合はFizzクラスが、それ以外の場合はnが返ることになります。

一方、FizzBuzzとFizzの演算では、FizzBuzzクラスの|メソッドが再度呼ばれることになります（ここがユニークなところです）。そしてその結果としてFizzBuzzクラスが返り、次の段に渡されることになります。

Buzzクラスでもこれと同様のことが起こり、一旦途中でFizzBuzz系クラスに変換されると、それがフォールスルーして最後まで維持されることになります。

Ruby de Streem

2014-12-15T00:00:00+09:00

のっぴきならない事情で暫くここを離れてたけど

戻ってきたらMatzが新言語を作ってた

僕がいないうちにRubyは捨てられてしまったの？

僕が暫く目を離しているうちに世の中もMatzも変わってしまって

もうだれもRubyを愛さなくなってしまったの？

matz/streem

Streem - stream based concurrent scripting language

Streem is a concurrent scripting language based on a programming model similar to shell, with influences from Ruby, Erlang and other functional programming languages.

In Streem, a simple cat program looks like this:

STDIN | STDOUT

And a simple FizzBuzz will look like this:

seq(100) | {|x|
  if x % 15 == 0 {
    "FizzBuzz"
  }
  else if x % 3 == 0 {
    "Fizz"
  }
  else if x % 5 == 0 {
    "Buzz"
  }
  else {
    x
  }
} | STDOUT

Ruby de Streem

でも

心配いらないよ、Ruby

もう僕が戻ってきたんだから

僕はここにいるよ

ごめんなさいごめんなさい。

Rubyでパイプライン？

Ruby的FizzBuzz

2014-08-10T00:00:00+09:00

最終鬼畜FizzBuzz大全 - Qiitaに刺激を受けて、Qiitaのほうにポストしてみたんだけど、こちらは解説付きで。

Ruby的FizzBuzz - その１

class FB
  def FizzBuzz(n)
    (n%15)==0
  end

  def Fizz(n)
    (n%3)==0
  end

  def Buzz(n)
    (n%5)==0
  end

  def self.call(n)
    instance_methods(false).detect { |m| new.send(m, n) } || n
  end
end

(1..100).each { |i| printf "%s ", FB.call(i) }

# >> 1 2 Fizz 4 Buzz Fizz 7 8 Fizz Buzz 11 Fizz 13 14 FizzBuzz 16 17 Fizz 19 Buzz Fizz 22 23 Fizz Buzz 26 Fizz 28 29 FizzBuzz 31 32 Fizz 34 Buzz Fizz 37 38 Fizz Buzz 41 Fizz 43 44 FizzBuzz 46 47 Fizz 49 Buzz Fizz 52 53 Fizz Buzz 56 Fizz 58 59 FizzBuzz 61 62 Fizz 64 Buzz Fizz 67 68 Fizz Buzz 71 Fizz 73 74 FizzBuzz 76 77 Fizz 79 Buzz Fizz 82 83 Fizz Buzz 86 Fizz 88 89 FizzBuzz 91 92 Fizz 94 Buzz Fizz 97 98 Fizz Buzz

解説

FB.callのinstance_methods(false)は、FBクラスに定義されたインスタンスメソッド名つまり:FizzBuzz, :Fizz, :Buzzの配列をそれらが定義された並びで返します。
detectのブロックでは各メソッドが、callに渡された引数nを引数に呼び出されます。
各メソッドでは引数がそれぞれの基数で割り切れるかが判定されますが、detectでは最初にtrueを返したメソッド名が返ることになります。例えばnが15のときは何れのメソッドの返り値もtrueになりますが、最初に評価される:FizzBuzzが返ります。
全メソッドの評価がfalseのときはdetectの返り値はnilになるので、||の右辺が実行され、結果引数nがそのまま返されることになります。

アピールポイント

文字列ではなくメソッド名に基いて出力の文字列を構成した点。
分岐的制御構造を使っていない点。

Ruby的FizzBuzz - その２

class FB
  def Fizz(n)
    (n%3)==0
  end

  def Buzz(n)
    (n%5)==0
  end

  def self.call(n)
    instance_methods(false).select { |m| new.send(m, n) }
                           .map(&:to_s).inject(:+) || n
  end
end

(1..100).each { |i| printf "%s ", FB.call(i) }

# >> 1 2 Fizz 4 Buzz Fizz 7 8 Fizz Buzz 11 Fizz 13 14 FizzBuzz 16 17 Fizz 19 Buzz Fizz 22 23 Fizz Buzz 26 Fizz 28 29 FizzBuzz 31 32 Fizz 34 Buzz Fizz 37 38 Fizz Buzz 41 Fizz 43 44 FizzBuzz 46 47 Fizz 49 Buzz Fizz 52 53 Fizz Buzz 56 Fizz 58 59 FizzBuzz 61 62 Fizz 64 Buzz Fizz 67 68 Fizz Buzz 71 Fizz 73 74 FizzBuzz 76 77 Fizz 79 Buzz Fizz 82 83 Fizz Buzz 86 Fizz 88 89 FizzBuzz 91 92 Fizz 94 Buzz Fizz 97 98 Fizz Buzz

解説

その１の発展型です。
FB.callでは、detectに代えてselectを使い、trueを返すメソッドをすべて返すようにしています。例えば、nが15のときは:Fizz, :Buzzの両方が返ります。
配列内のシンボル値をto_sした後、inject(:+)でそれらを連結します。nが3のときは要素が:FizzだけなのでFizzが返りますが、15のときは:Fizz, :Buzzが連結されてFizzBuzzが返ります。
Array#joinを使うという手もありましたが、空配列が""（空文字）になってしまうので、あとの処理が面倒なので避けました。

アピールポイント

selectを使い、Fizz, Buzzの２つのメソッドだけで３種類の出力をできるようにした点。

御社採用、ご検討のほど、よろしくお願い申し上げますm(__)m

Ruby製サードパーティライブラリgemのトレンドを知るには「BestGems.org」がベスト

2014-08-08T00:00:00+09:00

─質問１─

Ruby製サードパーティライブラリ、要はgemで、何が人気なのかってこと、手っ取り早く知りたいんですけど。

─回答１─

RubyGems.orgのstatsページを見てください。

─質問２─

えっ？これだけ？この辺は万年上位で固定でしょ。もうちょっと俺の知らないバラエティに富んだものに出会いたいんだけど。俺、Rails用ないし。

─回答２─

カテゴリー別ならThe Ruby Toolboxがあります。

The Ruby Toolbox - Terminal Coloring

─質問３─

あんた、俺の質問ちゃんと聞いてるの？カテゴリー別なんて言ってないし。それに、ここのカテゴリーってなんか俺的に信用ないんだよね。取りこぼし多いっていうか..。俺のgem出てこないっていうか..。

─回答３─

GitHubのTrendingでここ最近の人気リポジトリが分かります。

Trending Ruby repositories on GitHub this month

これをメールで定期的にもらうこともできます。

Subscribe to GitHub’s Explore Email

ターミナルで見たいならgemがあります。

git-trend というrubygemsを作りました - rochefort’s blog

─質問４─

まあ、これはこれでいいんだけどさ。でも俺、確か、gemって言ったよね、さっき？人気gemの再発見したいんだけど。

─回答４─

@xmisaoさんが作ったBestGems.orgがあります。約80,000個ある全gemの総合ダウンロードランキングが分かります。

BestGems – Ruby Gems Download Ranking

BestGems.orgはオープンソースでもあります。

xmisao/bestgems.org

─質問５─

ほぅ。じゃあ50番目に人気のあるgemが何かとかわかるの？

─回答５─

41-60 of all 79,598 gems

前日のダウンロード数（日別）のランキングも分かります。

Daily Download Ranking – Best Gems

総合ランキングと日別ランキングの差から最近の人気度を図るFeaturedというものもあります。

Featured Gems Ranking – Best Gems

─質問６─

おー、これいいね。なんか、面白いgem見つけられるかも。

あれ、そう言えば、日毎のダウンロード数って、RubyGems.orgのAPIじゃ、取れなかったと思うんだけど。

─回答６─

BestGems.orgにおけるgemの個別ページでは、ダウンロード数やランキングの伸びをグラフで見ることができます。

power_assert – BestGems

─質問７─

BestGems.orgは全gemについて日毎のダウンロード数、収集してるんだ。すごいな。そうすると、自分が作ったgemの成長過程をここで見ることもできる、ってわけだ。

いや、実は、自分の作ったgemのダウンロード数が気になっちゃって、ここのところ寝れなくってさ。勢いで、mygegegemsってgem作ったんだけど。あー、要はターミナルで自分のgemのダウンロード数見るやつ。

自分が公開しているgemの日々のダウンロード数が気になって寝られません。どうしたらいいでしょうか（Yawhoo知恵袋）

mygegegems

これ、一応前日からのダウンロード数の伸びが分かるようになってるんだけど、こんな感じで。

で、これ、アクセスした日だけダウンロード数をYAMLファイルに記録するんだけど、アクセスしない日もあるしね..。YAMLにどこまでデータ溜めるんだって話もあるし。

BestGems.orgの収集したデータにアクセスするAPIでもあったら、捗るんだけどな…。

─回答７─

BestGems APIが公開されています。各gemについて、「総ダウンロード数」、「日別ダウンロード数」、「総合ランキング」および「日別ランキング」の各トレンド、つまりBestGems.org開設からの日毎のデータがJSONで取れます。

BestGems API v1 Specification · xmisao/bestgems.org Wiki

─質問８─

えっ？API、あるの¹？

% curl http://bestgems.org/api/v1/gems/mygegegems/total_downloads.json

[{"date":"2014-08-07","total_downloads":583},{"date":"2014-08-06","total_downloads":569},{"date":"2014-08-05","total_downloads":569},{"date":"2014-08-04","total_downloads":563},{"date":"2014-08-03","total_downloads":557},{"date":"2014-08-02","total_downloads":550},{"date":"2014-08-01","total_downloads":544},{"date":"2014-07-31","total_downloads":542},{"date":"2014-07-30","total_downloads":534},{"date":"2014-07-29","total_downloads":489},{"date":"2014-07-28","total_downloads":466},{"date":"2014-07-27","total_downloads":444},{"date":"2014-07-26","total_downloads":441},{"date":"2014-07-25","total_downloads":441},{"date":"2014-07-24","total_downloads":428},{"date":"2014-07-23","total_downloads":359},{"date":"2014-07-22","total_downloads":326},{"date":"2014-07-21","total_downloads":326},{"date":"2014-07-20","total_downloads":312},{"date":"2014-07-19","total_downloads":303},{"date":"2014-07-18","total_downloads":303},{"date":"2014-07-17","total_downloads":303},{"date":"2014-07-16","total_downloads":301},{"date":"2014-07-15","total_downloads":255},{"date":"2014-07-14","total_downloads":202},{"date":"2014-07-13","total_downloads":141},{"date":"2014-07-12","total_downloads":6}]

おー、これはうれしい。

するってーと、だ。俺としてはこのデータを、Rubyのオブジェクトとして取り込めればいいんだな。まずは、ラッパークライアント書くか。

─回答８─

BestGems.org APIのRubyラッパーライブラリbestgemsがあります。

bestgems

melborne/bestgems

こう使います。

require 'bestgems'

client = Bestgems.client

client.total_downloads(:rack) # => {"2014-08-08"=>48484297, "2014-08-07"=>48426620, "2014-08-06"=>48365953, "2014-08-05"=>48305390, "2014-08-04"=>48246069, "2014-08-03"=>48203248, ... }

client.daily_downloads(:rack) # => {"2014-08-08"=>57677, "2014-08-07"=>60667, "2014-08-06"=>60563, "2014-08-05"=>59321, "2014-08-04"=>42821, "2014-08-03"=>30640, ... }

client.total_ranking(:rack) # => {"2014-08-08"=>2, "2014-08-07"=>2, "2014-08-06"=>2, "2014-08-05"=>2, "2014-08-04"=>2, "2014-08-03"=>2, "2014-08-02"=>2, "2014-08-01"=>2, "2014-07-31"=>2, ... }

client.daily_ranking(:rack) # => {"2014-08-08"=>6, "2014-08-07"=>6, "2014-08-06"=>6, "2014-08-05"=>7, "2014-08-04"=>4, "2014-08-03"=>3, "2014-08-02"=>3, "2014-08-01"=>6, "2014-07-31"=>6, ... }

─質問９─

おー、こりゃ助かる。これ、誰が作ったの？

─回答９─

あなた様です²。

─質問１０─

そうか、じゃあちょっと信用ならなぃ..。えっ？俺？…そうか、昨日書いたのか…。記憶力落ちたな。あーoctokit.rbのコード~~パクリ~~ちらちら見ながら、書いてたわ..。

まあ、それはいいとして、BesGems.orgの話に戻るんだけど、全gemのランキングが分かるっていったよね？そうすると、不人気の、つまり「ぺけ」のほうのgemも分かるってことだよね？「不人気gemベスト５０」とか、ちょっと興味あるな…。それ、見せてみてよ..。

─回答１０─

こちらになります。

下から５番目…orz

(追記：2014-8-9) bestgems gemの仕様変更に伴い記述（コード）を変更しました。

実のところBestGems.orgのAPIはtwitter上での@xmisaoさんと僕とのやりとりで生まれたのでした。https://twitter.com/merborne/status/488681089586585600 ↩
今日はこれが言いたかった ↩

ターミナルにデジタル式デカ文字を出力する「digi_moji」の紹介

2014-08-04T00:00:00+09:00

個人的にはターミナル文字の色付けツールである拙作「colcolor」を気に入ってまして。

Yet Another Terminal Color for Ruby: Colcolorの紹介

colcolor

require "colcolor"

str = "Languages: Python Lisp Ruby Perl Haskell Erlang"

puts str.colco(:yellow, :blue, :magenta, :red, :yellow, :blue, :red)
puts str.colco(:green, :blue, cyclic:true)
puts str.colco(:red_bold, regexp:/ruby/i)
puts str.colco(:black_magenta, cyclic:true, regexp:/^\w+|[A-Z]/)

このデモ的なものを作って宣伝できないかと考えたわけです。

それで「digi_moji」なるツールが生まれました。

で、ステマをしたのですが…

わかりやすいREADME.mdの書き方がわかりません。どうしたらいいでしょうか（Yawhoo知恵袋） - digi_mojiのステマ

見事にコケましたorz

そんなわけで…。

ここでちゃんとdigi_mojiの紹介記事を書いておくことにします。

DigiMojiとは

5x7で構成されたデジタル文字をターミナルに表示するためのツールです。裏で先のcolcolorを使っているので文字にANSIカラーによる色付けができます。

digi_moji

melborne/digi_moji

gem install digi_mojiすると、digi_mojiというターミナルコマンドが一緒にインストールされて使えるようになります。

% digi_moji help
Commands:
  digi_moji help [COMMAND]  # Describe available commands or one specific command
  digi_moji new WORD        # Print a digital word
  digi_moji time            # Print current time
  digi_moji timer SEC       # Print count down timer

Options:
  -f, [--fg=FG]      # Foreground color
                     # Default: bg_white
  -b, [--bg=BG]      # Background color
  -c, [--cell=CELL]  # Cell character
  -w, [--width=N]    # Character width
                     # Default: 2

digi_moji newコマンド

ターミナル上に単純に文字を出力するにはdigi_moji newコマンドを使います。引数として出力したい文字を渡します。

% digi_moji new BIGGER

スペースを含むときは文字列をクオートしてください。

newコマンドにはいくつかのオプションがあります。

% digi_moji help new
Usage:
  digi_moji new WORD

Options:
  -f, [--fg=FG]      # Foreground color
                     # Default: bg_white
  -b, [--bg=BG]      # Background color
  -c, [--cell=CELL]  # Cell character
  -w, [--width=N]    # Character width
                     # Default: 2

Print a digital word

色を付けてみます。

% digi_moji new BIGGER --fg=bg_red --bg=bg_blue

色指定の際の注意点は、--fg、--bgともに、bg_<color>のように背景色指定を渡すことです。これは文字を構成する各セルがスペース（空文字）で表現されているので、前景色を指定しても色が出ないためです。

各セルの文字を空文字以外にセットすると前景色が効くようになります。

% digi_moji new BIGGER --fg=green --cell=B

前景色が効くようになると、blinkやunderscoreなどのテキスト属性が使えるようになります。

% digi_moji new BIGGER --fg=green_bold --cell=B --bg=green_blink

--fg、--bgに渡す引数のフォーマットはcolcolorのそれに倣っていますので、先に示したcolcolorの記事を参考にしてください。

文字の大きさを調整したい場合は、--widthオプションを使います。デフォルトは2です。

英大文字、英小文字、キーボード上に表記された記号には概ね対応しています。

digi_moji timeコマンド

デジタル文字の代表と言えば、それは「デジタル時計」です。timeコマンドはまさにそのためのコマンドです。

% digi_moji time -f=bg_cyan

ターミナル上に好きな色のデジタル時計を表示できます。Ctrl+cで終了します。

色を工夫すれば、オリジナリティ溢れた時計が作れます。

% digi_moji time -f=cyan  -b=yellow_blink -c=T

いや、ちょっと見づらいですか。

digi_moji timerコマンド

「デジタル時計」があるなら「タイマー」もほしいと思うのが人情です。timerコマンドは引数で渡した時間（デフォルトで秒）を計測するカウントダウンタイマーを出力します。

 % digi_moji timer 5 -f=bg_magenta

timerコマンドには追加のオプションとして、--unit、--message、--message-colorがあります。

% digi_moji help timer
Usage:
  digi_moji timer SEC

Options:
  -m, [--message=MESSAGE]              # Message on time's up
                                       # Default: TIME'S UP!
  -k, [--message-color=MESSAGE_COLOR]  # Message color
                                       # Default: bg_red
  -u, [--unit=UNIT]                    # Argument unit
                                       # Default: sec
  -f, [--fg=FG]                        # Foreground color
                                       # Default: bg_white
  -b, [--bg=BG]                        # Background color
  -c, [--cell=CELL]                    # Cell character
  -w, [--width=N]                      # Character width
                                       # Default: 2

--unitは引数の単位を変えるもので、’min’, ‘hour’が渡せます。--messageは終了メッセージとして”TIME’S UP!”以外を表示できるようにします。--message-colorはそのメッセージの色を指定します。

% digi_moji timer 3 -u=min -f=bg_green -m=EAT -k=bg_yellow

Rubyスクリプトからの使い方

デジ文字はDigiMoji::String.newで生成します。

require "digi_moji"

str = DigiMoji::String.new("RUBY", fg:'bg_red')

puts str

出力です。

String#to_digimojiを用意してあるので、このコードは次のように書くこともできます。

require "digi_moji"

str = "RUBY".to_digimoji(fg:'bg_red')

puts str

いまのところインスタンスメソッドは、+、join、<<の結合系メソッドだけです。joinはオプションを渡しやすくするための+のエイリアスです。<<はデジ文字を破壊的に結合します。

str = "RUBY".to_digimoji(fg:'bg_red')

puts str + "IST"
puts
puts str.join("IST", fg:'bg_green')
puts
puts str
puts
str << "IST"
puts
puts str

各結合系メソッドには、DigiMoji::Stringオブジェクトを渡してもいいです。

特殊文字

いくつかの非ASCII文字に特殊文字が割り当てられています。

≤文字にはARROW_LEFT、≥文字にはARROW_RIGHT、¬文字にはARROW_UP、—文字にはARROW_DOWNが割り当てられています。同様に、÷文字にはDIVIDE、æ文字にはBLOCKが割り当てられています。これらの文字は、alt + <key>のコンビネーションでそれぞれ入力可能です（alt + ,、alt + .、alt + L、alt + ;、alt + /、alt + '）。

require "digi_moji"

chars = %w(≤ ≥ ¬ — ÷ æ)
colors= %w(red green yellow blue magenta cyan).to_enum

chars.map! { |char| char.to_digimoji(fg:"bg_#{colors.next}") }

puts chars.inject { |m, char| m + char }

デジ文字のユーザ定義

使われていない非ASCII文字を使って、独自のデジ文字を登録することができます。Ω（alt + z）を登録してみます。

デジ文字の登録には、DigiMoji::Char.registerを使います。第１引数に登録する文字、第２引数にデジ文字を構成するセルを配列で定義します。

require "digi_moji"

DigiMoji::Char.register("Ω", %w(f f f f f
                                f t t t f
                                t f f f t
                                t f f f t
                                t f f f t
                                f t f t f
                                t t f t t))

puts "18.3Ω".to_digimoji(fg:'bg_green')

コードにあるように、セルの定義は文字tとfの１次元配列で行います。tの箇所が文字の形を構成します。

以上で説明を終わります。まあ、どんな場面で使えるかわかりませんが、digi_mojiをよろしくです！

digi_moji

melborne/digi_moji

わかりやすいREADME.mdの書き方がわかりません。どうしたらいいでしょうか（Yawhoo知恵袋） - digi_mojiのステマ

2014-08-04T00:00:00+09:00

質問

【ID非公開さん】

GitHubで自作ツールを公開して世界中の人に使ってもらいたいと考えています。でも自分は英語が苦手です。どうしたらいいでしょうか。

ベストアンサーに選ばれた回答

【SOTAさん】

この記事を読んでください。

わかりやすいREADME.mdを書く SOTA

ベストアンサー以外の回答

【melborneさん】

ビジュアルに訴えるツールを作って、README.mdをそのスクショで埋めます。英文は最小限に留めましょう。作ったツールがビジュアルに訴えないもののときは、gvizなどのツールを使って説明をビジュアライズしてください。以下にサンプルを示します。

README.mdのサンプル

以下は、チンピラgem作者のmelborneさんのdigi_mojiというツールのREADME.mdです。英語がちょっと怪しいですが、スクショがあることでツールの目的が明確になっています。

digi_moji

melborne/digi_moji

DigiMoji

5x7 digital color words on your terminal.

Installation

Add this line to your application’s Gemfile:

gem 'digi_moji'

And then execute:

$ bundle

Or install it yourself as:

$ gem install digi_moji

Usage in your terminal

new command

Try digi_moji new command with words:

% digi_moji new RUBY

% digi_moji new RUBY --fg=bg_red --bg=bg_yellow

% digi_moji new RUBY --fg=red --bg=red_blink --cell='R'

time command

digi_moji time outputs current time:

timer command

digi_moji timer outputs count down timer:

digi_moji help for more info.

Usage as ruby script

require 'digi_moji'

str = DigiMoji::String.new("HE", fg:'bg_green', bg:'bg_yellow')

puts str
puts
puts str + "LLO!"
puts
puts str.join("LP!", fg:'bg_red')

Output:

Contributing

Fork it ( https://github.com/[my-github-username]/digi_moji/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

digi_mojiをよろしくね！

カラム指向ターミナルカラーライブラリ「colcolor」にcyclicオプションを付けました！

2014-07-28T00:00:00+09:00

先日、カラム指向ターミナルカラーライブラリ「colcolor」というのを公開しまして。

Yet Another Terminal Color for Ruby: Colcolorの紹介

colcolor

colcolorはStringクラスにcolcoというメソッドを挿します。colcoでは引数として複数の色名を受け取って単語区切りで文字を彩色します。こんな感じです。

require "colcolor"

DATA.each_line.with_index do |line, i|
  puts line.colco(:green, :yellow, :blue, :blue)
  puts "-".colco(:red) * line.size if i.zero?
end

__END__
lang year designer
Ruby 1993 Yukihiro Matsumoto
Lisp 1958 John McCarthy
C++ 1983 Bjarne Stroustrup

ターミナル出力です。

cyclicオプション

で、この度cyclicオプションをcolcoに渡せるようにしたので、紹介します。

colcolorでは渡した色数が単語数に対して不足するとき、残りの単語は色付けされないのですが、このcyclicオプションをtrueにセットすると、与えられた色を残りの単語に対しても繰り返し適用するようになります。こんな感じです。

require "colcolor"

text =<<-EOS
A dynamic, open source programming language
with a focus on simplicity and productivity.
It has an elegant syntax that is natural to
read and easy to write.
EOS

puts text.colco(:red, :green, :blue, :yellow, cyclic:true)

ターミナル出力です。

赤、緑、青、黄が単語に対して繰り返し適用されている様子がわかります。

regexpオプションと組み合わせると、少し面白いこともできます。regexpに/./を渡して色区切りを文字ベースにしてみます。

require "colcolor"

text =<<-EOS
A dynamic, open source programming language
with a focus on simplicity and productivity.
It has an elegant syntax that is natural to
read and easy to write.
EOS

puts text.colco(:red, :green, :blue, :yellow, cyclic:true, regexp:/./)

ターミナル出力です。

こんなこともできます。

require "colcolor"

line = " " * 50

colors = %i(bg_red bg_yellow)

10.times do
  puts line.colco(*colors.rotate!, cyclic:true, regexp:/../)
end

ターミナル出力です。

colcolorをどうぞよろしく！

Yet Another Terminal Color for Ruby: Colcolorの紹介

colcolor

melborne/colcolor

(追記：2014-7-30) オプション名を”cycle”から”cyclic”に変更しました（version 0.0.5）。

Yet Another Terminal Color for Ruby: Colcolorの紹介

2014-07-14T00:00:00+09:00

巷にはターミナル文字のカラー化を楽にするライブラリが溢れています。僕も以前にその幾つかを紹介した記事を書きました。

RubyでANSIカラーシーケンスを学ぼう！

にも拘わらずみんな、人の作ったライブラリが自分のテイストに合わないのか、自分用に、しかし他と似たようなものをまた作って、このリストを更に長くしていくという傾向があるようです。RubyGems.orgでcolorを検索してみてください。僕が言っていることが冗談ではないということが分かるでしょう。

これだけ大量のカラー化ライブラリがあるとどれを選ぶべきか皆目わからず、人気どころを２、３試してみてそれらが合わなかったら、他を探すより自分で作ったほうが早い、となるのも頷けます。

え〜、それで、ちょっと言いづらいのですが…。

ご多分に漏れず…。

「Colcolor」というgemを作りましたよ！> まじか。

colcolor

melborne/colcolor

Colcolorの特徴

殆どのカラーライブラリは、Stringにカラー用のメソッドを挿して、そのメソッドで文字列の前後にエスケープシーケンスを挿入します。

"Charlie".red # => "\e[31mChalie\e[0m"

colcolorもその点は他のライブラリと同じで、Stringにcolcoというインスタンスメソッドを追加します。

"Charlie".colco(:red) # => "\e[31mChalie\e[0m"

colcolorが特徴的なのは、他のライブラリが行指向のものであるのに対して、列（カラム）指向である点です。つまり一行におけるホワイトスペースで区切られたカラムを認識し、それ毎に異なるカラーを適用できるのです。

"Charlie 21 programmer".colco(:red, :yellow, :cyan) # => "\e[31mCharlie\e[0m \e[33m21\e[0m \e[36mprogrammer\e[0m"

例えば、タブ区切りのリストにおいて、そのカラムごとに色を変えたい場合は、次のように簡単にできます。

require "colcolor"

list = <<-EOS
Charlie\t21\tprogrammer
Bill\t43\tdoctor
Liz\t18\tstudent
EOS

list.each_line do |line|
  puts line.colco(:green, :yellow, :blue)
end

出力です。

背景色を作りたいときは、:bg_greenなどとします。

複数属性の適用

一つのカラムに対して、前景色と背景色など複数の属性を適用したい場合は、アンダースコア（_）で属性をつなぎます。

list.each_line do |line|
  puts line.colco(:green, :red_yellow, :blue_underline)
end

最初の色が前景色、２つ目以降が背景色になります。出力です。

緑背景に赤文字を点滅させたいときは、:red_green_blinkなどとします。

カスタムカラムパターン

デフォルトではホワイトスペースをカラムの区切りと認識して各色を適用しますが、regexpオプションでこれをカスタマイズできます。

例えば、リストにスペースで区切られた名前と苗字が含まれていて、そこは連続した背景色にしたい場合、次のようにします。

list = <<-EOS
Charlie Brown\t21\tprogrammer
Bill Clinton\t43\tdoctor
Liz Taylor\t18\tstudent
EOS

# 不適切な例:

list.each_line do |line|
  puts line.colco(:bg_green, :bg_green, :yellow, :blue_underline)
end

puts

# regexpオプションを使った例:

re = /^.*?(?=\t)|\S+/ # 最初のタブの前、または空白以外にマッチ

list.each_line do |line|
  puts line.colco(:bg_green, :yellow, :blue_underline, regexp:re)
end

出力です。

良かったら試してみてください。

以上、Yet Another Terminal Color for Rubyのお話でしたm(__)m

colcolor

melborne/colcolor

(追記：2014-7-28)

colcolorにcycleオプションを付けました。

カラム指向ターミナルカラーライブラリ「colcolor」にcycleオプションを付けました！