catalog.py revision 39
#!/usr/bin/python
#
# CDDL HEADER START
#
# The contents of this file are subject to the terms of the
# Common Development and Distribution License (the "License").
# You may not use this file except in compliance with the License.
#
# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
# or http://www.opensolaris.org/os/licensing.
# See the License for the specific language governing permissions
# and limitations under the License.
#
# When distributing Covered Code, include this CDDL HEADER in each
# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
# If applicable, add the following below this CDDL HEADER, with the
# fields enclosed by brackets "[]" replaced with your own identifying
# information: Portions Copyright [yyyy] [name of copyright owner]
#
# CDDL HEADER END
#
# Copyright 2007 Sun Microsystems, Inc. All rights reserved.
# Use is subject to license terms.
import os
import re
import sha
import shutil
import time
import urllib
import pkg.fmri as fmri
import pkg.package as package
class Catalog(object):
"""A Catalog is the representation of the package FMRIs available to
this client or repository. Both purposes utilize the same storage
format.
The serialized structure of the repository is an unordered list of
available package versions, followed by an unordered list of
incorporation relationships between packages. This latter section
allows the graph to be topologically sorted by the client.
XXX A authority mirror-uri ...
XXX ...
V fmri
V fmri
...
I fmri fmri
I fmri fmri
...
XXX Mirroring records also need to be allowed from client configuration,
and not just catalogs.
XXX It would be nice to include available tags and package sizes,
although this could also be calculated from the set of manifests.
XXX self.pkgs should be a dictionary, accessed by fmri string (or
package name). Current code is O(N_packages) O(M_versions), should be
O(1) O(M_versions), and possibly O(1) O(1).
"""
def __init__(self):
self.authority = None
self.catalog_root = ""
self.pkgs = []
self.relns = {}
return
def set_authority(self, authority):
self.authority = authority
def set_catalog_root(self, croot):
self.catalog_root = croot
def load(self, path):
self.path = path
cfile = file(path, "r")
centries = cfile.readlines()
for entry in centries:
# each V line is an fmri
m = re.match("^V (pkg:[^ ]*)", entry)
if m == None:
continue
pname = m.group(1)
self.add_fmri(fmri.PkgFmri(pname, None))
return
def add_fmri(self, pkgfmri):
name = pkgfmri.get_pkg_stem()
pfmri = fmri.PkgFmri(name, None)
for pkg in self.pkgs:
if pkg.fmri.is_same_pkg(pfmri):
pkg.add_version(pkgfmri)
return
pkg = package.Package(pfmri)
pkg.add_version(pkgfmri)
self.pkgs.append(pkg)
def add_pkg(self, pkg):
for opkg in self.pkgs:
if pkg.fmri == opkg.fmri:
#
# XXX This package is already in the catalog
# with some version set. Are we updating the
# version set or merging the two?
#
opkg = pkg
return
self.pkgs.append(pkg)
return
def add_package_fmri(self, pkg_fmri):
return
def delete_package_fmri(self, pkg_fmri):
return
def get_matching_pkgs(self, pfmri, constraint):
"""Iterate through the catalog's, looking for an fmri match."""
# XXX FMRI-based implementation doesn't do pattern matching, but
# exact matches only.
pf = fmri.PkgFmri(pfmri, None)
for pkg in self.pkgs:
if pkg.fmri.is_similar(pf):
return pkg.matching_versions(pfmri, constraint)
raise KeyError, "%s not found in catalog" % pfmri
def __str__(self):
s = ""
for p in self.pkgs:
s = s + p.get_catalog_entry()
for r in self.relns:
s = s + "I %s\n" % r
return s
def difference(self, catalog):
"""Return a pair of lists, the first list being those package
FMRIs present in the current object but not in the presented
catalog, the second being those present in the presented catalog
but not in the current catalog."""
return