Skip to main content

followmail

followmail is a command line utility that parse a postfix log file (also gzipped) and follow pathway of specific mail, in to or from fields.

Installation

To install followmail, follow this:

# With pypi
pip install followmail

# With git
git clone https://github.com/MatteoGuadrini/followmail.git && cd followmail
pip install .

Command arguments

followmail have many command line arguments. They are explained in this table:

short long description args
-v --verbose Print with verbosity
-t --to Email address into to field Mail address
-f --from Email address into from field Mail address
-l --maillog Input maillog file File path
-q --queue Name of postfix queue Name of queue
-m --max-lines Max lines to print Number
-D --sortby-date Sort lines by date
-Q --sortby-queue Sort lines by queue
-D --sortby-server Sort lines by server
-c --csv Print in csv format
-j --json Print in json format

Examples

  1. Search into to field the email other@example.com:

    followmail -t other@example.com
    
  2. Search into from field the email other@example.com:

    followmail -f other@example.com
    
  3. Search both from and to fields:

    followmail -f other@example.com -t other2@example.com
    
  4. Filter per queue

     followmail -f other@example.com -t other2@example.com -q "postfix/in"
    
  5. Select archived log

     followmail -f other@example.com -t other2@example.com -l "/var/log/maillog-20240709.tar.gz"
    
  6. Select max 20 max lines

     followmail -f other@example.com -t other2@example.com -m 20
    
  7. Sort results by date, queue or server

     followmail -f other@example.com -t other2@example.com -D
     followmail -f other@example.com -t other2@example.com -Q
     followmail -f other@example.com -t other2@example.com -S
    
  8. Print result in CSV format

     followmail -f other@example.com -t other2@example.com -c
    
  9. Print result in JSON format

     followmail -f other@example.com -t other2@example.com -j
    
  10. Debugging

     followmail -f other@example.com -t other2@example.com -v
    

Open source

followmail is an open source project. Any contribute, It's welcome.

A great thanks.

For donations, press this

For me

paypal

For Telethon

The Telethon Foundation is a non-profit organization recognized by the Ministry of University and Scientific and Technological Research. They were born in 1990 to respond to the appeal of patients suffering from rare diseases. Come today, we are organized to dare to listen to them and answers, every day of the year.

Adopt the future

Treeware

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Treeware

Acknowledgments

Thanks to Mark Lutz for writing the Learning Python and Programming Python books that make up my python foundation.

Thanks to Kenneth Reitz and Tanya Schlusser for writing the The Hitchhiker’s Guide to Python books.

Thanks to Dane Hillard for writing the Practices of the Python Pro books.

Special thanks go to my wife, who understood the hours of absence for this development. Thanks to my children, for the daily inspiration they give me and to make me realize, that life must be simple.

Thanks, Python!

Metadata

Release files for followmail 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for followmail 1.1.0
File Size Uploaded Provenance Actions
followmail-1.1.0.tar.gz 18.3 kB Without provenance Details for followmail-1.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for followmail 1.1.0
File Interpreter ABI Platform Actions
followmail-1.1.0-py3-none-any.whl Python 3 none any Details for followmail-1.1.0-py3-none-any.whl

Total release size: 36.9 kB

Release files / followmail-1.1.0.tar.gz

Download URL followmail-1.1.0.tar.gz
Size 18.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e5c2c0efbe65b177b6a6d3f796c3761a879da0ee3b6d03833d54639f07d71550
BLAKE2b-256 checksum
How to use checksums
7f86820b802b651b0a7a89c2fc9fc78661005cb7115b19a7bbd02dbadfed7308
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / followmail-1.1.0-py3-none-any.whl

Download URL followmail-1.1.0-py3-none-any.whl
Size 18.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ee4e2d412a044df078f8d539e461daa831a59d12c03e31725d186d2be954b46e
BLAKE2b-256 checksum
How to use checksums
75a03f0e75a774692ce38ec5f64117ef82c63c1c37acb1823203584f283515da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Security for followmail 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page