ALD 0.1.0 → 0.1.1

data/lib/ALD/local_filter.rb

@@ -0,0 +1,136 @@
+require 'semantic'
+
+module ALD
+  class API
+    class Collection
+      # Internal: Used by ItemCollection/UserCollection#where to filter data
+      # locally if possible. All methods are module methods.
+      module LocalFilter
+        # Internal: Apply certain conditions on given data. This is a wrapper
+        # method that calls ::filter, ::sort (if necessary) and applies a :range
+        # condition (if specified).
+        #
+        # data       - an Array of Hashes representing the entries to apply
+        #              conditions upon
+        # conditions - the Hash of conditions to apply
+        #
+        # Returns the modified data Array.
+        #
+        # Raises ArgumentError if the conditions cannot be applied. This can be
+        # avoided by passing them to ::can_apply? beforehand.
+        def self.apply_conditions(data, conditions)
+          data = filter(data, conditions)
+          data = sort(data, conditions[:sort])  if conditions.key?(:sort)
+          data = data.slice(conditions[:range]) if conditions.key?(:range)
+          data
+        end
+
+        # Internal: Test if the given filter, sort and range conditions can be
+        # applied locally or need a request to the server.
+        #
+        # conditions - a Hash of conditions to test
+        # local_keys - an Array of Strings or Symbols, containing the key names
+        #              that are available locally
+        #              Related: CollectionEntry::initialized_attributes
+        #
+        # Returns a Boolean; true if local application is possible, false
+        # otherwise
+        def self.can_apply?(conditions, local_keys)
+          local_keys.map!(&:to_sym) # symbolize keys
+
+          conditions.all? do |key, value|
+            if key == :sort
+              sort_criteria(value).all? { |c| local_keys.include?(c) }
+            else
+              local_keys.include?(key) || key == :range # range is always supported
+            end
+          end
+        end
+
+        # Internal: Filter the given data locally. This does not support range
+        # or switch conditions. Array conditions also only work if the values
+        # are exactly the same, i.e. the same entries in the same order.
+        #
+        # data       - an Array of Hashes representing the entries to filter
+        # conditions - a Hash of conditions to filter for
+        #
+        # Returns the filtered data array
+        #
+        # Raises ArgumentError if a filter is detected that cannot be handled
+        # locally. This can be prevented by calling ::can_filter? first.
+        def self.filter(data, conditions)
+          data.select do |entry|
+            conditions.all? do |key, value|
+              if [:sort, :range].include?(key)
+                true # must be done somewhere else
+              elsif entry.key?(key.to_s) # should be a locally available key
+                entry[key.to_s] == value
+              else
+                raise ArgumentError  # should be prevented by can_filter?
+              end
+            end
+          end
+        end
+
+        # Internal: Sort the given data locally
+        #
+        # data - the Array of Hashes representing entries
+        # sort - either: a Hash, associating sorting criteria (symbols) to
+        #        sorting direction (:asc ord :desc); or an Array of Symbols
+        #        representing sorting criteria (direction defaults to :asc)
+        #
+        # Returns the sorted data array
+        def self.sort(data, sort)
+          sort = to_sort_hash(sort)
+          data.sort do |a, b|
+            sortings(sort, a, b).find { |s| s != 0 } || 0 # use highest-priority (i.e. first) sorting info != 0
+          end
+        end
+
+        # Internal: Get the sort order for given criteria.
+        #
+        # sort - a Hash as described in ::sort
+        # a, b - the Hashes to compare
+        #
+        # Returns an Array of Integers (-1, 0, +1), where each represents the
+        # sort order for one of the sort keys.
+        def self.sortings(sort, a, b)
+          sort.map do |key, dir|
+            key = key.to_s
+            if key == 'version'
+              result = Semantic::Version.new(a[key]) <=> Semantic::Version.new(b[key])
+            else
+              result = a[key] <=> b[key]
+            end
+            dir == :asc ? result : -result
+          end
+        end
+        private_class_method :sortings
+
+        # Internal: Create a sorting Hash from an Array.
+        #
+        # sort - a Hash or Array, in the format described in ::sort
+        #
+        # Returns a Hash, in the format described in ::sort.
+        def self.to_sort_hash(sort)
+          if sort.is_a?(Hash)
+            sort
+          else
+            Hash[sort.map { |c| [c, :asc] }]
+          end
+        end
+        private_class_method :to_sort_hash
+
+        # Internal: The inverse of ::to_sort_hash.
+        #
+        # sort - an Array or Hash, in the format described in ::sort
+        #
+        # Returns an Array, in the format described in ::sort.
+        def self.sort_criteria(sort)
+          sort.is_a?(Hash) ? sort.keys : sort
+        end
+        private_class_method :sort_criteria
+      end
+    end
+  end
+end

