dt-cli-tools


Namedt-cli-tools JSON
Version 0.1.14 PyPI version JSON
download
home_pagehttps://github.com/JavaWiz1/dt-cli-tools
SummaryVarious CLIs created from dt-* packages
upload_time2024-10-16 15:43:26
maintainerNone
docs_urlNone
authorAl DAmico
requires_python<4.0,>=3.10
licenseMIT
keywords python dt-tools network
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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/1e/fb/32c13cb3e233ed6e2cdb572fa08343838b691ff9f36380d5dad3a97c349a/dt_cli_tools-0.1.14.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.14",
    "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": "789190fd2e3a18ca05d6d8f75531e7f42851624bd85de3a5b259c2287ffe82ab",
                "md5": "e789dc2006e26a9166a7a2dcf5b9bef6",
                "sha256": "5f04c3902fc65a3878c36a62d367d79a75bcabd0fa4d8bd910fffab6c3a75ef4"
            },
            "downloads": -1,
            "filename": "dt_cli_tools-0.1.14-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e789dc2006e26a9166a7a2dcf5b9bef6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 27022,
            "upload_time": "2024-10-16T15:43:24",
            "upload_time_iso_8601": "2024-10-16T15:43:24.678852Z",
            "url": "https://files.pythonhosted.org/packages/78/91/90fd2e3a18ca05d6d8f75531e7f42851624bd85de3a5b259c2287ffe82ab/dt_cli_tools-0.1.14-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1efb32c13cb3e233ed6e2cdb572fa08343838b691ff9f36380d5dad3a97c349a",
                "md5": "365c1b50aa94be85805f459fb264deb3",
                "sha256": "37ef91eebbce82a8e955e58d8b01119e566033e835bfa249cae6304605eeaa5b"
            },
            "downloads": -1,
            "filename": "dt_cli_tools-0.1.14.tar.gz",
            "has_sig": false,
            "md5_digest": "365c1b50aa94be85805f459fb264deb3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 21493,
            "upload_time": "2024-10-16T15:43:26",
            "upload_time_iso_8601": "2024-10-16T15:43:26.381126Z",
            "url": "https://files.pythonhosted.org/packages/1e/fb/32c13cb3e233ed6e2cdb572fa08343838b691ff9f36380d5dad3a97c349a/dt_cli_tools-0.1.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-16 15:43:26",
    "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"
}
        
Elapsed time: 0.38229s