router_os_client 1.0.2+1 router_os_client: ^1.0.2+1 copied to clipboard
RouterOSClient is a Dart/Flutter package that provides an easy-to-use interface for connecting and interacting with Mikrotik's RouterOS devices via a socket connection.
RouterOSClient #
RouterOSClient
is a Dart/Flutter package that provides an easy-to-use interface for connecting and interacting with Mikrotik's RouterOS devices via a socket connection. This package supports both standard and secure (SSL/TLS) connections, enabling you to send commands and receive data from RouterOS devices in real-time.
Features #
- Socket Connection: Connect to RouterOS devices using either standard TCP or secure SSL/TLS sockets.
- Command Execution: Send commands to RouterOS and receive structured replies.
- Stream Data: Stream long-running commands to receive continuous updates.
- Error Handling: Comprehensive error handling with custom exceptions for various failure scenarios.
- Verbose Logging: Optional logging for debugging and monitoring communication.
Installation #
Add the following to your pubspec.yaml
file:
dependencies:
router_os_client: ^1.0.1+1
Then run:
flutter pub get
Usage #
1. Create an Instance of RouterOSClient
#
import 'package:router_os_client/router_os_client.dart';
void main() async {
RouterOSClient client = RouterOSClient(
address: '192.168.88.1', // Replace with your RouterOS IP address
user: 'admin', // Replace with your RouterOS username
password: 'password', // Replace with your RouterOS password
useSsl: false, // Set to true if you are using SSL/TLS
verbose: true, // Set to true for detailed logging
);
bool isConnected = await client.login();
if (isConnected) {
print('Connected to RouterOS');
} else {
print('Failed to connect to RouterOS');
}
}
2. Send a Command #
To send a command to the RouterOS device and get a response:
void fetchInterfaces() async {
List<Map<String, String>> interfaces = await client.talk(['/interface/print']);
for (var interface in interfaces) {
print('Interface Name: ${interface['name']}');
}
}
3. Stream Data from RouterOS #
For long-running commands like /tool/torch
, you can stream the data:
void streamTorchData() async {
await for (var data in client.streamData('/tool/torch interface=ether1')) {
print('Torch Data: $data');
}
}
4. Close the Connection #
After you are done communicating with the RouterOS device, close the connection:
client.close();
Error Handling #
RouterOSClient
provides several custom exceptions to handle errors gracefully:
LoginError
: Thrown when there is an error during the login process.WordTooLong
: Thrown when a command word exceeds the maximum length.CreateSocketError
: Thrown when the socket connection fails.RouterOSTrapError
: Thrown when RouterOS returns a trap error in response to a command.
Example:
try {
await client.login();
} catch (LoginError e) {
print('Login failed: ${e.message}');
} catch (CreateSocketError e) {
print('Socket creation failed: ${e.message}');
}
Examples #
Here's a full example of connecting, sending a command, and streaming data:
import 'package:router_os_client/router_os_client.dart';
void main() async {
RouterOSClient client = RouterOSClient(
address: '192.168.88.1',
user: 'admin',
password: 'password',
useSsl: false,
verbose: true,
);
try {
if (await client.login()) {
print('Connected to RouterOS');
// Fetch and print interface list
List<Map<String, String>> interfaces = await client.talk(['/interface/print']);
interfaces.forEach((interface) {
print('Interface: ${interface['name']}');
});
// Stream torch data
await for (var data in client.streamData('/tool/torch interface=ether1')) {
print('Torch Data: $data');
}
} else {
print('Failed to connect to RouterOS');
}
} catch (e) {
print('Error: $e');
} finally {
client.close();
}
}
License #
This project is licensed under the MIT License. See the LICENSE file for details.
Contributing #
Contributions are welcome! Please feel free to submit a pull request or file an issue on the GitHub repository.
Contact #
For any issues or feature requests, please contact @Shafiq or open an issue on GitHub.