Author: Keiju ISHITSUKA
ruby上でsh/cshのようにコマンドの実行及びフィルタリングを手軽に行う. sh/cshの制御文はrubyの機能を用いて実現する.
Shellオブジェクトはカレントディレクトリを持ち, コマンド実行はそこからの 相対パスになります.
Shell#cwd
Shell#dir
Shell#getwd
Shell#pwdカレントディレクトリを返す。
Shell#system_pathコマンドサーチパスの配列を返す。
Shell#umaskumaskを返す。
コマンドの実行結果はすべてFilterとしてかえります. Enumerableをincludeし ています.
OS上のコマンドを実行するにはまず, Shellのメソッドとして定義します.
注) コマンドを定義しなくとも直接実行できるShell#systemコマンドもあります.
Shell.def_system_command(command, path = command)Shellのメソッドとしてcommandを登録します.
例) Shell.def_system_command "ls"
ls を定義
Shell.def_system_command "sys_sort", "sort"
sortコマンドをsys_sortとして定義
Shell.undef_system_command(command)commandを削除します.
Shell.alias_command(ali, command, *opts) {...}commandのaliasをします.
例)
Shell.alias_command "lsC", "ls", "-CBF", "--show-control-chars"
Shell.alias_command("lsC", "ls"){|*opts| ["-CBF", "--show-control-chars", *opts]}Shell.unalias_command(ali)commandのaliasを削除します.
Shell.install_system_commands(pre = "sys_")system_path上にある全ての実行可能ファイルをShellに定義する. メソッ ド名は元のファイル名の頭にpreをつけたものとなる.
Shell.newプロセスのカレントディレクトリをカレントディレクトリとするShellオ ブジェクトを生成します.
Shell.cd(path)pathをカレントディレクトリとするShellオブジェクトを生成します.
Shell#jobsスケジューリングされているjobの一覧を返す.
Shell#kill(sig, job)jobにシグナルsigを送る
Shell#cd(path, &block)
Shell#chdirカレントディレクトリをpathにする. イテレータとして呼ばれたときには ブロック実行中のみカレントディレクトリを変更する.
Shell#pushd(path = nil, &block)
Shell#pushdirカレントディレクトリをディレクトリスタックにつみ, カレントディレク トリをpathにする. pathが省略されたときには, カレントディレクトリと ディレクトリスタックのトップを交換する. イテレータとして呼ばれたと きには, ブロック実行中のみpushdする.
Shell#popd
Shell#popdirディレクトリスタックからポップし, それをカレントディレクトリにする.
Shell#foreach(path = nil, &block)pathがファイルなら, File#foreach pathがディレクトリなら, Dir#foreach
Shell#open(path, mode)pathがファイルなら, File#open pathがディレクトリなら, Dir#open
Shell#unlink(path)pathがファイルなら, File#unlink pathがディレクトリなら, Dir#unlink
Shell#test(command, file1, file2)
Shell#[command, file1, file2]ファイルテスト関数testと同じ. 例)
sh[?e, "foo"] sh[:e, "foo"] sh["e", "foo"] sh[:exists?, "foo"] sh["exists?", "foo"]
Shell#mkdir(*path)Dir.mkdirと同じ(複数可)
Shell#rmdir(*path)Dir.rmdirと同じ(複数可)
System#system(command, *opts)commandを実行する. 例)
print sh.system("ls", "-l")
sh.system("ls", "-l") | sh.head > STDOUTSystem#rehashリハッシュする
Shell#transact{ ... }ブロック中ではshellをselfとして実行する. 例)
sh.transact{system("ls", "-l") | head > STDOUT}Shell#out(dev = STDOUT, &block)transactを呼び出しその結果をdevに出力する.
Shell#echo(*strings)
Shell#cat(*files)
Shell#glob(patten)
Shell#tee(file)これらは実行すると, それらを内容とするFilterオブジェクトを返します.
Filter#eachフィルタの一行ずつをblockに渡す.
Filter#<(src)srcをフィルタの入力とする. srcが, 文字列ならばファイルを, IOであれ ばそれをそのまま入力とする.
Filter#>(to)srcをフィルタの出力とする. toが, 文字列ならばファイルに, IOであれ ばそれをそのまま出力とする.
Filter#>>(to)srcをフィルタに追加する. toが, 文字列ならばファイルに, IOであれば それをそのまま出力とする.
Filter#|(filter)パイプ結合
Filter#+(filter)filter1 + filter2 は filter1の出力の後, filter2の出力を行う.
Filter#to_a
Filter#to_s
Shell#atime(file)
Shell#basename(file, *opt)
Shell#chmod(mode, *files)
Shell#chown(owner, group, *file)
Shell#ctime(file)
Shell#delete(*file)
Shell#dirname(file)
Shell#ftype(file)
Shell#join(*file)
Shell#link(file_from, file_to)
Shell#lstat(file)
Shell#mtime(file)
Shell#readlink(file)
Shell#rename(file_from, file_to)
Shell#split(file)
Shell#stat(file)
Shell#symlink(file_from, file_to)
Shell#truncate(file, length)
Shell#utime(atime, mtime, *file)これらはFileクラスにある同名のクラスメソッドと同じです.
Shell#blockdev?(file)
Shell#chardev?(file)
Shell#directory?(file)
Shell#executable?(file)
Shell#executable_real?(file)
Shell#exist?(file)/Shell#exists?(file)
Shell#file?(file)
Shell#grpowned?(file)
Shell#owned?(file)
Shell#pipe?(file)
Shell#readable?(file)
Shell#readable_real?(file)
Shell#setgid?(file)
Shell#setuid?(file)
Shell#size(file)/Shell#size?(file)
Shell#socket?(file)
Shell#sticky?(file)
Shell#symlink?(file)
Shell#writable?(file)
Shell#writable_real?(file)
Shell#zero?(file)これらはFileTestクラスにある同名のクラスメソッドと同じです.
Shell#syscopy(filename_from, filename_to)
Shell#copy(filename_from, filename_to)
Shell#move(filename_from, filename_to)
Shell#compare(filename_from, filename_to)
Shell#safe_unlink(*filenames)
Shell#makedirs(*filenames)
Shell#install(filename_from, filename_to, mode)これらはFileToolsクラスにある同名のクラスメソッドと同じです.
その他, 以下のものがエイリアスされています.
Shell#cmpShell#compare と同じです。
Shell#mvShell#move と同じです。
Shell#cpShell#copy と同じです。
Shell#rm_fShell#safe_unlink と同じです。
Shell#mkpathShell#makedirs と同じです。
sh = Shell.cd("/tmp")
sh.mkdir "shell-test-1" unless sh.exists?("shell-test-1")
sh.cd("shell-test-1")
for dir in ["dir1", "dir3", "dir5"]
if !sh.exists?(dir)
sh.mkdir dir
sh.cd(dir) do
f = sh.open("tmpFile", "w")
f.print "TEST\n"
f.close
end
print sh.pwd
end
end
sh = Shell.cd("/tmp")
sh.transact do
mkdir "shell-test-1" unless exists?("shell-test-1")
cd("shell-test-1")
for dir in ["dir1", "dir3", "dir5"]
if !exists?(dir)
mkdir dir
cd(dir) do
f = open("tmpFile", "w")
f.print "TEST\n"
f.close
end
print pwd
end
end
end
sh.cat("/etc/printcap") | sh.tee("tee1") > "tee2"
(sh.cat < "/etc/printcap") | sh.tee("tee11") > "tee12"
sh.cat("/etc/printcap") | sh.tee("tee1") >> "tee2"
(sh.cat < "/etc/printcap") | sh.tee("tee11") >> "tee12"
print sh.cat("/etc/passwd").head.collect{|l| l =~ /keiju/}