rtm 0.1.6 → 0.2.0

data/lib/rtm/axes.rb

@@ -0,0 +1,295 @@
+# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
+# License:   Apache License, Version 2.0
+
+module RTM
+  module Axes
+
+    # ---- Proxy ---------------------------------------------------------------#
+    class Proxy
+      #attr_accessor :construct
+      attr_reader :construct
+      attr_reader :tm
+      
+      def initialize(construct,tm)
+        test_for_type(construct)
+        @construct = construct
+        @tm = tm
+      end
+    end
+    
+    # ---- ItemProxy -----------------------------------------------------------#
+    class ItemProxy < Proxy
+      alias result construct
+      alias :tmapi :result
+    end
+    
+    # ---- RTM::Axes::Topic ----------------------------------------#
+    class Topic < ItemProxy
+      require "rtm/axes/topic"
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(RTM::Topic)
+          raise("This is not a Topic. A RTM::Axes::Topic object requires a RTM::Topic.")
+        end
+      end
+    end
+    
+    # ---- Association ---------------------------------------------------------#
+    class Association < ItemProxy
+      require "rtm/axes/association"
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(RTM::Association)
+          raise("This is not an Association. An RTM::Axes::Association object requires a RTM::Association.")
+        end
+      end
+    end
+    
+    # ---- RTM::Axes::Characteristic -------------------------------#
+    class Characteristic < ItemProxy
+      require "rtm/axes/characteristic"
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(RTM::Name) || construct.is_a?(RTM::Occurrence)
+          raise("This is not a Name or Occurrence. A RTM::Axes::Characteristic object requires a RTM::Name or RTM::Occurrence.")
+        end
+      end
+    end
+    
+    # ---- RTM::Axes::Name -----------------------------------------#
+    class Name < Characteristic
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(RTM::Name)
+          raise("This is not a Name. A RTM::Axes::Name object requires a RTM::Name.")
+        end
+      end
+    end
+    # ---- RTM::Axes::Occurrence -----------------------------------#
+    class Occurrence < Characteristic
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(RTM::Occurrence)
+          raise("This is not a Occurrence. A RTM::Axes::Occurrence object requires a RTM::Occurrence.")
+        end
+      end
+    end
+    
+    # ---- RTM::Axes::String ---------------------------------------#
+    class String < ItemProxy
+      require "rtm/axes/string"
+      
+      private
+      
+      def test_for_type(construct)
+        unless construct.is_a?(Object::String)
+          raise("This is not a String. A RTM::Axes::String object requires a String.")
+        end
+      end
+    end
+    
+    # ---- ArrayProxy ----------------------------------------------------------#
+    module ArrayProxy
+      def define_helper(method,*args)
+        inject([]){|all,containee| all << containee.send(method,*args)}.flatten
+      end
+    end
+    
+    #  # ---- ArrayProxy ----------------------------------------------------------#
+    #  class ArrayProxy < Proxy
+    ##    def method_missing(method,*args)
+    ##      if @construct.all? {|containee| containee.respond_to?(method)}
+    ##        ArrayProxy.new(@construct.inject([]){|all,containee| all << containee.send(method,*args)})
+    ##      else
+    ##        super
+    ##      end
+    ##    end
+    #
+    #
+    #
+    #    def self.define_proxy_return_topics(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        _res = _res.map{|item| item.construct}.flatten
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          Topics.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def self.define_proxy_return_associations(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        _res = _res.map{|item| item.construct}.flatten
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          Associations.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def self.define_proxy_return_characteristics(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        _res = _res.map{|item| item.construct}.flatten
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          Characteristics.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def self.define_proxy_return_strings(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        _res = _res.map{|item| item.construct}.flatten
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          Strings.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def self.define_proxy_return_string(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          Strings.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def self.define_proxy_return_item(method,*args)
+    #      define_method method do |*args|
+    #        _res = filter_helper(method,*args)
+    #        if _res.empty?
+    #          EmptyArrayProxy.new(_res)
+    #        else
+    #          AssocsNamesOccsProxy.new(_res)
+    #        end
+    #      end
+    #    end
+    #
+    #    def result
+    #      @construct.map{|containee| containee.result}
+    #    end
+    #    alias :tmapi :result
+    #
+    #    def filter_helper(method,*args)
+    #      _res = define_helper(method,*args) #Array
+    #      _res = _res.reject{|item| item.empty? }
+    #      _res = _res.reject{|item| item.class == NilProxy}
+    #    end
+    #
+    #    def define_helper(method,*args)
+    #      #@construct.inject([]){|all,containee| all << containee.send(method,*args).construct}.flatten
+    #      @construct.inject([]){|all,containee| all << containee.send(method,*args)}
+    #    end
+    #  end
+    
+    #  # ---- Topics ---------------------------------------------------------#
+    #  class Topics < ArrayProxy
+    #    define_proxy_return_characteristics(:characteristics)
+    #    define_proxy_return_strings(:indicators)
+    #    define_proxy_return_string(:item)
+    #    define_proxy_return_strings(:locators)
+    #    define_proxy_return_associations(:reverse_players)
+    #    define_proxy_return_item(:reifier)
+    #
+    #    define_proxy_return_topics(:supertypes)
+    #
+    #    define_proxy_return_topics(:subtypes)
+    #    define_proxy_return_topics(:traverse)
+    #    define_proxy_return_topics(:types)
+    #    define_proxy_return_topics(:instances)
+    #    define_proxy_return_topics(:reverse_types)
+    #    define_proxy_return_topics(:reverse_instances)
+    #    define_proxy_return_associations(:reverse_roles)
+    #  end
+  end
+end
+
+module RTM::Topic
+  
+  # Changes from TMAPI-mode to Axes-mode.
+  #
+  # :call-seq:
+  #   axes -> RTM::Axes::Topic
+  #
+  def axes(tm = self.topic_map)
+    RTM::Axes::Topic.new(self, tm)
+  end
+end
+
+module RTM::Name
+  
+  # Changes from TMAPI-mode to Axes-mode.
+  #
+  # :call-seq:
+  #   axes -> RTM::Axes::Name
+  #
+  def axes(tm = self.topic_map)
+    RTM::Axes::Name.new(self, tm)
+  end
+end
+
+module RTM::Occurrence
+  
+  # Changes from TMAPI-mode to Axes-mode.
+  #
+  # :call-seq:
+  #   axes -> RTM::Axes::Occurrence
+  #
+  def axes(tm = self.topic_map)
+    RTM::Axes::Occurrence.new(self, tm)
+  end
+end
+
+module RTM::Association
+  
+  # Changes from TMAPI-mode to Axes-mode.
+  #
+  # :call-seq:
+  #   axes -> RTM::Axes::Association
+  #
+  def axes(tm = self.topic_map)
+    RTM::Axes::Association.new(self, tm)
+  end
+end
+
+class String
+  
+  # Changes from TMAPI-mode to Axes-mode.
+  #
+  # A TopicMap must be specified.
+  #
+  # :call-seq:
+  #   axes(topic_map) -> RTM::Axes::String
+  #
+  def axes(tm)
+    RTM::Axes::String.new(self,tm)
+  end
+end
+
+require "rtm/axes/topics"
+require "rtm/axes/associations"
+require "rtm/axes/characteristics"
+require "rtm/axes/assocs_names_occs"
+require "rtm/axes/strings"

data/lib/rtm/axes/association.rb

@@ -0,0 +1,76 @@
+# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
+# License:   Apache License, Version 2.0
+
+module RTM::Axes
+
+  class Association < ItemProxy
+
+    # ---- players-axis ------------------------------------------------------#
+    
+    # Returns all Role players of Roles in this Association.
+    #
+    # The optional identifier specifies the type of the Roles to be considered.
+    # The identifier may be a Topic or Topic-Reference.
+    #
+    # Multiple instances of the same Topic are possible.
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   players -> Array of Topics
+    #   players(identifier) -> Array of Topics
+    #
+    def players(type=:any)
+      _res = @construct.players(type).map{|r| r.axes}
+      _res.extend(Topics)
+    end
+
+    # ---- reifier-axis ------------------------------------------------------#
+    
+    # Returns the reifing Topic or nil, if no such Topic exists.
+    #
+    # :call-seq:
+    #   reverse_reified -> Topic or nil
+    #
+    def reverse_reifier
+      _res = @construct.reifier #Topic or nil
+      RTM::Axes::Topic.new(_res,@tm) if _res
+    end
+
+    # ---- roles-axis --------------------------------------------------------#
+    
+    # Returns all Topics that are types of Roles of this Association.
+    # Multiple instances of the same Topic are possible.
+    #
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   roles -> Array of Topics
+    #
+    def roles
+      _res = @construct.getRoles.map {|r| r.getType }
+      _res = _res.map{|r| r.axes}
+      _res.extend(Topics)
+    end
+
+    # ---- scope-axis --------------------------------------------------------#
+    
+    # Returns the scope of this Association.
+    #
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   scope -> Array of Topics
+    #
+    def scope
+      _res = @construct.scope.map{|r| r.axes} #Array of Topics or empty Array
+      _res.extend(Topics)
+    end
+
+#    # ---- traverse-axis -----------------------------------------------------#
+#    #def reverse_traverse
+#    #
+#    #end
+
+
+  end
+end

data/lib/rtm/axes/associations.rb

@@ -0,0 +1,96 @@
+# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
+# License:   Apache License, Version 2.0
+
+module RTM::Axes
+  module Associations
+
+    def self.extended(k)
+      k.extend ArrayProxy
+    end
+
+    def result
+      self.map{|i| i.construct}
+    end
+    alias tmapi :result
+
+    # ---- players-axis ------------------------------------------------------#
+    
+    # Returns all Role players of Roles in these Associations.
+    #
+    # The optional identifier specifies the type of the Roles to be considered.
+    # The identifier may be a Topic or Topic-Reference.
+    #
+    # Multiple instances of the same Topic are possible.
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   players -> Array of Topics
+    #   players(identifier) -> Array of Topics
+    #
+    def players(type=:any)
+      _res = self.inject([]){|all,containee| all << containee.send(:players,type)}.flatten
+      ### NO UNIQUE ###
+      _res = _res.extend(Topics)
+      _res
+    end
+
+    # ---- reifier-axis ------------------------------------------------------#
+    
+    # Returns the reifing Topics of these Assocations only 
+    # if such Topics exist.
+    #
+    # The result may be empty. 
+    #
+    # :call-seq:
+    #   reverse_reified -> Array of Topics
+    #
+    def reverse_reifier
+      _res = self.inject([]){|all,containee| all << containee.send(:reverse_reifier)}.flatten
+      _res = _res.select{|i| i}
+      ### NO UNIQUE NEEDED
+      _res = _res.extend(Topics)
+      _res
+    end
+
+    # ---- roles-axis --------------------------------------------------------#
+    
+    # Returns all Topics that are types of Roles in these Associations.
+    # Multiple instances of the same Topic are possible.
+    #
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   roles -> Array of Topics
+    #
+    def roles
+      _res = self.inject([]){|all,containee| all << containee.send(:roles)}.flatten
+      ### NO UNIQUE ###
+      _res = _res.extend(Topics)
+      _res
+    end
+
+    # ---- scope-axis --------------------------------------------------------#
+    
+    # Returns the scope of these Associations.
+    #
+    # The result may be empty.
+    #
+    # :call-seq:
+    #   scope -> Array of Topics
+    #
+    def scope
+      _res = self.inject([]){|all,containee| all << containee.send(:scope)}.flatten
+      ### FLAG UNIQUE ###
+      _res = _res.map{|i| i.construct}.uniq.map{|i| i.axes}
+      ###             ###
+      _res = _res.extend(Topics)
+      _res
+    end
+
+#    # ---- traverse-axis -----------------------------------------------------#
+#    #def reverse_traverse
+#    #
+#    #end
+    
+  end
+end