The C++ Asynchronous Framework

🐙 userver is the modern open source asynchronous framework with a rich set of abstractions for fast and comfortable creation of C++ microservices, services and utilities.

The framework solves the problem of efficient I/O interactions transparently for the developers. As a result, with the framework you get straightforward source code, avoid CPU-consuming context switches from OS, efficiently utilize the CPU with a small amount of execution threads.

Telegram support chats: English-speaking | Russian-speaking | News channel.

Introduction

• I/O-bound Applications and Coroutines
• The Basics
• Feature Comparison with other Frameworks
• Supported Platforms
• Configure and Build
• Deploy Environment Specific Configurations
• Releases, Trunk-based Development and Pull Requests
• Roadmap and Changelog
• Frequently Asked Questions

Tutorial

• Writing your first HTTP server
• Writing your own configs server
• Production configs and best practices
• TCP half-duplex server with static configs validation
• TCP full-duplex server with metrics and Spans
• Pre-caching data from HTTP remote
• HTTP Flatbuf handler and requests
• gRPC client and service
• PostgreSQL service
• MongoDB service
• Redis service
• Custom Authorization/Authentication via PostgreSQL
• Digest Authorization/Authentication via PostgreSQL
• Writing your WebSocket service
• File uploads and multipart/form-data testing
• Non-Coroutine Console Tool

Generic development

• Component system
  • Clients
  • HTTP Handlers
  • Other components
• Synchronization Primitives
• Formats (JSON, YAML, BSON, ...)
• Logging and Tracing
• Guide on TaskProcessor Usage
• Periodics and DistLocks

Testing and Benchmarking

• Unit Tests and Benchmarks
• Functional service tests (testsuite)
• Chaos Testing
• Profiling context switches

Protocols

• gRPC
• HTTP:
  • Client
  • HTTP, HTTPS, WebSocket
• RabbitMQ (AMQP 0-9-1) - EXPERIMENTAL
• Low level:
  • TLS client and server socket
  • TCP and UDP sockets
  • Subprocesses

Runtime service features

• Dynamic config
• Dynamic config schemas
• Changing the log level at runtime
• Inspecting in-flight requests
• Service Statistics and Metrics (Prometheus/Graphite/...)
• Memory profiling a production service
• Controlling DNS
• Handling OS signals
• Deadline propagation

Caches

• Basics of Caches
• Local cache dumps
• Caching Component for PostgreSQL
• Least Recently Used (LRU) Caches and expirable LRU caches

PostgreSQL

• uPg Driver
• uPg: Transactions
• uPg: Running queries
• uPg: Working with result sets
• uPg: Supported data types
• uPg: Typed PostgreSQL results
• uPg: Postgres errors
• uPg: Cluster topology discovery
• uPg: Automatic connection limit
• uPg: Mapping a C++ type to PostgreSQL user type
  • uPg: Composite user types
  • uPg: Mapping a C++ enum to PostgreSQL enum type.
  • uPg: Range types
  • uPg: Arrays
  • uPg bytea support

MySQL

• MySQL Driver - EXPERIMENTAL
• MySQL supported types
• MySQL driver design and implementation details

Non relational databases

• MongoDB
• Redis
• ClickHouse Driver

Opensource

• API and ABI stability, versioning
• Driver Writing Guide
• Build instructions for userver
• Publications and Videos
• Notice to external contributors
• Security Policy
• Security Changelog
• Distributed under Apache-2.0 License
  • Third Party Code Licenses