Skip to main content

A simple library to write content to public-inbox repositories

Project description

This is a very simple library that allows writing to public-inbox v2 repositories. Note, that this is not a suitable replacement for public-inbox in itself – the goal is merely to provide a way to write public-inbox repositories that can be cloned, indexed and served from an actual public-inbox server running elsewhere.

What it does:

  • provides a way to add RFC2822 messages to a git repository in a way that is compatible with public-inbox

What it doesn’t do:

  • anything else

What it may do in the future:

  • epoch support (optionally, since we want to allow people to publish these to places that only do single-level repos, like GitHub

For the public-inbox v2 format, see:

Requirements

The git command must exist and be in your path.

Installing

Install from pypi:

pip install ezpi

Library usage

This is the simplest usage example:

from email.message import EmailMessage
from ezpi import add_rfc822

msg = EmailMessage()
msg.set_content('Hello world!')
# We must have a Subject: and From: headers at least, in order
# to make a useful git commit with that data
msg['Subject'] = 'My excellent subject'
msg['From'] = 'E.X. Ample <example@example.com'>
# We won't create the repo for you, so run "git init --bare" first
add_rfc822('example.git', msg)

You can also pass bytes instead of an EmailMessage object, but we must be able to run message_from_bytes() on it.

ezpi command

We also provide an ezpi command:

usage: main.py [-h] [-r REPO] [-d] [-q] [-v] [--rfc822] [-f HDR_FROM] [-s HDR_SUBJ] [-p]
               [--domain DOMAIN]

optional arguments:
  -h, --help            show this help message and exit
  -r REPO, --repo REPO  Bare git repository where to write the commit (must exist) (default: None)
  -d, --dry-run         Do not write the commit, just show the commit that would be written. (default:
                        False)
  -q, --quiet           Only output errors to the stdout (default: False)
  -v, --verbose         Show debugging output (default: False)
  --rfc822              Treat stdin as an rfc822 message (default: False)
  -f HDR_FROM, --from HDR_FROM
                        From header for the message, if not using --rfc822 (default: None)
  -s HDR_SUBJ, --subject HDR_SUBJ
                        Subject header for the message, if not using --rfc822 (default: None)
  -p, --run-post-commit-hook
                        Run hooks/post-commit after a successful commit (if present) (default: False)
  --domain DOMAIN       Domain to use when creating message-ids (default: None)

Example:

ezpi -r path/to/example/git/0.git --rfc822 < valid.eml

How to delete messages?

Since every message is a separate commit to the git repository, deleting requires a git history rewrite. You will need to find the commit with the message you want to delete and perform operations directly on the git repository in order to delete that commit and rebase the ones that follow. Once it’s done, you will need to force-push the repository to wherever it is hosted.

Caution: if anyone is replicating your repository without –mirror, the history rewrite will result in an error the next time they do “git remote update”. Needless to say, they will be very interested in finding out what it is you just tried to delete, so use this as the last resort solution.

Problems? Patches?

Email ~monsieuricon/public-inbox@lists.sr.ht

(That’s a different kind of public-inbox. Unfortunately, there’s a name collision, but I believe public-inbox.org had that claimed earlier.)

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

ezpi-0.2.1.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

ezpi-0.2.1-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file ezpi-0.2.1.tar.gz.

File metadata

  • Download URL: ezpi-0.2.1.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.6

File hashes

Hashes for ezpi-0.2.1.tar.gz
Algorithm Hash digest
SHA256 1e3841d4ac2be69015ab98830876bbcca6b98b34c90a1866acefb63c17801938
MD5 b648126cc28126c086848e43a3b59695
BLAKE2b-256 bbb0ac0caf0f0ab6f27f1df83fbb3a08f6df4cde873008ad63b7378b62613c72

See more details on using hashes here.

File details

Details for the file ezpi-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: ezpi-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 6.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.6

File hashes

Hashes for ezpi-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8806985754f23b3f6e1aae74275852834ee361b284e34ecf1682aaf0dde6188a
MD5 67a91b0c4582202d806309af85f83422
BLAKE2b-256 f11d8b2af2a0c062925782b5799ec054ae53dfa9683dee137654988f78e076da

See more details on using hashes here.

Supported by

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