Simple python library for reading Fossil repositories
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Simple pure-python library for reading Fossil repositories.

>>> r = Repo('project.fossil')
>>> f = r.file(123)
>>> f.blob
b'File content...'
>>> filelist = r.manifest(124).F
>>> filelist
[('file', '1234567890aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa')]

This is a thin wrapper, and Fossil is an SQLite-based version control system. So using raw SQL (Repo.execute) may be necessary to get more information.

Writing, committing, or executing Fossil commands is not supported. (Although you can do SQL, writing is not recommended.) Reading the config database (~/.fossil), the checkout database (_FOSSIL_), or the checkout directory is also not supported.



  • Repo(repository, check=False, cachesize=64): Represents a Fossil repo. repository is the file name. check specifies whether to calculate checksum. If numpy is not installed, calculation will be much slower. cachesize specifies how much blobs should be cached, set to 0 to disable.
    • Repo.file(self, key): Returns a File according to the key, which is either the blob's rid or uuid (SHA1/SHA3-256).
    • Repo.manifest(self, key): Returns a StructuralArtifact according to the key.
    • Repo.artifact(self, key, type_=None): Returns an Artifact according to the key. type_ can be 'structural' or 'file'.
    • Repo.__getitem__(self, key): Returns an Artifact according to the key.
    • Repo.find_artifact(self, prefix): Given the uuid (SHA1/SHA3-256) prefix, returns a tuple (rid, uuid). If not found, raises a KeyError.
    • Repo.to_uuid(self, rid): Given the rid, returns the uuid of a blob. If not found, raises an IndexError.
    • Repo.to_rid(self, uuid): Given the uuid, returns the rid of a blob. If not found, raises an IndexError.
    • Repo.execute(self, sql, parameters=None): Execute raw SQL statements on the Fossil repo (SQLite database). See also src/schema.c.
  • Artifact(blob=None, rid=None, uuid=None): Represents a Fossil artifact, which is anything inside the blob table. Has attributes blob, rid and uuid. blob is the artifact(file) content.
  • File(blob=None, rid=None, uuid=None): Represents a file, same as Artifact.
  • StructuralArtifact(blob=None, rid=None, uuid=None): Represent a structural artifact, aka. manifest, can be such as check-in, wiki and tickets.
    • StructuralArtifact.keys(): List cards.
    • Dictionary of cards. If a card type can occur multiple times, cards of the same type are stored in a list.
    • Cards can be accessed like art.F, art['F'] or art.file. See also Fossil documentation. Some useful cards: F(file), C(comment), P(parent_artifact), U(user_login), D(datetime), W(wiki_text)


  • LRUCache(maxlen): A simple implementation of least recently used (LRU) cache.

Fossil uses Julian date in most tables.

  • julian_to_unix(t): Convert Julian date t to unix timestamp.
  • unix_to_julian(t): Convert unix timestamp t to Julian date.