netchecker 0.5.0

Cross-platform internet reachability checker: probes infrastructure, DNS, and a set of domestic/global/filtered sites in parallel
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

# netchecker task runner. Run `just` to list recipes.
# Requires: just, cargo. Version recipes also need cargo-edit (`just tools`).

set shell := ["bash", "-uc"]

bin := "netchecker"

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

# ---------------------------------------------------------------------------
# Everyday
# ---------------------------------------------------------------------------

# Run the app, forwarding args, e.g. `just run direct`.
run *ARGS:
    cargo run -- {{ ARGS }}

# Debug build.
build:
    cargo build

# Optimized release build.
release-build:
    cargo build --release

# Run tests.
test:
    cargo test

# Type-check without producing binaries.
check:
    cargo check --all-targets

# Format the code.
fmt:
    cargo fmt --all

# Verify formatting (CI does this).
fmt-check:
    cargo fmt --all --check

# Lint with clippy, warnings-as-errors (CI does this).
lint:
    cargo clippy --all-targets -- -D warnings

# Everything CI runs, locally.
ci: fmt-check lint test

# Audit dependencies for known vulnerabilities (needs cargo-audit).
audit:
    cargo audit

# Install netchecker into ~/.cargo/bin from source.
install:
    cargo install --path .

# Remove build artifacts.
clean:
    cargo clean

# Update dependencies within semver.
update:
    cargo update

# Cross-build a single release target locally, e.g.
# `just dist x86_64-unknown-linux-musl` (needs the target/toolchain installed).
dist TARGET:
    cargo build --release --target {{ TARGET }}

# Install the dev tooling these recipes rely on.
# cargo-edit provides `cargo set-version` (used by the version-* recipes).
tools:
    cargo install cargo-edit cargo-audit

# ---------------------------------------------------------------------------
# Versioning & release
#
# These bump the version in Cargo.toml, commit, tag `vX.Y.Z`, and push.
# Pushing the tag triggers .github/workflows/release.yml, which builds the
# cross-platform binaries AND runs `cargo publish` to crates.io.
# ---------------------------------------------------------------------------

# Bump patch and release, e.g. 1.2.3 -> 1.2.4  (cargo set-version --bump patch)
version-patch:
    @just _release patch

# Bump minor and release, e.g. 1.2.3 -> 1.3.0  (cargo set-version --bump minor)
version-minor:
    @just _release minor

# Bump major and release, e.g. 1.2.3 -> 2.0.0  (cargo set-version --bump major)
version-major:
    @just _release major

# Shared bump/commit/tag/push. LEVEL is patch|minor|major.
_release LEVEL:
    #!/usr/bin/env bash
    set -euo pipefail

    # Refuse to run on a dirty tree so the release commit is just the bump.
    if ! git diff-index --quiet HEAD -- || [ -n "$(git status --porcelain --untracked-files=no)" ]; then
        echo "error: working tree has uncommitted changes — commit or stash first." >&2
        exit 1
    fi

    # Make sure the tooling is present.
    if ! cargo set-version --help >/dev/null 2>&1; then
        echo "error: cargo-edit not installed. Run: just tools" >&2
        exit 1
    fi

    cargo set-version --bump "{{ LEVEL }}"
    version="$(cargo pkgid | sed -E 's/.*[#@]//')"

    git add Cargo.toml Cargo.lock
    git commit -m "release: v${version}"
    git tag -a "v${version}" -m "netchecker v${version}"

    echo "Tagged v${version}. Pushing to trigger the release pipeline..."
    git push origin HEAD --follow-tags
    echo "Done. Watch: https://github.com/pourmand1376/netchecker/actions"