/followmail

Postfix log parser to follow a mail address

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

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
-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 archived log

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

     followmail -f other@example.com -t other2@example.com -D
  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!