Visualisation of OSPF network topology as seen by the BIRD routing daemon.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Go to file
LEdoian ab132d4d86 Add initial idea of Annotator interfaces
This would allow Annotators to depend on Annotations without knowing
how they were created.

However, keeping track of these generic Annotations (GAnns) is hard:
	- When another Annotator runs and returns a GAnn, do we replace it?
	  Alternatively, should multiple Annotators be allowed to return the
	  same GAnn?
	- If an Annotator previously returned a GAnn but not when being
	  re-run, do we drop the GAnn?
	- Should we keep track of which Annotator created which GAnn? If so,
	  how and what granularity?
1 year ago
birdvisu Add initial idea of Annotator interfaces 1 year ago
design_notes Add note about supported OSPFv3 2 years ago
docs Ensure, that sphinx works 1 year ago
snippets Merge remote-tracking branch 'gitea/toolchain_setup' 1 year ago
.gitignore Merge branch 'socket_api' 1 year ago
Makefile Add a generator for current state 2 years ago
README.md Unify the two READMEs 1 year ago
poor_mans_visualisation.py Start reimplementing poor_mans_visualisation.py 1 year ago
pyproject.toml Initial version of packaging 2 years ago
reference.ospf Split visualisation directives to separate file. 1 year ago
visualisation.ospf Split visualisation directives to separate file. 1 year ago

README.md

A simple tool for visualising OSPF network topology as seen by BIRD

Birdvisu is a library and a graphical app to visualize routing topologies of OSPF. It does not implement OSPF on its own, but rather exports current state from BIRD that's where the name comes from.

The main use case is comparing a reference topology (e.g. a known good one) to the current state. This allows Birdvisu to show failed links and other anomailes in the network.

Also, this is the project for my Bachelor thesis.

Installation

Run pip install -e .. You can use a virtualenv if you wish (recommended).

A demo is located in ./poor_mans_visualisation.py, if that runs, everything should be working.

Documentation

Documentation is built using Sphinx by running make in the docs/ directory.

Licence

I have not decided yet, so please ask for terms if you want to use this in some non-trivial way. Obviously this is source available :-)