phpBB

Development Wiki

User:Toonarmy/phpBB4/Pkg

From phpBB Development Wiki

Revision as of 11:13, 24 December 2009 by Toonarmy (Talk | contribs)

Repository

URI

scheme://((username)(:password)@)(host)/path/

Where:

scheme
Protocol scheme
Examples: http, https, ftp, ftps, file, ssh
username
Username for authentication (optional)
password
Password for authentication (optional)
host
Hostname for network accessed schemes (optional)
path
Path to the repository root

This should cover most cases but as far as the repository client library is concerned the scheme is the only standard component the schemes driver is responsible for interpreting the remainder of the URI.

Structure

All file paths inside the repository indexes should be either canonical relative paths from the root directory or absolute URIs. The preferred format is for relative paths however absolute URIs can be used to distribute media across mirrors.

  • /
    • repository.xml
    • repository.xml.signature
    • phpbb/
      • index.xml
      • 4/
        • index.xml
        • 0/
          • index.xml
          • org/
            • index.xml
            • cs278/
              • index.xml
              • chris/
                • index.xml
                • packages.xml
    • pool/
      • org/
        • cs278/
          • chris/
            • package/
              • package-1.0.0.xml
              • package-1.0.0.tar.gz

Files

repository.xml

<repository>
	<name>Chris' Sample Repository</name>
	<description>
		<xhtml:p>Sample <xhtml:b>description</xhtml:b></xhtml:p>
	</description>
	<contact>
		<name>Chris Smith</name>
		<email>toonarmy@phpbb.com</email>
	</contact>
	<idx:index>
		<idx:directory>
			<idx:name>phpbb</idx:name>
			<idx:product>phpBB</idx:product>
			<idx:checksum algorithm="sha256">{hash}</idx:checksum>
		</idx:directory>
	</idx:index>
</repository>

index.xml

Something like:

<index>
	<directory>
		<name>4</name>
		<version>
			<architecture>4</architecture>
		<version>
		<checksum algorithm="sha256">{hash}</checksum>
		<checksum algorithm="sha512">{hash}</checksum>
	</directory>
	<file>
		<name>packages.xml</name>
		<checksum algorithm="sha512">{hash}</checksum>
	</file>
</index>