daklib/dbconn.py

   1 #!/usr/bin/python
   2
   3 """ DB access class
   4
   5 @contact: Debian FTPMaster <ftpmaster@debian.org>
   6 @copyright: 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
   7 @copyright: 2008-2009  Mark Hymers <mhy@debian.org>
   8 @copyright: 2009  Joerg Jaspert <joerg@debian.org>
   9 @copyright: 2009  Mike O'Connor <stew@debian.org>
  10 @license: GNU General Public License version 2 or later
  11 """
  12
  13 # This program is free software; you can redistribute it and/or modify
  14 # it under the terms of the GNU General Public License as published by
  15 # the Free Software Foundation; either version 2 of the License, or
  16 # (at your option) any later version.
  17
  18 # This program is distributed in the hope that it will be useful,
  19 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 # GNU General Public License for more details.
  22
  23 # You should have received a copy of the GNU General Public License
  24 # along with this program; if not, write to the Free Software
  25 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  26
  27 ################################################################################
  28
  29 # < mhy> I need a funny comment
  30 # < sgran> two peanuts were walking down a dark street
  31 # < sgran> one was a-salted
  32 #  * mhy looks up the definition of "funny"
  33
  34 ################################################################################
  35
  36 import os
  37 import re
  38 import psycopg2
  39 import traceback
  40 from datetime import datetime, timedelta
  41 from errno import ENOENT
  42 from tempfile import mkstemp, mkdtemp
  43
  44 from inspect import getargspec
  45
  46 import sqlalchemy
  47 from sqlalchemy import create_engine, Table, MetaData
  48 from sqlalchemy.orm import sessionmaker, mapper, relation
  49 from sqlalchemy import types as sqltypes
  50
  51 # Don't remove this, we re-export the exceptions to scripts which import us
  52 from sqlalchemy.exc import *
  53 from sqlalchemy.orm.exc import NoResultFound
  54
  55 from config import Config
  56 from textutils import fix_maintainer
  57
  58 ################################################################################
  59
  60 # Patch in support for the debversion field type so that it works during
  61 # reflection
  62
  63 class DebVersion(sqltypes.Text):
  64     def get_col_spec(self):
  65         return "DEBVERSION"
  66
  67 sa_major_version = sqlalchemy.__version__[0:3]
  68 if sa_major_version == "0.5":
  69     from sqlalchemy.databases import postgres
  70     postgres.ischema_names['debversion'] = DebVersion
  71 else:
  72     raise Exception("dak isn't ported to SQLA versions != 0.5 yet.  See daklib/dbconn.py")
  73
  74 ################################################################################
  75
  76 __all__ = ['IntegrityError', 'SQLAlchemyError']
  77
  78 ################################################################################
  79
  80 def session_wrapper(fn):
  81     """
  82     Wrapper around common ".., session=None):" handling. If the wrapped
  83     function is called without passing 'session', we create a local one
  84     and destroy it when the function ends.
  85
  86     Also attaches a commit_or_flush method to the session; if we created a
  87     local session, this is a synonym for session.commit(), otherwise it is a
  88     synonym for session.flush().
  89     """
  90
  91     def wrapped(*args, **kwargs):
  92         private_transaction = False
  93
  94         # Find the session object
  95         session = kwargs.get('session')
  96
  97         if session is None:
  98             if len(args) <= len(getargspec(fn)[0]) - 1:
  99                 # No session specified as last argument or in kwargs
 100                 private_transaction = True
 101                 session = kwargs['session'] = DBConn().session()
 102             else:
 103                 # Session is last argument in args
 104                 session = args[-1]
 105                 if session is None:
 106                     args = list(args)
 107                     session = args[-1] = DBConn().session()
 108                     private_transaction = True
 109
 110         if private_transaction:
 111             session.commit_or_flush = session.commit
 112         else:
 113             session.commit_or_flush = session.flush
 114
 115         try:
 116             return fn(*args, **kwargs)
 117         finally:
 118             if private_transaction:
 119                 # We created a session; close it.
 120                 session.close()
 121
 122     wrapped.__doc__ = fn.__doc__
 123     wrapped.func_name = fn.func_name
 124
 125     return wrapped
 126
 127 __all__.append('session_wrapper')
 128
 129 ################################################################################
 130
 131 class Architecture(object):
 132     def __init__(self, *args, **kwargs):
 133         pass
 134
 135     def __eq__(self, val):
 136         if isinstance(val, str):
 137             return (self.arch_string== val)
 138         # This signals to use the normal comparison operator
 139         return NotImplemented
 140
 141     def __ne__(self, val):
 142         if isinstance(val, str):
 143             return (self.arch_string != val)
 144         # This signals to use the normal comparison operator
 145         return NotImplemented
 146
 147     def __repr__(self):
 148         return '<Architecture %s>' % self.arch_string
 149
 150 __all__.append('Architecture')
 151
 152 @session_wrapper
 153 def get_architecture(architecture, session=None):
 154     """
 155     Returns database id for given C{architecture}.
 156
 157     @type architecture: string
 158     @param architecture: The name of the architecture
 159
 160     @type session: Session
 161     @param session: Optional SQLA session object (a temporary one will be
 162     generated if not supplied)
 163
 164     @rtype: Architecture
 165     @return: Architecture object for the given arch (None if not present)
 166     """
 167
 168     q = session.query(Architecture).filter_by(arch_string=architecture)
 169
 170     try:
 171         return q.one()
 172     except NoResultFound:
 173         return None
 174
 175 __all__.append('get_architecture')
 176
 177 @session_wrapper
 178 def get_architecture_suites(architecture, session=None):
 179     """
 180     Returns list of Suite objects for given C{architecture} name
 181
 182     @type source: str
 183     @param source: Architecture name to search for
 184
 185     @type session: Session
 186     @param session: Optional SQL session object (a temporary one will be
 187     generated if not supplied)
 188
 189     @rtype: list
 190     @return: list of Suite objects for the given name (may be empty)
 191     """
 192
 193     q = session.query(Suite)
 194     q = q.join(SuiteArchitecture)
 195     q = q.join(Architecture).filter_by(arch_string=architecture).order_by('suite_name')
 196
 197     ret = q.all()
 198
 199     return ret
 200
 201 __all__.append('get_architecture_suites')
 202
 203 ################################################################################
 204
 205 class Archive(object):
 206     def __init__(self, *args, **kwargs):
 207         pass
 208
 209     def __repr__(self):
 210         return '<Archive %s>' % self.archive_name
 211
 212 __all__.append('Archive')
 213
 214 @session_wrapper
 215 def get_archive(archive, session=None):
 216     """
 217     returns database id for given C{archive}.
 218
 219     @type archive: string
 220     @param archive: the name of the arhive
 221
 222     @type session: Session
 223     @param session: Optional SQLA session object (a temporary one will be
 224     generated if not supplied)
 225
 226     @rtype: Archive
 227     @return: Archive object for the given name (None if not present)
 228
 229     """
 230     archive = archive.lower()
 231
 232     q = session.query(Archive).filter_by(archive_name=archive)
 233
 234     try:
 235         return q.one()
 236     except NoResultFound:
 237         return None
 238
 239 __all__.append('get_archive')
 240
 241 ################################################################################
 242
 243 class BinAssociation(object):
 244     def __init__(self, *args, **kwargs):
 245         pass
 246
 247     def __repr__(self):
 248         return '<BinAssociation %s (%s, %s)>' % (self.ba_id, self.binary, self.suite)
 249
 250 __all__.append('BinAssociation')
 251
 252 ################################################################################
 253
 254 class BinContents(object):
 255     def __init__(self, *args, **kwargs):
 256         pass
 257
 258     def __repr__(self):
 259         return '<BinContents (%s, %s)>' % (self.binary, self.filename)
 260
 261 __all__.append('BinContents')
 262
 263 ################################################################################
 264
 265 class DBBinary(object):
 266     def __init__(self, *args, **kwargs):
 267         pass
 268
 269     def __repr__(self):
 270         return '<DBBinary %s (%s, %s)>' % (self.package, self.version, self.architecture)
 271
 272 __all__.append('DBBinary')
 273
 274 @session_wrapper
 275 def get_suites_binary_in(package, session=None):
 276     """
 277     Returns list of Suite objects which given C{package} name is in
 278
 279     @type source: str
 280     @param source: DBBinary package name to search for
 281
 282     @rtype: list
 283     @return: list of Suite objects for the given package
 284     """
 285
 286     return session.query(Suite).join(BinAssociation).join(DBBinary).filter_by(package=package).all()
 287
 288 __all__.append('get_suites_binary_in')
 289
 290 @session_wrapper
 291 def get_binary_from_id(binary_id, session=None):
 292     """
 293     Returns DBBinary object for given C{id}
 294
 295     @type binary_id: int
 296     @param binary_id: Id of the required binary
 297
 298     @type session: Session
 299     @param session: Optional SQLA session object (a temporary one will be
 300     generated if not supplied)
 301
 302     @rtype: DBBinary
 303     @return: DBBinary object for the given binary (None if not present)
 304     """
 305
 306     q = session.query(DBBinary).filter_by(binary_id=binary_id)
 307
 308     try:
 309         return q.one()
 310     except NoResultFound:
 311         return None
 312
 313 __all__.append('get_binary_from_id')
 314
 315 @session_wrapper
 316 def get_binaries_from_name(package, version=None, architecture=None, session=None):
 317     """
 318     Returns list of DBBinary objects for given C{package} name
 319
 320     @type package: str
 321     @param package: DBBinary package name to search for
 322
 323     @type version: str or None
 324     @param version: Version to search for (or None)
 325
 326     @type package: str, list or None
 327     @param package: Architectures to limit to (or None if no limit)
 328
 329     @type session: Session
 330     @param session: Optional SQL session object (a temporary one will be
 331     generated if not supplied)
 332
 333     @rtype: list
 334     @return: list of DBBinary objects for the given name (may be empty)
 335     """
 336
 337     q = session.query(DBBinary).filter_by(package=package)
 338
 339     if version is not None:
 340         q = q.filter_by(version=version)
 341
 342     if architecture is not None:
 343         if not isinstance(architecture, list):
 344             architecture = [architecture]
 345         q = q.join(Architecture).filter(Architecture.arch_string.in_(architecture))
 346
 347     ret = q.all()
 348
 349     return ret
 350
 351 __all__.append('get_binaries_from_name')
 352
 353 @session_wrapper
 354 def get_binaries_from_source_id(source_id, session=None):
 355     """
 356     Returns list of DBBinary objects for given C{source_id}
 357
 358     @type source_id: int
 359     @param source_id: source_id to search for
 360
 361     @type session: Session
 362     @param session: Optional SQL session object (a temporary one will be
 363     generated if not supplied)
 364
 365     @rtype: list
 366     @return: list of DBBinary objects for the given name (may be empty)
 367     """
 368
 369     return session.query(DBBinary).filter_by(source_id=source_id).all()
 370
 371 __all__.append('get_binaries_from_source_id')
 372
 373 @session_wrapper
 374 def get_binary_from_name_suite(package, suitename, session=None):
 375     ### For dak examine-package
 376     ### XXX: Doesn't use object API yet
 377
 378     sql = """SELECT DISTINCT(b.package), b.version, c.name, su.suite_name
 379              FROM binaries b, files fi, location l, component c, bin_associations ba, suite su
 380              WHERE b.package='%(package)s'
 381                AND b.file = fi.id
 382                AND fi.location = l.id
 383                AND l.component = c.id
 384                AND ba.bin=b.id
 385                AND ba.suite = su.id
 386                AND su.suite_name %(suitename)s
 387           ORDER BY b.version DESC"""
 388
 389     return session.execute(sql % {'package': package, 'suitename': suitename})
 390
 391 __all__.append('get_binary_from_name_suite')
 392
 393 @session_wrapper
 394 def get_binary_components(package, suitename, arch, session=None):
 395     # Check for packages that have moved from one component to another
 396     query = """SELECT c.name FROM binaries b, bin_associations ba, suite s, location l, component c, architecture a, files f
 397     WHERE b.package=:package AND s.suite_name=:suitename
 398       AND (a.arch_string = :arch OR a.arch_string = 'all')
 399       AND ba.bin = b.id AND ba.suite = s.id AND b.architecture = a.id
 400       AND f.location = l.id
 401       AND l.component = c.id
 402       AND b.file = f.id"""
 403
 404     vals = {'package': package, 'suitename': suitename, 'arch': arch}
 405
 406     return session.execute(query, vals)
 407
 408 __all__.append('get_binary_components')
 409
 410 ################################################################################
 411
 412 class BinaryACL(object):
 413     def __init__(self, *args, **kwargs):
 414         pass
 415
 416     def __repr__(self):
 417         return '<BinaryACL %s>' % self.binary_acl_id
 418
 419 __all__.append('BinaryACL')
 420
 421 ################################################################################
 422
 423 class BinaryACLMap(object):
 424     def __init__(self, *args, **kwargs):
 425         pass
 426
 427     def __repr__(self):
 428         return '<BinaryACLMap %s>' % self.binary_acl_map_id
 429
 430 __all__.append('BinaryACLMap')
 431
 432 ################################################################################
 433
 434 MINIMAL_APT_CONF="""
 435 Dir
 436 {
 437    ArchiveDir "%(archivepath)s";
 438    OverrideDir "/srv/ftp.debian.org/scripts/override/";
 439    CacheDir "/srv/ftp.debian.org/database/";
 440 };
 441
 442 Default
 443 {
 444    Packages::Compress ". bzip2 gzip";
 445    Sources::Compress ". bzip2 gzip";
 446    DeLinkLimit 0;
 447    FileMode 0664;
 448 }
 449
 450 bindirectory "incoming"
 451 {
 452    Packages "Packages";
 453    Contents " ";
 454
 455    BinOverride "override.sid.all3";
 456    BinCacheDB "packages-accepted.db";
 457
 458    FileList "%(filelist)s";
 459
 460    PathPrefix "";
 461    Packages::Extensions ".deb .udeb";
 462 };
 463
 464 bindirectory "incoming/"
 465 {
 466    Sources "Sources";
 467    BinOverride "override.sid.all3";
 468    SrcOverride "override.sid.all3.src";
 469    FileList "%(filelist)s";
 470 };
 471 """
 472
 473 class BuildQueue(object):
 474     def __init__(self, *args, **kwargs):
 475         pass
 476
 477     def __repr__(self):
 478         return '<BuildQueue %s>' % self.queue_name
 479
 480     def write_metadata(self, starttime, force=False):
 481         # Do we write out metafiles?
 482         if not (force or self.generate_metadata):
 483             return
 484
 485         session = DBConn().session().object_session(self)
 486
 487         fl_fd = fl_name = ac_fd = ac_name = None
 488         tempdir = None
 489         arches = " ".join([ a.arch_string for a in session.query(Architecture).all() if a.arch_string != 'source' ])
 490         startdir = os.getcwd()
 491
 492         try:
 493             # Grab files we want to include
 494             newer = session.query(BuildQueueFile).filter_by(build_queue_id = self.queue_id).filter(BuildQueueFile.lastused + timedelta(seconds=self.stay_of_execution) > starttime).all()
 495             # Write file list with newer files
 496             (fl_fd, fl_name) = mkstemp()
 497             for n in newer:
 498                 os.write(fl_fd, '%s\n' % n.fullpath)
 499             os.close(fl_fd)
 500
 501             # Write minimal apt.conf
 502             # TODO: Remove hardcoding from template
 503             (ac_fd, ac_name) = mkstemp()
 504             os.write(ac_fd, MINIMAL_APT_CONF % {'archivepath': self.path,
 505                                                 'filelist': fl_name})
 506             os.close(ac_fd)
 507
 508             # Run apt-ftparchive generate
 509             os.chdir(os.path.dirname(ac_name))
 510             os.system('apt-ftparchive -qq -o APT::FTPArchive::Contents=off generate %s' % os.path.basename(ac_name))
 511
 512             # Run apt-ftparchive release
 513             # TODO: Eww - fix this
 514             bname = os.path.basename(self.path)
 515             os.chdir(self.path)
 516             os.chdir('..')
 517
 518             # We have to remove the Release file otherwise it'll be included in the
 519             # new one
 520             try:
 521                 os.unlink(os.path.join(bname, 'Release'))
 522             except OSError:
 523                 pass
 524
 525             os.system("""apt-ftparchive -qq -o APT::FTPArchive::Release::Origin="%s" -o APT::FTPArchive::Release::Label="%s" -o APT::FTPArchive::Release::Description="%s" -o APT::FTPArchive::Release::Architectures="%s" release %s > Release""" % (self.origin, self.label, self.releasedescription, arches, bname))
 526
 527             # Sign if necessary
 528             if self.signingkey:
 529                 cnf = Config()
 530                 keyring = "--secret-keyring \"%s\"" % cnf["Dinstall::SigningKeyring"]
 531                 if cnf.has_key("Dinstall::SigningPubKeyring"):
 532                     keyring += " --keyring \"%s\"" % cnf["Dinstall::SigningPubKeyring"]
 533
 534                 os.system("gpg %s --no-options --batch --no-tty --armour --default-key %s --detach-sign -o Release.gpg Release""" % (keyring, self.signingkey))
 535
 536             # Move the files if we got this far
 537             os.rename('Release', os.path.join(bname, 'Release'))
 538             if self.signingkey:
 539                 os.rename('Release.gpg', os.path.join(bname, 'Release.gpg'))
 540
 541         # Clean up any left behind files
 542         finally:
 543             os.chdir(startdir)
 544             if fl_fd:
 545                 try:
 546                     os.close(fl_fd)
 547                 except OSError:
 548                     pass
 549
 550             if fl_name:
 551                 try:
 552                     os.unlink(fl_name)
 553                 except OSError:
 554                     pass
 555
 556             if ac_fd:
 557                 try:
 558                     os.close(ac_fd)
 559                 except OSError:
 560                     pass
 561
 562             if ac_name:
 563                 try:
 564                     os.unlink(ac_name)
 565                 except OSError:
 566                     pass
 567
 568     def clean_and_update(self, starttime, Logger, dryrun=False):
 569         """WARNING: This routine commits for you"""
 570         session = DBConn().session().object_session(self)
 571
 572         if self.generate_metadata and not dryrun:
 573             self.write_metadata(starttime)
 574
 575         # Grab files older than our execution time
 576         older = session.query(BuildQueueFile).filter_by(build_queue_id = self.queue_id).filter(BuildQueueFile.lastused + timedelta(seconds=self.stay_of_execution) <= starttime).all()
 577
 578         for o in older:
 579             killdb = False
 580             try:
 581                 if dryrun:
 582                     Logger.log(["I: Would have removed %s from the queue" % o.fullpath])
 583                 else:
 584                     Logger.log(["I: Removing %s from the queue" % o.fullpath])
 585                     os.unlink(o.fullpath)
 586                     killdb = True
 587             except OSError, e:
 588                 # If it wasn't there, don't worry
 589                 if e.errno == ENOENT:
 590                     killdb = True
 591                 else:
 592                     # TODO: Replace with proper logging call
 593                     Logger.log(["E: Could not remove %s" % o.fullpath])
 594
 595             if killdb:
 596                 session.delete(o)
 597
 598         session.commit()
 599
 600         for f in os.listdir(self.path):
 601             if f.startswith('Packages') or f.startswith('Source') or f.startswith('Release'):
 602                 continue
 603
 604             try:
 605                 r = session.query(BuildQueueFile).filter_by(build_queue_id = self.queue_id).filter_by(filename = f).one()
 606             except NoResultFound:
 607                 fp = os.path.join(self.path, f)
 608                 if dryrun:
 609                     Logger.log(["I: Would remove unused link %s" % fp])
 610                 else:
 611                     Logger.log(["I: Removing unused link %s" % fp])
 612                     try:
 613                         os.unlink(fp)
 614                     except OSError:
 615                         Logger.log(["E: Failed to unlink unreferenced file %s" % r.fullpath])
 616
 617     def add_file_from_pool(self, poolfile):
 618         """Copies a file into the pool.  Assumes that the PoolFile object is
 619         attached to the same SQLAlchemy session as the Queue object is.
 620
 621         The caller is responsible for committing after calling this function."""
 622         poolfile_basename = poolfile.filename[poolfile.filename.rindex(os.sep)+1:]
 623
 624         # Check if we have a file of this name or this ID already
 625         for f in self.queuefiles:
 626             if f.fileid is not None and f.fileid == poolfile.file_id or \
 627                f.poolfile.filename == poolfile_basename:
 628                    # In this case, update the BuildQueueFile entry so we
 629                    # don't remove it too early
 630                    f.lastused = datetime.now()
 631                    DBConn().session().object_session(poolfile).add(f)
 632                    return f
 633
 634         # Prepare BuildQueueFile object
 635         qf = BuildQueueFile()
 636         qf.build_queue_id = self.queue_id
 637         qf.lastused = datetime.now()
 638         qf.filename = poolfile_basename
 639
 640         targetpath = poolfile.fullpath
 641         queuepath = os.path.join(self.path, poolfile_basename)
 642
 643         try:
 644             if self.copy_files:
 645                 # We need to copy instead of symlink
 646                 import utils
 647                 utils.copy(targetpath, queuepath)
 648                 # NULL in the fileid field implies a copy
 649                 qf.fileid = None
 650             else:
 651                 os.symlink(targetpath, queuepath)
 652                 qf.fileid = poolfile.file_id
 653         except OSError:
 654             return None
 655
 656         # Get the same session as the PoolFile is using and add the qf to it
 657         DBConn().session().object_session(poolfile).add(qf)
 658
 659         return qf
 660
 661
 662 __all__.append('BuildQueue')
 663
 664 @session_wrapper
 665 def get_build_queue(queuename, session=None):
 666     """
 667     Returns BuildQueue object for given C{queue name}, creating it if it does not
 668     exist.
 669
 670     @type queuename: string
 671     @param queuename: The name of the queue
 672
 673     @type session: Session
 674     @param session: Optional SQLA session object (a temporary one will be
 675     generated if not supplied)
 676
 677     @rtype: BuildQueue
 678     @return: BuildQueue object for the given queue
 679     """
 680
 681     q = session.query(BuildQueue).filter_by(queue_name=queuename)
 682
 683     try:
 684         return q.one()
 685     except NoResultFound:
 686         return None
 687
 688 __all__.append('get_build_queue')
 689
 690 ################################################################################
 691
 692 class BuildQueueFile(object):
 693     def __init__(self, *args, **kwargs):
 694         pass
 695
 696     def __repr__(self):
 697         return '<BuildQueueFile %s (%s)>' % (self.filename, self.build_queue_id)
 698
 699     @property
 700     def fullpath(self):
 701         return os.path.join(self.buildqueue.path, self.filename)
 702
 703
 704 __all__.append('BuildQueueFile')
 705
 706 ################################################################################
 707
 708 class ChangePendingBinary(object):
 709     def __init__(self, *args, **kwargs):
 710         pass
 711
 712     def __repr__(self):
 713         return '<ChangePendingBinary %s>' % self.change_pending_binary_id
 714
 715 __all__.append('ChangePendingBinary')
 716
 717 ################################################################################
 718
 719 class ChangePendingFile(object):
 720     def __init__(self, *args, **kwargs):
 721         pass
 722
 723     def __repr__(self):
 724         return '<ChangePendingFile %s>' % self.change_pending_file_id
 725
 726 __all__.append('ChangePendingFile')
 727
 728 ################################################################################
 729
 730 class ChangePendingSource(object):
 731     def __init__(self, *args, **kwargs):
 732         pass
 733
 734     def __repr__(self):
 735         return '<ChangePendingSource %s>' % self.change_pending_source_id
 736
 737 __all__.append('ChangePendingSource')
 738
 739 ################################################################################
 740
 741 class Component(object):
 742     def __init__(self, *args, **kwargs):
 743         pass
 744
 745     def __eq__(self, val):
 746         if isinstance(val, str):
 747             return (self.component_name == val)
 748         # This signals to use the normal comparison operator
 749         return NotImplemented
 750
 751     def __ne__(self, val):
 752         if isinstance(val, str):
 753             return (self.component_name != val)
 754         # This signals to use the normal comparison operator
 755         return NotImplemented
 756
 757     def __repr__(self):
 758         return '<Component %s>' % self.component_name
 759
 760
 761 __all__.append('Component')
 762
 763 @session_wrapper
 764 def get_component(component, session=None):
 765     """
 766     Returns database id for given C{component}.
 767
 768     @type component: string
 769     @param component: The name of the override type
 770
 771     @rtype: int
 772     @return: the database id for the given component
 773
 774     """
 775     component = component.lower()
 776
 777     q = session.query(Component).filter_by(component_name=component)
 778
 779     try:
 780         return q.one()
 781     except NoResultFound:
 782         return None
 783
 784 __all__.append('get_component')
 785
 786 ################################################################################
 787
 788 class DBConfig(object):
 789     def __init__(self, *args, **kwargs):
 790         pass
 791
 792     def __repr__(self):
 793         return '<DBConfig %s>' % self.name
 794
 795 __all__.append('DBConfig')
 796
 797 ################################################################################
 798
 799 @session_wrapper
 800 def get_or_set_contents_file_id(filename, session=None):
 801     """
 802     Returns database id for given filename.
 803
 804     If no matching file is found, a row is inserted.
 805
 806     @type filename: string
 807     @param filename: The filename
 808     @type session: SQLAlchemy
 809     @param session: Optional SQL session object (a temporary one will be
 810     generated if not supplied).  If not passed, a commit will be performed at
 811     the end of the function, otherwise the caller is responsible for commiting.
 812
 813     @rtype: int
 814     @return: the database id for the given component
 815     """
 816
 817     q = session.query(ContentFilename).filter_by(filename=filename)
 818
 819     try:
 820         ret = q.one().cafilename_id
 821     except NoResultFound:
 822         cf = ContentFilename()
 823         cf.filename = filename
 824         session.add(cf)
 825         session.commit_or_flush()
 826         ret = cf.cafilename_id
 827
 828     return ret
 829
 830 __all__.append('get_or_set_contents_file_id')
 831
 832 @session_wrapper
 833 def get_contents(suite, overridetype, section=None, session=None):
 834     """
 835     Returns contents for a suite / overridetype combination, limiting
 836     to a section if not None.
 837
 838     @type suite: Suite
 839     @param suite: Suite object
 840
 841     @type overridetype: OverrideType
 842     @param overridetype: OverrideType object
 843
 844     @type section: Section
 845     @param section: Optional section object to limit results to
 846
 847     @type session: SQLAlchemy
 848     @param session: Optional SQL session object (a temporary one will be
 849     generated if not supplied)
 850
 851     @rtype: ResultsProxy
 852     @return: ResultsProxy object set up to return tuples of (filename, section,
 853     package, arch_id)
 854     """
 855
 856     # find me all of the contents for a given suite
 857     contents_q = """SELECT (p.path||'/'||n.file) AS fn,
 858                             s.section,
 859                             b.package,
 860                             b.architecture
 861                    FROM content_associations c join content_file_paths p ON (c.filepath=p.id)
 862                    JOIN content_file_names n ON (c.filename=n.id)
 863                    JOIN binaries b ON (b.id=c.binary_pkg)
 864                    JOIN override o ON (o.package=b.package)
 865                    JOIN section s ON (s.id=o.section)
 866                    WHERE o.suite = :suiteid AND o.type = :overridetypeid
 867                    AND b.type=:overridetypename"""
 868
 869     vals = {'suiteid': suite.suite_id,
 870             'overridetypeid': overridetype.overridetype_id,
 871             'overridetypename': overridetype.overridetype}
 872
 873     if section is not None:
 874         contents_q += " AND s.id = :sectionid"
 875         vals['sectionid'] = section.section_id
 876
 877     contents_q += " ORDER BY fn"
 878
 879     return session.execute(contents_q, vals)
 880
 881 __all__.append('get_contents')
 882
 883 ################################################################################
 884
 885 class ContentFilepath(object):
 886     def __init__(self, *args, **kwargs):
 887         pass
 888
 889     def __repr__(self):
 890         return '<ContentFilepath %s>' % self.filepath
 891
 892 __all__.append('ContentFilepath')
 893
 894 @session_wrapper
 895 def get_or_set_contents_path_id(filepath, session=None):
 896     """
 897     Returns database id for given path.
 898
 899     If no matching file is found, a row is inserted.
 900
 901     @type filename: string
 902     @param filename: The filepath
 903     @type session: SQLAlchemy
 904     @param session: Optional SQL session object (a temporary one will be
 905     generated if not supplied).  If not passed, a commit will be performed at
 906     the end of the function, otherwise the caller is responsible for commiting.
 907
 908     @rtype: int
 909     @return: the database id for the given path
 910     """
 911
 912     q = session.query(ContentFilepath).filter_by(filepath=filepath)
 913
 914     try:
 915         ret = q.one().cafilepath_id
 916     except NoResultFound:
 917         cf = ContentFilepath()
 918         cf.filepath = filepath
 919         session.add(cf)
 920         session.commit_or_flush()
 921         ret = cf.cafilepath_id
 922
 923     return ret
 924
 925 __all__.append('get_or_set_contents_path_id')
 926
 927 ################################################################################
 928
 929 class ContentAssociation(object):
 930     def __init__(self, *args, **kwargs):
 931         pass
 932
 933     def __repr__(self):
 934         return '<ContentAssociation %s>' % self.ca_id
 935
 936 __all__.append('ContentAssociation')
 937
 938 def insert_content_paths(binary_id, fullpaths, session=None):
 939     """
 940     Make sure given path is associated with given binary id
 941
 942     @type binary_id: int
 943     @param binary_id: the id of the binary
 944     @type fullpaths: list
 945     @param fullpaths: the list of paths of the file being associated with the binary
 946     @type session: SQLAlchemy session
 947     @param session: Optional SQLAlchemy session.  If this is passed, the caller
 948     is responsible for ensuring a transaction has begun and committing the
 949     results or rolling back based on the result code.  If not passed, a commit
 950     will be performed at the end of the function, otherwise the caller is
 951     responsible for commiting.
 952
 953     @return: True upon success
 954     """
 955
 956     privatetrans = False
 957     if session is None:
 958         session = DBConn().session()
 959         privatetrans = True
 960
 961     try:
 962         # Insert paths
 963         pathcache = {}
 964         for fullpath in fullpaths:
 965             if fullpath.startswith( './' ):
 966                 fullpath = fullpath[2:]
 967
 968             session.execute( "INSERT INTO bin_contents ( file, binary_id ) VALUES ( :filename, :id )", { 'filename': fullpath, 'id': binary_id}  )
 969
 970         session.commit()
 971         if privatetrans:
 972             session.close()
 973         return True
 974
 975     except:
 976         traceback.print_exc()
 977
 978         # Only rollback if we set up the session ourself
 979         if privatetrans:
 980             session.rollback()
 981             session.close()
 982
 983         return False
 984
 985 __all__.append('insert_content_paths')
 986
 987 ################################################################################
 988
 989 class DSCFile(object):
 990     def __init__(self, *args, **kwargs):
 991         pass
 992
 993     def __repr__(self):
 994         return '<DSCFile %s>' % self.dscfile_id
 995
 996 __all__.append('DSCFile')
 997
 998 @session_wrapper
 999 def get_dscfiles(dscfile_id=None, source_id=None, poolfile_id=None, session=None):