data/lib/ALD/user.rb

@@ -0,0 +1,94 @@
+require_relative 'collection_entry'
+require 'date'
+
+module ALD
+  class API
+    # Public: A user registered on an ALD server.
+    class User < CollectionEntry
+      # Public: Get the user's ID.
+      #
+      # Returns a 32-character string containing the user's GUID.
+      #
+      # Signature
+      #
+      #   id()
+
+      # Public: Get the user's name
+      #
+      # Returns a String containing the user's name.
+      #
+      # Signature
+      #
+      #   name()
+
+      # Public: Get the user's registration date. This method might trigger a
+      # HTTP request.
+      #
+      # Returns a DateTime containing the date and time of the user's
+      # registration on the ALD server.
+      #
+      # Signature
+      #
+      #   joined()
+
+      # Public: Get the user's privileges on the ALD server. This method might
+      # trigger a HTTP request.
+      #
+      # Returns an Array of Symbols representing privileges the user has.
+      #
+      # Signature
+      #
+      #   privileges()
+
+      # Internal: Create a new instance. This method is called by API#user and
+      # should not be called by library consumers.
+      #
+      # api         - The ALD::API instance this user belongs to
+      # data        - a Hash containing the user's data
+      # initialized - a Boolean indicating whether the given data is complete
+      #               or further API requests are necessary.
+      def initialize(api, data, initialized = false)
+        super(api, data, initialized)
+      end
+
+      # todo: mail
+
+      # Public: Get the MD5 hash of the user's mail adress. This method might
+      # trigger a HTTP request.
+      #
+      # Returns a String with the hashed mail adress.
+      def mailMD5
+        request unless initialized?
+        @data['mail-md5']
+      end
+
+      private
+
+      # Internal: If the data given to the constructor was not complete, use
+      # the API to request further information from the server.
+      #
+      # Returns nothing.
+      def request
+        @data = @api.request("/users/#{id}")
+        @data['privileges'].map!(&:to_sym)
+        @data['joined'] = DateTime.parse(@data['joined'])
+      end
+
+      # Internal: Override of CollectionEntry#initialized_attributes to enable
+      # automatic method definition, in this case #id and #name.
+      #
+      # Returns an Array of attribute names (String)
+      def self.initialized_attributes
+        %w[id name]
+      end
+
+      # Internal: Override of CollectionEntry#requested_attributes to enable
+      # automatic method definition, in this case #joined and #privileges.
+      #
+      # Returns an Array of attribute names (String)
+      def self.requested_attributes
+        %w[joined privileges]
+      end
+    end
+  end
+end

data/lib/ALD/user_collection.rb

