Hurocon (huawei router control) - command line interface tool for interacting with Huawei LTE routers
- Device Control
- Information
- Reboot
- Net
- Cellular
- Connection status
- Switch connection
- LAN
- List devices
- Cellular
- SMS
- Inbox: List, View
- Send
There are many features planned for future releases, you can view their full list here
Full list of supported devices is available on this link.
This tool is OS-independent, which means it should work on any platform where python3 can run. Minimal python3 version required for this package is 3.7
. This does not mean that it cannot work on python versions below the minimal, but its behavior is unpredictable and no support will be provided for any issues.
-
You can install it from PyPi:
pip install hurocon
-
Or directly from Github repo:
pip install git+https://github.com/maximilionus/hurocon.git
Currently can only be installed with
pip
onpython >= 3.7
. Binary bundle (pyinstaller-based) is planned but no ETA yet
After successful installation of this tool it can be accessed in shell using the following commands:
$ hurocon
# OR
$ python -m hurocon
You can also view a list of all main commands with:
$ hurocon --help
Each command and subcommand in this tool has a special --help
flag to display detailed information about it
Foremost, you need to specify the authentication details so that this tool can access the device.
$ hurocon auth login
After auth details successfully specified you can test your connection with router by running
$ hurocon auth test
# Returns
# Success: Successful Authentication
# Failure: Auth failed, reason: "..."
That's it, you're ready to go. And remember - no matter how deep you go, --help
flag is always here to help 👍
To prepare the development environment for this project, follow these steps:
-
Install
poetry
package manager with (pip, standalone (recommended)) -
Run the command below to prepare the virtual environment for this project
$ poetry install
-
That's it, now you can modify the code the way you want and test it in two ways
- Run this tool with
$ poetry run hurocon
- Or activate the project environment with
$ poetry shell Spawning shell within ... $ hurocon
- Run this tool with
To build this tool to package (sdist and wheel) you should execute:
$ poetry build
Building hurocon ...
Prepared for distribution package will be located in ./dist/
directory
Big thanks to Adam Schubert for his amazing huawei-lte-api
package, that made this whole thing possible.