http-date 0.2.0

Parsing and formatting of HTTP date values (RFC 9110)
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# http-date development recipes.
# Requires `just`, and `nix` for the fuzzing recipes.

# List available recipes.
default:
    @just --list

# Run the test suite with cargo-nextest (included in the nix dev shell).
test:
    cargo nextest run --all-targets --all-features

# Type-check the crate (lib, integration tests, and doctests).
check:
    cargo check --all-targets --all-features

# Lint with clippy; the crate enables `all` and `pedantic` lints, and this
# recipe fails on any warning so it is CI-friendly.
lint:
    cargo clippy --all-targets --all-features -- -D warnings

# Format the code with rustfmt.
fmt:
    cargo fmt

# Verify the code is formatted without modifying it (for CI).
fmt-check:
    cargo fmt --check

# Build the API documentation.
doc:
    cargo doc --no-deps --all-features

# Build and open the API documentation in a browser.
doc-open:
    cargo doc --no-deps --all-features --open

# ---------------------------------------------------------------------------
# Fuzzing with cargo-fuzz.
#
# The flake provides a dedicated `fuzz` dev shell with the nightly toolchain
# (required by libFuzzer's sanitizers), cargo-fuzz, and clang. These recipes
# enter it automatically, so they work from any shell.
#
# Targets: `roundtrip` (decode never panics and decode/encode round-trips)
# and `chrono_roundtrip` (chrono conversion fixed point).
# ---------------------------------------------------------------------------

# List the available fuzz targets.
fuzz-list:
    nix develop .#fuzz --command cargo fuzz list

# Build a fuzz target without running it.
fuzz-build TARGET='roundtrip':
    nix develop .#fuzz --command cargo fuzz build {{TARGET}}

# Run a fuzz target until it finds a crash or is interrupted.
# Cap the iterations with RUNS, e.g. `just fuzz roundtrip 2000`.
fuzz TARGET='roundtrip' RUNS='':
    nix develop .#fuzz --command cargo fuzz run {{TARGET}} -- {{ if RUNS != '' { '-runs=' + RUNS } else { '' } }}

# Remove generated fuzz corpora and crash artifacts.
fuzz-clean:
    rm -rf fuzz/corpus fuzz/artifacts

# Run all CI checks: format, lint, and tests.
ci: fmt-check lint test