The C++ Asynchronous Framework

Your opinion will help to improve our service

Leave a feedback >

Table of Contents

• Community and Telegram Support chats
• Source codes and service templates at github
• Introduction
• Install
• Tutorial
• Generic development
• Code generation
• Testing and Benchmarking
• Protocols
• Runtime service features
• Caches
• PostgreSQL
• MySQL
• Apache Kafka
• YDB
• Non relational databases
• Libraries
• Opensource

🐙 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.

Community and Telegram Support chats

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

Source codes and service templates at github

Ready-to-use services templates and the source codes of the framework itself are available at the userver-framework at github.

Introduction

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

Install

• Configure, Build and Install
• Build dependencies
• Build options
• Build instructions for userver's own samples, tests and benchmarks

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
• gRPC middleware
• PostgreSQL service
• MongoDB service
• Redis service
• Kafka service
• Custom Authorization/Authentication via PostgreSQL
• Digest Authorization/Authentication via PostgreSQL
• Writing your WebSocket service
• File uploads and multipart/form-data testing
• S3 client tutorial
• Non-Coroutine Console Tool

Generic development

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

Code generation

• Codegen overview
• JSON schema codegen - the Chaotic
• External SQL/YQL files

Testing and Benchmarking

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

Protocols

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

Runtime service features

• Dynamic config
• Dynamic config schemas
• Logging at runtime
• Inspecting in-flight requests
• Service Statistics and Metrics (Prometheus/Graphite/...)
• Memory profiling a production service
• Controlling DNS
• Handling OS signals
• Deadline propagation
• Congestion Control
• Coroutine stack

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: PostgreSQL user type mappings

MySQL

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

Apache Kafka

• Apache Kafka

YDB

• YDB

Non relational databases

• MongoDB
• Redis
• ClickHouse Driver

Libraries

• Easy - library for single file prototyping
• S3 API
• gRPC reflection

Opensource

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