neco-base64 0.1.0

zero dependency Base64 encoder and decoder
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# neco-base64

[Japanese](README-ja.md)

A zero-dependency Base64 encoder and decoder supporting standard and URL-safe alphabets.

## Usage

```rust
use neco_base64::{encode, decode, encode_url, decode_url};

let encoded = encode(b"hello");       // "aGVsbG8="
let decoded = decode("aGVsbG8=").unwrap(); // b"hello"

let url_encoded = encode_url(b"hello");         // "aGVsbG8"
let url_decoded = decode_url("aGVsbG8").unwrap(); // b"hello"
```

## API

### Encode

| Function | Description |
|----------|-------------|
| `encode(input: &[u8]) -> String` | Standard Base64 with padding |
| `encode_url(input: &[u8]) -> String` | URL-safe Base64, no padding |
| `encode_url_padded(input: &[u8]) -> String` | URL-safe Base64 with padding |

### Decode

| Function | Description |
|----------|-------------|
| `decode(input: &str) -> Result<Vec<u8>, Base64Error>` | Standard Base64 (padding optional) |
| `decode_url(input: &str) -> Result<Vec<u8>, Base64Error>` | URL-safe Base64 (padding optional) |
| `decode_url_strict(input: &str) -> Result<Vec<u8>, Base64Error>` | URL-safe, rejects padding chars and non-zero trailing bits |

### Error

```rust
pub enum Base64Error {
    InvalidCharacter,
    InvalidLength,
    NonZeroPaddingBits,
}
```

## License

MIT