https://github.com/gumblex/fossilpy

Simple python library for reading Fossil repositories
https://github.com/gumblex/fossilpy

fossil-scm

Last synced: about 2 months ago
JSON representation

Simple python library for reading Fossil repositories

• Host: GitHub
• URL: https://github.com/gumblex/fossilpy
• Owner: gumblex
• License: bsd-2-clause
• Created: 2017-07-02T15:27:37.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-12-27T00:39:43.000Z (about 5 years ago)
• Last Synced: 2024-11-03T08:52:06.547Z (2 months ago)
• Topics: fossil-scm
• Language: Python
• Size: 10.7 KB
• Stars: 6
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
fossilpy

========

Simple pure-python library for reading Fossil repositories.

.. code-block:: pycon

   >>> 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.

Install `python-fossil-delta` for better performance.

API

---

Classes

~~~~~~~

- **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.

  - StructuralArtifact.\ **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)

Misc.

~~~~~

- **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.