unageanu-jiji 1.1.4 → 1.2.1

data/lib/jiji/operator.rb

@@ -9,7 +9,7 @@ require 'uuidtools'
 module JIJI
 
   #==オペレーター
-  class Operator
+  class Operator #:nodoc:
 
     #===コンストラクタ
     #*money*:: 保証金
@@ -129,13 +129,12 @@ module JIJI
     attr :conf, true
   end
 
-
-
   #==ポジション
   class Position
 
-    #売り/買い区分
+    #売り/買い区分:売り
     SELL = 0
+    #売り/買い区分:買い
     BUY  = 1
 
     #状態:注文中
@@ -151,18 +150,18 @@ module JIJI
 
     #===コンストラクタ
     #
-    #*sell_or_buy*:: 売りor買い
-    #*count*:: 数量
-    #*unit*:: 取引単位
-    #*date*:: 取引日時
-    #*rate*:: レート
-    #*pair*:: 通貨ペア
-    #*trader*:: 取引実行者
-    #*operator*:: operator
-    #*open_interest_no*:: 建玉番号
-    #*order_no*:: 注文番号
+    #sell_or_buy:: 売りor買い
+    #count:: 数量
+    #unit:: 取引単位
+    #date:: 取引日時
+    #rate:: レート
+    #pair:: 通貨ペア
+    #trader:: 取引実行者
+    #operator:: operator
+    #open_interest_no:: 建玉番号
+    #order_no:: 注文番号
     def initialize( position_id, sell_or_buy, count, unit, date, rate, pair,
-      trader, operator, open_interest_no="", order_no="" )
+      trader, operator, open_interest_no="", order_no="" ) #:nodoc:
       @position_id = position_id
       @sell_or_buy = sell_or_buy
       @count = count
@@ -186,19 +185,19 @@ module JIJI
       @swap_time += 60*60*24 if date > @swap_time
     end
 
-    def _commit
+    def _commit #:nodoc:
       raise "illegal state" if @state != STATE_START
       @state = STATE_FIXED
       @fix_date = @current_date
       @fix_rate = @current_rate
     end
 
-    def lost
+    def lost #:nodoc:
       @state = STATE_LOST
     end
 
     #===現在価格を更新
-    def next(rates)
+    def next(rates) #:nodoc:
       return if @state == STATE_FIXED
       rate = rates[@pair]
       @current_rate = @sell_or_buy == BUY ? rate.bid : rate.ask
@@ -216,15 +215,15 @@ module JIJI
 
       @current_date = rates.time
     end
-
-    def [](key)
+    
+    def [](key) #:nodoc:
       @info[key]
     end
-    def []=(key, value)
+    def []=(key, value) #:nodoc:
       @info[key] = value
     end
 
-    def values
+    def values #:nodoc:
       {
         :position_id => position_id,
         :raw_position_id => raw_position_id,
@@ -243,14 +242,14 @@ module JIJI
       }
     end
 
-    # クライアント
-    attr :operator
+    # クライアント 
+    attr :operator #:nodoc:
 
     # 一意な識別子
     attr_reader :position_id
     # プラグインが返す識別子
     attr :raw_position_id, true
-    
+
     # 売りか買いか?
     attr_reader :sell_or_buy
     # 状態
@@ -276,17 +275,17 @@ module JIJI
     attr_reader :swap
     # 通貨ペア
     attr_reader :pair
-    # 取引実行者
+    # 取引を行ったエージェント名
     attr_reader :trader
   end
 
   #==リアル取引用オペレーター
-  class RmtOperator < Operator
+  class RmtOperator < Operator #:nodoc:
 
     #===コンストラクタ
-    #*client*:: クライアント
-    #*logger*:: ロガー
-    #*money*:: 保証金
+    #client:: クライアント
+    #logger:: ロガー
+    #money:: 保証金
     def initialize( client, logger, trade_result_dao, trade_enable=true, money=nil )
       super(trade_result_dao,money)
       @client = client
@@ -295,8 +294,8 @@ module JIJI
     end
 
     #===購入する
-    #*count*:: 購入する数量
-    #*return*:: Position
+    #count:: 購入する数量
+    #return:: Position
     def buy(count, pair=:EURJPY, trader="")
       id = nil
       if @trade_enable
@@ -312,8 +311,8 @@ module JIJI
     end
 
     #===売却する
-    #*count*:: 売却する数量
-    #*return*:: Position
+    #count:: 売却する数量
+    #return:: Position
     def sell(count, pair=:EURJPY, trader="")
       id = nil
       if @trade_enable
@@ -346,46 +345,51 @@ module JIJI
     end
   end
 
