XPLPC - Cross Platform Lite Procedure Call

Project

The XPLPC project connects languages and platforms, allowing for the transfer of serialized data between them. This is achieved without the need for a server, but instead by utilizing device memory. This approach is known as Lite Procedure Call.

The Platform Proxy class plays a crucial role in this process by connecting both languages and platforms, and facilitating the transfer of data using device memory instead of the HTTP protocol. This allows for a more efficient and streamlined communication process.

For example, you can call a procedure written in C++ code from a mobile application, or vice versa, with ease. This opens up a wide range of possibilities for developers and allows for a more seamless integration of different languages and platforms.

The XPLPC project is also highly user-friendly, as it does not require the use of generators or additional tools. This means that the generated library can be added to your existing project without the need for any rewriting of code. This plug-and-play feature allows for full code reuse and makes the integration process smooth and hassle-free.

Workflow

How to use

Using C++ code:

auto request = Request{
    "sample.login",
    Param<std::string>{"username", "paulo"},
    Param<std::string>{"password", "123456"},
    Param<bool>{"remember", true},
};

Client::call<std::string>(request, [](const auto &response) {
    std::cout << "Returned Value: " << (response ? response.value() : "Empty") << std::endl;
});

Using Kotlin code:

val request = Request(
    "sample.login",
    Param("username", "paulo"),
    Param("password", "123456"),
    Param("remember", true)
)

Client.call<String>(request) { response ->
    println("Returned Value: $response")
}

Using Swift code:

let request = Request(
    "sample.login",
    Param("username", "paulo"),
    Param("password", "123456"),
    Param("remember", true)
)

Client.call(request) { (response: String?) in
    print("Returned Value: \(response)")
}

Using WASM with Typescript:

const request = new XRequest(
    "sample.login",
    new XParam("username", "paulo"),
    new XParam("password", "123456"),
    new XParam("remember", true),
);

XClient.call<string>(request).then((response : string | undefined) => {
    console.log("Returned Value: " + response);
});

Using Flutter with Dart:

var request = Request("sample.login", [
    Param("username", "paulo"),
    Param("password", "123456"),
    Param("remember", true),
]);

Client.call<String>(request, (response) {
    print(response);
});

Using Python code:

request = Request(
    "sample.login",
    [
        Param("username", "paulo"),
        Param("password", "123456"),
        Param("remember", True),
    ],
)

response = Client.call(request)
print(response)

Obs: There are syntax suggar for async/await/future calls, see the documentation about each language/platform.

Supported languages and platforms

• C
• C++
• Kotlin (Android, Desktop)
• Swift (iOS, macOS, tvOS, watchOS, Catalyst)
• WebAssembly
• Flutter (iOS, Android, Desktop)
• Python

Documentation

• General
• C
• C++
• Kotlin
• Swift
• WebAssembly
• Flutter
• Python
• Dependency Manager
• Contribution
• Purpose

License

MIT

Copyright (c) 2022-2024, Paulo Coutinho