Home       Trees       Indices       Help   
Entropy Framework
Package entropy :: Module db :: Class EntropyRepository

Class EntropyRepository

source code

EntropyRepository implements SQLite3 based storage. In a Model-View based pattern, it can be considered the "model". Actually it's the only one available but more model backends will be supported in future (which will inherit this class directly).

Every Entropy repository storage interface MUST inherit from this base class.

To Do: refactoring and generalization needed

Nested Classes
  Schema
Instance Methods
 
__init__(self, readOnly=False, noUpload=False, dbFile=None, clientDatabase=False, xcache=False, dbname='etpdb:', indexing=True, OutputInterface=None, ServiceInterface=None, skipChecks=False, useBranch=None, lockRemote=True)
EntropyRepository constructor.		 source code
 
setCacheSize(self, size)
Change low-level, storage engine based cache size.		 source code
 
setDefaultCacheSize(self, size)
Change default low-level, storage engine based cache size.		 source code
 
__del__(self) source code
 
closeDB(self)
Close repository storage communication.		 source code
 
vacuum(self)
Repository storage cleanup and optimization function.		 source code
 
commitChanges(self)
Commit actual changes and make them permanently stored.		 source code
 
taintDatabase(self)
Server-side method that render your repository storage tainted, modified.		 source code
 
untaintDatabase(self)
Server-side method that render your repository storage NOT tainted, modified.		 source code
 
isDatabaseTainted(self) source code
 
initializeDatabase(self) source code
 
checkReadOnly(self) source code
 
serverUpdatePackagesData(self) source code
 
clientUpdatePackagesData(self, clientDbconn, force=False) source code
 
filterTreeUpdatesActions(self, actions) source code
 
runTreeUpdatesActions(self, actions) source code
 
runTreeUpdatesMoveAction(self, move_command, quickpkg_queue) source code
 
runTreeUpdatesSlotmoveAction(self, slotmove_command, quickpkg_queue) source code
 
runTreeUpdatesQuickpkgAction(self, atoms) source code
 
doTreeupdatesSpmCleanup(self, spm_moves) source code
 
handlePackage(self, etpData, forcedRevision=-1, formattedContent=False) source code
 
retrieve_packages_to_remove(self, name, category, slot, injected) source code
 
addPackage(self, etpData, revision=-1, idpackage=None, do_remove=True, do_commit=True, formatted_content=False) source code
 
removePackage(self, idpackage, do_cleanup=True, do_commit=True, do_rss=True) source code
 
removeMirrorEntries(self, mirrorname) source code
 
addMirrors(self, mirrorname, mirrorlist) source code
 
addCategory(self, category) source code
 
addProtect(self, protect) source code
 
addSource(self, source) source code
 
addDependency(self, dependency) source code
 
addKeyword(self, keyword) source code
 
addUseflag(self, useflag) source code
 
addEclass(self, eclass) source code
 
addNeeded(self, needed) source code
 
addLicense(self, pkglicense) source code
 
addCompileFlags(self, chost, cflags, cxxflags) source code
 
setSystemPackage(self, idpackage, do_commit=True) source code
 
setInjected(self, idpackage, do_commit=True) source code
 
setDateCreation(self, idpackage, date) source code
 
setDigest(self, idpackage, digest) source code
 
setSignatures(self, idpackage, signatures) source code
 
setDownloadURL(self, idpackage, url) source code
 
setCategory(self, idpackage, category) source code
 
setCategoryDescription(self, category, description_data) source code
 
setName(self, idpackage, name) source code
 
setDependency(self, iddependency, dependency) source code
 
setAtom(self, idpackage, atom) source code
 
setSlot(self, idpackage, slot) source code
 
removeLicensedata(self, license_name) source code
 
removeDependencies(self, idpackage) source code
 
insertDependencies(self, idpackage, depdata) source code
 
insertManualDependencies(self, idpackage, manual_deps) source code
 
removeContent(self, idpackage) source code
 
insertContent(self, idpackage, content, already_formatted=False) source code
 
insertNeededPaths(self, library, paths) source code
 
insertAutomergefiles(self, idpackage, automerge_data) source code
 
removeAutomergefiles(self, idpackage) source code
 
removeSignatures(self, idpackage) source code
 
removeSpmPhases(self, idpackage) source code
 
insertChangelog(self, category, name, changelog_txt) source code
 
removeChangelog(self, category, name) source code
 
