pynng – Python bindings for NNG

pynng provides Python bindings for NNG (nanomsg next generation), a lightweight messaging library that supports common communication patterns (pub/sub, req/rep, push/pull, pair, bus, survey).

pynng supports both synchronous and asynchronous usage with asyncio and trio.

Getting Started

• Installation
  • From PyPI
  • From source (development)
  • Build Requirements
  • Customizing the build
  • Troubleshooting
• Getting Started
  • Installation
  • Your First Pair Socket
  • Your First Pub/Sub
  • Your First Req/Rep
  • A Taste of Async
  • Next Steps

User Guide

• Protocol Patterns
  • Pair (Point-to-Point)
  • Pub/Sub (Publish-Subscribe)
  • Req/Rep (Request-Reply)
  • Push/Pull (Pipeline)
  • Surveyor/Respondent (Survey)
  • Bus (Many-to-Many)
  • Protocol Comparison
• Async Usage Guide
  • Supported Async Libraries
  • Async Context Manager (async with)
  • Async Iteration (async for)
  • Async Close (aclose())
  • Cancellation Handling
  • Timeout Patterns
  • Concurrent Contexts
  • High-Level Alternative: Rep0Service
• Transport Guide
  • TCP (tcp://)
  • IPC (ipc://)
  • In-Process (inproc://)
  • WebSocket (ws://, wss://)
  • Abstract Sockets (abstract://)
  • TLS over TCP (tls+tcp://) and DTLS (dtls://)
  • Transport Comparison
• TLS Guide
  • Overview
  • TLS Engines & NNG v2 Capabilities
  • Server Configuration
  • Client Configuration
  • Authentication Modes
  • Server Name (SNI)
  • Complete Example
  • Using TLS with Files
  • Post-Construction Configuration

API Reference

• Sockets
  • Base Socket
  • Protocol Sockets
• Messaging
  • Message
  • Context
• Networking
  • Dialer
  • Listener
  • Pipe
  • Pipe Events
• Services
  • Rep0Service
  • Request
• TLS Configuration
  • TLSConfig
• Socket Addresses
  • AbstractAddr
  • IPCAddr
  • In6Addr
  • InAddr
  • InprocAddr
  • SockAddr
  • ZTAddr
• Exceptions
  • AddressInUse
  • AddressInvalid
  • AlreadyExists
  • Ambiguous
  • AuthenticationError
  • BadState
  • BadType
  • Busy
  • Canceled
  • Closed
  • ConnectionAborted
  • ConnectionRefused
  • ConnectionReset
  • CryptoError
  • DestinationUnreachable
  • Internal
  • Interrupted
  • InvalidOperation
  • MessageStateError
  • MessageTooLarge
  • NNGException
  • NoArgument
  • NoEntry
  • NoMemory
  • NotSupported
  • OutOfFiles
  • OutOfSpace
  • PermissionDenied
  • ProtocolError
  • ReadOnly
  • Stopped
  • Timeout
  • TryAgain
  • WriteOnly
  • Exception Reference Table
• Options
  • Options Reference Table

Project

• Contributing
• Architecture
• Migration from 0.x to 1.0
• Changelog
• Pynng Developer Notes