-  # 各エージェントに設定されるオペレータ。
-  # 取引者としてエージェント名を指定して売り買いを行なう。
-  # また、建玉を独自に保持する。(エージェント間で共有されない)
-  # 売/買ロジック自体ははオペレータに委譲する。
+  #===オペレータ
+  #取引を行うためのクラスです。
+  #エージェントのプロパティとして設定されるので、エージェント内では以下のコードで取引を実行できます。
+  #
+  # sell_position = operator.sell(1, :EURJPY) # 売り
+  # buy_position  = operator.buy(1, :EURJPY) # 買い
+  # operator.commit( sell_position ) # 決済
+  #
   class AgentOperator
-    def initialize( operator, agent_name )
+    def initialize( operator, agent_name ) #:nodoc:
       @operator = operator
-      @name = agent_name
+      @agent_name = agent_name
       @positions = {}.taint
     end
 
-    #===購入する
+    #====購入します。
     #count:: 購入する数量
-    #pair:: 通貨ペア
-    #return:: ポジション
+    #pair:: 通貨ペアコード 例) :EURJPY
+    #return:: ポジション(JIJI::Position)
     def buy(count, pair=:EURJPY)
-      p = @operator.buy( count, pair, @name )
+      p = @operator.buy( count, pair, @agent_name )
       @positions[p.position_id] = p
       return p
     end
 
-    #===売却する
+    #====売却します。
     #count:: 売却する数量
-    #pair:: 通貨ペア
-    #return:: ポジション
+    #pair:: 通貨ペアコード 例) :EURJPY
+    #return:: ポジション(JIJI::Position)
     def sell(count, pair=:EURJPY)
-      p = @operator.sell( count, pair, @name )
+      p = @operator.sell( count, pair, @agent_name )
       @positions[p.position_id] = p
       return p
     end
 
-    # 取引を確定する
+    #===取引を確定します。
+    #position:: ホジション(JIJI::Position)
     def commit(position)
       @operator.commit(position)
       @positions.delete position.position_id
     end
-   
+
     #建て玉
     attr_reader :positions
-    
+    attr :agent_name, true
   end
 
 end

data/lib/jiji/output.rb

@@ -8,43 +8,85 @@ require 'fileutils'
 
 module JIJI
 
-  # データの出力先
+  #===グラフデータの出力先を作成するためのクラス
+  #エージェントでグラフを描画するには、JIJI::Output#getを呼び出してJIJI::GraphOutを取得し、グラフデータを出力します。
+  # 
+  # # output から出力先を作成。
+  # @out = output.get( "移動平均線", :graph, {
+  #   :column_count=>2, # データ数は2
+  #   :graph_type=>:line, # 線グラフ
+  #   :lines=>[30,40,50], # 30,40,50のメモリを描く
+  #   :colors=>["#779999","#557777"] # デフォルトのグラフの色
+  # })
+  # ...(略)
+  # 
+  # # グラフのデータを出力。
+  # # 出力先作成時にデータ数は2としているので、2つのデータを指定可能。
+  # @out.put( 33, 39 )
+  # @out.put( 45, 43 )
+  # @out.put( 60, 69 )
+  #
   class Output
 
+    #プロパティファイル名
+    PROPERTIES_FILE_NAME = "properties.yaml" #:nodoc:
+    #メタ情報ファイル名
+    META_FILE_NAME = "meta.yaml" #:nodoc:
+
     include Enumerable
 
-    def initialize( agent_name, dir, scales=[] )
-      @dir = "#{dir}/#{JIJI::Util.encode(agent_name).gsub(/\//, "_")}" # 「ベースディレクトリ/エージェント名/出力名」に保存する。
+    def initialize( agent_id, dir, scales=[] ) #:nodoc:
+      @dir = "#{dir}/#{agent_id}" # 「ベースディレクトリ/エージェントID/出力名」に保存する。
       FileUtils.mkdir_p @dir
 
       @outs = {}
       @scales = scales
+      @agent_id = agent_id
 
       # 既存データの読み込み
       DirLock.new( @dir ).writelock {
         Dir.glob( "#{@dir}/*" ) {|d|
+          meta = "#{d}/#{META_FILE_NAME}"
           next unless File.directory? d
-          next unless File.exist? "#{d}/meta.yaml"
-          props = YAML.load_file "#{d}/meta.yaml"
+          next unless File.exist? meta
+          props = YAML.load_file meta
           @outs[props[:name]] =
             create_output( d, props[:name], props[:type].to_sym, props )
         }
       }