insertLicenses(self, licenses_data) source code
 
insertConfigProtect(self, idpackage, idprotect, mask=False) source code
 
insertMirrors(self, mirrors) source code
 
insertKeywords(self, idpackage, keywords) source code
 
insertUseflags(self, idpackage, useflags) source code
 
insertSignatures(self, idpackage, signatures) source code
 
insertSpmPhases(self, idpackage, phases) source code
 
insertSources(self, idpackage, sources) source code
 
insertConflicts(self, idpackage, conflicts) source code
 
insertMessages(self, idpackage, messages) source code
 
insertProvide(self, idpackage, provides) source code
 
insertNeeded(self, idpackage, neededs) source code
 
insertEclasses(self, idpackage, eclasses) source code
 
insertOnDiskSize(self, idpackage, mysize) source code
 
insertTrigger(self, idpackage, trigger) source code
 
insertBranchMigration(self, repository, from_branch, to_branch, post_migration_md5sum, post_upgrade_md5sum) source code
 
setBranchMigrationPostUpgradeMd5sum(self, repository, from_branch, to_branch, post_upgrade_md5sum) source code
 
insertPortageCounter(self, idpackage, counter, branch, injected) source code
 
insertCounter(self, idpackage, counter, branch=None) source code
 
setTrashedCounter(self, counter) source code
 
setCounter(self, idpackage, counter, branch=None) source code
 
contentDiff(self, idpackage, dbconn, dbconn_idpackage) source code
 
doCleanups(self) source code
 
cleanupUseflags(self) source code
 
cleanupSources(self) source code
 
cleanupEclasses(self) source code
 
cleanupNeeded(self) source code
 
cleanupNeededPaths(self) source code
 
cleanupDependencies(self) source code
 
cleanupChangelogs(self) source code
 
getNewNegativeCounter(self) source code
 
getApi(self) source code
 
getCategory(self, idcategory) source code
 
get_category_description_from_disk(self, category) source code
 
getIDPackage(self, atom, branch=None) source code
 
getIDPackageFromDownload(self, download_relative_path, endswith=False) source code
 
getIDPackagesFromFile(self, file) source code
 
getIDCategory(self, category) source code
 
getVersioningData(self, idpackage) source code
 
getStrictData(self, idpackage) source code
 
getStrictScopeData(self, idpackage) source code
 
getScopeData(self, idpackage) source code
 
getBaseData(self, idpackage) source code
 
getTriggerInfo(self, idpackage, content=True) source code
 
getPackageData(self, idpackage, get_content=True, content_insert_formatted=False, trigger_unicode=True) source code
 
fetchall2set(self, item) source code
 
fetchall2list(self, item) source code
 
fetchone2list(self, item) source code
 
fetchone2set(self, item) source code
 
clearCache(self, depends=False) source code
 
retrieveRepositoryUpdatesDigest(self, repository) source code
 
listAllTreeUpdatesActions(self, no_ids_repos=False) source code
 
retrieveTreeUpdatesActions(self, repository, forbranch=None) source code
 
bumpTreeUpdatesActions(self, updates) source code
 
removeTreeUpdatesActions(self, repository) source code
 
insertTreeUpdatesActions(self, updates, repository) source code
 
setRepositoryUpdatesDigest(self, repository, digest) source code
 
addRepositoryUpdatesActions(self, repository, actions, branch) source code
 
doesTreeupdatesActionExist(self, repository, command, branch) source code
 
clearPackageSets(self) source code
 
insertPackageSets(self, sets_data) source code
 
retrievePackageSets(self) source code
 
retrievePackageSet(self, setname) source code
 
retrieveSystemPackages(self) source code
 
retrieveAtom(self, idpackage) source code
 
retrieveBranch(self, idpackage) source code
 
retrieveTrigger(self, idpackage, get_unicode=False) source code
 
retrieveDownloadURL(self, idpackage) source code
 
retrieveDescription(self, idpackage) source code
 
retrieveHomepage(self, idpackage) source code
 
retrieveCounter(self, idpackage) source code
 
retrieveMessages(self, idpackage) source code
 
retrieveSize(self, idpackage) source code
 
retrieveOnDiskSize(self, idpackage) source code
 
retrieveDigest(self, idpackage) source code
 
retrieveSignatures(self, idpackage) source code
 
retrieveName(self, idpackage) source code
 
retrieveKeySlot(self, idpackage) source code
 
