ChatNet 0.2.1

ChatArch generic network helper package

ChatNet

ChatNet is the ChatArch generic network helper package. It owns reusable network and portal/session helpers such as:

• ICMP ping scanning and TCP port scanning;
• URL collection and link checking;
• browser/chromedriver/playwright service URL health checks;
• service URL helpers such as append_token() and ensure_path();
• browser-like requests.Session setup with common headers;
• state-file backed cookie persistence;
• cookie header parsing/export;
• simple HTML table parsing helpers;
• safe request-spec / curl-preview generation for dry-run workflows;
• non-sudo explicit forward proxy serving, checking, and user autostart for trusted LAN clients.

Application-level campus portal logic belongs in packages such as ChatECNU, which depends on ChatNet for generic network and portal helpers.

Quick start

pip install -e ".[dev]"
chatnet --help
chatnet links --url https://example.com
CHATNET_PROXY_PASSWORD='<password>' chatnet proxy serve --bind 0.0.0.0 --port 18080 --allow-cidr 172.23.0.0/16 --user chatnet
CHATNET_PROXY_PASSWORD='<password>' chatnet proxy check --proxy-url http://127.0.0.1:18080 --user chatnet
chatnet proxy autostart print --bind 0.0.0.0 --port 18080 --allow-cidr 172.23.0.0/16 --user chatnet
chatenv status -t chatnet --detail
python -m pytest -q

Proxy defaults can also come from ChatEnv under $CHATARCH_HOME/envs/ChatNet/.env:

CHATNET_PROXY_BIND='127.0.0.1'
CHATNET_PROXY_PORT='18080'
CHATNET_PROXY_ALLOW_CIDR='127.0.0.0/8'
CHATNET_PROXY_USER='chatnet'
CHATNET_PROXY_PASSWORD='<password>'

Boundary

ChatNet should stay application-neutral. ECNU login, visitor management, ECNU-specific ChatEnv schema, and ECNU CAPTCHA behavior belong in ChatECNU, not in ChatNet.