https://github.com/kamchatka-volcano/hot_teacup

C++17 library for parsing HTTP requests data received over the FastCGI connection and forming HTTP responses.
https://github.com/kamchatka-volcano/hot_teacup

cpp17 fast-cgi fcgi http

Last synced: about 1 month ago
JSON representation

C++17 library for parsing HTTP requests data received over the FastCGI connection and forming HTTP responses.

• Host: GitHub
• URL: https://github.com/kamchatka-volcano/hot_teacup
• Owner: kamchatka-volcano
• License: ms-pl
• Created: 2021-09-27T15:21:03.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-10-12T19:19:28.000Z (3 months ago)
• Last Synced: 2024-10-30T02:03:28.294Z (about 2 months ago)
• Topics: cpp17, fast-cgi, fcgi, http
• Language: C++
• Homepage:
• Size: 115 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# ☕hot_teacup

[![build & test (clang, gcc, MSVC)](https://github.com/kamchatka-volcano/hot_teacup/actions/workflows/build_and_test.yml/badge.svg?branch=master)](https://github.com/kamchatka-volcano/hot_teacup/actions/workflows/build_and_test.yml)

**hot_teacup** is a C++17 library for parsing HTTP request data received over a FastCGI connection and forming HTTP responses. It supports reading HTTP headers, cookies, query strings, URL encoded forms, and multipart forms. The library is designed for use with the FastCGI protocol, so input data is expected to be percent-decoded by the web server. The headers are self-explanatory, so there is no documentation. If you need examples of usage, you can also check the unit tests.

### Installation

Download and link the library from your project's CMakeLists.txt:

```

cmake_minimum_required(VERSION 3.14)

include(FetchContent)

FetchContent_Declare(hot_teacup

    GIT_REPOSITORY "https://github.com/kamchatka-volcano/hot_teacup.git"

    GIT_TAG "origin/master"

)

#uncomment if you need to install hot_teacup with your target

#set(INSTALL_HOT_TEACUP ON)

FetchContent_MakeAvailable(hot_teacup)

add_executable(${PROJECT_NAME})

target_link_libraries(${PROJECT_NAME} PRIVATE hot_teacup::hot_teacup)

```

To install the library system-wide, use the following commands:

```

git clone https://github.com/kamchatka-volcano/hot_teacup.git

cd hot_teacup

cmake -S . -B build

cmake --build build

cmake --install build

```

After installation, you can use the `find_package()` command to make the installed library available inside your project:

```

find_package(hot_teacup 1.0.0 REQUIRED)

target_link_libraries(${PROJECT_NAME} PRIVATE hot_teacup::hot_teacup)

```

### Running tests

```

cd hot_teacup

cmake -S . -B build -DENABLE_TESTS=ON

cmake --build build 

cd build/tests && ctest

```

### License

**hot_teacup** is licensed under the [MS-PL license](/LICENSE.md)