retrieveKeySlotAggregated(self, idpackage) source code
 
retrieveKeySlotTag(self, idpackage) source code
 
retrieveVersion(self, idpackage) source code
 
retrieveRevision(self, idpackage) source code
 
retrieveDateCreation(self, idpackage) source code
 
retrieveApi(self, idpackage) source code
 
retrieveUseflags(self, idpackage) source code
 
retrieveEclasses(self, idpackage) source code
 
retrieveSpmPhases(self, idpackage) source code
 
retrieveNeededRaw(self, idpackage) source code
 
retrieveNeeded(self, idpackage, extended=False, format=False) source code
 
retrieveNeededPaths(self, idpackage) source code
 
retrieveNeededLibraryPaths(self, needed_library_name, elfclass) source code
 
retrieveNeededLibraryIdpackages(self) source code
 
clearNeededLibraryIdpackages(self) source code
 
setNeededLibraryIdpackages(self, library_map) source code
 
retrieveConflicts(self, idpackage) source code
 
retrieveProvide(self, idpackage) source code
 
retrieveDependenciesList(self, idpackage) source code
 
retrievePostDependencies(self, idpackage, extended=False) source code
 
retrieveManualDependencies(self, idpackage, extended=False) source code
 
retrieveDependencies(self, idpackage, extended=False, deptype=None, exclude_deptypes=None) source code
 
retrieveIdDependencies(self, idpackage) source code
 
retrieveDependencyFromIddependency(self, iddependency) source code
 
retrieveKeywords(self, idpackage) source code
 
retrieveProtect(self, idpackage) source code
 
retrieveProtectMask(self, idpackage) source code
 
retrieveSources(self, idpackage, extended=False) source code
 
retrieveAutomergefiles(self, idpackage, get_dict=False) source code
 
retrieveContent(self, idpackage, extended=False, contentType=None, formatted=False, insert_formatted=False, order_by='') source code
 
retrieveChangelog(self, idpackage) source code
 
retrieveChangelogByKey(self, category, name) source code
 
retrieveSlot(self, idpackage) source code
 
retrieveVersionTag(self, idpackage) source code
 
retrieveMirrorInfo(self, mirrorname) source code
 
retrieveCategory(self, idpackage) source code
 
retrieveCategoryDescription(self, category) source code
 
retrieveLicensedata(self, idpackage) source code
 
retrieveLicensedataKeys(self, idpackage) source code
 
retrieveLicenseText(self, license_name) source code
 
retrieveLicense(self, idpackage) source code
 
retrieveCompileFlags(self, idpackage) source code
 
retrieveDepends(self, idpackage, atoms=False, key_slot=False, exclude_deptypes=None) source code
 
retrieveUnusedIdpackages(self) source code
 
isPackageAvailable(self, pkgatom) source code
 
isIDPackageAvailable(self, idpackage) source code
 
areIDPackagesAvailable(self, idpackages) source code
 
isCategoryAvailable(self, category) source code
 
isProtectAvailable(self, protect) source code
 
isFileAvailable(self, myfile, get_id=False) source code
 
resolveNeeded(self, needed, elfclass=-1, extended=False) source code
 
isSourceAvailable(self, source) source code
 
isDependencyAvailable(self, dependency) source code
 
isKeywordAvailable(self, keyword) source code
 
isUseflagAvailable(self, useflag) source code
 
isEclassAvailable(self, eclass) source code
 
isNeededAvailable(self, needed) source code
 
isCounterAvailable(self, counter, branch=None, branch_operator='=') source code
 
isCounterTrashed(self, counter) source code
 
isLicensedataKeyAvailable(self, license_name) source code
 
isLicenseAccepted(self, license_name) source code
 
acceptLicense(self, license_name) source code
 
isLicenseAvailable(self, pkglicense) source code
 
isSystemPackage(self, idpackage) source code
 
isInjected(self, idpackage) source code
 
areCompileFlagsAvailable(self, chost, cflags, cxxflags) source code
 
searchBelongs(self, file, like=False, branch=None, branch_operator='=') source code
 
searchEclassedPackages(self, eclass, atoms=False) source code
 
searchTaggedPackages(self, tag, atoms=False) source code
 
searchLicenses(self, mylicense, caseSensitive=False, atoms=False) source code
 
searchSlottedPackages(self, slot, atoms=False) source code
 
searchKeySlot(self, key, slot, branch=None) source code
 