1000     """
1001     Returns a list of DSCFiles which may be empty
1002
1003     @type dscfile_id: int (optional)
1004     @param dscfile_id: the dscfile_id of the DSCFiles to find
1005
1006     @type source_id: int (optional)
1007     @param source_id: the source id related to the DSCFiles to find
1008
1009     @type poolfile_id: int (optional)
1010     @param poolfile_id: the poolfile id related to the DSCFiles to find
1011
1012     @rtype: list
1013     @return: Possibly empty list of DSCFiles
1014     """
1015
1016     q = session.query(DSCFile)
1017
1018     if dscfile_id is not None:
1019         q = q.filter_by(dscfile_id=dscfile_id)
1020
1021     if source_id is not None:
1022         q = q.filter_by(source_id=source_id)
1023
1024     if poolfile_id is not None:
1025         q = q.filter_by(poolfile_id=poolfile_id)
1026
1027     return q.all()
1028
1029 __all__.append('get_dscfiles')
1030
1031 ################################################################################
1032
1033 class PoolFile(object):
1034     def __init__(self, *args, **kwargs):
1035         pass
1036
1037     def __repr__(self):
1038         return '<PoolFile %s>' % self.filename
1039
1040     @property
1041     def fullpath(self):
1042         return os.path.join(self.location.path, self.filename)
1043
1044 __all__.append('PoolFile')
1045
1046 @session_wrapper
1047 def check_poolfile(filename, filesize, md5sum, location_id, session=None):
1048     """
1049     Returns a tuple:
1050      (ValidFileFound [boolean or None], PoolFile object or None)
1051
1052     @type filename: string
1053     @param filename: the filename of the file to check against the DB
1054
1055     @type filesize: int
1056     @param filesize: the size of the file to check against the DB
1057
1058     @type md5sum: string
1059     @param md5sum: the md5sum of the file to check against the DB
1060
1061     @type location_id: int
1062     @param location_id: the id of the location to look in
1063
1064     @rtype: tuple
1065     @return: Tuple of length 2.
1066              If more than one file found with that name:
1067                     (None,  None)
1068              If valid pool file found: (True, PoolFile object)
1069              If valid pool file not found:
1070                     (False, None) if no file found
1071                     (False, PoolFile object) if file found with size/md5sum mismatch
1072     """
1073
1074     q = session.query(PoolFile).filter_by(filename=filename)
1075     q = q.join(Location).filter_by(location_id=location_id)
1076
1077     ret = None
1078
1079     if q.count() > 1:
1080         ret = (None, None)
1081     elif q.count() < 1:
1082         ret = (False, None)
1083     else:
1084         obj = q.one()
1085         if obj.md5sum != md5sum or obj.filesize != int(filesize):
1086             ret = (False, obj)
1087
1088     if ret is None:
1089         ret = (True, obj)
1090
1091     return ret
1092
1093 __all__.append('check_poolfile')
1094
1095 @session_wrapper
1096 def get_poolfile_by_id(file_id, session=None):
1097     """
1098     Returns a PoolFile objects or None for the given id
1099
1100     @type file_id: int
1101     @param file_id: the id of the file to look for
1102
1103     @rtype: PoolFile or None
1104     @return: either the PoolFile object or None
1105     """
1106
1107     q = session.query(PoolFile).filter_by(file_id=file_id)
1108
1109     try:
1110         return q.one()
1111     except NoResultFound:
1112         return None
1113
1114 __all__.append('get_poolfile_by_id')
1115
1116
1117 @session_wrapper
1118 def get_poolfile_by_name(filename, location_id=None, session=None):
1119     """
1120     Returns an array of PoolFile objects for the given filename and
1121     (optionally) location_id
1122
1123     @type filename: string
1124     @param filename: the filename of the file to check against the DB
1125
1126     @type location_id: int
1127     @param location_id: the id of the location to look in (optional)
1128
1129     @rtype: array
1130     @return: array of PoolFile objects
1131     """
1132
1133     q = session.query(PoolFile).filter_by(filename=filename)
1134
1135     if location_id is not None:
1136         q = q.join(Location).filter_by(location_id=location_id)
1137
1138     return q.all()
1139
1140 __all__.append('get_poolfile_by_name')
1141
1142 @session_wrapper
1143 def get_poolfile_like_name(filename, session=None):
1144     """
1145     Returns an array of PoolFile objects which are like the given name
1146
1147     @type filename: string
1148     @param filename: the filename of the file to check against the DB
1149
1150     @rtype: array
1151     @return: array of PoolFile objects
1152     """
1153
1154     # TODO: There must be a way of properly using bind parameters with %FOO%
1155     q = session.query(PoolFile).filter(PoolFile.filename.like('%%/%s' % filename))
1156
1157     return q.all()
1158
1159 __all__.append('get_poolfile_like_name')
1160
1161 @session_wrapper
1162 def add_poolfile(filename, datadict, location_id, session=None):
1163     """
1164     Add a new file to the pool
1165
1166     @type filename: string
1167     @param filename: filename
1168
1169     @type datadict: dict
1170     @param datadict: dict with needed data
1171
1172     @type location_id: int
1173     @param location_id: database id of the location
1174
1175     @rtype: PoolFile
1176     @return: the PoolFile object created
1177     """
1178     poolfile = PoolFile()
1179     poolfile.filename = filename
1180     poolfile.filesize = datadict["size"]
1181     poolfile.md5sum = datadict["md5sum"]
1182     poolfile.sha1sum = datadict["sha1sum"]
1183     poolfile.sha256sum = datadict["sha256sum"]
1184     poolfile.location_id = location_id
1185
1186     session.add(poolfile)
1187     # Flush to get a file id (NB: This is not a commit)
1188     session.flush()
1189
1190     return poolfile
1191
1192 __all__.append('add_poolfile')
1193
1194 ################################################################################
1195
1196 class Fingerprint(object):
1197     def __init__(self, *args, **kwargs):
1198         pass
1199
1200     def __repr__(self):
1201         return '<Fingerprint %s>' % self.fingerprint
1202
1203 __all__.append('Fingerprint')
1204
1205 @session_wrapper
1206 def get_fingerprint(fpr, session=None):
1207     """
1208     Returns Fingerprint object for given fpr.
1209
1210     @type fpr: string
1211     @param fpr: The fpr to find / add
1212
1213     @type session: SQLAlchemy
1214     @param session: Optional SQL session object (a temporary one will be
1215     generated if not supplied).
1216
1217     @rtype: Fingerprint
1218     @return: the Fingerprint object for the given fpr or None
1219     """
1220
1221     q = session.query(Fingerprint).filter_by(fingerprint=fpr)
1222
1223     try:
1224         ret = q.one()
1225     except NoResultFound:
1226         ret = None
1227
1228     return ret
1229
1230 __all__.append('get_fingerprint')
1231
1232 @session_wrapper
1233 def get_or_set_fingerprint(fpr, session=None):
1234     """
1235     Returns Fingerprint object for given fpr.
1236
1237     If no matching fpr is found, a row is inserted.
1238
1239     @type fpr: string
1240     @param fpr: The fpr to find / add
1241
1242     @type session: SQLAlchemy
1243     @param session: Optional SQL session object (a temporary one will be
1244     generated if not supplied).  If not passed, a commit will be performed at
1245     the end of the function, otherwise the caller is responsible for commiting.
1246     A flush will be performed either way.
1247
1248     @rtype: Fingerprint
1249     @return: the Fingerprint object for the given fpr
1250     """
1251
1252     q = session.query(Fingerprint).filter_by(fingerprint=fpr)
1253
1254     try:
1255         ret = q.one()
1256     except NoResultFound:
1257         fingerprint = Fingerprint()
1258         fingerprint.fingerprint = fpr
1259         session.add(fingerprint)
1260         session.commit_or_flush()
1261         ret = fingerprint
1262
1263     return ret
1264
1265 __all__.append('get_or_set_fingerprint')
1266
1267 ################################################################################
1268
1269 # Helper routine for Keyring class
1270 def get_ldap_name(entry):
1271     name = []
1272     for k in ["cn", "mn", "sn"]:
1273         ret = entry.get(k)
1274         if ret and ret[0] != "" and ret[0] != "-":
1275             name.append(ret[0])
1276     return " ".join(name)
1277
1278 ################################################################################
1279
1280 class Keyring(object):
1281     gpg_invocation = "gpg --no-default-keyring --keyring %s" +\
1282                      " --with-colons --fingerprint --fingerprint"
1283
1284     keys = {}
1285     fpr_lookup = {}
1286
1287     def __init__(self, *args, **kwargs):
1288         pass
1289
1290     def __repr__(self):
1291         return '<Keyring %s>' % self.keyring_name
1292
1293     def de_escape_gpg_str(self, txt):
1294         esclist = re.split(r'(\\x..)', txt)
1295         for x in range(1,len(esclist),2):
1296             esclist[x] = "%c" % (int(esclist[x][2:],16))
1297         return "".join(esclist)
1298
1299     def load_keys(self, keyring):
1300         import email.Utils
1301
1302         if not self.keyring_id:
1303             raise Exception('Must be initialized with database information')
1304
1305         k = os.popen(self.gpg_invocation % keyring, "r")
1306         key = None
1307         signingkey = False
1308
1309         for line in k.xreadlines():
1310             field = line.split(":")
1311             if field[0] == "pub":
1312                 key = field[4]
1313                 (name, addr) = email.Utils.parseaddr(field[9])
1314                 name = re.sub(r"\s*[(].*[)]", "", name)
1315                 if name == "" or addr == "" or "@" not in addr:
1316                     name = field[9]
1317                     addr = "invalid-uid"
1318                 name = self.de_escape_gpg_str(name)
1319                 self.keys[key] = {"email": addr}
1320                 if name != "":
1321                     self.keys[key]["name"] = name
1322                 self.keys[key]["aliases"] = [name]
1323                 self.keys[key]["fingerprints"] = []
1324                 signingkey = True
1325             elif key and field[0] == "sub" and len(field) >= 12:
1326                 signingkey = ("s" in field[11])
1327             elif key and field[0] == "uid":
1328                 (name, addr) = email.Utils.parseaddr(field[9])
1329                 if name and name not in self.keys[key]["aliases"]:
1330                     self.keys[key]["aliases"].append(name)
1331             elif signingkey and field[0] == "fpr":
1332                 self.keys[key]["fingerprints"].append(field[9])
1333                 self.fpr_lookup[field[9]] = key
1334
1335     def import_users_from_ldap(self, session):
1336         import ldap
1337         cnf = Config()
1338
1339         LDAPDn = cnf["Import-LDAP-Fingerprints::LDAPDn"]
1340         LDAPServer = cnf["Import-LDAP-Fingerprints::LDAPServer"]
1341
1342         l = ldap.open(LDAPServer)
1343         l.simple_bind_s("","")
1344         Attrs = l.search_s(LDAPDn, ldap.SCOPE_ONELEVEL,
1345                "(&(keyfingerprint=*)(gidnumber=%s))" % (cnf["Import-Users-From-Passwd::ValidGID"]),
1346                ["uid", "keyfingerprint", "cn", "mn", "sn"])
1347
1348         ldap_fin_uid_id = {}
1349
1350         byuid = {}
1351         byname = {}
1352
1353         for i in Attrs:
1354             entry = i[1]
1355             uid = entry["uid"][0]
1356             name = get_ldap_name(entry)
1357             fingerprints = entry["keyFingerPrint"]
1358             keyid = None
1359             for f in fingerprints:
1360                 key = self.fpr_lookup.get(f, None)
1361                 if key not in self.keys:
1362                     continue
1363                 self.keys[key]["uid"] = uid
1364
1365                 if keyid != None:
1366                     continue
1367                 keyid = get_or_set_uid(uid, session).uid_id
1368                 byuid[keyid] = (uid, name)
1369                 byname[uid] = (keyid, name)
1370
1371         return (byname, byuid)
1372
1373     def generate_users_from_keyring(self, format, session):
1374         byuid = {}
1375         byname = {}
1376         any_invalid = False
1377         for x in self.keys.keys():
1378             if self.keys[x]["email"] == "invalid-uid":
1379                 any_invalid = True
1380                 self.keys[x]["uid"] = format % "invalid-uid"
1381             else:
1382                 uid = format % self.keys[x]["email"]
1383                 keyid = get_or_set_uid(uid, session).uid_id
1384                 byuid[keyid] = (uid, self.keys[x]["name"])
1385                 byname[uid] = (keyid, self.keys[x]["name"])
1386                 self.keys[x]["uid"] = uid
1387
1388         if any_invalid:
1389             uid = format % "invalid-uid"
1390             keyid = get_or_set_uid(uid, session).uid_id
1391             byuid[keyid] = (uid, "ungeneratable user id")
1392             byname[uid] = (keyid, "ungeneratable user id")
1393
1394         return (byname, byuid)
1395
1396 __all__.append('Keyring')
1397
1398 @session_wrapper
1399 def get_keyring(keyring, session=None):
1400     """
1401     If C{keyring} does not have an entry in the C{keyrings} table yet, return None
1402     If C{keyring} already has an entry, simply return the existing Keyring
1403
1404     @type keyring: string
1405     @param keyring: the keyring name
1406
1407     @rtype: Keyring
1408     @return: the Keyring object for this keyring
1409     """
1410
1411     q = session.query(Keyring).filter_by(keyring_name=keyring)
1412
1413     try:
1414         return q.one()
1415     except NoResultFound:
1416         return None
1417
1418 __all__.append('get_keyring')
1419
1420 ################################################################################
1421
1422 class KeyringACLMap(object):
1423     def __init__(self, *args, **kwargs):
1424         pass
1425
1426     def __repr__(self):
1427         return '<KeyringACLMap %s>' % self.keyring_acl_map_id
1428
1429 __all__.append('KeyringACLMap')
1430
1431 ################################################################################
1432
1433 class DBChange(object):
1434     def __init__(self, *args, **kwargs):
1435         pass
1436
1437     def __repr__(self):
1438         return '<DBChange %s>' % self.changesname
1439
1440     def clean_from_queue(self):
1441         session = DBConn().session().object_session(self)
1442
1443         # Remove changes_pool_files entries
1444         self.poolfiles = []
1445
1446         # Remove changes_pending_files references
1447         self.files = []
1448
1449         # Clear out of queue
1450         self.in_queue = None
1451         self.approved_for_id = None
1452
1453 __all__.append('DBChange')
1454
1455 @session_wrapper
1456 def get_dbchange(filename, session=None):
1457     """
1458     returns DBChange object for given C{filename}.
1459
1460     @type archive: string
1461     @param archive: the name of the arhive
1462
1463     @type session: Session
1464     @param session: Optional SQLA session object (a temporary one will be
1465     generated if not supplied)
1466
1467     @rtype: Archive
1468     @return: Archive object for the given name (None if not present)
1469
1470     """
1471     q = session.query(DBChange).filter_by(changesname=filename)
1472
1473     try:
1474         return q.one()
1475     except NoResultFound:
1476         return None
1477
1478 __all__.append('get_dbchange')
1479
1480 ################################################################################
1481
1482 class Location(object):
1483     def __init__(self, *args, **kwargs):
1484         pass
1485
1486     def __repr__(self):
1487         return '<Location %s (%s)>' % (self.path, self.location_id)
1488
1489 __all__.append('Location')
1490
1491 @session_wrapper
1492 def get_location(location, component=None, archive=None, session=None):
1493     """
1494     Returns Location object for the given combination of location, component
1495     and archive
1496
1497     @type location: string
1498     @param location: the path of the location, e.g. I{/srv/ftp.debian.org/ftp/pool/}
1499
1500     @type component: string
1501     @param component: the component name (if None, no restriction applied)
1502
1503     @type archive: string
1504     @param archive_id: the archive name (if None, no restriction applied)
1505
1506     @rtype: Location / None
1507     @return: Either a Location object or None if one can't be found
1508     """
1509
1510     q = session.query(Location).filter_by(path=location)
1511
1512     if archive is not None:
1513         q = q.join(Archive).filter_by(archive_name=archive)
1514
1515     if component is not None:
1516         q = q.join(Component).filter_by(component_name=component)
1517
1518     try:
1519         return q.one()
1520     except NoResultFound:
1521         return None
1522
1523 __all__.append('get_location')
1524
1525 ################################################################################
1526
1527 class Maintainer(object):
1528     def __init__(self, *args, **kwargs):
1529         pass
1530
1531     def __repr__(self):
1532         return '''<Maintainer '%s' (%s)>''' % (self.name, self.maintainer_id)
1533
1534     def get_split_maintainer(self):
1535         if not hasattr(self, 'name') or self.name is None:
1536             return ('', '', '', '')
1537
1538         return fix_maintainer(self.name.strip())
1539
1540 __all__.append('Maintainer')
1541
1542 @session_wrapper
1543 def get_or_set_maintainer(name, session=None):
1544     """
1545     Returns Maintainer object for given maintainer name.
1546
1547     If no matching maintainer name is found, a row is inserted.
1548
1549     @type name: string
1550     @param name: The maintainer name to add
1551
1552     @type session: SQLAlchemy
1553     @param session: Optional SQL session object (a temporary one will be
1554     generated if not supplied).  If not passed, a commit will be performed at
1555     the end of the function, otherwise the caller is responsible for commiting.
1556     A flush will be performed either way.
1557
1558     @rtype: Maintainer
1559     @return: the Maintainer object for the given maintainer
1560     """
1561
1562     q = session.query(Maintainer).filter_by(name=name)
1563     try:
1564         ret = q.one()
1565     except NoResultFound:
1566         maintainer = Maintainer()
1567         maintainer.name = name
1568         session.add(maintainer)
1569         session.commit_or_flush()
1570         ret = maintainer
1571
1572     return ret
1573
1574 __all__.append('get_or_set_maintainer')
1575
1576 @session_wrapper
1577 def get_maintainer(maintainer_id, session=None):
1578     """
1579     Return the name of the maintainer behind C{maintainer_id} or None if that
1580     maintainer_id is invalid.
1581
1582     @type maintainer_id: int
1583     @param maintainer_id: the id of the maintainer
1584
1585     @rtype: Maintainer
1586     @return: the Maintainer with this C{maintainer_id}
1587     """
1588
1589     return session.query(Maintainer).get(maintainer_id)
1590
1591 __all__.append('get_maintainer')
1592
1593 ################################################################################
1594
1595 class NewComment(object):
1596     def __init__(self, *args, **kwargs):
1597         pass
1598
1599     def __repr__(self):
1600         return '''<NewComment for '%s %s' (%s)>''' % (self.package, self.version, self.comment_id)
1601
1602 __all__.append('NewComment')
1603
1604 @session_wrapper
1605 def has_new_comment(package, version, session=None):
1606     """
1607     Returns true if the given combination of C{package}, C{version} has a comment.
1608
1609     @type package: string
1610     @param package: name of the package
1611
1612     @type version: string
1613     @param version: package version
1614
1615     @type session: Session
1616     @param session: Optional SQLA session object (a temporary one will be
1617     generated if not supplied)
1618
1619     @rtype: boolean
1620     @return: true/false
1621     """
1622
1623     q = session.query(NewComment)
1624     q = q.filter_by(package=package)
1625     q = q.filter_by(version=version)
1626
1627     return bool(q.count() > 0)
1628
1629 __all__.append('has_new_comment')
1630
1631 @session_wrapper
1632 def get_new_comments(package=None, version=None, comment_id=None, session=None):
1633     """
1634     Returns (possibly empty) list of NewComment objects for the given
1635     parameters
1636
1637     @type package: string (optional)
1638     @param package: name of the package
1639
1640     @type version: string (optional)
1641     @param version: package version
1642
1643     @type comment_id: int (optional)
1644     @param comment_id: An id of a comment
1645
1646     @type session: Session
1647     @param session: Optional SQLA session object (a temporary one will be
1648     generated if not supplied)
1649
1650     @rtype: list
1651     @return: A (possibly empty) list of NewComment objects will be returned
1652     """
1653
1654     q = session.query(NewComment)
1655     if package is not None: q = q.filter_by(package=package)
1656     if version is not None: q = q.filter_by(version=version)
1657     if comment_id is not None: q = q.filter_by(comment_id=comment_id)
1658
1659     return q.all()
1660
1661 __all__.append('get_new_comments')
1662
1663 ################################################################################
1664
1665 class Override(object):
1666     def __init__(self, *args, **kwargs):
1667         pass
1668
1669     def __repr__(self):
1670         return '<Override %s (%s)>' % (self.package, self.suite_id)
1671
1672 __all__.append('Override')
1673
1674 @session_wrapper
1675 def get_override(package, suite=None, component=None, overridetype=None, session=None):
1676     """
1677     Returns Override object for the given parameters
1678
1679     @type package: string
1680     @param package: The name of the package
1681
1682     @type suite: string, list or None
1683     @param suite: The name of the suite (or suites if a list) to limit to.  If
1684                   None, don't limit.  Defaults to None.
1685
1686     @type component: string, list or None
1687     @param component: The name of the component (or components if a list) to
1688                       limit to.  If None, don't limit.  Defaults to None.
1689
1690     @type overridetype: string, list or None
1691     @param overridetype: The name of the overridetype (or overridetypes if a list) to
1692                          limit to.  If None, don't limit.  Defaults to None.
1693
1694     @type session: Session
1695     @param session: Optional SQLA session object (a temporary one will be
1696     generated if not supplied)
1697
1698     @rtype: list
1699     @return: A (possibly empty) list of Override objects will be returned
1700     """
1701
1702     q = session.query(Override)
1703     q = q.filter_by(package=package)
1704
1705     if suite is not None:
1706         if not isinstance(suite, list): suite = [suite]
1707         q = q.join(Suite).filter(Suite.suite_name.in_(suite))
1708
1709     if component is not None:
1710         if not isinstance(component, list): component = [component]
1711         q = q.join(Component).filter(Component.component_name.in_(component))
1712
1713     if overridetype is not None:
1714         if not isinstance(overridetype, list): overridetype = [overridetype]
1715         q = q.join(OverrideType).filter(OverrideType.overridetype.in_(overridetype))
1716
1717     return q.all()
1718
1719 __all__.append('get_override')
1720
1721
1722 ################################################################################
1723
1724 class OverrideType(object):
1725     def __init__(self, *args, **kwargs):
1726         pass
1727
1728     def __repr__(self):
1729         return '<OverrideType %s>' % self.overridetype
1730
1731 __all__.append('OverrideType')
1732
1733 @session_wrapper
1734 def get_override_type(override_type, session=None):
1735     """
1736     Returns OverrideType object for given C{override type}.
1737
1738     @type override_type: string
1739     @param override_type: The name of the override type
1740
1741     @type session: Session
1742     @param session: Optional SQLA session object (a temporary one will be
1743     generated if not supplied)
1744
1745     @rtype: int
1746     @return: the database id for the given override type
1747     """
1748
1749     q = session.query(OverrideType).filter_by(overridetype=override_type)
1750
1751     try:
1752         return q.one()
1753     except NoResultFound:
1754         return None
1755
1756 __all__.append('get_override_type')
1757
1758 ################################################################################
1759
1760 class PendingContentAssociation(object):
1761     def __init__(self, *args, **kwargs):
1762         pass
1763
1764     def __repr__(self):
1765         return '<PendingContentAssociation %s>' % self.pca_id
1766
1767 __all__.append('PendingContentAssociation')
1768
1769 def insert_pending_content_paths(package, fullpaths, session=None):
1770     """
1771     Make sure given paths are temporarily associated with given
1772     package
1773
1774     @type package: dict
1775     @param package: the package to associate with should have been read in from the binary control file
1776     @type fullpaths: list
1777     @param fullpaths: the list of paths of the file being associated with the binary
1778     @type session: SQLAlchemy session
1779     @param session: Optional SQLAlchemy session.  If this is passed, the caller
1780     is responsible for ensuring a transaction has begun and committing the
1781     results or rolling back based on the result code.  If not passed, a commit
1782     will be performed at the end of the function
1783
1784     @return: True upon success, False if there is a problem
1785     """
1786
1787     privatetrans = False
1788
1789     if session is None:
1790         session = DBConn().session()
1791         privatetrans = True
1792
1793     try:
1794         arch = get_architecture(package['Architecture'], session)
1795         arch_id = arch.arch_id
1796
1797         # Remove any already existing recorded files for this package
1798         q = session.query(PendingContentAssociation)
1799         q = q.filter_by(package=package['Package'])
1800         q = q.filter_by(version=package['Version'])
1801         q = q.filter_by(architecture=arch_id)
1802         q.delete()
1803
1804         # Insert paths
1805         pathcache = {}
1806         for fullpath in fullpaths:
1807             (path, filename) = os.path.split(fullpath)
1808
1809             if path.startswith( "./" ):
1810                 path = path[2:]
1811
1812             filepath_id = get_or_set_contents_path_id(path, session)
1813             filename_id = get_or_set_contents_file_id(filename, session)
1814
1815             pathcache[fullpath] = (filepath_id, filename_id)
1816
1817         for fullpath, dat in pathcache.items():
1818             pca = PendingContentAssociation()
1819             pca.package = package['Package']
1820             pca.version = package['Version']
1821             pca.filepath_id = dat[0]
1822             pca.filename_id = dat[1]
1823             pca.architecture = arch_id
1824             session.add(pca)
1825
1826         # Only commit if we set up the session ourself
1827         if privatetrans:
1828             session.commit()
1829             session.close()
1830         else:
1831             session.flush()
1832
1833         return True
1834     except Exception, e:
1835         traceback.print_exc()
1836
1837         # Only rollback if we set up the session ourself
1838         if privatetrans:
1839             session.rollback()
1840             session.close()
1841
1842         return False
1843
1844 __all__.append('insert_pending_content_paths')
1845
1846 ################################################################################
1847
1848 class PolicyQueue(object):
1849     def __init__(self, *args, **kwargs):
1850         pass
1851
1852     def __repr__(self):
1853         return '<PolicyQueue %s>' % self.queue_name
1854
1855 __all__.append('PolicyQueue')
1856
1857 @session_wrapper
1858 def get_policy_queue(queuename, session=None):
1859     """
1860     Returns PolicyQueue object for given C{queue name}
1861
1862     @type queuename: string
1863     @param queuename: The name of the queue
1864
1865     @type session: Session
1866     @param session: Optional SQLA session object (a temporary one will be
1867     generated if not supplied)
1868
1869     @rtype: PolicyQueue
1870     @return: PolicyQueue object for the given queue
1871     """
1872
1873     q = session.query(PolicyQueue).filter_by(queue_name=queuename)
1874
1875     try:
1876         return q.one()
1877     except NoResultFound:
1878         return None
1879
1880 __all__.append('get_policy_queue')
1881
1882 ################################################################################
1883
1884 class Priority(object):
1885     def __init__(self, *args, **kwargs):
1886         pass
1887
1888     def __eq__(self, val):
1889         if isinstance(val, str):
1890             return (self.priority == val)
1891         # This signals to use the normal comparison operator
1892         return NotImplemented
1893
1894     def __ne__(self, val):
1895         if isinstance(val, str):
1896             return (self.priority != val)
1897         # This signals to use the normal comparison operator
1898         return NotImplemented
1899
1900     def __repr__(self):
1901         return '<Priority %s (%s)>' % (self.priority, self.priority_id)
1902
1903 __all__.append('Priority')
1904
1905 @session_wrapper
1906 def get_priority(priority, session=None):
1907     """
1908     Returns Priority object for given C{priority name}.
1909
1910     @type priority: string
1911     @param priority: The name of the priority
1912
1913     @type session: Session
1914     @param session: Optional SQLA session object (a temporary one will be
1915     generated if not supplied)
1916
1917     @rtype: Priority
1918     @return: Priority object for the given priority
1919     """
1920
1921     q = session.query(Priority).filter_by(priority=priority)
1922
1923     try:
1924         return q.one()
1925     except NoResultFound:
1926         return None
1927
1928 __all__.append('get_priority')
1929
1930 @session_wrapper
1931 def get_priorities(session=None):
1932     """
1933     Returns dictionary of priority names -> id mappings
1934
1935     @type session: Session
1936     @param session: Optional SQL session object (a temporary one will be
1937     generated if not supplied)
1938
1939     @rtype: dictionary
1940     @return: dictionary of priority names -> id mappings
1941     """
1942
1943     ret = {}
1944     q = session.query(Priority)
1945     for x in q.all():
1946         ret[x.priority] = x.priority_id
1947
1948     return ret
1949
1950 __all__.append('get_priorities')
1951
1952 ################################################################################
1953
1954 class Section(object):
1955     def __init__(self, *args, **kwargs):
1956         pass
1957
1958     def __eq__(self, val):
1959         if isinstance(val, str):
1960             return (self.section == val)
1961         # This signals to use the normal comparison operator
1962         return NotImplemented
1963
1964     def __ne__(self, val):
1965         if isinstance(val, str):
1966             return (self.section != val)
1967         # This signals to use the normal comparison operator
1968         return NotImplemented
1969
1970     def __repr__(self):
1971         return '<Section %s>' % self.section
1972
1973 __all__.append('Section')
1974
1975 @session_wrapper
1976 def get_section(section, session=None):
1977     """
1978     Returns Section object for given C{section name}.
1979
1980     @type section: string
1981     @param section: The name of the section
1982
1983     @type session: Session
1984     @param session: Optional SQLA session object (a temporary one will be
1985     generated if not supplied)
1986
1987     @rtype: Section
1988     @return: Section object for the given section name
1989     """
1990
1991     q = session.query(Section).filter_by(section=section)
1992
1993     try:
1994         return q.one()
1995     except NoResultFound:
1996         return None
1997
1998 __all__.append('get_section')
1999
2000 @session_wrapper
2001 def get_sections(session=None):
2002     """
2003     Returns dictionary of section names -> id mappings
2004
2005     @type session: Session
2006     @param session: Optional SQL session object (a temporary one will be
2007     generated if not supplied)
2008
2009     @rtype: dictionary
2010     @return: dictionary of section names -> id mappings
2011     """
2012
2013     ret = {}
2014     q = session.query(Section)
2015     for x in q.all():
2016         ret[x.section] = x.section_id
2017
2018     return ret
2019
2020 __all__.append('get_sections')
2021
2022 ################################################################################
2023
2024 class DBSource(object):
2025     def __init__(self, *args, **kwargs):
2026         pass
2027
2028     def __repr__(self):
2029         return '<DBSource %s (%s)>' % (self.source, self.version)
2030
2031 __all__.append('DBSource')
2032
2033 @session_wrapper
2034 def source_exists(source, source_version, suites = ["any"], session=None):
2035     """
2036     Ensure that source exists somewhere in the archive for the binary
2037     upload being processed.
2038       1. exact match     => 1.0-3
2039       2. bin-only NMU    => 1.0-3+b1 , 1.0-3.1+b1
2040
2041     @type package: string
2042     @param package: package source name
2043
2044     @type source_version: string
2045     @param source_version: expected source version
2046
2047     @type suites: list
2048     @param suites: list of suites to check in, default I{any}
2049
2050     @type session: Session
2051     @param session: Optional SQLA session object (a temporary one will be
2052     generated if not supplied)
2053
2054     @rtype: int
2055     @return: returns 1 if a source with expected version is found, otherwise 0
2056
2057     """
2058
2059     cnf = Config()
2060     ret = 1
2061
2062     for suite in suites:
2063         q = session.query(DBSource).filter_by(source=source)
2064         if suite != "any":
2065             # source must exist in suite X, or in some other suite that's
2066             # mapped to X, recursively... silent-maps are counted too,
2067             # unreleased-maps aren't.
2068             maps = cnf.ValueList("SuiteMappings")[:]
2069             maps.reverse()
2070             maps = [ m.split() for m in maps ]
2071             maps = [ (x[1], x[2]) for x in maps
2072                             if x[0] == "map" or x[0] == "silent-map" ]
2073             s = [suite]
2074             for x in maps:
2075                 if x[1] in s and x[0] not in s:
2076                     s.append(x[0])
2077
2078             q = q.join(SrcAssociation).join(Suite)
2079             q = q.filter(Suite.suite_name.in_(s))
2080
2081         # Reduce the query results to a list of version numbers
2082         ql = [ j.version for j in q.all() ]
2083
2084         # Try (1)
2085         if source_version in ql:
2086             continue
2087
2088         # Try (2)
2089         from daklib.regexes import re_bin_only_nmu
2090         orig_source_version = re_bin_only_nmu.sub('', source_version)
2091         if orig_source_version in ql:
2092             continue
2093
2094         # No source found so return not ok
2095         ret = 0
2096
2097     return ret
2098
2099 __all__.append('source_exists')
2100
2101 @session_wrapper
2102 def get_suites_source_in(source, session=None):
2103     """
2104     Returns list of Suite objects which given C{source} name is in
2105
2106     @type source: str
2107     @param source: DBSource package name to search for
2108
2109     @rtype: list
2110     @return: list of Suite objects for the given source
2111     """
2112
2113     return session.query(Suite).join(SrcAssociation).join(DBSource).filter_by(source=source).all()
2114
2115 __all__.append('get_suites_source_in')
2116
2117 @session_wrapper
2118 def get_sources_from_name(source, version=None, dm_upload_allowed=None, session=None):
2119     """
2120     Returns list of DBSource objects for given C{source} name and other parameters
2121
2122     @type source: str
2123     @param source: DBSource package name to search for
2124
2125     @type source: str or None
2126     @param source: DBSource version name to search for or None if not applicable
2127
2128     @type dm_upload_allowed: bool
2129     @param dm_upload_allowed: If None, no effect.  If True or False, only
2130     return packages with that dm_upload_allowed setting
2131
2132     @type session: Session
2133     @param session: Optional SQL session object (a temporary one will be
2134     generated if not supplied)
2135
2136     @rtype: list
2137     @return: list of DBSource objects for the given name (may be empty)
2138     """
2139
2140     q = session.query(DBSource).filter_by(source=source)
2141
2142     if version is not None:
2143         q = q.filter_by(version=version)
2144
2145     if dm_upload_allowed is not None:
2146         q = q.filter_by(dm_upload_allowed=dm_upload_allowed)
2147
2148     return q.all()
2149
2150 __all__.append('get_sources_from_name')
2151
2152 @session_wrapper
2153 def get_source_in_suite(source, suite, session=None):
2154     """
2155     Returns list of DBSource objects for a combination of C{source} and C{suite}.
2156
2157       - B{source} - source package name, eg. I{mailfilter}, I{bbdb}, I{glibc}
2158       - B{suite} - a suite name, eg. I{unstable}
2159
2160     @type source: string
2161     @param source: source package name
2162
2163     @type suite: string
2164     @param suite: the suite name
2165
2166     @rtype: string
2167     @return: the version for I{source} in I{suite}
2168
2169     """
2170
2171     q = session.query(SrcAssociation)
2172     q = q.join('source').filter_by(source=source)
2173     q = q.join('suite').filter_by(suite_name=suite)
2174
2175     try:
2176         return q.one().source
2177     except NoResultFound:
2178         return None
2179
2180 __all__.append('get_source_in_suite')
2181
2182 ################################################################################
2183
2184 @session_wrapper
2185 def add_dsc_to_db(u, filename, session=None):
2186     entry = u.pkg.files[filename]
2187     source = DBSource()
2188     pfs = []
2189
2190     source.source = u.pkg.dsc["source"]
2191     source.version = u.pkg.dsc["version"] # NB: not files[file]["version"], that has no epoch
2192     source.maintainer_id = get_or_set_maintainer(u.pkg.dsc["maintainer"], session).maintainer_id
2193     source.changedby_id = get_or_set_maintainer(u.pkg.changes["changed-by"], session).maintainer_id
2194     source.fingerprint_id = get_or_set_fingerprint(u.pkg.changes["fingerprint"], session).fingerprint_id
2195     source.install_date = datetime.now().date()
2196
2197     dsc_component = entry["component"]
2198     dsc_location_id = entry["location id"]
2199
2200     source.dm_upload_allowed = (u.pkg.dsc.get("dm-upload-allowed", '') == "yes")
2201
2202     # Set up a new poolfile if necessary
2203     if not entry.has_key("files id") or not entry["files id"]:
2204         filename = entry["pool name"] + filename
2205         poolfile = add_poolfile(filename, entry, dsc_location_id, session)
2206         session.flush()
2207         pfs.append(poolfile)
2208         entry["files id"] = poolfile.file_id
2209
2210     source.poolfile_id = entry["files id"]
2211     session.add(source)
2212     session.flush()
2213
2214     for suite_name in u.pkg.changes["distribution"].keys():
2215         sa = SrcAssociation()
2216         sa.source_id = source.source_id
2217         sa.suite_id = get_suite(suite_name).suite_id
2218         session.add(sa)
2219
2220     session.flush()
2221
2222     # Add the source files to the DB (files and dsc_files)
2223     dscfile = DSCFile()
2224     dscfile.source_id = source.source_id
2225     dscfile.poolfile_id = entry["files id"]
2226     session.add(dscfile)
2227
2228     for dsc_file, dentry in u.pkg.dsc_files.items():
2229         df = DSCFile()
2230         df.source_id = source.source_id
2231
2232         # If the .orig tarball is already in the pool, it's
2233         # files id is stored in dsc_files by check_dsc().
2234         files_id = dentry.get("files id", None)
2235
2236         # Find the entry in the files hash
2237         # TODO: Bail out here properly
2238         dfentry = None
2239         for f, e in u.pkg.files.items():
2240             if f == dsc_file:
2241                 dfentry = e
2242                 break
2243
2244         if files_id is None:
2245             filename = dfentry["pool name"] + dsc_file
2246
2247             (found, obj) = check_poolfile(filename, dentry["size"], dentry["md5sum"], dsc_location_id)
2248             # FIXME: needs to check for -1/-2 and or handle exception
2249             if found and obj is not None:
2250                 files_id = obj.file_id
2251                 pfs.append(obj)
2252
2253             # If still not found, add it
2254             if files_id is None:
2255                 # HACK: Force sha1sum etc into dentry
2256                 dentry["sha1sum"] = dfentry["sha1sum"]
2257                 dentry["sha256sum"] = dfentry["sha256sum"]
2258                 poolfile = add_poolfile(filename, dentry, dsc_location_id, session)
2259                 pfs.append(poolfile)
2260                 files_id = poolfile.file_id
2261         else:
2262             poolfile = get_poolfile_by_id(files_id, session)
2263             if poolfile is None:
2264                 utils.fubar("INTERNAL ERROR. Found no poolfile with id %d" % files_id)
2265             pfs.append(poolfile)
2266
2267         df.poolfile_id = files_id
2268         session.add(df)
2269
2270     session.flush()
2271
2272     # Add the src_uploaders to the DB
2273     uploader_ids = [source.maintainer_id]
2274     if u.pkg.dsc.has_key("uploaders"):
2275         for up in u.pkg.dsc["uploaders"].split(","):
2276             up = up.strip()
2277             uploader_ids.append(get_or_set_maintainer(up, session).maintainer_id)
2278
2279     added_ids = {}
2280     for up_id in uploader_ids:
2281         if added_ids.has_key(up_id):
2282             import utils
2283             utils.warn("Already saw uploader %s for source %s" % (up_id, source.source))
2284             continue
2285
2286         added_ids[up_id]=1
2287
2288         su = SrcUploader()
2289         su.maintainer_id = up_id
2290         su.source_id = source.source_id
2291         session.add(su)
2292
2293     session.flush()
2294
2295     return source, dsc_component, dsc_location_id, pfs
2296
2297 __all__.append('add_dsc_to_db')
2298
2299 @session_wrapper
2300 def add_deb_to_db(u, filename, session=None):
2301     """
2302     Contrary to what you might expect, this routine deals with both
2303     debs and udebs.  That info is in 'dbtype', whilst 'type' is
2304     'deb' for both of them
2305     """
2306     cnf = Config()
2307     entry = u.pkg.files[filename]
2308
2309     bin = DBBinary()
2310     bin.package = entry["package"]
2311     bin.version = entry["version"]
2312     bin.maintainer_id = get_or_set_maintainer(entry["maintainer"], session).maintainer_id
2313     bin.fingerprint_id = get_or_set_fingerprint(u.pkg.changes["fingerprint"], session).fingerprint_id
2314     bin.arch_id = get_architecture(entry["architecture"], session).arch_id
2315     bin.binarytype = entry["dbtype"]
2316
2317     # Find poolfile id
2318     filename = entry["pool name"] + filename
2319     fullpath = os.path.join(cnf["Dir::Pool"], filename)
2320     if not entry.get("location id", None):
2321         entry["location id"] = get_location(cnf["Dir::Pool"], entry["component"], session=session).location_id
2322
2323     if entry.get("files id", None):
2324         poolfile = get_poolfile_by_id(bin.poolfile_id)
2325         bin.poolfile_id = entry["files id"]
2326     else:
2327         poolfile = add_poolfile(filename, entry, entry["location id"], session)
2328         bin.poolfile_id = entry["files id"] = poolfile.file_id
2329
2330     # Find source id
2331     bin_sources = get_sources_from_name(entry["source package"], entry["source version"], session=session)
2332     if len(bin_sources) != 1:
2333         raise NoSourceFieldError, "Unable to find a unique source id for %s (%s), %s, file %s, type %s, signed by %s" % \
2334                                   (bin.package, bin.version, bin.architecture.arch_string,
2335                                    filename, bin.binarytype, u.pkg.changes["fingerprint"])
2336
2337     bin.source_id = bin_sources[0].source_id
2338
2339     # Add and flush object so it has an ID
2340     session.add(bin)
2341     session.flush()
2342
2343     # Add BinAssociations
2344     for suite_name in u.pkg.changes["distribution"].keys():
2345         ba = BinAssociation()
2346         ba.binary_id = bin.binary_id
2347         ba.suite_id = get_suite(suite_name).suite_id
2348         session.add(ba)
2349
2350     session.flush()
2351
2352     # Deal with contents - disabled for now
2353     #contents = copy_temporary_contents(bin.package, bin.version, bin.architecture.arch_string, os.path.basename(filename), None, session)
2354     #if not contents:
2355     #    print "REJECT\nCould not determine contents of package %s" % bin.package
2356     #    session.rollback()
2357     #    raise MissingContents, "No contents stored for package %s, and couldn't determine contents of %s" % (bin.package, filename)
2358
2359     return poolfile
2360
2361 __all__.append('add_deb_to_db')
2362
2363 ################################################################################
2364
2365 class SourceACL(object):
2366     def __init__(self, *args, **kwargs):
2367         pass
2368
2369     def __repr__(self):
2370         return '<SourceACL %s>' % self.source_acl_id
2371
2372 __all__.append('SourceACL')
2373
2374 ################################################################################
2375
2376 class SrcAssociation(object):
2377     def __init__(self, *args, **kwargs):
2378         pass
2379
2380     def __repr__(self):
2381         return '<SrcAssociation %s (%s, %s)>' % (self.sa_id, self.source, self.suite)
2382
2383 __all__.append('SrcAssociation')
2384
2385 ################################################################################
2386
2387 class SrcFormat(object):
2388     def __init__(self, *args, **kwargs):
2389         pass
2390
2391     def __repr__(self):
2392         return '<SrcFormat %s>' % (self.format_name)
2393
2394 __all__.append('SrcFormat')
2395
2396 ################################################################################
2397
2398 class SrcUploader(object):
2399     def __init__(self, *args, **kwargs):
2400         pass
2401
2402     def __repr__(self):
2403         return '<SrcUploader %s>' % self.uploader_id
2404
2405 __all__.append('SrcUploader')
2406
2407 ################################################################################
2408
2409 SUITE_FIELDS = [ ('SuiteName', 'suite_name'),
2410                  ('SuiteID', 'suite_id'),
2411                  ('Version', 'version'),
2412                  ('Origin', 'origin'),
2413                  ('Label', 'label'),
2414                  ('Description', 'description'),
2415                  ('Untouchable', 'untouchable'),
2416                  ('Announce', 'announce'),
2417                  ('Codename', 'codename'),
2418                  ('OverrideCodename', 'overridecodename'),
2419                  ('ValidTime', 'validtime'),
2420                  ('Priority', 'priority'),
2421                  ('NotAutomatic', 'notautomatic'),
2422                  ('CopyChanges', 'copychanges'),
2423                  ('CopyDotDak', 'copydotdak'),
2424                  ('CommentsDir', 'commentsdir'),
2425                  ('OverrideSuite', 'overridesuite'),
2426                  ('ChangelogBase', 'changelogbase')]
2427
2428
2429 class Suite(object):
2430     def __init__(self, *args, **kwargs):
2431         pass
2432
2433     def __repr__(self):
2434         return '<Suite %s>' % self.suite_name
2435
2436     def __eq__(self, val):
2437         if isinstance(val, str):
2438             return (self.suite_name == val)
2439         # This signals to use the normal comparison operator
2440         return NotImplemented
2441
2442     def __ne__(self, val):
2443         if isinstance(val, str):
2444             return (self.suite_name != val)
2445         # This signals to use the normal comparison operator
2446         return NotImplemented
2447
2448     def details(self):
2449         ret = []
2450         for disp, field in SUITE_FIELDS:
2451             val = getattr(self, field, None)
2452             if val is not None:
2453                 ret.append("%s: %s" % (disp, val))
2454
2455         return "\n".join(ret)
2456
2457 __all__.append('Suite')
2458
2459 @session_wrapper
2460 def get_suite_architecture(suite, architecture, session=None):
2461     """
2462     Returns a SuiteArchitecture object given C{suite} and ${arch} or None if it
2463     doesn't exist
2464
2465     @type suite: str
2466     @param suite: Suite name to search for
2467
2468     @type architecture: str
2469     @param architecture: Architecture name to search for
2470
2471     @type session: Session
2472     @param session: Optional SQL session object (a temporary one will be
2473     generated if not supplied)
2474
2475     @rtype: SuiteArchitecture
2476     @return: the SuiteArchitecture object or None
2477     """
2478
2479     q = session.query(SuiteArchitecture)
2480     q = q.join(Architecture).filter_by(arch_string=architecture)
2481     q = q.join(Suite).filter_by(suite_name=suite)
2482
2483     try:
2484         return q.one()
2485     except NoResultFound:
2486         return None
2487
2488 __all__.append('get_suite_architecture')
2489
2490 @session_wrapper
2491 def get_suite(suite, session=None):
2492     """
2493     Returns Suite object for given C{suite name}.
2494
2495     @type suite: string
2496     @param suite: The name of the suite
2497
2498     @type session: Session
2499     @param session: Optional SQLA session object (a temporary one will be
2500     generated if not supplied)
2501
2502     @rtype: Suite
2503     @return: Suite object for the requested suite name (None if not present)
2504     """
2505
2506     q = session.query(Suite).filter_by(suite_name=suite)
2507
2508     try:
2509         return q.one()
2510     except NoResultFound:
2511         return None
2512
2513 __all__.append('get_suite')
2514
2515 ################################################################################
2516
2517 class SuiteArchitecture(object):
2518     def __init__(self, *args, **kwargs):
2519         pass
2520
2521     def __repr__(self):
2522         return '<SuiteArchitecture (%s, %s)>' % (self.suite_id, self.arch_id)
2523
2524 __all__.append('SuiteArchitecture')
2525
2526 @session_wrapper
2527 def get_suite_architectures(suite, skipsrc=False, skipall=False, session=None):
2528     """
2529     Returns list of Architecture objects for given C{suite} name
2530
2531     @type source: str
2532     @param source: Suite name to search for
2533
2534     @type skipsrc: boolean
2535     @param skipsrc: Whether to skip returning the 'source' architecture entry
2536     (Default False)
2537
2538     @type skipall: boolean
2539     @param skipall: Whether to skip returning the 'all' architecture entry
2540     (Default False)
2541
2542     @type session: Session
2543     @param session: Optional SQL session object (a temporary one will be
2544     generated if not supplied)
2545
2546     @rtype: list
2547     @return: list of Architecture objects for the given name (may be empty)
2548     """
2549
2550     q = session.query(Architecture)
2551     q = q.join(SuiteArchitecture)
2552     q = q.join(Suite).filter_by(suite_name=suite)
2553
2554     if skipsrc:
2555         q = q.filter(Architecture.arch_string != 'source')
2556
2557     if skipall:
2558         q = q.filter(Architecture.arch_string != 'all')
2559
2560     q = q.order_by('arch_string')
2561
2562     return q.all()
2563
2564 __all__.append('get_suite_architectures')
2565
2566 ################################################################################
2567
2568 class SuiteSrcFormat(object):
2569     def __init__(self, *args, **kwargs):
2570         pass
2571
2572     def __repr__(self):
2573         return '<SuiteSrcFormat (%s, %s)>' % (self.suite_id, self.src_format_id)
2574
2575 __all__.append('SuiteSrcFormat')
2576
2577 @session_wrapper
2578 def get_suite_src_formats(suite, session=None):
2579     """
2580     Returns list of allowed SrcFormat for C{suite}.
2581
2582     @type suite: str
2583     @param suite: Suite name to search for
2584
2585     @type session: Session
2586     @param session: Optional SQL session object (a temporary one will be
2587     generated if not supplied)
2588
2589     @rtype: list
2590     @return: the list of allowed source formats for I{suite}
2591     """
2592
2593     q = session.query(SrcFormat)
2594     q = q.join(SuiteSrcFormat)
2595     q = q.join(Suite).filter_by(suite_name=suite)
2596     q = q.order_by('format_name')
2597
2598     return q.all()
2599
2600 __all__.append('get_suite_src_formats')
2601
2602 ################################################################################
2603
2604 class Uid(object):
2605     def __init__(self, *args, **kwargs):
2606         pass
2607
2608     def __eq__(self, val):
2609         if isinstance(val, str):
2610             return (self.uid == val)
2611         # This signals to use the normal comparison operator
2612         return NotImplemented
2613
2614     def __ne__(self, val):
2615         if isinstance(val, str):
2616             return (self.uid != val)
2617         # This signals to use the normal comparison operator
2618         return NotImplemented
2619
2620     def __repr__(self):
2621         return '<Uid %s (%s)>' % (self.uid, self.name)
2622
2623 __all__.append('Uid')
2624
2625 @session_wrapper
2626 def add_database_user(uidname, session=None):
2627     """
2628     Adds a database user
2629
2630     @type uidname: string
2631     @param uidname: The uid of the user to add
2632
2633     @type session: SQLAlchemy
2634     @param session: Optional SQL session object (a temporary one will be
2635     generated if not supplied).  If not passed, a commit will be performed at
2636     the end of the function, otherwise the caller is responsible for commiting.
2637
2638     @rtype: Uid
2639     @return: the uid object for the given uidname
2640     """
2641
2642     session.execute("CREATE USER :uid", {'uid': uidname})
2643     session.commit_or_flush()
2644
2645 __all__.append('add_database_user')
2646
2647 @session_wrapper
2648 def get_or_set_uid(uidname, session=None):
2649     """
2650     Returns uid object for given uidname.
2651
2652     If no matching uidname is found, a row is inserted.
2653
2654     @type uidname: string
2655     @param uidname: The uid to add
2656
2657     @type session: SQLAlchemy
2658     @param session: Optional SQL session object (a temporary one will be
2659     generated if not supplied).  If not passed, a commit will be performed at
2660     the end of the function, otherwise the caller is responsible for commiting.
2661
2662     @rtype: Uid
2663     @return: the uid object for the given uidname
2664     """
2665
2666     q = session.query(Uid).filter_by(uid=uidname)
2667
2668     try:
2669         ret = q.one()
2670     except NoResultFound:
2671         uid = Uid()
2672         uid.uid = uidname
2673         session.add(uid)
2674         session.commit_or_flush()
2675         ret = uid
2676
2677     return ret
2678
2679 __all__.append('get_or_set_uid')
2680
2681 @session_wrapper
2682 def get_uid_from_fingerprint(fpr, session=None):
2683     q = session.query(Uid)
2684     q = q.join(Fingerprint).filter_by(fingerprint=fpr)
2685
2686     try:
2687         return q.one()
2688     except NoResultFound:
2689         return None
2690
2691 __all__.append('get_uid_from_fingerprint')
2692
2693 ################################################################################
2694
2695 class UploadBlock(object):
2696     def __init__(self, *args, **kwargs):
2697         pass
2698
2699     def __repr__(self):
2700         return '<UploadBlock %s (%s)>' % (self.source, self.upload_block_id)
2701
2702 __all__.append('UploadBlock')
2703
2704 ################################################################################
2705
2706 class DBConn(object):
2707     """
2708     database module init.
2709     """
2710     __shared_state = {}
2711
2712     def __init__(self, *args, **kwargs):
2713         self.__dict__ = self.__shared_state
2714
2715         if not getattr(self, 'initialised', False):
2716             self.initialised = True
2717             self.debug = kwargs.has_key('debug')
2718             self.__createconn()
2719
2720     def __setuptables(self):
2721         tables = (
2722             'architecture',
2723             'archive',
2724             'bin_associations',
2725             'binaries',
2726             'binary_acl',
2727             'binary_acl_map',
2728             'build_queue',
2729             'build_queue_files',
2730             'component',
2731             'config',
2732             'content_associations',
2733             'content_file_names',
2734             'content_file_paths',
2735             'changes_pending_binaries',
2736             'changes_pending_files',
2737             'changes_pending_files_map',
2738             'changes_pending_source',
2739             'changes_pending_source_files',
2740             'changes_pool_files',
2741             'dsc_files',
2742             'files',
2743             'fingerprint',
2744             'keyrings',
2745             'changes',
2746             'keyring_acl_map',
2747             'location',
2748             'maintainer',
2749             'new_comments',
2750             'override',
2751             'override_type',
2752             'pending_content_associations',
2753             'policy_queue',
2754             'priority',
2755             'section',
2756             'source',
2757             'source_acl',
2758             'src_associations',
2759             'src_format',
2760             'src_uploaders',
2761             'suite',
2762             'suite_architectures',
2763             'suite_src_formats',
2764             'suite_build_queue_copy',
2765             'uid',
2766             'upload_blocks',
2767         )
2768
2769         for table_name in tables:
2770             table = Table(table_name, self.db_meta, autoload=True)
2771             setattr(self, 'tbl_%s' % table_name, table)
2772
2773     def __setupmappers(self):
2774         mapper(Architecture, self.tbl_architecture,
2775                properties = dict(arch_id = self.tbl_architecture.c.id))
2776
2777         mapper(Archive, self.tbl_archive,
2778                properties = dict(archive_id = self.tbl_archive.c.id,
2779                                  archive_name = self.tbl_archive.c.name))
2780
2781         mapper(BinAssociation, self.tbl_bin_associations,
2782                properties = dict(ba_id = self.tbl_bin_associations.c.id,
2783                                  suite_id = self.tbl_bin_associations.c.suite,
2784                                  suite = relation(Suite),
2785                                  binary_id = self.tbl_bin_associations.c.bin,
2786                                  binary = relation(DBBinary)))
2787
2788         mapper(BuildQueue, self.tbl_build_queue,
2789                properties = dict(queue_id = self.tbl_build_queue.c.id))
2790
2791         mapper(BuildQueueFile, self.tbl_build_queue_files,
2792                properties = dict(buildqueue = relation(BuildQueue, backref='queuefiles'),
2793                                  poolfile = relation(PoolFile, backref='buildqueueinstances')))
2794
2795         mapper(DBBinary, self.tbl_binaries,
2796                properties = dict(binary_id = self.tbl_binaries.c.id,
2797                                  package = self.tbl_binaries.c.package,
2798                                  version = self.tbl_binaries.c.version,
2799                                  maintainer_id = self.tbl_binaries.c.maintainer,
2800                                  maintainer = relation(Maintainer),
2801                                  source_id = self.tbl_binaries.c.source,
2802                                  source = relation(DBSource),
2803                                  arch_id = self.tbl_binaries.c.architecture,
2804                                  architecture = relation(Architecture),
2805                                  poolfile_id = self.tbl_binaries.c.file,
2806                                  poolfile = relation(PoolFile),
2807                                  binarytype = self.tbl_binaries.c.type,
2808                                  fingerprint_id = self.tbl_binaries.c.sig_fpr,
2809                                  fingerprint = relation(Fingerprint),
2810                                  install_date = self.tbl_binaries.c.install_date,
2811                                  binassociations = relation(BinAssociation,
2812                                                             primaryjoin=(self.tbl_binaries.c.id==self.tbl_bin_associations.c.bin))))
2813
2814         mapper(BinaryACL, self.tbl_binary_acl,
2815                properties = dict(binary_acl_id = self.tbl_binary_acl.c.id))
2816
2817         mapper(BinaryACLMap, self.tbl_binary_acl_map,
2818                properties = dict(binary_acl_map_id = self.tbl_binary_acl_map.c.id,
2819                                  fingerprint = relation(Fingerprint, backref="binary_acl_map"),
2820                                  architecture = relation(Architecture)))
2821
2822         mapper(Component, self.tbl_component,
2823                properties = dict(component_id = self.tbl_component.c.id,
2824                                  component_name = self.tbl_component.c.name))
2825
2826         mapper(DBConfig, self.tbl_config,
2827                properties = dict(config_id = self.tbl_config.c.id))
2828
2829         mapper(DSCFile, self.tbl_dsc_files,
2830                properties = dict(dscfile_id = self.tbl_dsc_files.c.id,
2831                                  source_id = self.tbl_dsc_files.c.source,
2832                                  source = relation(DBSource),
2833                                  poolfile_id = self.tbl_dsc_files.c.file,
2834                                  poolfile = relation(PoolFile)))
2835
2836         mapper(PoolFile, self.tbl_files,
2837                properties = dict(file_id = self.tbl_files.c.id,
2838                                  filesize = self.tbl_files.c.size,
2839                                  location_id = self.tbl_files.c.location,
2840                                  location = relation(Location)))
2841
2842         mapper(Fingerprint, self.tbl_fingerprint,
2843                properties = dict(fingerprint_id = self.tbl_fingerprint.c.id,
2844                                  uid_id = self.tbl_fingerprint.c.uid,
2845                                  uid = relation(Uid),
2846                                  keyring_id = self.tbl_fingerprint.c.keyring,
2847                                  keyring = relation(Keyring),
2848                                  source_acl = relation(SourceACL),
2849                                  binary_acl = relation(BinaryACL)))
2850
2851         mapper(Keyring, self.tbl_keyrings,
2852                properties = dict(keyring_name = self.tbl_keyrings.c.name,
2853                                  keyring_id = self.tbl_keyrings.c.id))
2854
2855         mapper(DBChange, self.tbl_changes,
2856                properties = dict(change_id = self.tbl_changes.c.id,
2857                                  poolfiles = relation(PoolFile,
2858                                                       secondary=self.tbl_changes_pool_files,
2859                                                       backref="changeslinks"),
2860                                  seen = self.tbl_changes.c.seen,
2861                                  source = self.tbl_changes.c.source,
2862                                  binaries = self.tbl_changes.c.binaries,
2863                                  architecture = self.tbl_changes.c.architecture,
2864                                  distribution = self.tbl_changes.c.distribution,
2865                                  urgency = self.tbl_changes.c.urgency,
2866                                  maintainer = self.tbl_changes.c.maintainer,
2867                                  changedby = self.tbl_changes.c.changedby,
2868                                  date = self.tbl_changes.c.date,
2869                                  version = self.tbl_changes.c.version,
2870                                  files = relation(ChangePendingFile,
2871                                                   secondary=self.tbl_changes_pending_files_map,
2872                                                   backref="changesfile"),
2873                                  in_queue_id = self.tbl_changes.c.in_queue,
2874                                  in_queue = relation(PolicyQueue,
2875                                                      primaryjoin=(self.tbl_changes.c.in_queue==self.tbl_policy_queue.c.id)),
2876                                  approved_for_id = self.tbl_changes.c.approved_for))
2877
2878         mapper(ChangePendingBinary, self.tbl_changes_pending_binaries,
2879                properties = dict(change_pending_binary_id = self.tbl_changes_pending_binaries.c.id))
2880
2881         mapper(ChangePendingFile, self.tbl_changes_pending_files,
2882                properties = dict(change_pending_file_id = self.tbl_changes_pending_files.c.id,
2883                                  filename = self.tbl_changes_pending_files.c.filename,
2884                                  size = self.tbl_changes_pending_files.c.size,
2885                                  md5sum = self.tbl_changes_pending_files.c.md5sum,
2886                                  sha1sum = self.tbl_changes_pending_files.c.sha1sum,
2887                                  sha256sum = self.tbl_changes_pending_files.c.sha256sum))
2888
2889         mapper(ChangePendingSource, self.tbl_changes_pending_source,
2890                properties = dict(change_pending_source_id = self.tbl_changes_pending_source.c.id,
2891                                  change = relation(DBChange),
2892                                  maintainer = relation(Maintainer,
2893                                                        primaryjoin=(self.tbl_changes_pending_source.c.maintainer_id==self.tbl_maintainer.c.id)),
2894                                  changedby = relation(Maintainer,
2895                                                       primaryjoin=(self.tbl_changes_pending_source.c.changedby_id==self.tbl_maintainer.c.id)),
2896                                  fingerprint = relation(Fingerprint),
2897                                  source_files = relation(ChangePendingFile,
2898                                                          secondary=self.tbl_changes_pending_source_files,
2899                                                          backref="pending_sources")))
2900         mapper(KeyringACLMap, self.tbl_keyring_acl_map,
2901                properties = dict(keyring_acl_map_id = self.tbl_keyring_acl_map.c.id,
2902                                  keyring = relation(Keyring, backref="keyring_acl_map"),
2903                                  architecture = relation(Architecture)))
2904
2905         mapper(Location, self.tbl_location,
2906                properties = dict(location_id = self.tbl_location.c.id,
2907                                  component_id = self.tbl_location.c.component,
2908                                  component = relation(Component),
2909                                  archive_id = self.tbl_location.c.archive,
2910                                  archive = relation(Archive),
2911                                  archive_type = self.tbl_location.c.type))
2912
2913         mapper(Maintainer, self.tbl_maintainer,
2914                properties = dict(maintainer_id = self.tbl_maintainer.c.id))
2915
2916         mapper(NewComment, self.tbl_new_comments,
2917                properties = dict(comment_id = self.tbl_new_comments.c.id))
2918
2919         mapper(Override, self.tbl_override,
2920                properties = dict(suite_id = self.tbl_override.c.suite,
2921                                  suite = relation(Suite),
2922                                  component_id = self.tbl_override.c.component,
2923                                  component = relation(Component),
2924                                  priority_id = self.tbl_override.c.priority,
2925                                  priority = relation(Priority),
2926                                  section_id = self.tbl_override.c.section,
2927                                  section = relation(Section),
2928                                  overridetype_id = self.tbl_override.c.type,
2929                                  overridetype = relation(OverrideType)))
2930
2931         mapper(OverrideType, self.tbl_override_type,
2932                properties = dict(overridetype = self.tbl_override_type.c.type,
2933                                  overridetype_id = self.tbl_override_type.c.id))
2934
2935         mapper(PolicyQueue, self.tbl_policy_queue,
2936                properties = dict(policy_queue_id = self.tbl_policy_queue.c.id))
2937
2938         mapper(Priority, self.tbl_priority,
2939                properties = dict(priority_id = self.tbl_priority.c.id))
2940
2941         mapper(Section, self.tbl_section,
2942                properties = dict(section_id = self.tbl_section.c.id))
2943
2944         mapper(DBSource, self.tbl_source,
2945                properties = dict(source_id = self.tbl_source.c.id,
2946                                  version = self.tbl_source.c.version,
2947                                  maintainer_id = self.tbl_source.c.maintainer,
2948                                  maintainer = relation(Maintainer,
2949                                                        primaryjoin=(self.tbl_source.c.maintainer==self.tbl_maintainer.c.id)),
2950                                  poolfile_id = self.tbl_source.c.file,
2951                                  poolfile = relation(PoolFile),
2952                                  fingerprint_id = self.tbl_source.c.sig_fpr,
2953                                  fingerprint = relation(Fingerprint),
2954                                  changedby_id = self.tbl_source.c.changedby,
2955                                  changedby = relation(Maintainer,
2956                                                       primaryjoin=(self.tbl_source.c.changedby==self.tbl_maintainer.c.id)),
2957                                  srcfiles = relation(DSCFile,
2958                                                      primaryjoin=(self.tbl_source.c.id==self.tbl_dsc_files.c.source)),
2959                                  srcassociations = relation(SrcAssociation,
2960                                                             primaryjoin=(self.tbl_source.c.id==self.tbl_src_associations.c.source)),
2961                                  srcuploaders = relation(SrcUploader)))
2962
2963         mapper(SourceACL, self.tbl_source_acl,
2964                properties = dict(source_acl_id = self.tbl_source_acl.c.id))
2965
2966         mapper(SrcAssociation, self.tbl_src_associations,
2967                properties = dict(sa_id = self.tbl_src_associations.c.id,
2968                                  suite_id = self.tbl_src_associations.c.suite,
2969                                  suite = relation(Suite),
2970                                  source_id = self.tbl_src_associations.c.source,
2971                                  source = relation(DBSource)))
2972
2973         mapper(SrcFormat, self.tbl_src_format,
2974                properties = dict(src_format_id = self.tbl_src_format.c.id,
2975                                  format_name = self.tbl_src_format.c.format_name))
2976
2977         mapper(SrcUploader, self.tbl_src_uploaders,
2978                properties = dict(uploader_id = self.tbl_src_uploaders.c.id,
2979                                  source_id = self.tbl_src_uploaders.c.source,
2980                                  source = relation(DBSource,
2981                                                    primaryjoin=(self.tbl_src_uploaders.c.source==self.tbl_source.c.id)),
2982                                  maintainer_id = self.tbl_src_uploaders.c.maintainer,
2983                                  maintainer = relation(Maintainer,
2984                                                        primaryjoin=(self.tbl_src_uploaders.c.maintainer==self.tbl_maintainer.c.id))))
2985
2986         mapper(Suite, self.tbl_suite,
2987                properties = dict(suite_id = self.tbl_suite.c.id,
2988                                  policy_queue = relation(PolicyQueue),
2989                                  copy_queues = relation(BuildQueue, secondary=self.tbl_suite_build_queue_copy)))
2990
2991         mapper(SuiteArchitecture, self.tbl_suite_architectures,
2992                properties = dict(suite_id = self.tbl_suite_architectures.c.suite,
2993                                  suite = relation(Suite, backref='suitearchitectures'),
2994                                  arch_id = self.tbl_suite_architectures.c.architecture,
2995                                  architecture = relation(Architecture)))
2996
2997         mapper(SuiteSrcFormat, self.tbl_suite_src_formats,
2998                properties = dict(suite_id = self.tbl_suite_src_formats.c.suite,
2999                                  suite = relation(Suite, backref='suitesrcformats'),
3000                                  src_format_id = self.tbl_suite_src_formats.c.src_format,
3001                                  src_format = relation(SrcFormat)))
3002
3003         mapper(Uid, self.tbl_uid,
3004                properties = dict(uid_id = self.tbl_uid.c.id,
3005                                  fingerprint = relation(Fingerprint)))
3006
3007         mapper(UploadBlock, self.tbl_upload_blocks,
3008                properties = dict(upload_block_id = self.tbl_upload_blocks.c.id,
3009                                  fingerprint = relation(Fingerprint, backref="uploadblocks"),
3010                                  uid = relation(Uid, backref="uploadblocks")))
3011
3012     ## Connection functions
3013     def __createconn(self):
3014         from config import Config
3015         cnf = Config()
3016         if cnf["DB::Host"]:
3017             # TCP/IP
3018             connstr = "postgres://%s" % cnf["DB::Host"]
3019             if cnf["DB::Port"] and cnf["DB::Port"] != "-1":
3020                 connstr += ":%s" % cnf["DB::Port"]
3021             connstr += "/%s" % cnf["DB::Name"]
3022         else:
3023             # Unix Socket
3024             connstr = "postgres:///%s" % cnf["DB::Name"]
3025             if cnf["DB::Port"] and cnf["DB::Port"] != "-1":
3026                 connstr += "?port=%s" % cnf["DB::Port"]
3027
3028         self.db_pg   = create_engine(connstr, echo=self.debug)
3029         self.db_meta = MetaData()
3030         self.db_meta.bind = self.db_pg
3031         self.db_smaker = sessionmaker(bind=self.db_pg,
3032                                       autoflush=True,
3033                                       autocommit=False)
3034
3035         self.__setuptables()
3036         self.__setupmappers()
3037
3038     def session(self):
3039         return self.db_smaker()
3040
3041 __all__.append('DBConn')
3042
3043