Skip to content

Commit ec8732a

Browse files
committed
docs: remove generated docs
1 parent 001dfb6 commit ec8732a

4 files changed

Lines changed: 12 additions & 101 deletions

File tree

.github/workflows/release.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ name: release
33
on:
44
push:
55
tags:
6-
- 'imap-codec/v*'
7-
- 'imap-types/v*'
6+
- 'smtp-codec/v*'
7+
- 'smtp-types/v*'
88

99
jobs:
1010
release:

CHANGELOG.md

Lines changed: 0 additions & 33 deletions
This file was deleted.

README.md

Lines changed: 9 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,13 @@
1-
# smtp-{codec,types}
1+
[![CI](https://github.com/duesee/smtp-codec/actions/workflows/ci.yml/badge.svg)](https://github.com/duesee/smtp-codec/actions/workflows/ci.yml)
2+
[![Scheduled](https://github.com/duesee/smtp-codec/actions/workflows/scheduled.yml/badge.svg)](https://github.com/duesee/smtp-codec/actions/workflows/scheduled.yml)
3+
[![docs](https://docs.rs/smtp-codec/badge.svg)](https://docs.rs/smtp-codec)
24

3-
This workspace contains `smtp-codec` and `smtp-types`, two crates for building SMTP clients and servers following [RFC 5321].
5+
# smtp-codec
46

5-
`smtp-codec` provides parsing and serialization, and is based on `smtp-types`.
6-
`smtp-types` provides misuse-resistant types, constructors, and general support for SMTP implementations.
7+
This library provides parsing, serialization, and support for SMTP implementations.
8+
It is based on `smtp-types` and aims to become a rock-solid building block for SMTP client and server implementations in Rust.
9+
Many things are there, but `smtp-codec` is still in a rough state.
710

8-
## Features
11+
# License
912

10-
* Complete formal syntax of SMTP is implemented following RFC 5321
11-
* Several SMTP extensions are supported (AUTH, SIZE, 8BITMIME, PIPELINING, STARTTLS, SMTPUTF8, ENHANCEDSTATUSCODES)
12-
* Correctness and misuse-resistance are enforced on the type level
13-
* Comprehensive test coverage
14-
15-
## Usage
16-
17-
```rust
18-
use smtp_codec::{decode::Decoder, encode::Encoder, CommandCodec, GreetingCodec};
19-
20-
// Parse a greeting
21-
let input = b"220 mail.example.com ESMTP ready\r\n";
22-
let (remaining, greeting) = GreetingCodec::default().decode(input).unwrap();
23-
println!("Domain: {}", greeting.domain);
24-
25-
// Encode a command
26-
use smtp_codec::smtp_types::command::Command;
27-
let cmd = Command::quit();
28-
let bytes = CommandCodec::default().encode(&cmd);
29-
assert_eq!(bytes.dump(), b"QUIT\r\n");
30-
```
31-
32-
## Supported Extensions
33-
34-
| Feature | Description | RFC |
35-
|-------------------------|------------------------------------------|----------|
36-
| starttls | SMTP over TLS | RFC 3207 |
37-
| ext_auth | SMTP Authentication | RFC 4954 |
38-
| ext_size | Message Size Declaration | RFC 1870 |
39-
| ext_8bitmime | 8-bit MIME Transport | RFC 6152 |
40-
| ext_pipelining | Command Pipelining | RFC 2920 |
41-
| ext_smtputf8 | Internationalized Email | RFC 6531 |
42-
| ext_enhancedstatuscodes | Enhanced Error Codes | RFC 2034 |
43-
44-
## License
45-
46-
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
47-
48-
[RFC 5321]: https://tools.ietf.org/html/rfc5321
13+
This crate is dual-licensed under Apache 2.0 and MIT terms.

justfile

Lines changed: 1 addition & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -46,33 +46,12 @@ cargo_hack mode: install_cargo_hack
4646
--no-dev-deps \
4747
--exclude-features default \
4848
--feature-powerset \
49-
--group-features \
50-
arbitrary,\
51-
serde \
52-
--group-features \
53-
starttls,\
54-
ext_auth,\
55-
ext_size,\
56-
ext_8bitmime,\
57-
ext_pipelining,\
58-
ext_smtputf8,\
59-
ext_enhancedstatuscodes,\
60-
quirk_crlf_relaxed\
6149
{{ mode }}
6250
cargo hack check -p smtp-types \
6351
--no-dev-deps \
6452
--feature-powerset \
6553
--group-features \
66-
arbitrary,\
67-
serde \
68-
--group-features \
69-
starttls,\
70-
ext_auth,\
71-
ext_size,\
72-
ext_8bitmime,\
73-
ext_pipelining,\
74-
ext_smtputf8,\
75-
ext_enhancedstatuscodes\
54+
serde\
7655
{{ mode }}
7756

7857
[private]

0 commit comments

Comments
 (0)