# dt-cli-tools
CLI tools using the dt suite of helpers (dt-misc, dt-console, dt-net)
For detailed usage information, supply -h or --help to command line.
ex: ip-helper -h
## ip-helper
Retrieve IP information on Local and Internet IP addresses.
This utility interfaces with the free ipinfo.io site. The ipinfo.io site
requires a user token which is free.
- See 'setting up user token' (https://htmlpreview.github.io/?https://github.com/JavaWiz1/dt-net/blob/develop/docs/html/dt_tools.net.ip_info_helper.html) in docs for information on aquiring and setting up token.
Features:
- IP Cache for to increase perfomance and and limit calls to ipinfo.io
- Command line interface, or console prompt menu.
- Commands to manage cache (list, clean, search,...)
- Cached IP entry will auto-refresh if it is more than 48 hours old.
## lan-clients
Create report of all identified clients on local network.
Entries are identified thru Address Resolution Protocal (ARP) cache or broadcast.
Default approach is ARP cache, however Broadcast (-b parameter) is more thorough, but takes more time.
Features:
- Identifies LAN Clients and displays associated details:
- IP Address
- Hostname
- MAC Address
- MAC Vendor
- Uses ARP Cache or ARP Broadcast to identify clients
- Can output results into a pipe '|' delimited file
## port-check
This module checks for open[/closed] ports on target host(s).
Features:
- Check a port, a list of ports, range of ports or common ports
- Limit output to only show open ports
- Check multiple hosts via an input file of hostnames(and ports)
- Threaded to improve performance for large number of ports
## set-api-tokens
This module creates the token file and stores the tokens used for 3rd party interfaces.
Visit the Token registration URL to aquire a FREE token for the desired service, then run
set-api-tokens (from dt-foundation package) to cache the token locally for the dt-* routines.
| Service | Function | Token registration URL |
| --- | --- | --- |
| ip-info.io | Retrieve IP metadata | https://ipinfo.io/missingauth |
| weatherapi.com | Current weather conditions | https://www.weatherapi.com/signup.aspx |
| geocode.maps.co | GeoCode lookup based on address, ip, etc.. | https://geocode.maps.co/join/ |
## speak
Speak text from command-line or text file.
Features:
- Input from command line or file
- Selectable accents (see --list option for values)
- Control cadence/speed of voice
## weather-cli
Weather command line interface
Get weather for any location from your command line!
Features:
- Get weather (current, forecast or alerts)
- Specify location as GPS coordinates, an address, a landmark, or from your internet IP location
- Specify future dates for weather forecast
- Have device 'speak' the weather
## wol-cli
Send Wake-on-LAN (WOL) packet to device.
WOL is a standard for Ethernet and Token-Ring which allows a computer to be
turned on or awakened from sleep-mode via a network message.
A 'magic' packet is sent to the MAC address of the target device, which if
enabled, will signal the device to wake-up.
This module allows the user to send WOL to hostnames and IPs in addition to
the MAC address. This is accomplished by leveraging a cache that this program
maintains which relates the MAC to IP and hostname.
Raw data
{
"_id": null,
"home_page": "https://github.com/JavaWiz1/dt-cli-tools",
"name": "dt-cli-tools",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "python, dt-tools, network",
"author": "Al DAmico",
"author_email": "JavaWiz1@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/92/66/eaa96b55f6c2adc865a258d61db417a5c3a3e91c8b37eb92be506381dc47/dt_cli_tools-0.1.22.tar.gz",
"platform": null,
"description": "# dt-cli-tools\n\nCLI tools using the dt suite of helpers (dt-misc, dt-console, dt-net)\n\nFor detailed usage information, supply -h or --help to command line.\n\n ex: ip-helper -h\n\n## ip-helper \n\nRetrieve IP information on Local and Internet IP addresses.\n\nThis utility interfaces with the free ipinfo.io site. The ipinfo.io site\nrequires a user token which is free.\n\n - See 'setting up user token' (https://htmlpreview.github.io/?https://github.com/JavaWiz1/dt-net/blob/develop/docs/html/dt_tools.net.ip_info_helper.html) in docs for information on aquiring and setting up token.\n\nFeatures:\n\n - IP Cache for to increase perfomance and and limit calls to ipinfo.io\n - Command line interface, or console prompt menu.\n - Commands to manage cache (list, clean, search,...)\n - Cached IP entry will auto-refresh if it is more than 48 hours old.\n\n\n## lan-clients \n\nCreate report of all identified clients on local network.\n\nEntries are identified thru Address Resolution Protocal (ARP) cache or broadcast.\nDefault approach is ARP cache, however Broadcast (-b parameter) is more thorough, but takes more time.\n\n\nFeatures:\n\n - Identifies LAN Clients and displays associated details:\n\n - IP Address\n - Hostname\n - MAC Address\n - MAC Vendor\n - Uses ARP Cache or ARP Broadcast to identify clients\n - Can output results into a pipe '|' delimited file\n\n\n## port-check \n\nThis module checks for open[/closed] ports on target host(s).\n\nFeatures:\n\n - Check a port, a list of ports, range of ports or common ports\n - Limit output to only show open ports\n - Check multiple hosts via an input file of hostnames(and ports)\n - Threaded to improve performance for large number of ports\n\n\n## set-api-tokens \n\nThis module creates the token file and stores the tokens used for 3rd party interfaces.\n\nVisit the Token registration URL to aquire a FREE token for the desired service, then run\nset-api-tokens (from dt-foundation package) to cache the token locally for the dt-* routines.\n\n| Service | Function | Token registration URL |\n| --- | --- | --- |\n| ip-info.io | Retrieve IP metadata | https://ipinfo.io/missingauth | \n| weatherapi.com | Current weather conditions | https://www.weatherapi.com/signup.aspx |\n| geocode.maps.co | GeoCode lookup based on address, ip, etc.. | https://geocode.maps.co/join/ |\n\n## speak\n\nSpeak text from command-line or text file.\n\nFeatures:\n\n - Input from command line or file\n - Selectable accents (see --list option for values)\n - Control cadence/speed of voice\n\n## weather-cli\n\nWeather command line interface\n\nGet weather for any location from your command line!\n\nFeatures:\n\n - Get weather (current, forecast or alerts)\n - Specify location as GPS coordinates, an address, a landmark, or from your internet IP location\n - Specify future dates for weather forecast\n - Have device 'speak' the weather\n\n\n## wol-cli \n\nSend Wake-on-LAN (WOL) packet to device.\n\nWOL is a standard for Ethernet and Token-Ring which allows a computer to be\nturned on or awakened from sleep-mode via a network message.\n\nA 'magic' packet is sent to the MAC address of the target device, which if\nenabled, will signal the device to wake-up.\n\nThis module allows the user to send WOL to hostnames and IPs in addition to\nthe MAC address. This is accomplished by leveraging a cache that this program\nmaintains which relates the MAC to IP and hostname.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Various CLIs created from dt-* packages",
"version": "0.1.22",
"project_urls": {
"Homepage": "https://github.com/JavaWiz1/dt-cli-tools",
"Repository": "https://github.com/JavaWiz1/dt-cli-tools"
},
"split_keywords": [
"python",
" dt-tools",
" network"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ce429962d8e9d2d4a43a0dfd0726f748018415a6954e42a4006b31557bf330f4",
"md5": "7b7a5d40b2e76620db87e4956ac4b3ad",
"sha256": "725c6309bb0d43f3d9f48fc1f010a71d5d704634c68d5208b1a21dd83c71a891"
},
"downloads": -1,
"filename": "dt_cli_tools-0.1.22-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7b7a5d40b2e76620db87e4956ac4b3ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 30711,
"upload_time": "2025-01-18T17:30:14",
"upload_time_iso_8601": "2025-01-18T17:30:14.649277Z",
"url": "https://files.pythonhosted.org/packages/ce/42/9962d8e9d2d4a43a0dfd0726f748018415a6954e42a4006b31557bf330f4/dt_cli_tools-0.1.22-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9266eaa96b55f6c2adc865a258d61db417a5c3a3e91c8b37eb92be506381dc47",
"md5": "a7c4cdb2f3de37f32f5b55448eb0923f",
"sha256": "b68b4b0385927726bec663f183a65796d13c6cd47099a9f4e3e2489fd46cfb04"
},
"downloads": -1,
"filename": "dt_cli_tools-0.1.22.tar.gz",
"has_sig": false,
"md5_digest": "a7c4cdb2f3de37f32f5b55448eb0923f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 24385,
"upload_time": "2025-01-18T17:30:16",
"upload_time_iso_8601": "2025-01-18T17:30:16.356654Z",
"url": "https://files.pythonhosted.org/packages/92/66/eaa96b55f6c2adc865a258d61db417a5c3a3e91c8b37eb92be506381dc47/dt_cli_tools-0.1.22.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 17:30:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JavaWiz1",
"github_project": "dt-cli-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dt-cli-tools"
}
JSON
