292 lines
9.3 KiB
Python
292 lines
9.3 KiB
Python
import os
|
|
import sqlite3
|
|
|
|
HASH_TYPE_MD5 = 0 # 16 bytes long
|
|
HASH_TYPE_SHA1 = 1 # 20 bytes long
|
|
HASH_TYPE_SHA256 = 2 # 32 bytes long
|
|
HASH_TYPE_SHA512 = 3 # 64 bytes long
|
|
|
|
# Please feel free to use this file however you wish.
|
|
# None of this is thread-safe, though, so don't try to do anything clever.
|
|
|
|
|
|
# If you want to make a new tag archive for use in hydrus, you want to do something like:
|
|
|
|
# import HydrusTagArchive
|
|
# hta = HydrusTagArchive.HydrusTagArchive( 'my_little_archive.db' )
|
|
# hta.SetHashType( HydrusTagArchive.HASH_TYPE_MD5 )
|
|
# hta.BeginBigJob()
|
|
# for ( hash, tags ) in my_complex_mappings_generator: hta.AddMappings( hash, tags )
|
|
# -or-
|
|
# for ( hash, tag ) in my_simple_mapping_generator: hta.AddMapping( hash, tag )
|
|
# hta.CommitBigJob()
|
|
# del hta
|
|
|
|
|
|
# If you are only adding a couple tags, you can exclude the BigJob stuff. It just makes millions of sequential writes more efficient.
|
|
|
|
|
|
# Also, this manages hashes as bytes, not hex, so if you have something like:
|
|
|
|
# hash = ab156e87c5d6e215ab156e87c5d6e215
|
|
|
|
# Then go hash = hash.decode( 'hex' ) before you pass it to Add/Get/Has/SetMappings
|
|
|
|
|
|
# If you have tags that are namespaced like hydrus (e.g. series:ghost in the shell), then check out:
|
|
# GetNamespaces
|
|
# DeleteNamespaces
|
|
# and
|
|
# RebuildNamespaces
|
|
|
|
# RebuildNamespaces takes namespaces_to_exclude, if you want to curate your namespaces a little better.
|
|
|
|
# If your GetNamespaces gives garbage, then just hit DeleteNamespaces. I'll be using the result of GetNamespaces to populate
|
|
# the advanced tag options widget when people sync with these archives.
|
|
|
|
|
|
# And also feel free to contact me directly at hydrus.admin@gmail.com if you need help.
|
|
|
|
class HydrusTagArchive( object ):
|
|
|
|
def __init__( self, path ):
|
|
|
|
self._path = path
|
|
|
|
if not os.path.exists( self._path ): create_db = True
|
|
else: create_db = False
|
|
|
|
self._InitDBCursor()
|
|
|
|
if create_db: self._InitDB()
|
|
|
|
self._namespaces = { namespace for ( namespace, ) in self._c.execute( 'SELECT namespace FROM namespaces;' ) }
|
|
self._namespaces.add( '' )
|
|
|
|
|
|
def _AddMappings( self, hash_id, tag_ids ):
|
|
|
|
self._c.executemany( 'INSERT OR IGNORE INTO mappings ( hash_id, tag_id ) VALUES ( ?, ? );', ( ( hash_id, tag_id ) for tag_id in tag_ids ) )
|
|
|
|
|
|
def _InitDB( self ):
|
|
|
|
self._c.execute( 'CREATE TABLE hash_type ( hash_type INTEGER );', )
|
|
|
|
self._c.execute( 'CREATE TABLE hashes ( hash_id INTEGER PRIMARY KEY, hash BLOB_BYTES );' )
|
|
self._c.execute( 'CREATE UNIQUE INDEX hashes_hash_index ON hashes ( hash );' )
|
|
|
|
self._c.execute( 'CREATE TABLE mappings ( hash_id INTEGER, tag_id INTEGER, PRIMARY KEY( hash_id, tag_id ) );' )
|
|
self._c.execute( 'CREATE INDEX mappings_hash_id_index ON mappings ( hash_id );' )
|
|
|
|
self._c.execute( 'CREATE TABLE namespaces ( namespace TEXT );' )
|
|
|
|
self._c.execute( 'CREATE TABLE tags ( tag_id INTEGER PRIMARY KEY, tag TEXT );' )
|
|
self._c.execute( 'CREATE UNIQUE INDEX tags_tag_index ON tags ( tag );' )
|
|
|
|
|
|
def _InitDBCursor( self ):
|
|
|
|
self._db = sqlite3.connect( self._path, isolation_level = None, detect_types = sqlite3.PARSE_DECLTYPES )
|
|
|
|
self._c = self._db.cursor()
|
|
|
|
|
|
def _GetHashId( self, hash, read_only = False ):
|
|
|
|
result = self._c.execute( 'SELECT hash_id FROM hashes WHERE hash = ?;', ( sqlite3.Binary( hash ), ) ).fetchone()
|
|
|
|
if result is None:
|
|
|
|
if read_only: raise Exception()
|
|
|
|
self._c.execute( 'INSERT INTO hashes ( hash ) VALUES ( ? );', ( sqlite3.Binary( hash ), ) )
|
|
|
|
hash_id = self._c.lastrowid
|
|
|
|
else: ( hash_id, ) = result
|
|
|
|
return hash_id
|
|
|
|
|
|
def _GetTagId( self, tag ):
|
|
|
|
if ':' in tag:
|
|
|
|
( namespace, subtag ) = tag.split( ':', 1 )
|
|
|
|
if namespace != '' and namespace not in self._namespaces:
|
|
|
|
self._c.execute( 'INSERT INTO namespaces ( namespace ) VALUES ( ? );', ( namespace, ) )
|
|
|
|
self._namespaces.add( namespace )
|
|
|
|
|
|
|
|
result = self._c.execute( 'SELECT tag_id FROM tags WHERE tag = ?;', ( tag, ) ).fetchone()
|
|
|
|
if result is None:
|
|
|
|
self._c.execute( 'INSERT INTO tags ( tag ) VALUES ( ? );', ( tag, ) )
|
|
|
|
tag_id = self._c.lastrowid
|
|
|
|
else: ( tag_id, ) = result
|
|
|
|
return tag_id
|
|
|
|
|
|
def BeginBigJob( self ): self._c.execute( 'BEGIN IMMEDIATE' )
|
|
|
|
def CommitBigJob( self ):
|
|
|
|
self._c.execute( 'COMMIT' )
|
|
self._c.execute( 'VACUUM' )
|
|
|
|
|
|
def AddMapping( self, hash, tag ):
|
|
|
|
hash_id = self._GetHashId( hash )
|
|
tag_id = self._GetTagId( tag )
|
|
|
|
self._c.execute( 'INSERT OR IGNORE INTO mappings ( hash_id, tag_id ) VALUES ( ?, ? );', ( hash_id, tag_id ) )
|
|
|
|
|
|
def AddMappings( self, hash, tags ):
|
|
|
|
hash_id = self._GetHashId( hash )
|
|
|
|
tag_ids = [ self._GetTagId( tag ) for tag in tags ]
|
|
|
|
self._AddMappings( hash_id, tag_ids )
|
|
|
|
|
|
def DeleteMapping( self, hash, tag ):
|
|
|
|
hash_id = self._GetHashId( hash )
|
|
tag_id = self._GetTagId( tag )
|
|
|
|
self._c.execute( 'DELETE FROM mappings WHERE hash_id = ? AND tag_id = ?;', ( hash_id, tag_id ) )
|
|
|
|
|
|
def DeleteMappings( self, hash ): self.DeleteTags( hash )
|
|
|
|
def DeleteTags( self, hash ):
|
|
|
|
try: hash_id = self._GetHashId( hash, read_only = True )
|
|
except: return
|
|
|
|
self._c.execute( 'DELET FROM mappings WHERE hash_id = ?;', ( hash_id, ) )
|
|
|
|
|
|
def DeleteNamespaces( self ):
|
|
|
|
self._namespaces = {}
|
|
self._namespaces.add( '' )
|
|
|
|
self._c.execute( 'DELETE FROM namespaces;' )
|
|
|
|
|
|
def GetHashType( self ):
|
|
|
|
try: ( hash_type, ) = self._c.execute( 'SELECT hash_type FROM hash_type;' ).fetchone()
|
|
except:
|
|
|
|
try:
|
|
|
|
( hash, ) = self._c.execute( 'SELECT hash FROM hashes;' ).fetchone()
|
|
|
|
if len( hash ) == 16: self.SetHashType( HASH_TYPE_MD5 )
|
|
elif len( hash ) == 20: self.SetHashType( HASH_TYPE_SHA1 )
|
|
elif len( hash ) == 32: self.SetHashType( HASH_TYPE_SHA256 )
|
|
elif len( hash ) == 64: self.SetHashType( HASH_TYPE_SHA512 )
|
|
else: raise Exception()
|
|
|
|
return self.GetHashType()
|
|
|
|
except: raise Exception( 'This archive has no hash type set, and as it has no files, no hash type guess can be made.' )
|
|
|
|
|
|
return hash_type
|
|
|
|
|
|
def GetMappings( self, hash ): return self.GetTags( hash )
|
|
|
|
def GetNamespaces( self ): return self._namespaces
|
|
|
|
def GetTags( self, hash ):
|
|
|
|
try: hash_id = self._GetHashId( hash, read_only = True )
|
|
except: return []
|
|
|
|
result = { tag for ( tag, ) in self._c.execute( 'SELECT tag FROM mappings, tags USING ( tag_id ) WHERE hash_id = ?;', ( hash_id, ) ) }
|
|
|
|
return result
|
|
|
|
|
|
def HasHash( self, hash ):
|
|
|
|
try:
|
|
|
|
hash_id = self._GetHashId( hash, read_only = True )
|
|
|
|
return True
|
|
|
|
except: return False
|
|
|
|
|
|
def IterateMappings( self ):
|
|
|
|
hash_ids = [ hash_id for ( hash_id, ) in self._c.execute( 'SELECT hash_id FROM hashes;' ) ]
|
|
|
|
for hash_id in hash_ids:
|
|
|
|
( hash, ) = self._c.execute( 'SELECT hash FROM hashes WHERE hash_id = ?;', ( hash_id, ) ).fetchone()
|
|
|
|
tags = self.GetTags( hash )
|
|
|
|
if len( tags ) > 0: yield ( hash, tags )
|
|
|
|
|
|
|
|
def RebuildNamespaces( self, namespaces_to_exclude = set() ):
|
|
|
|
self._namespaces = set()
|
|
self._namespaces.add( '' )
|
|
|
|
self._c.execute( 'DELETE FROM namespaces;' )
|
|
|
|
for ( tag, ) in self._c.execute( 'SELECT tag FROM tags;' ):
|
|
|
|
if ':' in tag:
|
|
|
|
( namespace, subtag ) = tag.split( ':', 1 )
|
|
|
|
if namespace != '' and namespace not in self._namespaces and namespace not in namespaces_to_exclude:
|
|
|
|
self._namespaces.add( namespace )
|
|
|
|
|
|
|
|
|
|
self._c.executemany( 'INSERT INTO namespaces ( namespace ) VALUES ( ? );', ( ( namespace, ) for namespace in self._namespaces ) )
|
|
|
|
|
|
def SetHashType( self, hash_type ):
|
|
|
|
self._c.execute( 'DELETE FROM hash_type;' )
|
|
|
|
self._c.execute( 'INSERT INTO hash_type ( hash_type ) VALUES ( ? );', ( hash_type, ) )
|
|
|
|
|
|
def SetMappings( self, hash, tags ):
|
|
|
|
hash_id = self._GetHashId( hash )
|
|
|
|
self._c.execute( 'DELETE FROM mappings WHERE hash_id = ?;', ( hash_id, ) )
|
|
|
|
tag_ids = [ self._GetTagId( tag ) for tag in tags ]
|
|
|
|
self._AddMappings( hash_id, tag_ids )
|
|
|
|
|