mirror of
https://github.com/foxcpp/maddy.git
synced 2025-04-05 22:17:39 +03:00
305fdddf24
It is useful to define background tasks lifetimes more precisely, especially involving timeouts and other cancellation methods. On top of that, several tracing facilities are context-based (e.g. runtime/trace), so it is possible to use them now.
40 lines
1.5 KiB
Go
40 lines
1.5 KiB
Go
package module
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/emersion/go-message/textproto"
|
|
"github.com/foxcpp/maddy/internal/buffer"
|
|
)
|
|
|
|
// StatusCollector is an object that is passed by message source
|
|
// that is interested in intermediate status reports about partial
|
|
// delivery failures.
|
|
type StatusCollector interface {
|
|
// SetStatus sets the error associated with the recipient.
|
|
//
|
|
// rcptTo should match exactly the value that was passed to the
|
|
// AddRcpt, i.e. if any translations was made by the target,
|
|
// they should not affect the rcptTo argument here.
|
|
//
|
|
// It should not be called multiple times for the same
|
|
// value of rcptTo. It also should not be called
|
|
// after BodyNonAtomic returns.
|
|
//
|
|
// SetStatus is goroutine-safe. Implementations
|
|
// provide necessary serialization.
|
|
SetStatus(rcptTo string, err error)
|
|
}
|
|
|
|
// PartialDelivery is an optional interface that may be implemented
|
|
// by the object returned by DeliveryTarget.Start. See PartialDelivery.BodyNonAtomic
|
|
// documentation for details.
|
|
type PartialDelivery interface {
|
|
// BodyNonAtomic is similar to Body method of the regular Delivery interface
|
|
// with the except that it allows target to reject the body only for some
|
|
// recipients by setting statuses using passed collector object.
|
|
//
|
|
// This interface is preferred by the LMTP endpoint and queue implementation
|
|
// to ensure correct handling of partial failures.
|
|
BodyNonAtomic(ctx context.Context, c StatusCollector, header textproto.Header, body buffer.Buffer)
|
|
}
|