Skip to content
Back to top
View this page

# flufl.bounce - Email bounce detectors

This package is called `flufl.bounce`, an email bounce detection library.

The `flufl.bounce` library provides a set of heuristic detectors for discerning the original bouncing email address from a bounce message. Many formats found in the wild are supported, as are VERP and RFC 3464 (DSN). It also provides an API for extension with your own detector formats.

## Requirements

`flufl.bounce` requires Python 3.10 or newer.

## Documentation

A simple guide to using the library is available within this package, along with a detailed API reference.

## Project details

> - Project home: https://gitlab.com/flufl/flufl.bounce

> - Report bugs at: https://gitlab.com/flufl/flufl.bounce/issues

> - Code hosting: https://gitlab.com/flufl/flufl.bounce.git

> - Documentation: http://fluflbounce.readthedocs.io/

You can contact the author via barry@python.org.

## Copyright

Copyright (C) 2004-2026 Barry A. Warsaw

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

> http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

## Table of Contents

- Index

- Using the flufl.bounce library
  - Basic usage
- API Reference
  - Top-level functions
    - `scan_message()`
    - `all_failures()`
  - Detector interfaces
    - `BounceDetector`
      - `BounceDetector.__init__()`
      - `BounceDetector.process()`
- NEWS for flufl.bounce
  - 5.0.1 (2026-05-21)
  - 5.0 (2026-05-20)
  - 4.0 (2021-06-16)
  - 3.0.2 (2021-02-09)
  - 3.0.1 (2020-01-17)
  - 3.0 (2017-02-17)
  - 2.3 (2014-08-18)
  - 2.2.1 (2013-06-21)
  - 2.2 (2013-06-20)
  - 2.1.1 (2012-04-19)
  - 2.1 (2012-01-19)
  - 2.0 (2012-01-04)
  - 1.0.2 (2011-10-10)
  - 1.0.1 (2011-10-07)
  - 1.0 (2011-08-22)
  - 0.91 (2011-07-15)
  - 0.90 (2011-07-02)