mobileproxy clib

x/examples/mobileproxy-clib/.gitignore

@@ -0,0 +1 @@
+demo/bin

x/examples/mobileproxy-clib/README.md

@@ -0,0 +1,19 @@
+# Mobileproxy CLib Wrapper
+
+This is a C wrapper for the mobileproxy library. It is intended to be used downstream by native wrappers like Swift or Java.
+
+## Demo
+
+To run the demo, you first must build the library for your platform. You can build it by running:
+
+```bash
+cd x
+
+CGO_ENABLED=1 go build -buildmode=c-shared -o=examples/mobileproxy-clib/demo/bin github.com/Jigsaw-Code/outline-sdk/x/examples/mobileproxy-clib
+```
+
+Then, you can run the demo by running:
+
+```bash
+TODO
+```

x/examples/mobileproxy-clib/demo/demo.c

@@ -0,0 +1,44 @@
+// Copyright 2024 Jigsaw Operations LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// -- WORK IN PROGRESS --
+
+#include <stdio.h>
+#include <bin/mobileproxy-clib.h>
+
+// Is there a way to import these? Or do we need to define them ourselves?
+typedef unsigned int StreamDialerPtr;
+typedef unsigned int ProxyPtr;
+
+int main()
+{
+  StreamDialerPtr *dialer;
+  ProxyPtr *proxy;
+
+  dialer = NewStreamDialerFromConfig("split:3");
+  proxy = RunProxy("127.0.0.1:1234", dialer); // Is this call blocking? Do we need to run it in another thread?
+
+  // TODO: Wait for terminate key, we may read from console using fgetc
+  // Signal (i.e. Ctrl+C) is a Unix/Linux only API, Windows doesn't use it
+  // So it also depends on whether we need the program to be cross-platform
+  printf("Running proxy on 127.0.0.1:1234. Press <Enter> to terminate: ");
+
+  // Stop the proxy and clean up
+  StopProxy(proxy, 1000);
+
+  DeleteProxy(proxy);
+  DeleteStreamDialer(dialer);
+
+  return 0;
+}

x/examples/mobileproxy-clib/main.go

@@ -0,0 +1,87 @@
+// Copyright 2024 Jigsaw Operations LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package main
+
+// #include <stdlib.h>
+import (
+	"C"
+	"runtime/cgo"
+	"unsafe"
+
+	"github.com/Jigsaw-Code/outline-sdk/x/mobileproxy"
+)
+
+type StreamDialerPtr = unsafe.Pointer
+type ProxyPtr = unsafe.Pointer
+
+//export NewStreamDialerFromConfig
+func NewStreamDialerFromConfig(config *C.char) StreamDialerPtr {
+	streamDialerObject, err := mobileproxy.NewStreamDialerFromConfig(C.GoString(config))
+
+	if err != nil {
+		// TODO: print something?
+		return unsafe.Pointer(nil)
+	}
+
+	streamDialerHandle := cgo.NewHandle(streamDialerObject)
+
+	return unsafe.Pointer(&streamDialerHandle)
+}
+
+//export RunProxy
+func RunProxy(address *C.char, dialer StreamDialerPtr) ProxyPtr {
+	dialerObject := (*cgo.Handle)(dialer).Value().(mobileproxy.StreamDialer)
+
+	proxyObject, err := mobileproxy.RunProxy(C.GoString(address), &dialerObject)
+
+	if err != nil {
+		// TODO: print something?
+		return unsafe.Pointer(nil)
+	}
+
+	handle := cgo.NewHandle(proxyObject)
+
+	return unsafe.Pointer(&handle)
+}
+
+//export AddURLProxy
+func AddURLProxy(proxy ProxyPtr, url *C.char, dialer StreamDialerPtr) {
+	proxyObject := (*cgo.Handle)(proxy).Value().(mobileproxy.Proxy)
+	dialerObject := (*cgo.Handle)(dialer).Value().(mobileproxy.StreamDialer)
+
+	proxyObject.AddURLProxy(C.GoString(url), &dialerObject)
+}
+
+//export StopProxy
+func StopProxy(proxy ProxyPtr, timeoutSeconds C.uint) {
+	proxyObject := (*cgo.Handle)(proxy).Value().(mobileproxy.Proxy)
+
+	proxyObject.Stop(int(timeoutSeconds))
+}
+
+//export DeleteStreamDialer
+func DeleteStreamDialer(dialer StreamDialerPtr) {
+	(*cgo.Handle)(dialer).Delete()
+}
+
+//export DeleteProxy
+func DeleteProxy(proxy ProxyPtr) {
+	(*cgo.Handle)(proxy).Delete()
+}
+
+func main() {
+	// We need the main function to make possible
+	// CGO compiler to compile the package as C shared library
+}