feat(examples): add a very WIP, basic http client example

examples/http-client-curl/main.d

@@ -0,0 +1,64 @@
+// Purpose: This is a simple command line tool that uses the higher-level HttpClient stuff
+//          to send out a simple HTTP request and print the response to stdout.
+//
+//          Additionally this example is showing a more GC-friendly way of using Juptune.
+
+import core.time;
+import juptune.core.ds, juptune.core.util, juptune.event, juptune.http;
+
+__gshared string[] g_args;
+__gshared int g_statusCode;
+
+int main(string[] args)
+{
+    g_args = args;
+
+    auto loop = EventLoop(EventLoopConfig());
+    loop.addGCThread(() nothrow {
+        try curl();
+        catch(Exception ex)
+        {
+            import std.stdio     : stderr;
+            import std.exception : assumeWontThrow;
+
+            stderr.writeln(ex).assumeWontThrow;
+            g_statusCode = 1;
+        }
+    });
+    loop.join();
+
+    return g_statusCode;
+}
+
+void curl()
+{
+    // CLI interface is super raw because this is just a barebones example right now.
+    // I want to make this a lot more elaborate in the future.
+    IpAddress address;
+    IpAddress.parse(address, g_args[1], 80).throwIfError;
+
+    scope client = HttpClient(HttpClientConfig());
+    client.connect(address).throwIfError;
+
+    scope request = HttpRequest();
+    request.withMethod("GET");
+    request.withPath("/");
+    request.setHeader("Connection", "close");
+
+    scope HttpResponse response;
+    client.request(request, response).throwIfError;
+
+    // Print the response to stdout.
+    import std.stdio : writefln;
+
+    writefln("%s %s", response.status, response.reason[]);
+    foreach(ref header; response.headers[])
+        writefln("%s: %s", header.name[], header.value[]);
+    writefln("\n%s", cast(char[])response.body[]);
+}
+
+void throwIfError(Result result)
+{
+    if(result.isError)
+        throw new Exception(result.error);
+}

meson.build

@@ -86,6 +86,7 @@ juptune_all_dep = declare_dependency(
 examples = {
     'http-hello-world-hardcoded': ['./examples/http-hello-world-hardcoded/main.d'],
     'http-echo-low-level': ['./examples/http-echo-low-level/main.d'],
+    'http-client-curl': ['./examples/http-client-curl/main.d'],
 }
 
 foreach example_name, example_srcs : examples

src/juptune/http/client.d

@@ -156,7 +156,7 @@ struct HttpClient
      +
      + Please note that the `HttpResponse` does not contain a body - it only contains the headers and status line.
      +
-     + Please note that this is marked `@safe`` to help make it clear that the `scope` for `bodyChunk` is
+     + Please note that this is marked `@safe` to help make it clear that the `scope` for `bodyChunk` is
      + _very_ important to adhear to.
      +
      + You can (and probably will have to) mark your func/lambda as `@trusted`, 
@@ -246,6 +246,13 @@ struct HttpClient
     Result connect(IpAddress ip) @nogc nothrow
     in(!this._isConnected, "This client is already connected")
     {
+        if(!this._socket.isOpen)
+        {
+            auto result = this._socket.open();
+            if(result.isError)
+                return result;
+        }
+
         auto result = this._socket.connect(ip);
         if(result.isError)
             return result;