aznet

<img src="https://github.com/Atsika/aznet/raw/main/docs/src/assets/aznet.png" width="300">

Network abstraction over Azure Storage

The standard Go net.Conn interface using Azure Storage services as the transport layer.

What is aznet?

aznet provides a TCP-like networking abstraction over Azure Storage, allowing you to use familiar socket programming patterns with cloud storage as the underlying transport. Any code that works with net.Conn can work with aznet.

Drop-in Replacement Example

Swap standard TCP for Azure Storage with a single line:

// Before: Standard TCP
ln, _ := net.Listen("tcp", ":8080")

// After: aznet using Azure Blob Storage
ln, _ := aznet.Listen("azblob", "https://account:key@account.blob.core.windows.net/")

Documentation

Comprehensive documentation is available in the docs/ directory and rendered via Starlight:

cd docs
pnpm install
pnpm dev

Requirements

• Go 1.25 or later.
• An Azure Storage Account (or Azurite for local development).

Installation

go get github.com/atsika/aznet

Contributing

Contributions are welcome! Please see the existing code structure and driver implementations.

License

MIT License - see LICENSE file for details.

Credits

• Noise Protocol: noiseprotocol.org
• Azure SDK for Go: github.com/Azure/azure-sdk-for-go

Built with ❤️ by Atsika