LeSysBot docs

Official cross-platform collection

network

Ping, DNS lookup, and traceroute on every OS.

Collection

Official cross-platform collection

Package version

2.0.0

Platforms

All platforms

Requires on PATH

ping nslookup

Python dependencies

none

Install#

Install just this package:

shell
lesysbot tools install lesysbot/lesysbot-packages-official/tools/network

Or take the whole Official packages collection at once:

shell
lesysbot install lesysbot/lesysbot-packages-official

Tools#

This package exposes 3 tools.

ping(host)#

shell commandtimeout 15s

Send three ICMP echo requests to a host and report the replies.

Runs

shell
ping -c 3 {host} (Unix) · ping -n 3 {host} (Windows)

Parameters

ParameterTypeDefaultDescription
hostrequiredstr—Hostname or IP address to ping.

dns_lookup(domain)#

shell command

Resolve a domain name and report the answering nameserver.

Runs

shell
nslookup {domain}

Parameters

ParameterTypeDefaultDescription
domainrequiredstr—Domain name to resolve.

traceroute(host)#

shell commandtimeout 120s

Trace the network path to a host, up to 15 hops.

Runs

shell
traceroute -m 15 {host} (Unix) · tracert -h 15 -w 1000 {host} (Windows)

Parameters

ParameterTypeDefaultDescription
hostrequiredstr—Hostname or IP address to trace.

Notes#

  • One package for every OS: each tool carries its per-OS command variants, and traceroute requires the binary this OS actually uses (traceroute on Unix, tracert on Windows).
  • Each tool is gated independently on its own binary, so a machine without traceroute still gets working ping and dns_lookup.

Source#

Every package is a folder holding a README.md and a tool.py. Read this one on GitHub: lesysbot/lesysbot-packages-official/tools/network.

To write your own, see Writing tools.