KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

swish

★ 63 Open GitHub ↗

C++ HTTP requests for humans

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Swish
 ![](https://raw.githubusercontent.com/lamarrr/swish/master/assets/icon.png) 
 
## Overview 
Swish is a Modern C++ 17 HTTP client library for Humans

Swish is for the most parts, A simple libcurl wrapper which provides, data structures and type safe OOP abstractions to make operating with libcurl much easier and pain free as compared to error-prone manual manipulation of net. sockets.

## Features
- Provides implementations for GET, POST (Multipart and Form Fields), DELETE, HEAD, TRACE etc.
- Fast file download
- Simple and expressive API (type safe OOP)
- Byte type customization
- Almost zero cost abstraction
- Supports local file://location
- Custom data structures for ease of use
- Proxy and OAuth support

## Installation
- Install libcurl (7.60.0 or higher)
- clone this repo
- build and install using cmake e.g. For linux users
	
```bash	
user@pc:~$ cmake .
user@pc:~$ sudo make install
```

- *or* copy the *swish* directory to your project's local or global include path

## Quick Start

```cpp
/**
 * @file: example.cc
 *
 */
#include <swish/swish.h>

using namespace swish;

int main() {
  // create a new HTTP client
  auto client = Client();

// Perform request
  auto [response, status] = client.Get("https://github.com");

// Check if any errors occured
  if (IsOK(status)) {
    // convert body buffer to std::basic_string<char> aka std::string
    std::cout << response.body.ToString() << "\n";

} else {
    // Interpret status code to english
    std::cerr << "The following Error occured: " << InterpretStatusCode(status)
              << "\n";
  }

return EXIT_SUCCESS;
}
```

## Building
Swish depends on libcurl, ensure you have an active installation.
Compile with the -lcurl postfix flag e.g in clang :
	
```bash
user@pc:~$ clang++ -std=c++17 example.cc -o example.o -lcurl
user@pc:~$ clang++ -std=c++17 example.cc -o example.o -lcurl
user@pc:~$ ./example.o
```

swish

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README