voruby 1.0.1

data/lib/voruby/resources/voresource/voresource_v0_9.rb

@@ -0,0 +1,405 @@
+require 'voruby/resources/voresource/loader'
+
+require 'voruby/resources/voresource/voresource_v0_10'
+
+module VORuby
+  module Resources
+    module VOResource
+      module V0_9
+        
+        # Forward declarations
+        class VODescription; end
+        class VOResource; end
+        class ResourceType; end
+        class Resource < ResourceType; end
+        class IdentifierType; end
+        class Identifier < IdentifierType; end
+        class AuthorityIDType; end
+        class AuthorityID < AuthorityIDType; end
+        class ResourceKeyType; end
+        class ResourceKey < ResourceKeyType; end
+        class Title; end
+        class ShortName; end
+        class SummaryType; end
+        class Summary < SummaryType; end
+        class Description; end
+        class SourceType; end
+        class Source < SourceType; end
+        class ReferenceURL < VOResource::V0_10::AnyURI; end
+        class CategoryType; end
+        class Type < CategoryType; end
+        class RelatedResourceType; end
+        class RelatedResource < RelatedResourceType; end
+        class RelationshipType; end
+        class Relationship < RelationshipType; end
+        class LogicalIdentifierType < IdentifierType; end
+        class LogicalIdentifier < LogicalIdentifierType; end
+        class CurationType; end
+        class Curation < CurationType; end
+        class ResourceReferenceType; end
+        class Publisher < ResourceReferenceType; end
+        class RelatedTo < ResourceReferenceType; end
+        class ContactType; end
+        class Contact < ContactType; end
+        class Name; end
+        class Email; end
+        class DateType; end
+        class Date < DateType; end
+        class NameReferenceType; end
+        class CreatorType < NameReferenceType; end
+        class Contributor < NameReferenceType; end
+        class Creator < CreatorType; end
+        class Logo < VOResource::V0_10::AnyURI; end
+        class Version; end
+        class Subject; end
+        class ContentLevelType; end
+        class ContentLevel < ContentLevelType; end
+        class InterfaceType; end
+        class Interface < InterfaceType; end
+        class InvocationType; end
+        class Invocation < InvocationType; end
+        class AccessURLType < VOResource::V0_10::AnyURI; end
+        class AccessURL < AccessURLType; end
+        class CapabilityType; end
+        class Capability < CapabilityType; end
+        class Facility < ResourceReferenceType; end
+        class Instrument < ResourceReferenceType; end
+        class ServiceType < ResourceType; end
+        class Service < ServiceType; end
+        class StandardID < IdentifierType; end
+        class StandardURL < VOResource::V0_10::AnyURI; end
+        
+        # A description of one or more VO Resources.
+        class VODescription
+          include XML::Mapping
+          
+          array_node :resources, 'Resource', :class => Resource, :optional => false
+        end
+        
+        # A description of a single VO Resource.
+        class VOResource
+          include XML::Mapping
+          
+          object_node :resource, 'Resource', :class => Resource, :optional => false
+        end
+        
+        # Any entity that is describable and identifiable by a IVOA Identifier.
+        class Resource; end
+        class ResourceType
+          include XML::Mapping
+          
+          date_time_node :created, '@created', :optional => true
+          date_time_node :updated, '@updated', :optional => true
+          
+          text_enumeration_node :status, :optional => true, :default_value => 'active',
+            :choices => ['active', 'inactive', 'deleted']
+          
+          object_node :identifier, 'Identifier', :class => Identifier, :optional => false
+          object_node :title, 'Title', :class => Title, :optional => false
+          object_node :short_name, 'ShortName', :class => ShortName, :optional => true
+          object_node :summary, 'Summary', :class => Summary, :optional => false
+          object_node :curation, 'Curation', :class => Curation, :optional => false
+          
+          array_node :types, 'Type', :class => Type, :optional => true
+          array_node :related_resources, 'RelatedResource', :class => RelatedResource, :optional => true, :default_value => []
+          array_node :logical_identifiers, 'LogicalIdentifier', :class => LogicalIdentifier, :optional => true, :default_value => []
+          array_node :subjects, 'Subject', :class => Subject, :optional => true, :default_value => []
+          array_node :content_levels, 'ContentLevel', :class => ContentLevel, :optional => true, :default_value => []
+        end
+        
+        # Unambiguous reference to the resource conforming to the IVOA standard for identifiers.
+        class Identifier; end
+        class IdentifierType
+          include XML::Mapping
+          
+          object_node :authority_id, 'AuthorityID', :class => AuthorityID, :optional => false
+          object_node :resource_key, 'ResourceKey', :class => ResourceKey, :optional => false
+        end
+        
+        # The identifier of a namespace under the control of a single naming authority.
+        class AuthorityID; end
+        class AuthorityIDType
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+          
+          def value=(authid)
+            raise RuntimeError, "AuthorityID '#{authid} in wrong format" if !authid.match(/^[\w\d][\w\d\-_\.!~\*'\(\)]{2,}$/)
+
+             @value = authid
+          end
+        end
+        
+        # A name for a resource that is unique within an authority's namespace.
+        class ResourceKey; end
+        class ResourceKeyType
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+          
+          def value=(reskey)
+            raise RuntimeError, "Resource Key '#{reskey}' in wrong format" if !reskey.match("^[\w\d\-_\.!~\*'\(\)]+(/[\w\d\-_\.!~\*'\(\)]+)*$")
+          end
+        end
+        
+        # The full name of a resource.
+        class Title
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # A short name or abbreviation for this resource that applications may use to refer to this resource in a compact display.
+        class ShortName
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # An account of the nature of the resource.
+        class Description
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # An informational, human-readable overview of a resource.
+        class Summary; end
+        class SummaryType
+          include XML::Mapping
+          
+          object_node :description, 'Description', :class => Description, :optional => false
+          object_node :reference_url, 'ReferenceURL', :class => ReferenceURL, :optional => false
+          object_node :source, 'Source', :class => Source, :optional => true
+        end
+        
+        # A bibliographic reference from which the present resource is derived or extracted.
+        class Source; end
+        class SourceType
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+          text_node :format, '@format', :optional => true
+        end
+        
+        # URL pointing to a human-readable document describing this resource.
+        class ReferenceURL; end
+        
+        # Nature or genre of the content of the resource.
+        class Type; end
+        class CategoryType
+          include XML::Mapping
+          
+          text_enumeration_node :value, '', :optional => false,
+            :choices => ['Other', 'Archive', 'Bibliography', 'Catalog',
+                         'Journal', 'Library', 'Simulation', 'Survey',
+                         'Transformation', 'Education', 'Outreach', 'EPOResource',
+                         'Animation', 'Artwork', 'Background', 'BasicData',
+                         'Historical', 'Photographic', 'Press', 'Organisation',
+                         'Project', 'Person']
+        end
+        
+        # A description of a relationship to another resource.  
+        class RelatedResource; end
+        class RelatedResourceType
+          include XML::Mapping
+          
+          object_node :relationship, 'Relationship', :class => Relationship, :optional => false
+          object_node :related_to, 'RelatedTo', :class => RelatedTo, :optional => false
+        end
+        
+        # A property that relates one resource to another.
+        class Relationship; end
+        class RelationshipType
+          include XML::Mapping
+          
+          text_enumeration_node :value, '', :optional => false,
+            :choices => ['service-for', 'derived-from', 'related-to']
+        end
+        
+        # The resource that is related to the current one being described.
+        class RelatedTo; end
+        
+        # A reference to a group of resources which the current resouce 
+        # claims to be similar to in some way.  A resource's registered
+        # identifier (given by the Identifier element) is its default
+        # LogicalIdentifier.
+        class LogicalIdentifier; end
+        class LogicalIdentiferType
+          include XML::Mapping
+          
+          # a name refering to the characteristic that relates resources having this logical identifier.
+          text_node :role, '@role', :optional => true
+        end
+        
+        # Information regarding the general curation of the resource.
+        class Curation; end
+        class CurationType
+          include XML::Mapping
+          
+          object_node :publisher, 'Publisher', :class => Publisher, :optional => false
+          object_node :contact, 'Contact', :class => Contact, :optional => false
+          object_node :creator, 'Creator', :class => Creator, :optional => true
+          object_node :version, 'Version', :class => Version, :optional => true
+          
+          array_node :dates, 'Date', :class => Date, :optional => true, :default_value => []
+          array_node :contributors, 'Contributor', :class => Contributor, :optional => true, :default_value => []
+        end
+        
+        # Entity (e.g. person or organisation) responsible for making the resource available.
+        class Publisher; end
+        
+        class ResourceReferenceType
+          include XML::Mapping
+          
+          object_node :identifier, 'Identifier', :class => Identifier, :optional => true
+          object_node :title, 'Title', :class => Title, :optional => false
+          object_node :description, 'Description', :class => Description, :optional => true
+          object_node :reference_url, 'ReferenceURL', :class => ReferenceURL, :optional => true
+        end
+        
+        # Information that can be used for contacting someone with regard to this resource.
+        class Contact; end
+        class ContactType
+          include XML::Mapping
+          
+          object_node :name, 'Name', :class => Name, :optional => false
+          object_node :identifier, 'Identifier', :class => Identifier, :optional => true
+          object_name :email, 'Email', :class => Email, :optional => true
+        end
+        
+        # The name of someone or something.
+        class Name
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # An email address.
+        class Email
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # Date associated with an event in the life cycle of the resource.
+        class Date; end
+        class DateType
+          include XML::Mapping
+          
+          # a string indicating what the date refers to
+          text_node :role, '@role', :optional => true, :default_value => 'representative'
+          
+          date_time_node :value, '', :optional => false
+        end
+        
+        # Entity responsible for contributions to the content of the resource.
+        class Contributor; end
+        
+        class NameReferenceType
+          include XML::Mapping
+          
+          object_node :identifier, 'Identifier', :class => Identifier, :optional => true
+          object_node :name, 'Name', :class => Name, :optional => false
+        end
+        
+        # The entity (e.g. person or organisation) primarily responsible for creating the content or constitution of the resource.
+        class Creator; end
+        class CreatorType
+          object_node :logo, 'Logo', :class => Logo, :optional => true
+        end
+        
+        # URL pointing to a graphical logo, which may be used to help identify the information source.
+        class Logo; end
+        
+        # Label associated with creation or availablilty of a version ofa resource.
+        class Version
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # List of topics, object types, or other descriptive keywords about the resource.
+        class Subject
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+        end
+        
+        # Description of the content level or intended audience.
+        class ContentLevel; end
+        class ContentLevelType
+          include XML::Mapping
+          
+          text_enumeration_node :value, '', :optional => false,
+            :choices => ['General', 'Elementary Education', 'Middle School Education', 'Secondary Education',
+                         'Community College', 'University', 'Research', 'Amateur', 'Informal Education']
+        end
+        
+        # A description of a service interface.
+        class Interface; end
+        # This is typically used as a base type for defining specific
+        # kinds of service interfaces.  If this type is used
+        # directly, the Description element should be used to describe
+        # how to invoke the service.
+        class InterfaceType
+          require XML::Mapping
+          
+          object_node :invocation, 'Invocation', :class => Invocation, :optional => false
+          object_node :description, 'Description', :class => Description, :optional => true
+          object_node :access_url, 'AccessURL', :class => AccessURL, :optional => false
+        end
+        
+        # The type of interface used by the current Service, expressed as a controlled name.
+        class Invocation; end
+        class InvocationType
+          require XML::Mapping
+          
+          text_enumeration_node :value, '', :optional => false,
+            :choices => ['Extended', 'WebService', 'WebBrowser', 'GLUService']
+        end
+        
+        # A full or base URL that can be used to access data or a service.
+        class AccessURL; end
+        class AccessURLType
+          # a flag indicating whether this should be interpreted as a base
+          # URL, a full URL, or a URL to a directory that will produce a 
+          # listing of files
+          text_enumeration_node :use, '@use', :optional => true,
+            :choices => ['full', 'base', 'dir']
+        end
+        
+        # A specific description of the context and capabilities of a service.
+        class Capability; end
+        # This is a base type for defining specific kinds of service 
+        # capability descriptions, each with its own special mark-up schema.
+        class CapabilityType
+          include XML::Mapping
+          
+          object_node :standard_url, 'StandardURL', :class => StandardURL, :optional => true
+          object_node :standard_id, 'StandardID', :class => StandardID, :optional => true
+        end
+        
+        # The observatory or facility used to collect the data contained or managed by this resource.
+        class Facility; end
+        
+        # the instrument used to collect the data contain or managed by a resource.
+        class Instrument; end
+        
+        # A resource that provides an interface for executing some operation or retrieving data.
+        class Service; end
+        class ServiceType
+          object_node :capability, 'Capability', :class => Capability, :optional => true
+          object_node :interface, 'Interface', :class => Interface, :optional => false
+        end
+        
+        # An identifier for a registered standard.
+        class StandardID; end
+        
+        # A URL that points to a human-readable document that describes the standard upon which a resource is based.
+        class StandardURL; end
+        
+      end
+    end
+  end
+end

data/lib/voruby/resources/voresource/voresource_v1_0.rb

@@ -0,0 +1,230 @@
+require 'voruby/resources/voresource/loader'
+
+# Re-use the classes unchanged from previous versions of the schema.
+require 'voruby/resources/voresource/voresource_v0_10'
+
+module VORuby
+  module Resources
+    module VOResource
+      module V1_0
+        
+        # Forward declarations
+        class Resource; end
+        class Organisation < Resource; end
+        class Service < Resource; end
+        class ValidationLevel; end
+        class Curation; end
+        class ResourceName < VOResource::V0_10::ResourceName; end
+        class Creator < VOResource::V0_10::Creator; end
+        class Contact < VOResource::V0_10::Contact; end
+        class Content; end
+        class Subject; end
+        class Source < VOResource::V0_10::Source; end
+        class Type < VOResource::V0_10::Type; end
+        class ContentLevel < VOResource::V0_10::ContentLevel; end
+        class Relationship; end
+        class RelatedResource; end
+        class Rights; end
+        class Capability; end
+        class Interface; end
+        class SecurityMethod; end
+        class AuthorityID < VOResource::V0_10::AuthorityID; end
+        class WebBrowser < Interface; end
+        class WebService < Interface; end
+        class Validation < ValidationLevel; end
+        class UTCTimestamp; end
+        class UTCDateTime < UTCTimestamp; end
+        class Date < UTCDateTime; end
+        class ShortName < VOResource::V0_10::ShortName; end
+        class AnyURI < VOResource::V0_10::AnyURI; end
+        class IdentifierURI < VOResource::V0_10::IdentifierURI; end
+        class AccessURL < AnyURI; end
+        class ResourceKey < VOResource::V0_10::ResourceKey; end
+        
+        $CapabilityUnmarshaller = Resources::namespace_dispatcher(
+          'VORuby::Resources::VOResource::V1_0',
+          'Capability', Capability)
+        $InterfaceUnmarshaller = Resources::namespace_dispatcher(
+          'VORuby::Resources::VOResource::V1_0',
+          'Interface', Interface)
+
+        # Any entity or component of a VO application that is describable and identifiable by a IVOA Identifier.
+        class Resource
+          include XML::Mapping
+    
+          text_node :title, 'title', :optional => false
+          date_time_node :created, '@created', :optional => true
+          date_time_node :updated, '@updated', :optional => true
+        
+          text_enumeration_node :status, '@status', :optional => false, :default_value => 'active',
+            :choices => ['active', 'inactive', 'deleted']
+          
+          object_node :short_name, 'shortName', :class => ShortName, :optional => true
+          object_node :identifier, 'identifier', :class => IdentifierURI, :optional => false
+          object_node :curation, 'curation', :class => Curation, :optional => false
+          object_node :content, 'content', :class => Content, :optional => false
+          array_node :validation_levels, 'validationLevel', :class => Validation, :optional => true, :default_value => []
+        end
+  
+        # A numeric grade describing the quality of the
+        # resource description, when applicable, 
+        # to be used to indicate the confidence an end-user
+        # can put in the resource as part of a VO application
+        # or research study.
+        class ValidationLevel
+          include XML::Mapping
+    
+          numeric_enumeration_node :value, '', :optional => false,
+            :choices => [0, 1, 2, 3, 4]
+        end
+  
+        # Information regarding the general curation of the resource.
+        class Curation
+          include XML::Mapping
+    
+          text_node :version, 'version', :optional => true
+    
+          object_node :publisher, 'publisher', :class => ResourceName, :optional => false
+    
+          array_node :creators, 'creator', :class => Creator, :default_value => [], :optional => true
+          array_node :contributors, 'contributor', :class => ResourceName, :default_value => [], :optional => true
+          array_node :dates, 'date', :class => Date, :default_value => [], :optional => true
+          array_node :contacts, 'contact', :class => Contact, :optional => false
+        end
+  
+        # Date associated with an event in the life cycle of the resource.
+        class Date
+          include XML::Mapping
+
+          text_node :role, '@role', :optional => false, :default_value => 'representative'
+        end
+  
+        # Information regarding the general content of the resource.
+        class Content
+          include XML::Mapping
+    
+          text_node :description, 'description', :optional => false
+    
+          object_node :source, 'source', :class => Source, :optional => true
+          object_node :reference_url, 'referenceURL', :class => AnyURI, :optional => false
+    
+          array_node :subjects, 'subject', :class => Subject, :optional => false
+          array_node :types, 'type', :class => Type, :default_value => [], :optional => true
+          array_node :content_levels, 'contentLevel', :class => ContentLevel, :default_value => [], :optional => true
+          array_node :relationships, 'relationship', :class => Relationship, :default_value => [], :optional => true
+        end
+  
+        # A topic, object type, or other descriptive keywords about the resource.
+        class Subject
+          include XML::Mapping
+    
+          text_node :value, '', :optional => false
+        end
+  
+        # A description of a relationship to another resource.
+        class Relationship
+          include XML::Mapping
+    
+          text_node :relationship_type, 'relationshipType', :optional => false
+    
+          array_node :related_resources, 'relatedResource', :class => RelatedResource, :optional => false
+        end
+  
+        # The name of resource that this resource is related to.
+        class RelatedResource
+          include XML::Mapping
+    
+          text_node :value, '', :optional => false
+        end
+  
+        # A named group of one or more persons brought together to pursue participation in VO applications.
+        class Organisation
+          array_node :facilities, 'facility', :class => ResourceName, :optional => true, :default_value => []
+          array_node :instruments, 'instrument', :class => ResourceName, :optional => true, :default_value => []
+        end
+  
+        # A resource that can be invoked by a client to perform some action on its behalf.
+        class Service
+          array_node :rights, 'rights', :class => Rights, :optional => true, :default_value => []
+          
+          # Choose the capability based on the type.
+          array_node :capabilities, 'capability', :unmarshaller => $CapabilityUnmarshaller, :optional => true,
+            :default_value => []
+        end
+  
+        # Information about rights held in and over the resource.
+        class Rights
+          include XML::Mapping
+    
+          text_enumeration_node :value, '', :optional => false,
+            :choices => ['public', 'secure', 'proprietary']
+        end
+  
+        # A description of a general capability of the service and how to use it.
+        class Capability
+          include XML::Mapping
+    
+          text_node :capability_type, '@type', :optional => true
+          text_node :description, 'description', :optional => true
+          
+          object_node :standard_id, '@standardID', :class => AnyURI, :optional => true
+    
+          array_node :validation_levels, 'validationLevel', :class => Validation, :optional => true, :default_value => []
+          array_node :interfaces, 'interface', :unmarshaller => $InterfaceUnmarshaller, :optional => true, :default_value => []
+        end
+  
+        # A description of how to call the service to access this capability
+        class Interface
+          include XML::Mapping
+    
+          text_node :interface_type, '@type', :optional => false
+          text_node :version, '@version', :optional => true, :default_value => '1.0'
+          text_node :role, '@role', :optional => true
+    
+          array_node :access_urls, 'accessURL', :class => AccessURL, :optional => false
+          array_node :security_methods, 'securityMethod', :class => SecurityMethod, :optional => true, :default_value => []
+        end
+      
+        # The URL (or base URL) that a client uses to access the service.
+        class AccessURL
+          text_enumeration_node :use, '@use', :optional => false, :default_value => 'full',
+            :choices => ['full', 'base', 'post', 'dir']
+        end
+  
+        # A description of a security mechanism.
+        class SecurityMethod
+          include XML::Mapping
+
+          object_node :standard_id, '@standardID', :class => AnyURI, :optional => false
+        end
+  
+        # A (form-based) interface intended to be accesed interactively by a user via a web browser.
+        class WebBrowser; end
+  
+        # A Web Service that is describable by a WSDL document.
+        class WebService
+          array_node :wsdl_urls, 'wsdlURL', :class => AnyURI, :optional => true, :default_value => []
+        end
+      
+        # A validation stamp combining a validation level and the ID of the validator.
+        class Validation
+          object_node :validated_by, '@validatedBy', :class => IdentifierURI, :optional => false
+        end
+        
+        # A timestamp that is compliant with ISO8601 but disallows the use of a timezone indicator.
+        class UTCTimestamp
+          include XML::Mapping
+          
+          text_node :value, '', :optional => false
+          
+          def value=(timestamp)
+            raise RuntimeError, "UTCTimestamp '#{timestamp} in wrong format" if !timestamp.strip.match('^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(\.\d+)?$')
+          
+            @value = Time.parse(timestamp.strip)
+          end
+        end
+      
+      end
+    end
+  end
+end

data/lib/voruby/services/ext.rb

@@ -0,0 +1,11 @@
+class Hash
+  require 'soap/mapping/registry'
+  
+  def to_soap_map
+    map = SOAP::Mapping::Object.new()
+    self.each do |name, value|
+      map[name] = value
+    end
+    map
+  end
+end