+
+      # 名前の読み込み
+      file = properties_file
+      if File.exist? file
+        properties = YAML.load_file(file)
+        @agent_name = properties[:agent_name]
+      end
+    end
+
+    #エージェント名を設定する
+    def agent_name=(name) #:nodoc:
+      @agent_name = name
+      FileLock.new( properties_file ).writelock { |f|
+        f.write( YAML.dump({:agent_name=>name}) )
+      }
+    end
+
+    #エージェント名を取得する
+    def agent_name #:nodoc:
+      @agent_name
     end
 
-    # 名前に対応する出力先を得る。
-    # 対応する出力先がなければ新規に作成。
+    #====グラフの出力先オブジェクトを取得します。
     #
     #name:: 名前(UIでの表示名)
-    #type:: 種別。:event,:graphのいずれかが指定可能
-    #option:: 補足情報。以下が指定可能
-    # -*グラフの場合*
-    # --[:column_count] .. グラフのカラム数を整数値で指定する。(*必須*)
-    # --「:graph_type」 .. グラフの種類を指定する。以下の値が指定可能。
-    # ---"rate" ..  レート情報に重ねて表示(移動平均線やボリンジャーバンド向け)。グラフは、ローソク足描画領域に描画される。
-    # ---"zero_base" ..  0を中心線とした線グラフ(RCIやMACD向け)。グラフは、グラフ描画領域に描画される。
-    # ---"line" ..  線グラフとして描画する。(デフォルト)。グラフは、グラフ描画領域に描画される。
-    # --「:colors」 .. グラフの色を「#FFFFFF」形式の文字列の配列で指定する。指定を省略した場合「0x557777」で描画される。
+    #type:: 種別。:graph を指定してください。
+    #option:: 補足情報。以下が指定可能です
+    #         - 「:column_count」 .. グラフのカラム数を整数値で指定します。(<b>必須</b>)
+    #         - 「:graph_type」 .. グラフの種類を指定します。以下の値が指定可能です。
+    #           - :rate ..  レート情報に重ねて表示(移動平均線やボリンジャーバンド向け)。グラフは、ローソク足描画領域に描画される。
+    #           - :zero_base ..  0を中心線とした線グラフ(RCIやMACD向け)。グラフは、グラフ描画領域に描画される。
+    #           - :line ..  線グラフとして描画する。(デフォルト)。グラフは、グラフ描画領域に描画される。
+    #         - 「:colors」 .. グラフの色を「#FFFFFF」形式の文字列の配列で指定します。指定を省略した場合「0x557777」で描画されます。
     #return:: 出力先
     def get( name, type=:graph, options={} )
       raise "illegal Name. name=#{name}" if name =~ /[\x00-\x1F\x7F\\\/\r\n\t]/
@@ -62,24 +104,33 @@ module JIJI
     end
 
     # 出力先を列挙する
-    def each( &block )
+    def each( &block ) #:nodoc:
       @outs.each( &block )
     end
 
+    # 出力先をが存在するか評価する
+    def exist?( name ) #:nodoc:
+      @outs.key? name
+    end
+
+
     # 現在時刻を設定する
-    def time=(time)
+    def time=(time) #:nodoc:
       @time = time
       @outs.each_pair {|k,v|
         v.time = time
       }
     end
     # 現在時刻
-    attr_reader :time
+    attr_reader :time  #:nodoc:
     # スケール
-    attr :scales, true
+    attr :scales, true  #:nodoc:
+    # エージェントID
+    attr_reader :agent_id  #:nodoc:
+
   private
     # 出力先を作る
-    def create_output( sub_dir, name, type, options )
+    def create_output( sub_dir, name, type, options )  #:nodoc:
       case type
         when :event
           EventOut.new( sub_dir, name, options )
@@ -89,10 +140,14 @@ module JIJI
           raise "unkown output type."
       end
     end
+    #プロパティ情報ファイルのパスを取得する
+    def properties_file  #:nodoc:
+      "#{@dir}/#{PROPERTIES_FILE_NAME}"
+    end
   end
 
-  # 出力先の基底クラス
-  class BaseOut
+  #===出力先の基底クラス
+  class BaseOut #:nodoc:
 
     include Enumerable
 
@@ -121,7 +176,7 @@ module JIJI
 
     #設定値をファイルに出力
     def save
