From 21dce82056887d8d28edde61b1b82f78bdf7613c Mon Sep 17 00:00:00 2001 From: Richard Purdie Date: Fri, 10 Jul 2015 14:13:43 +0100 Subject: prserv/db: Document history modes I keep having to dig into the archives to remember this information. Add it as a comment to the file instead. Signed-off-by: Richard Purdie --- lib/prserv/db.py | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'lib/prserv/db.py') diff --git a/lib/prserv/db.py b/lib/prserv/db.py index 9d6d11526..437958013 100644 --- a/lib/prserv/db.py +++ b/lib/prserv/db.py @@ -15,6 +15,16 @@ sqlversion = sqlite3.sqlite_version_info if sqlversion[0] < 3 or (sqlversion[0] == 3 and sqlversion[1] < 3): raise Exception("sqlite3 version 3.3.0 or later is required.") +# +# "No History" mode - for a given query tuple (version, pkgarch, checksum), +# the returned value will be the largest among all the values of the same +# (version, pkgarch). This means the PR value returned can NOT be decremented. +# +# "History" mode - Return a new higher value for previously unseen query +# tuple (version, pkgarch, checksum), otherwise return historical value. +# Value can decrement if returning to a previous build. +# + class PRTable(object): def __init__(self, conn, table, nohist): self.conn = conn -- cgit 1.2.3-korg