dojo.swos: Python and PHP library for MikroTik SwOS switches

Installation and usage

Installation (Python)

pip install --index-url https://mikrotikdojo.com/en/pypi/<your-address>/simple/ dojo-swos

Usage example (Python)

from dojo.swos import SwOS

sw = SwOS("192.0.2.10")            # utente admin, password vuota (default SwOS)
print(sw.system()["identity"])      # -> SWOS

for p in sw.ports():
    print(p["name"], "UP" if p["link"] else "giu'")

# configurare una VLAN (attento alla porta di gestione!)
sw.set_vlans([{"vid": 10, "ports": [2, 3], "name": "lab"}])

# scrivi via b-file, verifica via SNMP
sw.set_snmp(location="sala-rack")

Installation (PHP)

composer config repositories.dojo composer https://mikrotikdojo.com/en/composer/<your-address>/
composer require dojo/swos

Usage example (PHP)

use Dojo\Swos\SwOS;

$sw = new SwOS("192.0.2.10");        // utente admin, password vuota (default SwOS)
echo $sw->system()["identity"];      // -> SWOS

foreach ($sw->ports() as $p) {
    echo $p["name"], $p["link"] ? " UP\n" : " giu'\n";
}

// configurare una VLAN (attento alla porta di gestione!)
$sw->setVlans([["vid" => 10, "ports" => [2, 3], "name" => "lab"]]);