mikrotik-tests

Runs and debugs tik4net integration tests against a live MikroTik router.

198|97|Updated Aug 16, 2015
One-click install
npx skills add https://github.com/danikf/tik4net --skill mikrotik-tests-danikf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mikrotik-tests
Source: https://github.com/danikf/tik4net/tree/main/.claude/skills/mikrotik-tests
Command: npx skills add https://github.com/danikf/tik4net --skill mikrotik-tests-danikf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running the tik4net integration suite against a live MikroTik router involves eleven transports, per-transport runsettings, capability-based skips, cross-run orphan contamination, and TRX result analysis — this Skill encodes all of that operational knowledge so test runs are invoked, interpreted, and debugged correctly. ## Core Features & Use Cases - Transport-aware test execution: Run the full matrix, a single transport, or a smoke subset via the run-integration-tests.ps1 harness, with correct PowerShell invocation patterns for multi-transport arrays. - Result and skip analysis: Parse TRX files with parse-trx.ps1, distinguish capability skips from real failures, and generate re-run filters for failed tests. - Orphan and contamination debugging: Diagnose cross-run residue (IPsec peers, EoIP interfaces, firewall rules), router self-blackouts caused by enabled probe rows, and RouterOS 7.24 routing wedges, including MacTelnet-based recovery. - Test authoring guidance: Scaffold new TestBase-derived tests with the standard List/Add pattern, t4n markers, guards, and mandatory try/finally cleanup. - Use Case: After a change to the WinBox native codec, run the smoke subset across rest, telnet, and winboxnative, then compare skip counts and failures against the preserved previous TRX to confirm nothing regressed. ## Quick Start Run the tik4net integration test suite on the api transport and show me any failures and skips from the TRX results.

Frequently Asked Questions about mikrotik-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run tik4net integration tests against a live MikroTik router?

Use the run-integration-tests.ps1 harness with -Transport for a single transport, -Smoke for a subset, or no arguments for the full matrix. Router coordinates come from App.config, and each transport has its own .runsettings file setting tik.connectionType.

How do I run tests across multiple transports in one command?

Use PowerShell -Command instead of -File so the transport list arrives as an array: -Command "& 'Tools/probes/run-integration-tests.ps1' -Smoke -Transport @('rest','telnet','winboxnative')". With -File, comma-separated names arrive as one invalid transport string.

Why are tik4net tests skipped or reported as Inconclusive?

EnsureCapability reports Inconclusive when the active transport lacks a required capability, which is a skip, not a failure. Many skips are also [Ignore]d manual probes; read skip reasons with parse-trx.ps1 -ShowSkips rather than trusting raw counts.

Why do tests fail with 'already have interface with name' errors?

A previous run left an orphan: a CLI transport add returned no .id, so cleanup never ran but the object exists on the router. Fix the test that leaves residue using SaveTracked or TrackForCleanup, and look for objects prefixed t4n.

What should I do when all IP transports stop responding mid-run?

Try the MacTelnet transport before rebooting, since MAC-layer connections are unaffected by routing rules. A test row that dropped traffic can be removed over the L2 path, restoring IP access without losing uptime.

Can I run an [Ignore]d test using a dotnet test filter?

No. MSTest applies [Ignore] before the filter, so the test reports as skipped and the run passes without measuring anything. Comment out the attribute, run the test, then restore it.