Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/takuya/rbsync
TODO: one-line summary of your gem
https://github.com/takuya/rbsync
Last synced: 21 days ago
JSON representation
TODO: one-line summary of your gem
- Host: GitHub
- URL: https://github.com/takuya/rbsync
- Owner: takuya
- License: mit
- Created: 2011-06-11T07:02:41.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2011-07-27T16:57:12.000Z (over 13 years ago)
- Last Synced: 2024-10-13T18:53:16.408Z (about 1 month ago)
- Language: Ruby
- Size: 125 KB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rdoc
- License: LICENSE.txt
Awesome Lists containing this project
README
= rbsync
Synchronize files src to dest .
this class can sync files and recuresively
options are
+sync update file only
+no overwrite when dist files are newer than src
+sync by file digest hash , not useing filename
== usage
=== mirror files
同期元と同期先を同じにする
require 'rbsync'
rsync =RbSync.new
rsync.sync( "src", "dest" )
=== mirror updated only files
同期先に、同期元と同名のファイルがあったら、更新日時を調べる。新しいモノだけをコピーする．
require 'rbsync'
rsync =RbSync.new
rsync.sync( "src", "dest",{:update=>true} )
=== using exclude pattern
同期先と同期元を同じにする，但し、*.rb / *.log の拡張子は除外する．
require 'rbsync'
rsync =RbSync.new
rsync.sync( "src", "dest",{:excludes=>["*.log","*.bak"]} )
== sync by another name if file name confilicts
send src file with anothername. when file name confilicts
名前が衝突した場合で、ファイルを書換える時は，転送元のファイルを別名で転送する
windows のファイルコピーっぽい動作
before sync
|src | test.txt | 2011-06-14
|dest | test.txt | 2011-06-12
after sync
|src | test.txt | 2011-06-14
|dest | test(1).txt | 2011-06-14 # same to src
|dest | test.txt | 2011-06-12
== sync with backup
名前が衝突した場合で、ファイルを書換える場合転送先のファイルを別名で保存してから転送する
before sync
|src | test.txt | 2011-06-14
|dest | test.txt | 2011-06-12
after sync
|src | test.txt | 2011-06-14
|dest | test.txt | 2011-06-14 # same to src
|dest | test_20110614022255.txt | 2011-06-12 # moved
==special usage , sync by file cotetets
if directory has a same file with different file name. insted of filename , sync file by file hash
when files are theses,
|src| test.txt | "47bce5c74f589f4867dbd57e9ca9f808" |
|dst| test.bak | "47bce5c74f589f4867dbd57e9ca9f808" |
:check_hash results no effect.
ディレクトリ内のファイル名をうっかり変えてしまったときに使う．ファイル名でなく、ファイルの中身を比較して同期する．
|src| test.txt | "47bce5c74f589f4867dbd57e9ca9f808" |
|dst| test.bak | "47bce5c74f589f4867dbd57e9ca9f808" |
の場合何もおきません
require 'rbsync'
rsync =RbSync.new
rsync.sync( "src", "dest",{:check_hash=>true} )
=== directory has very large file ,such as mpeg video
using with :check_hash=>true
checking only head of 1024*1024 bytes to distinguish src / dest files.this is for speed up.
FileUtils::cmp is reading whole file. large file will take time.With :hash_limit_size Rbsync read only head of files for comparing.
巨大なファイルだと，全部読み込むのに時間が掛かるので、先頭1024*1024 バイトを比較してOKとする.写真とかはコレで十分
ファイル名を書換えてしまってコンテンツ内容の比較だけで使う。
:check_hash=>true とペアで使います
require 'rbsync'
rsync =RbSync.new
rsync.sync( "src", "dest",{:check_hash=>true,:hash_limit_size=1024*1024} )
=== sync both updated files
To sync both, call sync methods twice
双方向に同期させたい場合は２回起動する．
require 'rbsync'
rsync =RbSync.new
rsync.updated_file_only = true
rsync.sync( "src", "dest" )
rsync.sync( "dest", "src" )# swap src to dest , dest to src
== Contributing to rbsync
* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
* Fork the project
* Start a feature/bugfix branch
* Commit and push until you are happy with your contribution
* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
== Copyright
Copyright (c) 2011 takuya. See LICENSE.txt for
further details.