rtfs 0.2.0 → 0.2.1

data/CHANGES.md

@@ -1,3 +1,7 @@
+## 0.2.0 / 2013-03-15
+
+* Now can custom upload filename;
+
 ## 0.1.0 / 2012-04-25
 
 * Add WebService interface.
@@ -5,4 +9,4 @@
 
 ## 0.0.1 / 2011-08-02
 
-* Birthday!
+* Birthday!

data/README.md

@@ -124,14 +124,48 @@ tfs.save('foo.jpg')         # ==> 133/7463/foo.jpg
 
 # remove named file.
 tfs.del('foo.jpg')          # ==> true
+```
+
+
+Custom Path
+-----------
+
+自定义文件名的完整路径处理逻辑如下：
 
-# put files under public folder, and preserve its name.
-# will prepend the basedir in front of the file path passed in.
-tfs.save('jquery.js')
+```ruby
+tfs = RTFS::Client.new(:ns_addr => 'http://127.0.0.1:3800',
+                       :appkey  => 'myprecious',
+                       :basedir => Rails.root.join('public'))
+tfs.save('foo/ham.jpg')
 ```
 
+将会做如下步骤：
+
+ 1. 判断你的 TFS 中是否已有这个文件，
+ 2. 如果有，先删掉，
+ 3. 创建这个文件，相当于 UNIX 中的 `touch` 命令，不写入实际内容，文件内容为空，
+ 4. 尝试打开 `basedir` 与传入的 `foo/ham.jpg` 拼起来的路径，在此例中，即：
+    `Rails.root.join('public', 'foo/ham.jpg')`
+ 5. 将该文件数据写入 TFS
+
+在这中间，有个概念需要说明，自定义路径中，有一层叫做 uid（User ID），目的是分散文件位置，
+避免数据读写过度集中。如果希望把 TFS 当 CDN 用，则需要固定这个 uid，可以在实例化 `RTFS::Client`
+时传入，也可以实例化之后赋值：
+
+```ruby
+tfs = RTFS::Client.new(:uid => 10001,
+                       # other options...
+                       )
+
+tfs.uid = 10001
+```
+
+这里选择 10001 是有原因的。在 `RTFS::Client` 的实现中，如果用户没有指定 uid，
+则它会根据传入的文件名自动计算，算该名称的哈希，然后取余，范围是 10000 之内。
+而 10000 本身，则为 RTFS 的测试所用，所以，自定义的 uid，从 10001 开始，比较妥。
+
 
 Executabes?
 -----------
 
-RTFS will be available as a executable binary soon. Stay tuned...
+RTFS will be available as an executable binary soon. Stay tuned...

data/lib/rtfs/client.rb

@@ -17,17 +17,22 @@ module RTFS
     end
 
     attr_accessor :nameservers
+    attr_accessor :access_count
     attr_accessor :appkey
     attr_accessor :uid
 
     def initialize(options)
-      # 通过 ns_addr 的地址获取负载均衡的地址
-      @nameservers = open("#{options[:ns_addr]}/tfs.list").read.split("\n")
-      @appkey = options[:appkey]
 
+
+      @appkey = options[:appkey]
+      @ns_addr = options[:ns_addr]
       @basedir = options[:basedir]
       @uid = options[:uid]
 
+      @access_count = 0
+
+      get_nameservers
+
       if @uid.nil? && !@basedir.nil?
         (Digest::MD5.hexdigest(@basedir).to_i(16) % 10000)
       end
@@ -38,6 +43,11 @@ module RTFS
       http_get("/v1/#{appkey}/#{tfs_name}")
     end
 
+    def get_nameservers
+      # 通过 ns_addr 的地址获取负载均衡的地址
+      @nameservers = open("#{@ns_addr}/tfs.list").read.split("\n")
+    end
+
     # 上传文件
     # 参数:
     #   file_path     需要上传的文件路径
@@ -177,6 +187,11 @@ module RTFS
     #
     def nameserver
       # 现在第一行是 50，表示频次，访问 50 次就要更新
+      @access_count += 1
+      if(@access_count > @nameservers[0].to_i)
+        get_nameservers
+        @access_count = 0
+      end
       @nameservers[rand(@nameservers.size - 1) + 1]
     end
 

data/lib/rtfs/version.rb

@@ -5,7 +5,7 @@
 module RTFS::Version
   MAJOR    = 0
   MINOR    = 2
-  REVISION = 0
+  REVISION = 1
 
   class << self
     # Returns X.Y.Z formatted version string

data/spec/basics_spec.rb

@@ -3,12 +3,17 @@ require 'open-uri'
 
 describe 'Basic operations' do
   it 'should put and remove file' do
+    rcount = $tfs.access_count
+
     fname = $tfs.put('spec/a.jpg')
+    $tfs.access_count.should eq(rcount + 1)
 
     f = open("http://img01.daily.taobaocdn.net/tfscom/#{fname}.jpg")
     f.read.length.should eq(6511)
 
+    $tfs.access_count = $tfs.nameservers[0].to_i
     $tfs.rm(fname).should eq(true)
+    $tfs.access_count.should eq(0)
   end
 
   it 'should stat file' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rtfs
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-15 00:00:00.000000000 Z
+date: 2013-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client