# connx

**Repository Path**: shadowyuan/connx

## Basic Information

- **Project Name**: connx
- **Description**: A cross-platform networking library in C/C++ for client-side SDKs — the connectivity foundation for your applications.
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# connx

> Cross-platform client networking foundation — the connectivity base for your SDKs and applications.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![C/C++](https://img.shields.io/badge/C%2FC%2B%2B-11-blue.svg)](https://isocpp.org/)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()

**connx** is a lightweight, cross-platform networking library written in C/C++. It provides the essential building blocks for client-side network connections — the "bottom layer" for applications that need to communicate with servers. With a clean C API at its core, connx enables seamless bindings to other languages such as Python, Java, and beyond.

## Why connx?

Building SDKs and client applications often requires the same networking foundation: connecting to servers, managing sessions, handling timeouts, and maintaining stability across platforms. connx wraps this complexity into a simple, reliable core — letting you focus on your application logic, not the transport layer.

- **Cross-platform** — Works on Windows, Linux, and macOS with consistent behavior.
- **C-first API** — Stable ABI, perfect for creating bindings to other languages.
- **Multi-language ready** — Core is designed for easy FFI integration (Python, Java, etc.).
- **Lightweight** — Minimal dependencies, small footprint.
- **Built for clients** — Optimized for client-side use cases, not servers.

## Features

- TCP client connections with synchronous and asynchronous modes
- SSL/TLS support (optional)
- Connection pooling
- Configurable timeouts and retries
- Thread-safe design
- Event-driven architecture

## Quick Example

```c
#include "connx.h"

int main() {
    // TODO:
    return 0;
}
```

## Bindings

The C API serves as the foundation for language bindings:

| Language | Status |
|----|------|
| `Python` | ✅ Planned |
| `Java` | ✅ Planned |
| `C++` | ✅ Native wrapper included |

## Build

```shell
git clone https://gitee.com/shadowyuan/connx.git
cd connx
mkdir build && cd build
cmake ..
make
sudo make install
```

## Requirements

- CMake 3.14+
- C11 / C++11 compatible compiler
- OpenSSL (optional, for TLS support)

## License

MIT License — see LICENSE for details.