## MemoryBackend


A memory backend records each submission instead of sending it.


Usage

``` python
MemoryBackend(
    *,
    from_address="epistole@example.invalid",
    refuse=None,
)
```


See ADR-0015 for its design.


## Parameters


`refuse: Mapping[str, Refusal] | None = None`  
Maps an address to the refusal it gets, matched by addr-spec. A key that is not an address raises here, rather than never matching.


## Attributes


`submissions: list[Submission]`  
Every submission at least one recipient accepted, from every connection, in the order the submits completed. Reset it with `list.clear()`.


## Examples

``` python
from epistole import MemoryBackend, Message, Refusal

backend = MemoryBackend(from_address="reports@example.com")
backend.send(Message(text="Weekly numbers").to("ada@example.com"))

backend.submissions[0].message.to_  # ("ada@example.com",)
backend.submissions[0].from_address  # "reports@example.com"
```

Refuse one recipient, and the backend accepts the rest, as SMTP does:

``` python
backend = MemoryBackend(refuse={"ada@example.com": Refusal(550, "No such mailbox")})
result = backend.send(
    Message(text="Weekly numbers").to("ada@example.com", "bob@example.com")
)

result.refused  # {"ada@example.com": Refusal(code=550, reason="No such mailbox")}
```


## Attributes

| Name | Description |
|----|----|
| [submissions](#submissions) | Return the list every connection appends to, which has no setter because an open connection would keep appending to the old one (ADR-0005). |

------------------------------------------------------------------------


#### submissions


Return the list every connection appends to, which has no setter because an open connection would keep appending to the old one (ADR-0005).


`submissions: list[Submission]`