ProductPromotion
Logo

Go.Lang

made by https://0x3d.site

GitHub - cunicu/gont: A Go testing framework for distributed applications
A Go testing framework for distributed applications - cunicu/gont
Visit Site

GitHub - cunicu/gont: A Go testing framework for distributed applications

GitHub - cunicu/gont: A Go testing framework for distributed applications

A Go testing framework for distributed applications

GitHub build goreportcard Codecov branch License GitHub go.mod Go version Go Reference DOI

Gont is a Go package to support the development networked and distributed applications.

It can construct a virtual network using Linux network spaces, to simulate switches, routers, NAT and endpoints, on a single machine (VM, cloud or native). In addition, it supports developers with tooling for tracing and debugger tooling for investigating distributed applications.

Gont is heavily inspired by Mininet. It allows the user to build virtual network topologies defined Go code. Under the hood the network is then constructed using Linux virtual bridges and network namespaces.

Gont runs on all moderatly recent Linux versions and requires NET_ADMIN capabilities (or root access).

Using Gont, developers can test complex distributed peer-to-peer and federated applications like routing daemons or social networks and messaging. Integration tests can be automated and executed in CI environments like GitHub actions (which are in fact used to test Gont itself).

Getting started

Have a look at our slide set to get you started.

Features

  • Various common network nodes:

    • Standard host
    • Layer-3 Routers
    • Layer-2 Switches
    • Layer-3 NAT Routers
    • Layer-3 NAT to host networks
  • Hostname resolution for test nodes (/etc/hosts overlay)

  • Execution of sub-processes, Go code & functions in the network namespace of test nodes

  • Simultaneous setup of multiple isolated networks

  • Ideal for Golang unit tests

  • Can run in workflows powered by GitHub's runners

  • Lean code thanks to functional options

  • Full IPv6 support

  • Per link network emulation and bandwidth limiting via for Netem and TBF queuing disciplines

  • Use of existing network namespaces as nodes

  • Configuration of per-host nftables firewall rules

  • Built-in Ping & Traceroute diagnostic tools

  • Built-in packet tracing with PCAPng output

  • Distributed tracing of events

    • A slog.Handler to emit structured log records as trace events
    • A zapcore.Core to emit zap log messages as trace events
    • Dedicated gont/trace package for emitting trace events
    • Capturing of trace events in PCAPng files
    • WireShark Lua dissector for decoding events
  • Built-in Delve debugger

    • Simultaneous attachment to multiple processes
    • Tracing via HW watch- & breakpoints to emit tracer events (see above)
      • Capture and investigate tracepoints in WireShark
    • Remote debugging via DAP
    • Generation of VS Code compound launch configurations
      • Start Gont test and attach to all processes at once

Examples

Please refer to our documentation

Contact

Please have a look at the contact page: cunicu.li/docs/contact.

Funding acknowledment

The development of Gont has been supported by the ERIGrid 2.0 project
of the H2020 Programme under Grant Agreement No. 870620

License

Gont is licensed under the Apache 2.0 license.

  • SPDX-FileCopyrightText: 2023 Steffen Vogel <[email protected]>
  • SPDX-License-Identifier: Apache-2.0

Articles
to learn more about the golang concepts.

Resources
which are currently available to browse on.

mail [email protected] to add your project or resources here ๐Ÿ”ฅ.

FAQ's
to know more about the topic.

mail [email protected] to add your project or resources here ๐Ÿ”ฅ.

Queries
or most google FAQ's about GoLang.

mail [email protected] to add more queries here ๐Ÿ”.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory