rBuilder:Repository Browser

From rPath Wiki

rBuilder provides a Repository Browser as part of its web interface. All users, registered and unregistered, can browse the public contents of any project repository, and registered users can browse repository contents to which they have permissions. To browse a project's repository, navigate to the project and click Browse Repository from the Project Resources menu. This following sections describe the Repository Browser features.

Repository Browser Index

Repository contents are indexed by package or group name. After clicking Browse Repository for a project, use the linked letters at the top of the index to list all packages that start with that letter. Because groups all start with the group- prefix, they are listed in the "G" section. Click a linked package or group name to view its information.

Information Summary for Packages

The information summary for a package provides information and links to obtain more details. The information summary for a package includes the following:

The package name

The version information for the package

Click the arrow beside the version to toggle between the full version string and the default abbreviated view.

The version of the package from which it was shadowed or promoted (if applicable)

Click the arrow beside the original package from which the current package was shadowed or cloned to toggle between its full version string and the default abbreviated view. If the originating package is in the same rBuilder, click its linked version to view its complete package information.

The source component from which the package is built

Click the linked source component name to view its component information (as described in the Information Summary for Source Components section to follow.

A linked list of the components that make up the package

Click a linked component to view the source component from which it was built (may differ from the package itself).

The flavors in which the package was built

Click the arrow beside a flavor to toggle between the entire flavor and its default abbreviated view.

A Show Contents link for each flavor displaying the list of files that make up the package

Click this link to see the list of files, and note the following information about the list view:

* The file listing is in long list format as if viewing from a Linux command line.

* File names note those shown in blue indicate files that were shadowed and modified on the current branch.

A License and Crypto link for each flavor displaying any available license and cryptography information for the included software

Click this link to see the information, and not the following about the list view:

* License data is listed under Licenses if it is available for the component listed.

* Crypto data is listed under Crypto if it is available for the component listed.

* Currently, this data is only provided for certain packages provided by rPath Linux that have been packaged to display such data.

* As stated in the interface, rPath believes the information provided related to the licenses and cryptography is accurate, though such information may be out of date, and anyone using this software should rely only on its own review of this information.

A Search link to find packages derived from this package and groups which include this package (descendants and references)

Click this link to see the lists, and note the following information about that list view:

* The top list shows a list of all groups in the same rBuilder instance that contain the package.

* The bottom list shows a list of shadows of the package in the same rBuilder. For a package to appear in this list, the current user must have permission to see the package in its repository.

An All Versions display, showing a tree of labels and revisions on each label

Click a linked revision to change the information page to the same package on that label and revision.

Information Summary for Groups

The information summary for a package provides information and links to obtain more details. The information for a group includes:

The group name

The version information for the group

Click the arrow beside the version to toggle between the full version string and the default abbreviated view.

The version of the group from which it was shadowed or promoted (if applicable)

Click the arrow beside the original group from which the current group was shadowed or cloned to toggle between its full version string and the default abbreviated view. If the originating group is in the same rBuilder, click its linked version to view its complete group information.

The source component from which the group is built

Click the linked source component name to view its component information.

The flavors in which the group was cooked

Click the arrow beside a flavor to toggle between the entire flavor and its default abbreviated view.

A Show Contents link for each flavor displaying the list of packages and subgroups that make up the group

Click this link to see the list of packages and subgroups, and note the following information about the list view:

* Click the arrow beside an item's version to see its full version string.

* Click the linked item name to view the files that make up that item. Note files shown in blue indicating files that were shadowed and modified on the current branch.

A License and Crypto link for each flavor displaying any available license and cryptography information for the included software

Click this link to see the information, and not the following about the list view:

* License data is listed under Licenses if it is available for the package or component listed.

* Crypto data is listed under Crypto if it is available for the package or component listed.

* Currently, this data is only provided for certain packages provided by rPath Linux that have been packaged to display such data.

* As stated in the interface, rPath believes the information provided related to the licenses and cryptography is accurate, though such information may be out of date, and anyone using this software should rely only on its own review of this information.

A Search link to find packages derived from this package and groups which include this package (descendants and references)

A Search link to find groups derived from this group and other groups which include this group (descendants and references)

Click this link to see the lists, and not the following information about that list view:

* The top list shows a list of all other groups in the same rBuilder instance that contain the group.

* The bottom list shows a list of shadows of the group in the same rBuilder. For a package to appear in this list, the current user must have permission to see the group in its repository.

An All Versions display, showing a tree of labels and revisions on each label

Click a linked revision to change the information page to the same group name on that label and revision.

Information Summary for Source Components

Source components are repository units that contain the source from which a package or group is built. Click the linked :source component name in the Built from source section of a package or group information summary to view information about the source component. The information for a source component includes:

The component name

The version information for the source

Click the arrow beside the version to toggle between the full version string and the default abbreviated view.

The version of the source component from which it was shadowed or promoted (if applicable)

Click the arrow beside the original component from which the current component was shadowed or cloned to toggle between its full version string and the default abbreviated view. If the originating component is in the same rBuilder, click its linked version to view its complete component information.

A Show Files link for displaying the list of files that were committed as source for the package or group

Click this link to see the list of files, and note the following about that list view:

* Note the recipe file that was committed along with any supporting files.

* Click the linked file name to download the file. Note that this is a convenient way to view a recipe without checking out the source component.

An All Versions display, showing a tree of labels and revisions on each label

Click a linked revision to change the information page to the source component with the same name matching that label and revision.

Compare Versions

When a package or group has been shadowed from a parent branch and modified on the current branch, the Repository Browser includes a feature to compare the differences between a file on the parent and the same file on the shadow. To see these differences:

1. Navigate to the list of files in the shadow.
2. Click Calculate Diff beside the file listing.
3. Scroll the result page to see the differences between the parent version (on the left) and the current version (on the right).

In the following cases, the diff results vary:

• When a file exists on the current branch and not on the parent branch, the results include the entire file on the current branch.
• When a file's metadata has changed, but the file contents have not changed, the results include a message indicating this.