@@ -0,0 +1,140 @@
+require_relative 'collection'
+require_relative 'conditioned'
+
+module ALD
+  class API
+    # Public: Represents a collection of users on an ALD server.
+    class UserCollection < Collection
+      include Conditioned
+
+      # Internal: Create a new collection instance. Library consumers should
+      # not directly call this, but instead obtain new instances from API#users
+      # or #where.
+      #
+      # api        - the ALD::API instance this collection belongs to
+      # conditions - the Hash of conditions users in this collection must meet
+      # data       - an Array of Hashes containing the data about the users in
+      #              the collection. May be nil.
+      def initialize(api, conditions = {}, data = nil)
+        super(api, conditions, data)
+      end
+
+      # Public: Access an individual user in the collection.
+      #
+      # Examples
+      #
+      #   puts api.users['Fred'].name # => 'Fred'
+      #
+      # Returns the ALD::API::User instance representing the user, or nil if
+      # not found.
+      #
+      # Signature
+      #
+      #   [](name)
+      #   [](id)
+      #
+      # name - a String containing the user's name
+      # id   - a 32-character String containing the user's GUID
+
+      # Internal: filter conditions that allow specifying a range. See #where.
+      RANGE_CONDITIONS = %w[joined]
+
+      # Internal: filter conditions that allow specifying an array.
+      ARRAY_CONDITIONS = %w[privileges]
+
+      # Internal: filter conditions that can be handled locally.
+      LOCAL_CONDITIONS = %w[name]
+
+      # Public: Return a new collection containing a subset of the users in
+      # this collection.
+      #
+      # conditions - a Hash of conditions the users in the new collection must
+      #              meet:
+      #              :range      - a zero-based Integer Range of users in this
+      #                            collection that should be in the new
+      #                            collection. Note that this is applied AFTER
+      #                            the other conditions.
+      #              :joined     - the date and time the user registered to the
+      #                            server. Instead of specifying an exact value,
+      #                            You can specify a comparison such as
+      #                            '>= 2013-03-04 13:00:00'.
+      #              :privileges - an Array of privileges the user should have.
+      #              :sort       - an Array of sorting criteria, in descending
+      #                            order of precedence; or a Hash where the keys
+      #                            are the sorting criteria, and the values
+      #                            (:asc, :desc) indicate sorting order.
+      #
+      # Returns a new UserCollection or self if conditions is nil.
+      #
+      # Raises ArgumentError if the new conditions are incompatible with the
+      # current ones.
+      #
+      # Signature
+      #
+      #   where(conditions)
+
+      private
+
+      # Internal: Make a HTTP request to the ALD server to get the list of user
+      # hashes matching this collection's conditions.
+      #
+      # Returns nothing.
+      def request
+        data = [
+          range_condition_queries(%w[joined]),
+          array_queries(%w[privileges]),
+          sort_query,
+          range_query
+        ].reduce({}, :merge)
+
+        url = "/items/#{data.empty? ? '' : '?'}#{URI.encode_www_form(data)}"
+        @data = @api.request(url).map do |hash|
+          hash['id'] = @api.normalize_id(hash['id'])
+          hash
+        end
+      end
+
+      # Internal: Make a HTTP request to the ALD server to get a single user.
+      # Used by Collection#[].
+      #
+      # filter - a filter Hash as returned by #entry_filter
+      #
+      # Returns a Hash with all information about the user.
+      #
+      # Raises ArgumentError if the filters cannot be handled.
+      def request_entry(filter)
+        url = if %w[id name].any? { |k| filter.key?(k.to_sym) }
+          "/users/#{filter[:id] || filter[:name]}"
+        else
+          raise ArgumentError
+        end
+
+        @api.request(url)
+      end
+
+      # Internal: Used by Collection#each and Collection#[] to create new users.
+      #
+      # hash        - a Hash describing the item, with the keys 'id' and 'name'
+      # initialized - a Boolean indicating if the given Hash already contains
+      #               all information about the user or only name and id.
+      def entry(hash, initialized = false)
+        @api.user(hash, initialized)
+      end
+
+      # Internal: Implements user access for #[]. See Collection#entry_filter
+      # for more information.
+      #
+      # UserCollection allows access by ID (String) or name (String).
+      def entry_filter(args)
+        unless args.length == 1 && args.first.is_a?(String)
+          raise ArgumentError
+        end
+        if /^[0-9a-fA-F]{32}$/ =~ args.first
+          { id: @api.normalize_id(args.first) }
+        else
+          { name: args.first }
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ALD
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - maul.esel
@@ -130,12 +130,20 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/ALD.rb
-- lib/ALD/package.rb
+- lib/ALD/local_filter.rb
 - lib/ALD/definition.rb
+- lib/ALD/collection.rb
+- lib/ALD/item.rb
+- lib/ALD/package.rb
+- lib/ALD/user.rb
 - lib/ALD/package_generator.rb
-- lib/ALD/definition_generator.rb
+- lib/ALD/user_collection.rb
+- lib/ALD/api.rb
 - lib/ALD/exceptions.rb
-- lib/ALD/schema.xsd
+- lib/ALD/definition_generator.rb
+- lib/ALD/collection_entry.rb
+- lib/ALD/item_collection.rb
+- lib/ALD/conditioned.rb
 homepage: https://github.com/Library-Distribution/ALD.rb
 licenses:
 - MIT

data/lib/ALD/schema.xsd

