SiddiqSoft.sip2json 3.0.1

sip2json: A Focused SIP Parser for Modern C++

sip2json is a header-only Modern C++20 SIP protocol parser and serializer library designed with nlohmann::json as a first-class API metaphor for seamlessly converting SIP protocol messages to/from JSON for NoSQL databases and distributed event processing.

Documentation

siddiqsoft.github.io/sip2json

• Quick Start & Integration
• Asynchronous Stream Parsing
• Performance & Benchmarks
• JSON Schema Metaphor
• API Reference

Quick Example

#include <iostream>
#include "siddiqsoft/sip2json.hpp"

using namespace siddiqsoft;

void onNetworkDataReceived(std::string& tcpReadBuffer)
{
    // Asynchronously parse multiple SIP frames from buffer
    sip2json::parseAsync(
        tcpReadBuffer,
        [](sipmessage&& msg) {
            if (!msg.empty()) {
                std::cout << "Parsed " << msg.getMethod() << " Call-ID: " << msg.getCallID() << "\n";
            }
        },
        [](const sip2json_exception& ex, std::string::iterator& start, const std::string::iterator& end) {
            std::cerr << "Parser warning: " << ex.what() << "\n";
        }
    );
    // Note: sip2json::parseAsync automatically erases decoded messages from tcpReadBuffer.
}

Standards Compliance & Certification Test Suite

sip2json includes an automated test suite featuring dedicated RFC compliance and torture test suites located in tests/compliance/:

• RFC 3261 Core Compliance (tests/compliance/rfc3261_compliance_tests.cpp): Validates 14 standard RFC request methods, status line classes (1xx-6xx), case-insensitive header canonicalization (vIa, fRoM, cALL-id), 10 compact header abbreviations (v, f, t, i, c, l, m, s, k, e), and body framing.
• RFC 4475 SIP Torture Tests (tests/compliance/rfc4475_torture_tests.cpp): All 50 official bit-exact IETF torture test cases (.dat files) including multiline header folding with LWSP (\r\n\t / \r\n ), non-ASCII & empty reason phrases, URI escaping, unknown extension header preservation, multiple Via header array formatting, negative Content-Length rejection, and truncated stream buffer handling.
• SIP Standard Certification Suite (tests/compliance/sip_certification_suite.cpp): Full end-to-end certification for RFC 3261, RFC 3262 (PRACK), RFC 6665 (Event/Subscription-State), RFC 3515 (REFER), and RFC 3903 (PUBLISH).
• SDP RFC 4566 / 8866 / 3264 / WebRTC (RFC 8829 / 8839) Compliance Suite (tests/compliance/sdp_compliance_tests.cpp): Complete Session Description Protocol parsing, Offer/Answer direction flags (sendrecv, sendonly, recvonly, inactive), WebRTC BUNDLE media grouping (a=group:BUNDLE), ICE candidates (a=candidate), ICE credentials (a=ice-ufrag, a=ice-pwd), DTLS fingerprints (a=fingerprint), multiple SDP session blocks (v=0 demarcation), and UNIX \n line endings.

License

Licensed under the BSD 3-Clause License.