Skip to main content

A python simple and flexible CLI tool used to network testing.

Project description

Netbox

A python simple and flexible CLI tool used to network testing.

Introduction

This command line tool integrates some common network operations, such as wireless network connection, network ping, network speed measurement, etc., which can be done by using simple commands. The tool supports cross-platform, consistent command-line style for the three major operating systems and user-friendly. In addition, the tool provides a rich function interface which is convenient for users to integrate according to the actual business.

Getting Started

Prerequisites

  • Install python3 on your local machine, no matter what operating system you are using, you can refer to the link as below

    How to install python3

  • Install git on your local machine, no matter what operating system you are using, you can refer to the link as below

    How to install git

Installing

A step by step series of examples that tell you how to get the CLI tool running.

Installing via git repository

  1. Clone project with git command

    git clone https://github.com/Hellboycc/netbox.git
    
  2. Create a virtual environment in the project root directory

    cd netbox
    python -m venv .venv
    
  3. Activate current virtual environment

    # For MacOS
    cd .venv/bin
    source activate
    
  4. Install all dependency with pip3 command

    # In this path /Users/..../netbox
    pip3 install -r requirements.txt
    
  5. Install project on your local machine

    # In this path /Users/..../netbox 
    pip3 install -e .
    

Installing from pypi

If you don't want to use git repository, you could choose to download from pypi.org and install to use.

pip3 install netbox

Running CLI on your terminal window

  1. Example for display CLI tool information

    netbox-cli                                                                                                                                                                    
    Usage: netbox-cli [OPTIONS] COMMAND [ARGS]...
    
      A simple and flexible CLI tool for network testing
    
    Options:
      --version  Print version information and quit
      --help     Show this message and exit.
    
    Commands:
      version  Show the CLI tool version information
      wlan     Manage wifi network
    
  2. Example for child commands

    netbox-cli wlan                                                                                                                                                              
    Usage: netbox-cli wlan [OPTIONS] COMMAND [ARGS]...
    
      Manage wifi network
    
    Options:
      --help  Show this message and exit.
    
    Commands:
      connect     Connect a wifi network
      current     Current wifi network information
      disconnect  Disconnect current wifi network
      scan        Scan surround wifi network
    
  3. Example for dispaly current version

    netbox-cli version   
                                                                                                                                                             
    Current version is v0.0.1
    
  4. Example for scan a specified wifi network exists or not

    netbox-cli wlan scan --ssid Hellboycc 
                                                                                                                                            
    Current ssid Hellboycc is not found.
    

Testing

The project contains complete unit tests, if you want to know the unit test results before using the tool, you can get the detailed test results by executing the unit tests.

How to run unit test

  1. Install all dependency of develop

    # For MacOS
    cd netbox
    python -m venv .venv
    cd .venv/bin
    source activate
    # In this path /Users/..../netbox
    pip3 install -r requirements-dev.txt
    
  2. Running unit test with tox command

    # In this path /Users/..../netbox
    tox
    

FAQ & Issues

  • If you encounter any problems in using it, please keep in touch with me and I will reply as soon as possible, you can access to the link as below

    Issues of project

  • Other classic questions

    FAQ

License

This project is licensed under the MIT License (see the LICENSE file for details).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netbox-0.0.2.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

netbox-0.0.2-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file netbox-0.0.2.tar.gz.

File metadata

  • Download URL: netbox-0.0.2.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.0

File hashes

Hashes for netbox-0.0.2.tar.gz
Algorithm Hash digest
SHA256 947e064cd4bbf7864bbd573b4244d5e148de02b94822222919b21bddd7217d09
MD5 c361e9a3273ecb13a4d9f4d5fbb31384
BLAKE2b-256 3ac72daf95337a2ce5c1b4eb45c252a6f350d9fa8b2ead0c759ec84103f8c115

See more details on using hashes here.

File details

Details for the file netbox-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: netbox-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.0

File hashes

Hashes for netbox-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 28baf9dad19ab0e29de96e164c91a79c036364f7d32acdc3ec520580c2aa8aea
MD5 04c37844916b771ac3735395908e9460
BLAKE2b-256 26b47cb6949faf1526593f07c6be76d6c3a7c3cd02e96d077267a87e7470c477

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page