-      FileLock.new("#{@dir}/meta.yaml" ).writelock { |f|
+      FileLock.new("#{@dir}/#{JIJI::Output::META_FILE_NAME}" ).writelock { |f|
         f.write( YAML.dump(@options) )
       }
     end
@@ -134,7 +189,7 @@ module JIJI
   end
 
   # イベントデータの出力先
-  class EventOut < BaseOut
+  class EventOut < BaseOut #:nodoc:
     # ログを書き込む
     def put( type, message )
       @dao << JIJI::Dao::BasicTimedData.new(
@@ -145,18 +200,19 @@ module JIJI
     end
   end
 
-  # グラフデータの出力先
+  #===グラフデータの出力先
   class GraphOut < BaseOut
     # コンストラクタ
-    def initialize( dir, name, options, scales=[] )
+    def initialize( dir, name, options, scales=[] ) #:nodoc:
       @scales = scales
       super( dir, name, options )
     end
-    # ログを書き込む
+    #====グラフデータを出力します。
+    #numbers:: グラフデータ
     def put( *numbers )
       @dao << JIJI::Dao::BasicTimedData.new( numbers << @time.to_i, @time)
     end
-    def aggregators
+    def aggregators #:nodoc:
       list = @scales.map{|s| JIJI::Dao::AvgAggregator.new s}
       list << JIJI::Dao::RawAggregator.new
     end

data/lib/jiji/output_manager.rb

@@ -0,0 +1,84 @@
+
+require 'jiji/util/util'
+require "jiji/dao/timed_data_dao"
+require 'yaml'
+require 'jiji/util/fix_yaml_bug'
+require 'jiji/util/file_lock'
+require 'fileutils'
+
+module JIJI
+
+  # Outputのマネージャ
+  class OutputManager
+
+    #コンストラクタ
+    #registry:: レジストリ
+    def initialize( registry )
+      @registry = registry
+    end
+
+    #指定されたプロセスのOutputを列挙する
+    #process_id:: プロセスID
+    def each( process_id )
+      map = get_process_map( process_id )
+      map.each_pair {|k,v|
+        yield v
+      }
+    end
+
+    #指定されたプロセスの指定エージェントのOutputを生成する
+    #すでに作成済みであればそれをそのまま返す。
+    #process_id:: プロセスID
+    #agent_id:: エージェントID
+    def create( process_id, agent_id )
+      map = get_process_map( process_id )
+      unless map.key?( agent_id )
+        map[agent_id] = @registry.output( process_id, agent_id )
+      end
+      return map[agent_id]
+    end
+
+    #指定されたプロセスの指定エージェントのOutputを取得する
+    #process_id:: プロセスID
+    #agent_id:: エージェントID
+    def get( process_id, agent_id )
+      map = get_process_map( process_id )
+      unless map.key?( agent_id )
+        raise UserError.new( JIJI::ERROR_NOT_FOUND, "agent not found. id=#{agent_id}")
+      end
+      return map[agent_id]
+    end
+
+    #指定されたプロセスの指定エージェントのOutputを削除する
+    #process_id:: プロセスID
+    #agent_id:: エージェントID
+    def delete( process_id, agent_id )
+      map = get_process_map( process_id )
+      unless map.key?( agent_id )
+        raise UserError.new( JIJI::ERROR_NOT_FOUND, "agent not found. id=#{agent_id}")
+      end
+      FileUtils.rm_rf "#{@registry.output_dir(process_id)}/#{agent_id}"
+      map.delete(agent_id)
+    end
+
+    # 指定のプロセスに対応するoutputを取得する。
+    def get_process_map( process_id )
+     load_output( process_id )
+    end
+
+  private
+    def load_output( process_id )
+      # 既存データの読み込み
+      map = {}
+      dir = @registry.output_dir(process_id)
+      Dir.glob( "#{dir}/*" ) {|d|
+        properties_file = "#{d}/#{JIJI::Output::PROPERTIES_FILE_NAME}"
+        next unless File.directory? d
+        next unless File.exist? properties_file
+        agent_id = File.basename( d )
+        map[agent_id] = @registry.output( process_id, agent_id )
+      }
+      map
+    end
+  end
+end

data/lib/jiji/plugin/embedded/single_click_client.rb

@@ -40,9 +40,9 @@ module JIJI
           begin
             @session = create_session unless @session
             @session.request {|fx|
-              #timeout( conf[:timeout] || 60 ) {
+              timeout( conf[:timeout] || 60 ) {
                 yield fx
-              #}
+              }
             }
           rescue Exception
             begin

data/lib/jiji/plugin/securities_plugin.rb

@@ -31,7 +31,6 @@ module JIJI
       
       #プラグインを初期化します。プラグインの利用が開始される前に1度だけ呼び出されます。
       #引数として、ユーザーが入力したパラメータが渡されます。
-      #プラグインの利用開始前に一度だけ呼ばれます。
       #props:: ユーザーが入力したパラメータ(JIJI::Plugin::Securities::Inputのkeyをキーとする設定値の配列)
       #logger:: ロガー
       def init_plugin( props, logger )