Skip to main content

Gentoo Manifest Tool -- a utility to verify and update Manifest files

Project description

Author:

Michał Górny

License:

2-clause BSD license

Introduction

gemato provides a reference implementation of the full-tree Manifest checks as specified in GLEP 74 [1]. Originally focused on verifying the integrity and authenticity of the Gentoo ebuild repository, the tool can be used as a generic checksumming tool for any directory trees.

Usage

Verification

The basic purpose of gemato is to verify a directory tree against Manifest files. In order to do that, run the gemato verify tool against the requested directory:

gemato verify /var/db/repos/gentoo

The tool will automatically locate the top-level Manifest (if any) and check the specified directory recursively. If a subdirectory of the Manifest tree is specified, only the specified leaf is checked.

Creating new Manifest tree

Creating a new Manifest tree can be accomplished using the gemato create command against the top directory of the new Manifest tree:

gemato create -p ebuild /var/db/repos/gentoo

Note that for the create command you always need to specify either a profile (via -p) or at least a hash set (via -H).

Updating existing Manifests

The gemato update command is provided to update an existing Manifest tree:

gemato update -p ebuild /var/db/repos/gentoo

Alike create, update also requires specifying a profile (-p) or a hash set (-H). The command locates the appropriate top-level Manifest and updates the specified directory recursively. If a subdirectory of the Manifest tree is specified, the entries for the specified leaf and respective Manifest files are updated.

Utility commands

gemato provides a few other utility commands that provide access to its crypto backend. These are:

gemato hash -H <hashes> [<path>...]

Print hashes of the specified files in Manifest-like format.

gemato openpgp-verify [-K <key>] [<path>...]

Check OpenPGP cleartext signatures embedded in the specified files.

gemato openpgp-verify-detached [-K <key>] <sig-file> <data-file>

Verify the specified data file against a detached OpenPGP signature.

Requirements

gemato is written in Python and compatible with implementations of Python 3.9+. gemato is currently tested against CPython 3.9 through 3.11 and PyPy3. gemato core depends only on standard Python library modules.

Additionally, OpenPGP requires system install of GnuPG 2.2+ and requests Python module. Tests require pytest, and responses for mocking.

References and footnotes

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gemato-20.6.tar.gz (87.4 kB view details)

Uploaded Source

Built Distribution

gemato-20.6-py3-none-any.whl (51.6 kB view details)

Uploaded Python 3

File details

Details for the file gemato-20.6.tar.gz.

File metadata

  • Download URL: gemato-20.6.tar.gz
  • Upload date:
  • Size: 87.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for gemato-20.6.tar.gz
Algorithm Hash digest
SHA256 c63d3dfb707cd71b6c3531b82da29e126584627848ef62b28fbb16790ce3c559
MD5 adad364958459a0bea3020cdd086ebd2
BLAKE2b-256 b703409d9d5578e8cf9bb6aea43d12faa882bfec213101ed24676c98a0d7b93e

See more details on using hashes here.

File details

Details for the file gemato-20.6-py3-none-any.whl.

File metadata

  • Download URL: gemato-20.6-py3-none-any.whl
  • Upload date:
  • Size: 51.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for gemato-20.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4c9217d0efe5d7ef23662c686e6e86172a3efff5fd69d5b11cc053179b77ee0a
MD5 3b77eaaf957f4d65097d04a91a9f9917
BLAKE2b-256 b43b978d77aee2f5207c7aa6f2178f5a52af4fe652d2317b0fd525cbeea016fe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page