searchNeeded(self, keyword, like=False) source code
 
searchDependency(self, dep, like=False, multi=False, strings=False) source code
 
searchIdpackageFromIddependency(self, iddep) source code
 
searchSets(self, keyword) source code
 
searchSimilarPackages(self, mystring, atom=False) source code
 
searchPackages(self, keyword, sensitive=False, slot=None, tag=None, branch=None, order_by='atom', just_id=False) source code
 
searchProvide(self, keyword, slot=None, tag=None, branch=None, justid=False) source code
 
searchPackagesByDescription(self, keyword) source code
 
searchPackagesByName(self, keyword, sensitive=False, branch=None, justid=False) source code
 
searchPackagesByCategory(self, keyword, like=False, branch=None) source code
 
searchPackagesByNameAndCategory(self, name, category, sensitive=False, branch=None, justid=False) source code
 
isPackageScopeAvailable(self, atom, slot, revision) source code
tuple
isBranchMigrationAvailable(self, repository, from_branch, to_branch)
Returns whether branch migration metadata given by the provided key (repository, from_branch, to_branch,) is available.		 source code
 
listAllPackages(self, get_scope=False, order_by=None, branch=None, branch_operator='=') source code
 
listAllInjectedPackages(self, justFiles=False) source code
 
listAllCounters(self, onlycounters=False, branch=None, branch_operator='=') source code
 
listAllIdpackages(self, branch=None, branch_operator='=', order_by=None) source code
 
listAllDependencies(self, only_deps=False) source code
 
listAllBranches(self) source code
 
listIdPackagesInIdcategory(self, idcategory, order_by='atom') source code
 
listIdpackageDependencies(self, idpackage) source code
 
listAllDownloads(self, do_sort=True, full_path=False) source code
 
listAllFiles(self, clean=False, count=False) source code
 
listAllCategories(self, order_by='') source code
 
listConfigProtectDirectories(self, mask=False) source code
 
switchBranch(self, idpackage, tobranch) source code
 
databaseStructureUpdates(self) source code
 
validateDatabase(self) source code
 
getIdpackagesDifferences(self, foreign_idpackages) source code
 
uniformBranch(self, branch) source code
 
alignDatabases(self, dbconn, force=False, output_header=' ', align_limit=300) source code
 
checkDatabaseApi(self) source code
 
doDatabaseImport(self, dumpfile, dbfile) source code
 
doDatabaseExport(self, dumpfile, gentle_with_tables=True, exclude_tables=None) source code
 
listAllTables(self) source code
 
doesTableExist(self, table) source code
 
doesColumnInTableExist(self, table, column) source code
 
database_checksum(self, do_order=False, strict=True, strings=False) source code
 
updateInstalledTableSource(self, idpackage, source) source code
 
addPackageToInstalledTable(self, idpackage, repoid, source=0) source code
 
retrievePackageFromInstalledTable(self, idpackage) source code
 
removePackageFromInstalledTable(self, idpackage) source code
 
removePackageFromDependsTable(self, idpackage) source code
 
createDependsTable(self) source code
 
sanitizeDependsTable(self) source code
 
isDependsTableSane(self) source code
 
createXpakTable(self) source code
 
storeXpakMetadata(self, idpackage, blob) source code
 
retrieveXpakMetadata(self, idpackage) source code
dict
retrieveBranchMigration(self, to_branch)
This method returns branch migration metadata stored in Entropy Client database (installed packages database).		 source code
 
dropContent(self) source code
 
dropAllIndexes(self) source code
 
listAllIndexes(self, only_entropy=True) source code
 
createAllIndexes(self) source code
 
createPackagesetsIndex(self) source code
 
createNeededlibraryidpackagesIndex(self) source code
 
createNeededlibrarypathsIndex(self) source code
 
createAutomergefilesIndex(self) source code
 
createNeededIndex(self) source code
 
createMessagesIndex(self) source code
 
createCompileFlagsIndex(self) source code
 
createUseflagsIndex(self) source code
 
dropContentIndex(self, only_file=False) source code
 
createContentIndex(self) source code
 
createConfigProtectReferenceIndex(self) source code
 
createBaseinfoIndex(self) source code
 
createLicensedataIndex(self) source code
 
createLicensesIndex(self) source code
 
createCategoriesIndex(self) source code
 
createKeywordsIndex(self) source code
 
createDependenciesIndex(self) source code
 