@@ -1,340 +0,0 @@
-<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-			xmlns:ald="ald://package/schema/2014"
-			attributeFormDefault="qualified" elementFormDefault="qualified"
-			targetNamespace="ald://package/schema/2014">
-
-	<xsd:simpleType name="guid-type"> <!-- defines the type of a GUID -->
-		<xsd:restriction base="xsd:string">
-			<xsd:pattern value="[a-fA-F0-9]{32}"/> <!-- update: do not use any format, just the raw number -->
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="internetURL">
-		<xsd:restriction base="xsd:anyURI">
-			<xsd:pattern value="https?://.*"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="schemaURL">
-		<xsd:restriction base="xsd:anyURI">
-			<xsd:pattern value="(https?|ald)://.*"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="word-string">
-		<xsd:restriction base="xsd:string">
-			<xsd:pattern value="(\w|_)+"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="architecture">
-		<xsd:restriction base="xsd:string">
-			<xsd:enumeration value="x32"/>
-			<xsd:enumeration value="x64"/>
-			<xsd:enumeration value="x128"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="encoding">
-		<xsd:restriction base="xsd:string">
-			<xsd:enumeration value="ANSI"/>
-			<xsd:enumeration value="Unicode"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:simpleType name="access">
-		<xsd:restriction base="xsd:string">
-			<xsd:enumeration value="read"/>
-			<xsd:enumeration value="write"/>
-			<xsd:enumeration value="read+write"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<!-- I. VERSIONING -->
-	<!-- a. semantic versioning -->
-	<xsd:simpleType name="semverType">
-		<xsd:restriction base="xsd:string">
-			<xsd:pattern value="(\d+)\.(\d+)\.(\d+)(\-([0-9A-Za-z\-]+\.)*([0-9A-Za-z\-]+))?(\+([0-9A-Za-z\-]+\.)*([0-9A-Za-z\-]+))?"/>
-		</xsd:restriction>
-	</xsd:simpleType>
-
-	<xsd:complexType name="semanticVersion"> <!-- defines a version of a dependency -->
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" name="value" type="ald:semverType"/>
-	</xsd:complexType>
-
-	<xsd:group name="semantic-version-switch"> <!-- defines several ways to validate a version -->
-		<xsd:choice>
-			<xsd:element name="version" type="ald:semanticVersion"/> <!-- the only accepted version number -->
-			<xsd:element name="version-list"> <!-- a list of accepted version numbers -->
-				<xsd:complexType>
-					<xsd:sequence>
-						<xsd:element name="version" type="ald:semanticVersion" minOccurs="1" maxOccurs="unbounded"/>
-					</xsd:sequence>
-				</xsd:complexType>
-			</xsd:element>
-			<xsd:element name="version-range"> <!-- a range of accepted version numbers -->
-				<xsd:complexType>
-					<xsd:sequence>
-						<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-					</xsd:sequence>
-
-					<xsd:attribute use="required" type="ald:semverType" name="min-version"/> <!-- the lower bound of a range of accepted version numbers for the item. -->
-					<xsd:attribute use="required" type="ald:semverType" name="max-version"/> <!-- the upper bound of a range of accepted version numbers for the item. -->
-				</xsd:complexType>
-			</xsd:element>
-		</xsd:choice>
-	</xsd:group>
-
-	<!-- b. lax versioning -->
-	<!-- defines a version of a requirement -->
-	<xsd:complexType name="laxVersion">
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="value"/> <!-- carries the version number -->
-	</xsd:complexType>
-
-	<xsd:group name="version-switch"> <!-- defines several ways to validate a version -->
-		<xsd:choice>
-			<xsd:element name="version" type="ald:laxVersion"/> <!-- the only accepted version number -->
-			<xsd:element name="version-list"> <!-- a list of accepted version numbers -->
-				<xsd:complexType>
-					<xsd:sequence>
-						<xsd:element name="version" type="ald:laxVersion" minOccurs="1" maxOccurs="unbounded"/>
-					</xsd:sequence>
-				</xsd:complexType>
-			</xsd:element>
-			<xsd:element name="version-range"> <!-- a range of accepted version numbers -->
-				<xsd:complexType>
-					<xsd:sequence>
-						<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-					</xsd:sequence>
-
-					<xsd:attribute use="required" type="xsd:string" name="min-version"/> <!-- the lower bound of a range of accepted version numbers for the item. -->
-					<xsd:attribute use="required" type="xsd:string" name="max-version"/> <!-- the upper bound of a range of accepted version numbers for the item. -->
-				</xsd:complexType>
-			</xsd:element>
-		</xsd:choice>
-	</xsd:group>
-	<!-- END OF VERSIONING -->
-
-	<!-- defines data of an author who wrote this item -->
-	<xsd:complexType name="authorType">
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="name"/> <!-- the name to identify the author. Can be same as user-name -->
-		<xsd:attribute use="optional" type="xsd:string" name="user-name"/> <!-- the AHK forums user name -->
-		<xsd:attribute use="optional" type="ald:internetURL" name="homepage"/> <!-- an URL to a homepage of the author -->
-		<xsd:attribute use="optional" type="xsd:string" name="email"/> <!-- an email address of the author -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- defines a library required for this item to work -->
-	<xsd:complexType name="dependencyType">
-		<xsd:sequence>
-			<xsd:group ref="ald:semantic-version-switch" minOccurs="1" maxOccurs="1"/> <!-- defines the version(s) of this dependency that are accepted -->
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="name"/> <!-- the name of the required item -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- specifies that the item can run on the given system -->
-	<xsd:complexType name="targetType">
-		<xsd:sequence>
-			<xsd:element name="language-version" minOccurs="0" maxOccurs="1">
-				<xsd:complexType>
-					<xsd:group ref="ald:version-switch" minOccurs="1" maxOccurs="1"/>
-				</xsd:complexType>
-			</xsd:element>
-			<xsd:element name="target" type="ald:targetType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="optional" type="xsd:string" name="message"/>
-		<xsd:attribute use="optional" type="xsd:NCName" name="id"/>
-
-		<xsd:attribute use="optional" type="ald:architecture" name="language-architecture"/>
-		<xsd:attribute use="optional" type="ald:encoding" name="language-encoding"/>
-		<xsd:attribute use="optional" type="ald:architecture" name="system-architecture"/>
-		<xsd:attribute use="optional" type="xsd:string" name="system-version"/>
-		<xsd:attribute use="optional" type="xsd:string" name="system-type"/>
-
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- specifies different files for different platforms -->
-	<xsd:complexType name="fileSetType">
-		<xsd:sequence>
-			<xsd:choice minOccurs="1" maxOccurs="unbounded">
-				<xsd:element name="file" type="ald:fileType"/>
-				<xsd:element name="file-set" type="ald:fileSetType"/>
-			</xsd:choice>
-			<xsd:element name="target" minOccurs="0" maxOccurs="unbounded">
-				<xsd:complexType>
-					<xsd:attribute use="required" type="xsd:NCName" name="ref"/>
-				</xsd:complexType>
-			</xsd:element>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="src"/>
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- defines a file being included -->
-	<xsd:complexType name="fileType">
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute name="path" use="required" type="xsd:string"/> <!-- the (internal) path to the file -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- defines a tag for the package -->
-	<xsd:complexType name="tagType">
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute name="name" use="required" type="ald:word-string"/> <!-- the name of the tag -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- defines a link related to the package -->
-	<xsd:complexType name="linkType">
-		<xsd:sequence>
-			<xsd:element name="customdata" type="ald:customDataType" minOccurs="0" maxOccurs="unbounded"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="name"/> <!-- a short name for what the link points to -->
-		<xsd:attribute use="required" type="xsd:string" name="description"/> <!-- a description of what the link points to -->
-		<xsd:attribute use="required" type="ald:internetURL" name="href"/> <!-- the URL the link points to -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<!-- allows users to include custom data in the package which can be read by ALD clients -->
-	<xsd:complexType name="customDataType" mixed="true">
-		<xsd:sequence>
-			<xsd:any minOccurs="0" maxOccurs="unbounded" processContents="lax"/>
-		</xsd:sequence>
-
-		<xsd:attribute use="required" type="xsd:string" name="namespace"/> <!-- a string identifying the client using this or the usage for the included data -->
-		<xsd:attribute use="optional" type="ald:schemaURL" name="schema"/> <!-- an optional schema URL which can be used for checking the content -->
-		<xsd:anyAttribute/>
-	</xsd:complexType>
-
-	<xsd:complexType name="file-list-type">
-		<xsd:sequence minOccurs="0" maxOccurs="unbounded">
-			<xsd:choice>
-				<xsd:element name="file" type="ald:fileType"/>
-				<xsd:element name="file-set" type="ald:fileSetType"/>
-			</xsd:choice>
-		</xsd:sequence>
-	</xsd:complexType>
-
-	<xsd:complexType name="repositoryType">
-		<xsd:sequence minOccurs="1" maxOccurs="unbounded">
-			<xsd:element name="url">
-				<xsd:complexType>
-					<xsd:simpleContent>
-						<xsd:extension base="xsd:anyURI">
-							<xsd:attribute use="required" type="ald:access" name="access"/>
-						</xsd:extension>
-					</xsd:simpleContent>
-				</xsd:complexType>
-			</xsd:element>
-		</xsd:sequence>
-		<xsd:attribute use="required" type="xsd:string" name="type"/>
-		<xsd:attribute use="required" type="ald:internetURL" name="view-url"/>
-	</xsd:complexType>
-
-	<!-- root -->
-	<xsd:element name="package">
-		<xsd:complexType>
-			<xsd:sequence>
-				<xsd:element name="description" minOccurs="1" maxOccurs="1" type="xsd:string"/>
-				<xsd:element name="authors" minOccurs="1" maxOccurs="1"> <!-- the list of authors being involved in this item -->
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="author" type="ald:authorType" minOccurs="1" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<xsd:element name="dependencies" minOccurs="0" maxOccurs="1"> <!-- the list of dependencies this package has -->
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="dependency" type="ald:dependencyType" minOccurs="0" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<xsd:element name="targets" minOccurs="1" maxOccurs="1">
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="target" type="ald:targetType" minOccurs="0" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-
-					<xsd:unique name="targetID">
-						<xsd:selector xpath=".//ald:target"/>
-						<xsd:field xpath="@ald:id"/>
-					</xsd:unique>
-				</xsd:element>
-				<xsd:element name="files" minOccurs="1" maxOccurs="1"> <!-- holds the lists of files to include -->
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="doc" type="ald:file-list-type" minOccurs="1" maxOccurs="1"/> <!-- the list of documentation files -->
-							<xsd:element name="src" type="ald:file-list-type" minOccurs="1" maxOccurs="1"/> <!-- the list of source files -->
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<xsd:element name="development" minOccurs="0" maxOccurs="1">
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="repository" type="ald:repositoryType" minOccurs="1" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<xsd:element name="tags" minOccurs="0" maxOccurs="1"> <!-- the list of tags for the package -->
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="tag" type="ald:tagType" minOccurs="1" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<!-- todo: triggers
-					Triggers can be run after installation, before and after update and before uninstall.
-					They consist of a command line to execute.
-				-->
-				<xsd:element name="links" minOccurs="1" maxOccurs="1"> <!-- the list of related links -->
-					<xsd:complexType>
-						<xsd:sequence>
-							<xsd:element name="link" type="ald:linkType" minOccurs="0" maxOccurs="unbounded"/>
-						</xsd:sequence>
-					</xsd:complexType>
-				</xsd:element>
-				<xsd:any minOccurs="0"/>
-			</xsd:sequence>
-
-			<xsd:attribute use="required" type="ald:guid-type"   name="id"/> <!-- the unique ID of the package -->
-			<xsd:attribute use="required" type="xsd:string"      name="type"/> <!-- the type of the package -->
-			<xsd:attribute use="required" type="xsd:string"      name="summary"/>
-			<xsd:attribute use="required" type="xsd:string"      name="name"/> <!-- the name of the package -->
-			<xsd:attribute use="required" type="ald:semverType"  name="version"/> <!-- the current version of the package -->
-			<xsd:attribute use="optional" type="xsd:string"      name="logo-image"/> <!-- the relative path to a logo image, if one is included -->
-			<xsd:attribute use="optional" type="ald:internetURL" name="homepage"/>
-			<xsd:anyAttribute/>
-		</xsd:complexType>
-
-		<xsd:keyref name="target-ref" refer="ald:targetID">
-			<xsd:selector xpath=".//ald:file-set/ald:target"/>
-			<xsd:field xpath="@ald:ref"/>
-		</xsd:keyref>
-	</xsd:element>
-</xsd:schema>