createCountersIndex(self) source code
 
createSourcesIndex(self) source code
 
createProvideIndex(self) source code
 
createConflictsIndex(self) source code
 
createExtrainfoIndex(self) source code
 
createEclassesIndex(self) source code
 
regenerateCountersTable(self, vdb_path, output=False) source code
 
clearTreeupdatesEntries(self, repository) source code
 
resetTreeupdatesDigests(self) source code
 
migrateCountersTable(self) source code
 
createNeededlibrarypathsTable(self) source code
 
createNeededlibraryidpackagesTable(self) source code
 
createInstalledTableSource(self) source code
 
createPackagechangelogsTable(self) source code
 
createAutomergefilesTable(self) source code
 
createPackagesignaturesTable(self) source code
 
createPackagespmphases(self) source code
 
createEntropyBranchMigrationTable(self) source code
 
createPackagesetsTable(self) source code
 
createCategoriesdescriptionTable(self) source code
 
createTreeupdatesTable(self) source code
 
createLicensedataTable(self) source code
 
createLicensesAcceptedTable(self) source code
 
createInstalledTable(self) source code
 
addDependsRelationToDependsTable(self, iterable) source code
 
clearDependsTable(self) source code
 
regenerateDependsTable(self, output=True) source code
 
regenerateLibrarypathsidpackageTable(self, output=True) source code
 
moveCountersToBranch(self, to_branch, from_branch=None) source code
 
atomMatchFetchCache(self, *args) source code
 
atomMatchStoreCache(self, *args, **kwargs) source code
 
atomMatchValidateCache(self, cached_obj, multiMatch, extendedResults) source code
 
idpackageValidator(self, idpackage, live=True) source code
 
packagesFilter(self, results) source code
 
atomMatch(self, atom, caseSensitive=True, matchSlot=None, multiMatch=False, matchBranches=(), matchTag=None, matchUse=(), packagesFilter=True, matchRevision=None, extendedResults=False, useCache=True) source code
Method Details

__init__(self, readOnly=False, noUpload=False, dbFile=None, clientDatabase=False, xcache=False, dbname='etpdb:', indexing=True, OutputInterface=None, ServiceInterface=None, skipChecks=False, useBranch=None, lockRemote=True)
(Constructor)

source code 

EntropyRepository constructor.

Parameters:
  • readOnly (bool) - open file in read-only mode
  • noUpload (bool) - server-side setting for not allowing database uploads when remote revision is lower than local
  • dbFile (string) - path to database to open
  • clientDatabase (bool) - state that EntropyRepository instance is a client-side one
  • xcache (bool) - enable on-disk cache
  • dbname (string) - EntropyRepository instance identifier
  • indexing (bool) - enable database indexes
  • OutputInterface (entropy.output.TextInterface based instance) - interface used to communicate with the user. must inherit entropy.output.TextInterface
  • ServiceInterface (Python class instance) - any class instance that could be useful when writing custom routines
  • skipChecks (bool) - if True, skip integrity checks
  • useBranch (string) - if True, it won't use SystemSettings' branch setting but rather the one provided
  • lockRemote (bool) - determine whether remote server-side database should be locked when updating the local version

setCacheSize(self, size)

source code 

Change low-level, storage engine based cache size.

Parameters:
  • size (int) - new size

setDefaultCacheSize(self, size)

source code 

Change default low-level, storage engine based cache size.

Parameters:
  • size (int) - new default size

closeDB(self)

source code 

Close repository storage communication. Note: once issues this, you won't be able to use such instance anymore.

isBranchMigrationAvailable(self, repository, from_branch, to_branch)

source code 

Returns whether branch migration metadata given by the provided key (repository, from_branch, to_branch,) is available.

Parameters:
  • repository (string) - repository identifier
  • from_branch (string) - original branch
  • to_branch (string) - destination branch
Returns: tuple
tuple composed by (1)post migration script md5sum and (2)post upgrade script md5sum

retrieveBranchMigration(self, to_branch)

source code 

This method returns branch migration metadata stored in Entropy Client database (installed packages database). It is used to determine whether to run per-repository branch migration scripts.

Parameters:
  • to_branch (string) - usually the current branch string
Returns: dict
branch migration metadata contained in database

   Home       Trees       Indices       Help   
Entropy Framework
Generated by Epydoc 3.0.1 on Sun Jul 19 08:06:40 2009 http://epydoc.sourceforge.net