diff --git a/README.md b/README.md index a9c12b1..2706bc6 100644 --- a/README.md +++ b/README.md @@ -16,25 +16,21 @@ web application framework](https://facil.io). ## **⚡ZAP⚡ IS FAST, ROBUST, AND STABLE** -After having used ZAP in production for a year, I can confidently assert that it +After having used ZAP in production for years, I can confidently assert that it proved to be: - ⚡ **blazingly fast** ⚡ - 💪 **extremely robust** 💪 -Exactly the goals I set out to achieve! - ## FAQ: - Q: **What version of Zig does Zap support?** - - Zap uses the latest stable zig release (0.13.0), so you don't have to keep + - Zap uses the latest stable zig release (0.14.0), so you don't have to keep up with frequent breaking changes. It's an "LTS feature". - Q: **Can Zap build with Zig's master branch?** - - See the `zig-master` branch. An example of how to use it is - [here](https://github.com/zigzap/hello-master). Please note that the - zig-master branch is not the official master branch of ZAP. Be aware that - I don't provide `build.zig.zon` snippets or tagged releases for it for - the time being. If you know what you are doing, that shouldn't stop you + - See the `zig-master` branch. Please note that the zig-master branch is not + the official master branch of ZAP. Be aware that I don't provide tagged + releases for it. If you know what you are doing, that shouldn't stop you from using it with zig master though. - Q: **Where is the API documentation?** - Docs are a work in progress. You can check them out @@ -43,7 +39,7 @@ Exactly the goals I set out to achieve! - Q: **Does ZAP work on Windows?** - No. This is due to the underlying facil.io C library. Future versions of facil.io might support Windows but there is no timeline yet. Your best - options on Windows are WSL2 or a docker container. + options on Windows are **WSL2 or a docker container**. - Q: **Does ZAP support TLS / HTTPS?** - Yes, ZAP supports using the system's openssl. See the [https](./examples/https/https.zig) example and make sure to build with @@ -55,29 +51,43 @@ Exactly the goals I set out to achieve! ## Here's what works -I recommend checking out **Endpoint-based examples for more realistic -use cases**. Most of the examples are super stripped down to only include -what's necessary to show a feature. +**NOTE:** I recommend checking out **the new App-based** or the Endpoint-based +examples, as they reflect how I intended Zap to be used. -**NOTE: To see API docs, run `zig build run-docserver`.** To specify a custom +Most of the examples are super stripped down to only include what's necessary to +show a feature. + +**To see API docs, run `zig build run-docserver`.** To specify a custom port and docs dir: `zig build docserver && zig-out/bin/docserver --port=8989 --docs=path/to/docs`. -- **Super easy build process**: Zap's `build.zig` now uses the new Zig package - manager for its C-dependencies, no git submodules anymore. - - _tested on Linux and macOS (arm, M1)_ -- **[hello](examples/hello/hello.zig)**: welcomes you with some static HTML -- **[routes](examples/routes/routes.zig)**: a super easy example dispatching on - the HTTP path. **NOTE**: The dispatch in the example is a super-basic - DIY-style dispatch. See endpoint-based examples for more realistic use cases. -- **[serve](examples/serve/serve.zig)**: the traditional static web server with - optional dynamic request handling -- **[sendfile](examples/sendfile/sendfile.zig)**: simple example of how to send - a file, honoring compression headers, etc. -- **[bindataformpost](examples/bindataformpost/bindataformpost.zig)**: example - to receive binary files via form post. -- **[hello_json](examples/hello_json/hello_json.zig)**: serves you json - dependent on HTTP path +### New App-Based Examples + +- **[app_basic](examples/app/basic.zig)**: Shows how to use zap.App with a +simple Endpoint. +- **[app_basic](examples/app/auth.zig)**: Shows how to use zap.App with an +Endpoint using an Authenticator. + +See the other examples for specific uses of Zap. + +Benefits of using `zap.App`: + +- Provides a global, user-defined "Application Context" to all endpoints. +- Made to work with "Endpoints": an endpoint is a struct that covers a `/slug` + of the requested URL and provides a callback for each supported request method + (get, put, delete, options, post, head, patch). +- Each request callback receives: + - a per-thread arena allocator you can use for throwaway allocations without + worrying about freeing them. + - the global "Application Context" of your app's choice +- Endpoint request callbacks are allowed to return errors: + - you can use `try`. + - the endpoint's ErrorStrategy defines if runtime errors should be reported to + the console, to the response (=browser for debugging), or if the error + should be returned. + +### Legacy Endpoint-based examples + - **[endpoint](examples/endpoint/)**: a simple JSON REST API example featuring a `/users` endpoint for performing PUT/DELETE/GET/POST operations and listing users, together with a simple frontend to play with. **It also introduces a @@ -87,26 +97,16 @@ port and docs dir: `zig build docserver && zig-out/bin/docserver --port=8989 `GeneralPurposeAllocator` to report memory leaks when ZAP is shut down. The [StopEndpoint](examples/endpoint/stopendpoint.zig) just stops ZAP when receiving a request on the `/stop` route. -- **[mustache](examples/mustache/mustache.zig)**: a simple example using - [mustache](https://mustache.github.io/) templating. - **[endpoint authentication](examples/endpoint_auth/endpoint_auth.zig)**: a simple authenticated endpoint. Read more about authentication [here](./doc/authentication.md). -- **[http parameters](examples/http_params/http_params.zig)**: a simple example - sending itself query parameters of all supported types. -- **[cookies](examples/cookies/cookies.zig)**: a simple example sending itself a - cookie and responding with a session cookie. -- **[websockets](examples/websockets/)**: a simple websockets chat for the - browser. -- **[Username/Password Session - Authentication](./examples/userpass_session_auth/)**: A convenience - authenticator that redirects un-authenticated requests to a login page and - sends cookies containing session tokens based on username/password pairs - received via POST request. + + +### Legacy Middleware-Style examples + - **[MIDDLEWARE support](examples/middleware/middleware.zig)**: chain together request handlers in middleware style. Provide custom context structs, totally - type-safe, using **[ZIG-CEPTION](doc/zig-ception.md)**. If you come from GO - this might appeal to you. + type-safe. If you come from GO this might appeal to you. - **[MIDDLEWARE with endpoint support](examples/middleware_with_endpoint/middleware_with_endpoint.zig)**: Same as the example above, but this time we use an endpoint at the end of the @@ -126,6 +126,36 @@ port and docs dir: `zig build docserver && zig-out/bin/docserver --port=8989 struct in the callbacks via the `@fieldParentPtr()` trick that is used extensively in Zap's examples, like the [endpoint example](examples/endpoint/endpoint.zig). + +### Specific and Very Basic Examples + +- **[hello](examples/hello/hello.zig)**: welcomes you with some static HTML +- **[routes](examples/routes/routes.zig)**: a super easy example dispatching on + the HTTP path. **NOTE**: The dispatch in the example is a super-basic + DIY-style dispatch. See endpoint-based examples for more realistic use cases. +- [**simple_router**](examples/simple_router/simple_router.zig): See how you + can use `zap.Router` to dispatch to handlers by HTTP path. +- **[serve](examples/serve/serve.zig)**: the traditional static web server with + optional dynamic request handling +- **[sendfile](examples/sendfile/sendfile.zig)**: simple example of how to send + a file, honoring compression headers, etc. +- **[bindataformpost](examples/bindataformpost/bindataformpost.zig)**: example + to receive binary files via form post. +- **[hello_json](examples/hello_json/hello_json.zig)**: serves you json + dependent on HTTP path +- **[mustache](examples/mustache/mustache.zig)**: a simple example using + [mustache](https://mustache.github.io/) templating. +- **[http parameters](examples/http_params/http_params.zig)**: a simple example + sending itself query parameters of all supported types. +- **[cookies](examples/cookies/cookies.zig)**: a simple example sending itself a + cookie and responding with a session cookie. +- **[websockets](examples/websockets/)**: a simple websockets chat for the + browser. +- **[Username/Password Session + Authentication](./examples/userpass_session_auth/)**: A convenience + authenticator that redirects un-authenticated requests to a login page and + sends cookies containing session tokens based on username/password pairs + received via POST request. - [**Error Trace Responses**](./examples/senderror/senderror.zig): You can now call `r.sendError(err, status_code)` when you catch an error and a stack trace will be returned to the client / browser. @@ -136,12 +166,6 @@ port and docs dir: `zig build docserver && zig-out/bin/docserver --port=8989 - run it like this: `ZAP_USE_OPENSSL=true zig build run-https` OR like this: `zig build -Dopenssl=true run-https` - it will tell you how to generate certificates -- [**simple_router**](examples/simple_router/simple_router.zig): See how you - can use `zap.Router` to dispatch to handlers by HTTP path. - -I'll continue wrapping more of facil.io's functionality and adding stuff to zap -to a point where I can use it as the JSON REST API backend for real research -projects, serving thousands of concurrent clients. ## ⚡blazingly fast⚡ @@ -158,25 +182,7 @@ machine (x86_64-linux): - Zig Zap was nearly 30% faster than GO - Zig Zap had over 50% more throughput than GO - -**Update**: Thanks to @felipetrz, I got to test against more realistic Python -and Rust examples. Both python `sanic` and rust `axum` were easy enough to -integrate. - -**Update**: I have automated the benchmarks. See -[blazingly-fast.md](./blazingly-fast.md) for more information. Also, thanks to -@alexpyattaev, the benchmarks are fairer now, pinning server and client to -specific CPU cores. - -**Update**: I have consolidated the benchmarks to one good representative per -language. See more details in [blazingly-fast.md](./blazingly-fast.md). It -contains rust implementations that come pretty close to Zap's performance in the -simplistic testing scenario. - -![](./wrk/samples/README_req_per_sec.png) - -![](./wrk/samples/README_xfer_per_sec.png) - +- **YMMV !!!** So, being somewhere in the ballpark of basic GO performance, zig zap seems to be ... of reasonable performance 😎. @@ -184,7 +190,38 @@ So, being somewhere in the ballpark of basic GO performance, zig zap seems to be I can rest my case that developing ZAP was a good idea because it's faster than both alternatives: a) staying with Python, and b) creating a GO + Zig hybrid. -See more details in [blazingly-fast.md](blazingly-fast.md). +### On (now missing) Micro-Benchmakrs + +I used to have some micro-benchmarks in this repo, showing that Zap beat all the +other things I tried, and eventually got tired of the meaningless discussions +they provoked, the endless issues and PRs that followed, wanting me to add and +maintain even more contestants, do more justice to beloved other frameworks, +etc. + +Case in point, even for me the micro-benchmarks became meaningless. They were +just some rough indicator to me confirming that I didn't do anything terribly +wrong to facil.io, and that facil.io proved to be a reasonable choice, also from +a performance perspective. + +However, none of the projects I use Zap for, ever even remotely resembled +anything close to a static HTTP response micro-benchmark. + +For my more CPU-heavy than IO-heavy use-cases, a thread-based microframework +that's super robust is still my preferred choice, to this day. + +Having said that, I would **still love** for other, pure-zig HTTP frameworks to +eventually make Zap obsolete. Now, in 2025, the list of candidates is looking +really promising. + +### 📣 Shout-Outs + +- [httpz](https://github.com/karlseguin/http.zig) : Pure Zig! Closer to Zap's + model. Performance = good! +- [jetzig](https://github.com/jetzig-framework/jetzig) : Comfortably develop + modern web applications quickly, using http.zig under the hood +- [zzz](https://github.com/tardy-org/zzz) : Super promising, super-fast, +especially for IO-heavy tasks, io_uring support - need I say more? + ## 💪 Robust @@ -217,9 +254,10 @@ local variables that require tens of megabytes of stack space. ### 🛡️ Memory-safe See the [StopEndpoint](examples/endpoint/stopendpoint.zig) in the -[endpoint](examples/endpoint) example. That example uses ZIG's awesome -`GeneralPurposeAllocator` to report memory leaks when ZAP is shut down. The -`StopEndpoint` just stops ZAP when receiving a request on the `/stop` route. +[endpoint](examples/endpoint) example. The `StopEndpoint` just stops ZAP when +receiving a request on the `/stop` route. That example uses ZIG's awesome +`GeneralPurposeAllocator` in [main.zig](examples/endpoint/main.zig) to report +memory leaks when ZAP is shut down. You can use the same strategy in your debug builds and tests to check if your code leaks memory. @@ -228,7 +266,7 @@ code leaks memory. ## Getting started -Make sure you have **zig 0.13.0** installed. Fetch it from +Make sure you have **zig 0.14.0** installed. Fetch it from [here](https://ziglang.org/download). ```shell @@ -237,12 +275,11 @@ $ cd zap $ zig build run-hello $ # open http://localhost:3000 in your browser ``` - ... and open [http://localhost:3000](http://localhost:3000) in your browser. ## Using ⚡zap⚡ in your own projects -Make sure you have **the latest zig release (0.13.0)** installed. Fetch it from +Make sure you have **the latest zig release (0.14.0)** installed. Fetch it from [here](https://ziglang.org/download). If you don't have an existing zig project, create one like this: @@ -250,17 +287,11 @@ If you don't have an existing zig project, create one like this: ```shell $ mkdir zaptest && cd zaptest $ zig init -$ git init ## (optional) ``` -**Note**: Nix/NixOS users are lucky; you can use the existing `flake.nix` and run -`nix develop` to get a development shell providing zig and all -dependencies to build and run the GO, python, and rust examples for the -`wrk` performance tests. For the mere building of zap projects, -`nix develop .#build` will only fetch zig 0.11.0. TODO: upgrade to latest zig. With an existing Zig project, adding Zap to it is easy: -1. Add zap to your `build.zig.zon` +1. Zig fetch zap 2. Add zap to your `build.zig` In your zig project folder (where `build.zig` is located), run: @@ -284,26 +315,9 @@ Then, in your `build.zig`'s `build` function, add the following before exe.root_module.addImport("zap", zap.module("zap")); ``` -From then on, you can use the Zap package in your project. Check out the -examples to see how to use Zap. +From then on, you can use the Zap package in your project via `const zap = +@import("zap");`. Check out the examples to see how to use Zap. -## Updating your project to the latest version of zap - -You can change the URL to Zap in your `build.zig.zon` - -- easiest: use a tagged release -- or to one of the tagged versions, e.g. `0.0.9` -- or to the latest commit of `zap` - -### Using a tagged release - -Go to the [release page](https://github.com/zigzap/zap/releases). Every release -will state its version number and also provide instructions for changing -`build.zig.zon` and `build.zig`. - -### Using other versions - -See [here](./doc/other-versions.md). ## Contribute to ⚡zap⚡ - blazingly fast @@ -314,16 +328,7 @@ world a blazingly fast place by providing patches or pull requests, add documentation or examples, or interesting issues and bug reports - you'll know what to do when you receive your calling 👼. -Check out [CONTRIBUTING.md](CONTRIBUTING.md) for more details. - -See also [introducing.md](introducing.md) for more on the state and progress of -this project. - -**We now have our own [ZAP discord](https://discord.gg/jQAAN6Ubyj) server!!!** - -You can also reach me on [the zig showtime discord -server](https://discord.gg/CBzE3VMb) under the handle renerocksai -(renerocksai#1894). +**We have our own [ZAP discord](https://discord.gg/jQAAN6Ubyj) server!!!** ## Support ⚡zap⚡ diff --git a/blazingly-fast.md b/blazingly-fast.md deleted file mode 100644 index 41f186a..0000000 --- a/blazingly-fast.md +++ /dev/null @@ -1,332 +0,0 @@ -# ⚡blazingly fast⚡ - -Initially, I conducted a series of quick tests, using wrk with simple HTTP -servers written in GO and in zig zap. I made sure that all servers only output -17 bytes of HTTP body. - -Just to get some sort of indication, I also included measurements for python -since I used to write my REST APIs in python before creating zig zap. - -You can check out the scripts I used for the tests in [./wrk](wrk/). - -## Why - -I aimed to enhance the performance of my Python + Flask backends by replacing -them with a Zig version. To evaluate the success of this transition, I compared -the performance of a static HTTP server implemented in Python and its Zig -counterpart, which showed significant improvements. - -To further assess the Zig server's performance, I compared it with a Go -implementation, to compare against a widely used industry-standard. I expected -similar performance levels but was pleasantly surprised when Zap outperformed Go -by approximately 30% on my test machine. - -Intrigued by Rust's reputed performance capabilities, I also experimented with a -Rust version. The results of this experiment are discussed in the -[Flaws](#flaws) section below. - -## What - -So, what are the benchmarks testing? - -- simple http servers that reply to GET requests with a constant, 17-bytes long response -- 4 cores are assigned to the subject under test (the respective server) -- 4 cores are assigned to `wrk` - - using 4 threads - - aiming at 400 concurrent connections - -## How - -I have fully automated the benchmarks and graph generation. - -To generate the data: - -```console -$ ./wrk/measure_all.sh -``` - -To generate the graphs: - -```console -$ python wrk/graph.py -``` - -For dependencies, please see the [flake.nix](./flake.nix#L46). - -## Flaws - -The benchmarks have limitations, such as the lack of request latencies. The Rust -community has often criticized these benchmarks as biased. However, no such -criticisms have come from the Go or Python communities. - -In response to the Rust community's concerns, we've added three Rust -implementations for comparison: - -- A standard version from [the Rust book](https://doc.rust-lang.org/book/ch20-00-final-project-a-web-server.html). -- An "axum" version to highlight Rust's speed. -- A refined version of the Rust book version. - -Originally, the goal was to compare "batteries included" versions, which created -a disparity by comparing the optimized zap / facil.io code with basic bundled -functionalities. These tests were for personal interest and not meant to be -definitive benchmarks. - -To address this bias, we've added the Rust-axum and Python-sanic benchmarks. For -more information, refer to the relevant discussions and pull requests. - - -## More benchmarks? - -I often receive requests or PRs to include additional benchmarks, which a lot of -times I find to be either ego-driven or a cause for unnecessary disputes. People -tend to favor their preferred language or framework. Zig, Rust, C, and C++ are -all capable of efficiently creating fast web servers, with different frameworks -potentially excelling in certain benchmarks. My main concern was whether Zap, -given its current level of abstraction, could compete with standard web servers. -This question has been answered, and I see no need for further benchmarks. - -So far, we have the following benchmark subjects (implementations) which you'll -find in the graphs below: - -- **zig-zap** : ZAP implementation -- **go** : GO implementation -- **python** : Python implementation -- **python-sanic** : Python implementation with sanic framework -- **rust-bythebook** : Rust example from the Rust book (not representative) -- **rust-bythebook-improved** : Improved version of the by-the-book code (thx @alexpyattaev) -- **rust-clean** : A clean, straight-forward Rust implementation (thx @alexpyattaev) -- **rust-axum** : Rust implementation using the axum framework (realistic) -- **(csharp)** : CSharp implementation (thx @leo-costa) -- **cpp-beast** : A C++ implementation using boost::beast (thx @kassane) - - -## The computer makes the difference - -After automating the performance benchmarks, I gathered data from three -different computers. It's interesting to see the variation in relative numbers. - - -### The test machine (graphs in the README) - -![](./wrk/samples/req_per_sec_graph.png) - -![](./wrk/samples/xfer_per_sec_graph.png) - -``` -➜ neofetch --stdout -rs@ryzen --------- -OS: NixOS 23.05.997.ddf4688dc7a (Stoat) x86_64 -Host: Micro-Star International Co., Ltd. B550-A PRO (MS-7C56) -Kernel: 6.3.7 -Uptime: 15 days, 11 hours, 13 mins -Packages: 2094 (nix-system), 1356 (nix-user), 7 (flatpak) -Shell: bash 5.2.15 -Resolution: 3840x2160 -DE: none+i3 -WM: i3 -Terminal: tmux -CPU: AMD Ryzen 5 5600X (12) @ 3.700GHz -GPU: AMD ATI Radeon RX 6700/6700 XT/6750 XT / 6800M/6850M XT -Memory: 4981MiB / 32028MiB - - -➜ lscpu -Architecture: x86_64 - CPU op-mode(s): 32-bit, 64-bit - Address sizes: 48 bits physical, 48 bits virtual - Byte Order: Little Endian -CPU(s): 12 - On-line CPU(s) list: 0-11 -Vendor ID: AuthenticAMD - Model name: AMD Ryzen 5 5600X 6-Core Processor - CPU family: 25 - Model: 33 - Thread(s) per core: 2 - Core(s) per socket: 6 - Socket(s): 1 - Stepping: 0 - Frequency boost: enabled - CPU(s) scaling MHz: 67% - CPU max MHz: 4650.2920 - CPU min MHz: 2200.0000 - BogoMIPS: 7399.43 - Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext fxsr_opt - pdpe1gb rdtscp lm constant_tsc rep_good nopl nonstop_tsc cpuid extd_apicid aperfmperf rapl pni pclmulqdq monitor ssse3 fma cx16 - sse4_1 sse4_2 movbe popcnt aes xsave avx f16c rdrand lahf_lm cmp_legacy svm extapic cr8_legacy abm sse4a misalignsse 3dnowprefet - ch osvw ibs skinit wdt tce topoext perfctr_core perfctr_nb bpext perfctr_llc mwaitx cpb cat_l3 cdp_l3 hw_pstate ssbd mba ibrs ib - pb stibp vmmcall fsgsbase bmi1 avx2 smep bmi2 erms invpcid cqm rdt_a rdseed adx smap clflushopt clwb sha_ni xsaveopt xsavec xget - bv1 xsaves cqm_llc cqm_occup_llc cqm_mbm_total cqm_mbm_local clzero irperf xsaveerptr rdpru wbnoinvd arat npt lbrv svm_lock nrip - _save tsc_scale vmcb_clean flushbyasid decodeassists pausefilter pfthreshold avic v_vmsave_vmload vgif v_spec_ctrl umip pku ospk - e vaes vpclmulqdq rdpid overflow_recov succor smca fsrm -Virtualization features: - Virtualization: AMD-V -Caches (sum of all): - L1d: 192 KiB (6 instances) - L1i: 192 KiB (6 instances) - L2: 3 MiB (6 instances) - L3: 32 MiB (1 instance) -NUMA: - NUMA node(s): 1 - NUMA node0 CPU(s): 0-11 -Vulnerabilities: - Itlb multihit: Not affected - L1tf: Not affected - Mds: Not affected - Meltdown: Not affected - Mmio stale data: Not affected - Retbleed: Not affected - Spec store bypass: Mitigation; Speculative Store Bypass disabled via prctl - Spectre v1: Mitigation; usercopy/swapgs barriers and __user pointer sanitization - Spectre v2: Mitigation; Retpolines, IBPB conditional, IBRS_FW, STIBP always-on, RSB filling, PBRSB-eIBRS Not affected - Srbds: Not affected - Tsx async abort: Not affected -``` - -### Workstation at work - -A beast. Many cores (which we don't use). - -![](./wrk/samples/workstation_req_per_sec_graph.png) - -![](./wrk/samples/workstation_xfer_per_sec_graph.png) - -``` -[rene@nixos:~]$ neofetch --stdout -rene@nixos ----------- -OS: NixOS 23.05.2947.475d5ae2c4cb (Stoat) x86_64 -Host: LENOVO 1038 -Kernel: 6.1.46 -Uptime: 26 mins -Packages: 5804 (nix-system), 566 (nix-user) -Shell: bash 5.2.15 -Terminal: /dev/pts/2 -CPU: Intel Xeon Gold 5218 (64) @ 3.900GHz -GPU: NVIDIA Quadro P620 -GPU: NVIDIA Tesla M40 -Memory: 1610MiB / 95247MiB - - -[rene@nixos:~]$ lscpu -Architecture: x86_64 - CPU op-mode(s): 32-bit, 64-bit - Address sizes: 46 bits physical, 48 bits virtual - Byte Order: Little Endian -CPU(s): 64 - On-line CPU(s) list: 0-63 -Vendor ID: GenuineIntel - Model name: Intel(R) Xeon(R) Gold 5218 CPU @ 2.30GHz - CPU family: 6 - Model: 85 - Thread(s) per core: 2 - Core(s) per socket: 16 - Socket(s): 2 - Stepping: 7 - CPU(s) scaling MHz: 57% - CPU max MHz: 3900,0000 - CPU min MHz: 1000,0000 - BogoMIPS: 4600,00 - Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs b - ts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf pni pclmulqdq dtes64 monitor ds_cpl vmx smx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid dca sse4_1 sse4_2 x2apic movbe popcnt tsc_ - deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault epb cat_l3 cdp_l3 invpcid_single intel_ppin ssbd mba ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpri - ority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid cqm mpx rdt_a avx512f avx512dq rdseed adx smap clflushopt clwb intel_pt avx512cd avx512bw avx512vl xsaveopt xs - avec xgetbv1 xsaves cqm_llc cqm_occup_llc cqm_mbm_total cqm_mbm_local dtherm ida arat pln pts hwp hwp_act_window hwp_epp hwp_pkg_req pku ospke avx512_vnni md_clear flush_l1d arch_capabi - lities -Virtualization features: - Virtualization: VT-x -Caches (sum of all): - L1d: 1 MiB (32 instances) - L1i: 1 MiB (32 instances) - L2: 32 MiB (32 instances) - L3: 44 MiB (2 instances) -NUMA: - NUMA node(s): 2 - NUMA node0 CPU(s): 0-15,32-47 - NUMA node1 CPU(s): 16-31,48-63 -Vulnerabilities: - Gather data sampling: Mitigation; Microcode - Itlb multihit: KVM: Mitigation: VMX disabled - L1tf: Not affected - Mds: Not affected - Meltdown: Not affected - Mmio stale data: Mitigation; Clear CPU buffers; SMT vulnerable - Retbleed: Mitigation; Enhanced IBRS - Spec rstack overflow: Not affected - Spec store bypass: Mitigation; Speculative Store Bypass disabled via prctl - Spectre v1: Mitigation; usercopy/swapgs barriers and __user pointer sanitization - Spectre v2: Mitigation; Enhanced IBRS, IBPB conditional, RSB filling, PBRSB-eIBRS SW sequence - Srbds: Not affected - Tsx async abort: Mitigation; TSX disabled -``` - - -### Work Laptop - -Very strange. It absolutely **LOVES** zap 🤣! - -![](./wrk/samples/laptop_req_per_sec_graph.png) - -![](./wrk/samples/laptop_xfer_per_sec_graph.png) - -``` -➜ neofetch --stdout -rs@nixos --------- -OS: NixOS 23.05.2918.4cdad15f34e6 (Stoat) x86_64 -Host: LENOVO 20TKS0W700 -Kernel: 6.1.45 -Uptime: 1 day, 4 hours, 50 mins -Packages: 6259 (nix-system), 267 (nix-user), 9 (flatpak) -Shell: bash 5.2.15 -Resolution: 3840x1600, 3840x2160 -DE: none+i3 -WM: i3 -Terminal: tmux -CPU: Intel i9-10885H (16) @ 5.300GHz -GPU: NVIDIA GeForce GTX 1650 Ti Mobile -Memory: 4525MiB / 31805MiB - - -➜ lscpu -Architecture: x86_64 -CPU op-mode(s): 32-bit, 64-bit -Address sizes: 39 bits physical, 48 bits virtual -Byte Order: Little Endian -CPU(s): 16 -On-line CPU(s) list: 0-15 -Vendor ID: GenuineIntel -Model name: Intel(R) Core(TM) i9-10885H CPU @ 2.40GHz -CPU family: 6 -Model: 165 -Thread(s) per core: 2 -Core(s) per socket: 8 -Socket(s): 1 -Stepping: 2 -CPU(s) scaling MHz: 56% -CPU max MHz: 5300.0000 -CPU min MHz: 800.0000 -BogoMIPS: 4800.00 -Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf pni pclmulqdq dtes64 monitor ds_cpl vmx smx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault epb invpcid_single ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust sgx bmi1 avx2 smep bmi2 erms invpcid mpx rdseed adx smap clflushopt intel_pt xsaveopt xsavec xgetbv1 xsaves dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp pku ospke sgx_lc md_clear flush_l1d arch_capabilities -Virtualization: VT-x -L1d cache: 256 KiB (8 instances) -L1i cache: 256 KiB (8 instances) -L2 cache: 2 MiB (8 instances) -L3 cache: 16 MiB (1 instance) -NUMA node(s): 1 -NUMA node0 CPU(s): 0-15 -Vulnerability Gather data sampling: Mitigation; Microcode -Vulnerability Itlb multihit: KVM: Mitigation: VMX disabled -Vulnerability L1tf: Not affected -Vulnerability Mds: Not affected -Vulnerability Meltdown: Not affected -Vulnerability Mmio stale data: Mitigation; Clear CPU buffers; SMT vulnerable -Vulnerability Retbleed: Mitigation; Enhanced IBRS -Vulnerability Spec rstack overflow: Not affected -Vulnerability Spec store bypass: Mitigation; Speculative Store Bypass disabled via prctl -Vulnerability Spectre v1: Mitigation; usercopy/swapgs barriers and __user pointer sanitization -Vulnerability Spectre v2: Mitigation; Enhanced IBRS, IBPB conditional, RSB filling, PBRSB-eIBRS SW sequence -Vulnerability Srbds: Mitigation; Microcode -Vulnerability Tsx async abort: Not affected -``` - diff --git a/create-archive.sh b/create-archive.sh deleted file mode 100755 index 88f393d..0000000 --- a/create-archive.sh +++ /dev/null @@ -1,35 +0,0 @@ -#!/usr/bin/env bash -tag=$1 -override=$2 - -if [ "$tag" == "--override" ] ; then - override=$tag - tag="" -fi - -if [ "$tag" == "" ] ; then - tag=$(git rev-parse --abbrev-ref HEAD) - echo "Warning: no tag provided, using: >> $tag <<" -fi - - -git archive --format=tar.gz -o ${tag}.tar.gz --prefix=zap-$tag/ HEAD - -git diff --quiet - -if [ $? -ne 0 ] ; then - if [ "$override" == "--override" ] ; then - ./zig-out/bin/pkghash -g --tag=$tag --template=doc/release-template.md - else - echo "WARNING: GIT WORKING TREE IS DIRTY!" - echo "If you want to get zig hash anyway, run:" - echo "./zig-out/bin/pkghash -g" - echo "or, with full-blown release-notes:" - echo "./zig-out/bin/pkghash -g --tag=$tag --template=doc/release-template.md" - echo "" - echo "To skip this message and do the pkghash thing anyway, supply the" - echo "--override parameter" - fi -else - ./zig-out/bin/pkghash -g --tag=$tag --template=doc/release-template.md -fi diff --git a/doc/build-localhost.md b/doc/build-localhost.md deleted file mode 100644 index 8725fde..0000000 --- a/doc/build-localhost.md +++ /dev/null @@ -1,101 +0,0 @@ -# Self-hosting release packages until Zig master is fixed - -Recently, GitHub started hosting release archives on a dedicated host -codeload.github.com. This is when the problems started. Back then, zig's package -manager was not expecting to be re-directed to a different URL. On top of that, -GitHub changed the redirected-to URLs so they wouldn't end in `.tar.gz` anymore. - -Above issues were fixed but after some progress on `zig.http` related standard -library stuff, a similar error started impacting the package manager: parsing -long TLS responses has the [issue -ziglang/zig#15990](https://github.com/ziglang/zig/issues/15590). - -So, here we are. Since this topic has come up often enough now, it deserves its -own doc. - -## The workaround: self-hosting on localhost - -My workaround is: not using https! The easiest way to do this, is: - -- create the tar archive yourself -- start a python http server on the command line -- replace the URL in the build.zig.zon with a http and localhost one. - -For simple packages, this is relatively easy. But zap itself has a -`build.zig.zon` that references its `facilio` dependency. For that reason, ZAP's -build.zig.zon also needs to change: to only reference localhost packages. - -The consequence of changing build.zig.zon is: zap's package hash changes! --> -Any build.zig.zon that wants to use ZAP needs to change, too. - -This is why, for the time being, I am always creating two releases, -a `release-0.0.n` one and `release-0.0.n-localhost` one, for each release. - - -So, while the TLS bug persists, you have to use the `-localhost` releases. The -procedure is: - -- fetch zap's dependency `facilio` from GitHub -- fetch zap's `localhost` release from GitHub -- _(use the localhost URL and package hash in your build.zig)_ -- start a local http server -- run zig build -- stop the http server - -Here is an example for the `release-0.0.20-localhost` release which is the -current release at the time of writing: - -```console -$ # get dependency required by zap -$ wget https://github.com/zigzap/facil.io/archive/refs/tags/zap-0.0.8.tar.gz -$ # get zap itself -$ wget https://github.com/zigzap/zap/archive/refs/tags/release-0.0.20-localhost.tar.gz -$ # start a http server on port 8000 -$ python -m http.server -``` - -... and use the following in your build.zig.zon: - -```zig - // zap release-0.0.20-localhost - .zap = .{ - .url = "http://127.0.0.1/release-0.0.20-localhost.tar.gz", - .hash = "12204c663be7639e98af40ad738780014b18bcf35efbdb4c701aad51c7dec45abf4d", - } -``` - -After the first successful zig build, zig will have cached both dependencies, -the direct zap one and the transient facilio one, and you won't need to start an -HTTP server again until you want to update your dependencies. - - -## Building Release Packages yourself - -- In your branch, replace `build.zig.zon` with `build.zig.zon.localhost` -- **make sure everything is committed and your branch is clean.** This is - essential for calculating the package hash. -- `zig build pkghash` if you haven't already. -- tag your release: `git tag MY_TAG` - - I recommend putting `localhost` in the tagname -- `./create-archive.sh MY_TAG` - -The `create-archive.sh` script will spit out release notes that contain the -hashes, as well as a `MY_TAG.tar.gz`. - -You can then host this via python HTTP server and proceed as if you had -downloaded it from github. - -If all goes well, your dependend code should be able to use your freshly-built -zap release, depending on it via localhost URL in its `build.zig.zon`. - -If not, fix bugs, rinse, and repeat. - -You may want to push to your fork and create a GitHub 'localhost' release. - -When you're happy with the release, you may consider replacing `build.zig.zon` -with the non-localhost version from the master branch. Commit it, make sure your -worktree is clean, and perform above steps again. This time, using a tag that -doesn't contain `localhost`. You can then push to your fork and create a release -for the future when zig's bug is fixed. - - diff --git a/doc/other-versions.md b/doc/other-versions.md deleted file mode 100644 index c8c1005..0000000 --- a/doc/other-versions.md +++ /dev/null @@ -1,40 +0,0 @@ -# Alternatives to released versions - - -## Using a tagged version - -Go to [to the tags page](https://github.com/zigzap/zap/tags) to view all -available tagged versions of zap. From there, right click on the `tar.gz` link -to copy the URL to put into your `build.zig.zon`. - -After changing the `.url` field, you will get an error like this at the next -attempt to `zig build`: - -``` -.../build.zig.zon:8:21: error: hash mismatch: -expected: 12205fd0b60720fb2a40d82118ee75c15cb5589bb9faf901c8a39a93551dd6253049, -found: 1220f4ea8be4a85716ae1362d34c077dca10f10d1baf9196fc890e658c56f78b7424 -.hash = "12205fd0b60720fb2a40d82118ee75c15cb5589bb9faf901c8a39a93551dd6253049", -^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -``` - -**Note:** If you don't get this error, clean your global zig cache: `rm -fr -~/.cache/zig`. This shouldn't happen with current zig master anymore. - -With the new URL, the old hash in the `build.zig.zon` is no longer valid. You -need to take the hash value displayed after `found: ` in the error message as -the `.hash` value in `build.zig.zon`. - - -## Using an arbitrary (last) commit - -Use the same workflow as above for tags, excpept for the URL, use this schema: - -```zig -.url = "https://github.com/zigzap/zap/archive/[COMMIT-HASH].tar.gz", -``` - -Replace `[COMMIT-HASH]` with the full commit hash as provided, e.g. by `git -log`. - - diff --git a/doc/zig-ception.md b/doc/zig-ception.md deleted file mode 100644 index cdea9d8..0000000 --- a/doc/zig-ception.md +++ /dev/null @@ -1,81 +0,0 @@ -# ZIG-CEPTION! - -In ZAP, we have great zig-ception moment in the [middleware -example](../examples/middleware/middleware.zig). But first we need to introduce -one key function of `zap.Middleware`: **combining structs at comptime!** - -## Combining structs at runtime - -Here is how it is used in user-code: - -```zig -// create a combined context struct -const Context = struct { - user: ?UserMiddleWare.User = null, - session: ?SessionMiddleWare.Session = null, -}; -``` - -Why do we create combined structs? Because all our Middleware handler functions -need to receive a per-request context. But each wants their own data: the User -middleware might want to access a User struct, the Session middleware might want -a Session struct, and so on. So, which struct should we use in the prototype of -the "on_request" callback function? We could just use an `anyopaque` pointer. -That would solve the generic function prototype problem. But then everyone -implementing such a handler would need to cast this pointer back into - what? -Into the same type that the caller of the handler used. It gets really messy -when we continue this train of thought. - -So, in ZAP, I opted for one Context type for all request handlers. Since ZAP is -a library, it cannot know what your preferred Context struct is. What it should -consist of. Therefore, it lets you combine all the structs your and maybe your -3rd parties's middleware components require - at comptime! And derive the -callback function prototype from that. If you look at the [middleware -example](../examples/middleware/middleware.zig), you'll notice, it's really -smooth to use. - -**NOTE:** In your contexts, please also use OPTIONALS. They are set null at -context creation time. And will aid you in not shooting yourself in the foot -when accessing context fields that haven't been initialized - which may happen -when the order of your chain of components isn't perfect yet. 😉 - -## The zig-ception moment - -Have a look at an excerpt of the example: - -```zig -// create a combined context struct -const Context = struct { - user: ?UserMiddleWare.User = null, - session: ?SessionMiddleWare.Session = null, -}; - -// we create a Handler type based on our Context -const Handler = zap.Middleware.Handler(Context); - -// -// ZIG-CEPTION!!! -// -// Note how amazing zig is: -// - we create the "mixed" context based on the both middleware structs -// - we create the handler based on this context -// - we create the middleware structs based on the handler -// - which needs the context -// - which needs the middleware structs -// - ZIG-CEPTION! - -// Example user middleware: puts user info into the context -const UserMiddleWare = struct { - handler: Handler, - - // .. the UserMiddleWare depends on the handler - // which depends on the Context - // which depends on this UserMiddleWare struct - // ZIG-CEPTION!!! -``` - -## 🤯 - -The comments in the code say it all. - -**Isn't ZIG AMAZING?** diff --git a/examples/app/basic.zig b/examples/app/basic.zig index 6186e31..752b0d0 100644 --- a/examples/app/basic.zig +++ b/examples/app/basic.zig @@ -3,6 +3,7 @@ const Allocator = std.mem.Allocator; const zap = @import("zap"); +// The global Application Context const MyContext = struct { db_connection: []const u8, @@ -13,12 +14,14 @@ const MyContext = struct { } }; +// A very simple endpoint handling only GET requests const SimpleEndpoint = struct { - // Endpoint Interface part + // zap.App.Endpoint Interface part path: []const u8, error_strategy: zap.Endpoint.ErrorStrategy = .log_to_response, + // data specific for this endpoint some_data: []const u8, pub fn init(path: []const u8, data: []const u8) SimpleEndpoint { @@ -28,12 +31,14 @@ const SimpleEndpoint = struct { }; } + // handle GET requests pub fn get(e: *SimpleEndpoint, arena: Allocator, context: *MyContext, r: zap.Request) anyerror!void { + const thread_id = std.Thread.getCurrentId(); + r.setStatus(.ok); - const thread_id = std.Thread.getCurrentId(); - // look, we use the arena allocator here - // and we also just try it, not worrying about errors + // look, we use the arena allocator here -> no need to free the response_text later! + // and we also just `try` it, not worrying about errors const response_text = try std.fmt.allocPrint( arena, \\Hello! @@ -58,23 +63,29 @@ const SimpleEndpoint = struct { }; pub fn main() !void { - var my_context = MyContext.init("db connection established!"); - + // setup allocations var gpa: std.heap.GeneralPurposeAllocator(.{ // just to be explicit .thread_safe = true, }) = .{}; defer std.debug.print("\n\nLeaks detected: {}\n\n", .{gpa.deinit() != .ok}); - const allocator = gpa.allocator(); + + // create an app context + var my_context = MyContext.init("db connection established!"); + + // create an App instance const App = zap.App.Create(MyContext); var app = try App.init(allocator, &my_context, .{}); defer app.deinit(); + // create the endpoint var my_endpoint = SimpleEndpoint.init("/", "some endpoint specific data"); + // register the endpoint with the app try app.register(&my_endpoint); + // listen on the network try app.listen(.{ .interface = "0.0.0.0", .port = 3000, diff --git a/flake.lock b/flake.lock index ee9c5fd..97a50f0 100644 --- a/flake.lock +++ b/flake.lock @@ -70,11 +70,11 @@ }, "nixpkgs": { "locked": { - "lastModified": 1741037377, - "narHash": "sha256-SvtvVKHaUX4Owb+PasySwZsoc5VUeTf1px34BByiOxw=", + "lastModified": 1743259260, + "narHash": "sha256-ArWLUgRm1tKHiqlhnymyVqi5kLNCK5ghvm06mfCl4QY=", "owner": "nixos", "repo": "nixpkgs", - "rev": "02032da4af073d0f6110540c8677f16d4be0117f", + "rev": "eb0e0f21f15c559d2ac7633dc81d079d1caf5f5f", "type": "github" }, "original": { @@ -145,11 +145,11 @@ "nixpkgs": "nixpkgs_2" }, "locked": { - "lastModified": 1741263138, - "narHash": "sha256-qlX8tgtZMTSOEeAM8AmC7K6mixgYOguhl/xLj5xQrXc=", + "lastModified": 1743250246, + "narHash": "sha256-gVFyxsxfqnEXSldeeURim7RRZGwPX4f/egLcSC7CXec=", "owner": "mitchellh", "repo": "zig-overlay", - "rev": "627055069ee1409e8c9be7bcc533e8823fb87b18", + "rev": "b0da956a6db25564d0ee461e669fb07a348d2528", "type": "github" }, "original": { diff --git a/flake.nix b/flake.nix index f6781a1..cf4d61a 100644 --- a/flake.nix +++ b/flake.nix @@ -3,7 +3,6 @@ inputs = { nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable"; - # nixpkgs.url = "github:nixos/nixpkgs/release-23.05"; flake-utils.url = "github:numtide/flake-utils"; # required for latest zig @@ -38,28 +37,10 @@ in rec { devShells.default = pkgs.mkShell { nativeBuildInputs = with pkgs; [ - # TODO: re-enable this once it is fixed: zigpkgs."0.14.0" - zigpkgs.master + zigpkgs."0.14.0" bat wrk - python3 - python3Packages.sanic - python3Packages.setuptools - python3Packages.matplotlib - poetry - poetry - pkgs.rustc - pkgs.cargo - pkgs.gcc - pkgs.rustfmt - pkgs.clippy - pkgs.go - pkgs.gotools - pkgs.gopls - pkgs.golint - pkgs.dotnet-sdk_8 - pkgs.dotnet-runtime_8 pkgs.zlib pkgs.icu pkgs.openssl @@ -85,9 +66,8 @@ devShells.build = pkgs.mkShell { nativeBuildInputs = with pkgs; [ - # zigpkgs."0.14.0" + zigpkgs."0.14.0" zigpkgs.master - pkgs.openssl ]; buildInputs = with pkgs; [ diff --git a/introducing.md b/introducing.md deleted file mode 100644 index 2d951cb..0000000 --- a/introducing.md +++ /dev/null @@ -1,100 +0,0 @@ -# Introducing ⚡zap⚡ - blazingly fast backends in zig - -Zap is intended to become my [zig](https://ziglang.org) replacement for the kind of REST APIs I used to write in [python](https://python.org) with [Flask](https://flask.palletsprojects.com) and [mongodb](https://www.mongodb.com), etc. It can be considered to be a microframework for web applications. - -What I need for that is a blazingly fast, robust HTTP server that I can use with zig. While facil.io supports TLS, I don't care about HTTPS support. In production, I use [nginx](https://www.nginx.com) as a reverse proxy anyway. - -Zap wraps and patches [facil.io - the C web application framework](https://facil.io). - -At the time of writing, ZAP is only a few days old and aims to be: - -- **robust** -- **fast** -- **minimal** - -**⚡ZAP⚡ IS SUPER ALPHA** - -_Under the hood, everything is super robust and fast. My zig wrappers are fresh, juicy, and alpha._ - -Here's what works: - -- **Super easy build process**: zap's `build.zig` fetches facilio's git sub-module, applies a patch to its logging for microsecond precision, and then builds and optionally runs everything. - - _tested on Linux and macOS (arm, M1)_ -- **[hello](https://github.com/renerocksai/zap/blob/master/examples/hello/hello.zig)**: welcomes you with some static HTML -- **[routes](https://github.com/renerocksai/zap/blob/master/examples/routes/routes.zig)**: a super easy example dispatching on the HTTP path -- **[serve](https://github.com/renerocksai/zap/blob/master/examples/serve/serve.zig)**: the traditional static web server with optional dynamic request handling -- **[hello_json](https://github.com/renerocksai/zap/blob/master/examples/hello_json/hello_json.zig)**: serves you json dependent on HTTP path -- **[endpoint](https://github.com/renerocksai/zap/blob/master/examples/endpoint/)**: a simple JSON REST API example featuring a `/users` endpoint for PUTting/DELETE-ing/GET-ting/POST-ing and listing users, together with a static HTML and JavaScript frontend to play with. - -If you want to take it for a quick spin: - -```shell -$ git clone https://github.com/renerocksai/zap.git -$ cd zap -$ zig build run-hello -$ # open http://localhost:3000 in your browser -``` - -See [the README](https://github.com/renerocksai/zap) for how easy it is to get started, how to run the examples, and how to use zap in your own projects. - -I'll continue wrapping more of facil.io's functionality and adding stuff to zap to a point where I can use it as the JSON REST API backend for real research projects, serving thousands of concurrent clients. Now that the endpoint example works, ZAP has actually become pretty usable to me. - -**Side-note:** It never ceases to amaze me how productive I can be in zig, eventhough I am still considering myself to be a newbie. Sometimes, it's almost like writing python but with all the nice speed and guarantees that zig gives you. Also, the C integration abilities of zig are just phenomenal! I am super excited about zig's future! - -Now, on to the guiding principles of Zap. - -## robust - -A common recommendation for doing web stuff in zig is to write the actual HTTP server in Go, and use zig for the real work. While there is a selection of notable and cool HTTP server implementations written in zig out there, at the time of writing, most of them seem to a) depend on zig's async facilities which are unsupported until ca. April 2023 when async will return to the self-hosted compiler, and b) have not matured to a point where **I** feel safe using them in production. These are just my opionions and they could be totally wrong though. - -However, when I conduct my next online research experiment with thousands of concurrent clients, I cannot afford to run into potential maturity-problems of the HTTP server. These projects typically feature a you-get-one-shot process with little room for errors or re-tries. - -With zap, if something should go wrong, at least I'd be close enough to the source-code to, hopefully, be able to fix it in production. With that out of the way, I am super confident that facil.io is very mature compared to many of the alternatives. My `wrk` tests also look promising. - -I intend to add app-specific performance tests, e.g. stress-testing the endpoint example, to make sure the zap endpoint framework is able to sustain a high load without running into performance or memory problems. That will be interesting. - - -## ⚡blazingly fast⚡ - -Claiming to be blazingly fast is the new black. At least, zap doesn't slow you down and if your server performs poorly, it's probably not exactly zap's fault. Zap relies on the [facil.io](https://facil.io) framework and so it can't really claim any performance fame for itself. In this initial implementation of zap, I didn't care about optimizations at all. - -But, how fast is it? Being blazingly fast is relative. When compared with a simple GO HTTP server, a simple zig zap HTTP server performed really good on my machine: - -- zig zap was nearly 30% faster than GO -- zig zap had over 50% more throughput than GO - -I intentionally only tested static HTTP output, as that seemed to be the best common ground of all test subjects to me. The measurements were for just getting a ballpark baseline anyway. - -**Update**: I was intrigued comparing to a basic rust HTTP server. Unfortunately, knowing nothing at all about rust, I couldn't find a simple, just-a-few-lines one like in Go and Python right away and hence tried to go for the one in the book [The Rust Programming Language](https://doc.rust-lang.org/book/ch20-00-final-project-a-web-server.html). Wanting it to be of a somewhat fair comparison, I opted for the multi-threaded example. It didn't work out-of-the-book, but I got it to work (essentially, by commenting out all "print" statements) and changed it to not read files but outputting static text just like the other examples. **Maybe someone with rust experience** can have a look at my [wrk/rust/hello](wrk/rust/hello) code and tell me why it is surprisingly 'slow', as I expected it to be faster than or at least on-par with the basic Go example. I'll enable the GitHub discussions for this matter. My suspicion is bad performance of the mutexes. - -![table](https://raw.githubusercontent.com/renerocksai/zap/master/wrk_table_summary.png) - -![charts](https://raw.githubusercontent.com/renerocksai/zap/master/wrk_charts_summary.png) - -So, being somewhere in the ballpark of basic GO performance, zig zap seems to be ... of reasonable performance 😎. - -See more details in [blazingly-fast.md](https://github.com/renerocksai/zap/blob/master/blazingly-fast.md). - -## minimal - -Zap is minimal by necessity. I only (have time to) add what I need - for serving REST APIs and HTML. The primary use-case are frontends that I wrote that communicate with my APIs. Hence, the focus is more on getting stuff done rather than conforming to every standard there is. Even though facilio is able to support TLS, I don't care about that - at least for now. Also, if you present `404 - File not found` as human-readable HTML to the user, nobody forces you to also set the status code to 404, so it can be OK to spare those nanoseconds. Gotta go fast! - -Facilio comes with Mustache parsing, TLS via third-party libs, websockets, redis support, concurrency stuff, Base64 support, logging facilities, pub/sub / cluster messages API, hash algorithm implementations, its own memory allocator, and so forth. It is really an amazing project! - -On the lower level, you can use all of the above by working with `zap.C`. I'll zig-wrap what I need for my projects first, before adding more fancy stuff. - -Also, there are nice and well-typed zig implementations for some of the above extra functionalities, and zap-wrapping them needs careful consideration. E.g. it might not be worth the extra effort to wrap facil.io's mustache support when there is a good zig alternative already. Performance / out-of-the-box integration might be arguments pro wrapping them in zap. - -## wrapping up - zig is WYSIWYG code - -I am super excited about both zig and zap's future. I am still impressed by how easy it is to integrate a C codebase into a zig project, then benefiting from and building on top of battle-tested high-performance C code. Additionally, with zig you get C-like performance with almost Python-like comfort. And you can be sure no exception is trying to get you when you least expect it. No hidden allocations, no hidden control-flows, how cool is that? **WYSIWYG code!** - -Provided that the incorporated C code is well-written and -tested, WYSIWYG even holds mostly true for combined Zig and C projects. - -You can truly build on the soulders of giants here. Mind you, it took me less than a week to arrive at the current state of zap where I am confident that I can already use it to write the one or other REST API with it and, after stress-testing, just move it into production - from merely researching Zig and C web frameworks a few days ago. - -Oh, and have I mentioned Zig's built-in build system and testing framework? Those are both super amazing and super convenient. `zig build` is so much more useful than `make` (which I quite like to be honest). And `zig test` is just amazing, too. Zig's physical code layout: which file is located where and how can it be built, imported, tested - it all makes so much sense. Such a coherent, pleasant experience. - -Looking forward, I am also tempted to try adding some log-and-replay facilities as a kind of backup for when things go wrong. I wouldn't be confident to attemt such things in C because I'd view them as being too much work; too much could go wrong. But with Zig, I am rather excited about the possibilities that open up and eager to try such things. - -For great justice! diff --git a/shell.nix b/shell.nix deleted file mode 100644 index b7dafc3..0000000 --- a/shell.nix +++ /dev/null @@ -1,35 +0,0 @@ -{ - pkgs ? import { - overlays = [ - (import (builtins.fetchTarball { - # url = https://github.com/nix-community/neovim-nightly-overlay/archive/master.tar.gz; - url = https://github.com/nix-community/neovim-nightly-overlay/archive/72ff8b1ca0331a8735c1eeaefb95c12dfe21d30a.tar.gz; - })) - ]; - } -} : -pkgs.mkShell { - nativeBuildInputs = [ - pkgs.neovim-nightly - pkgs.bat - pkgs.wrk - pkgs.python3 - pkgs.rustc - pkgs.cargo - pkgs.gcc - pkgs.rustfmt - pkgs.clippy - ]; - - buildInputs = [ - pkgs.go - pkgs.gotools - pkgs.gopls - # pkgs.go-outline - # pkgs.gocode - # pkgs.gopkgs - # pkgs.gocode-gomod - # pkgs.godef - pkgs.golint - ]; -} diff --git a/wrk/axum-sanic.md b/wrk/axum-sanic.md deleted file mode 100644 index f22a1cc..0000000 --- a/wrk/axum-sanic.md +++ /dev/null @@ -1,70 +0,0 @@ -# axum - -```console -zap on  newwrk [$!?] via ↯ v0.11.0-dev.2837+b55b8e774 via  impure (nix-shell) -➜ wrk/measure.sh axum - Finished release [optimized] target(s) in 0.05s -======================================================================== - axum -======================================================================== -Running 10s test @ http://127.0.0.1:3000 - 4 threads and 400 connections - Thread Stats Avg Stdev Max +/- Stdev - Latency 527.01us 260.08us 8.47ms 74.31% - Req/Sec 151.11k 4.06k 166.63k 71.25% - Latency Distribution - 50% 518.00us - 75% 644.00us - 90% 811.00us - 99% 1.39ms - 6014492 requests in 10.01s, 768.61MB read -Requests/sec: 600582.38 -Transfer/sec: 76.75MB - -zap on  newwrk [$!?] via ↯ v0.11.0-dev.2837+b55b8e774 via  impure (nix-shell) took 11s -➜ wrk/measure.sh axum - Finished release [optimized] target(s) in 0.05s -======================================================================== - axum -======================================================================== -Running 10s test @ http://127.0.0.1:3000 - 4 threads and 400 connections - Thread Stats Avg Stdev Max +/- Stdev - Latency 534.89us 280.25us 7.37ms 76.81% - Req/Sec 150.03k 4.26k 162.67k 72.75% - Latency Distribution - 50% 520.00us - 75% 647.00us - 90% 831.00us - 99% 1.50ms - 5969526 requests in 10.01s, 762.86MB read -Requests/sec: 596134.58 -Transfer/sec: 76.18MB - -zap on  newwrk [$!?] via ↯ v0.11.0-dev.2837+b55b8e774 via  impure (nix-shell) took 11s -➜ wrk/measure.sh axum - Finished release [optimized] target(s) in 0.05s -======================================================================== - axum -======================================================================== -Running 10s test @ http://127.0.0.1:3000 - 4 threads and 400 connections - Thread Stats Avg Stdev Max +/- Stdev - Latency 519.96us 269.86us 11.92ms 76.98% - Req/Sec 151.29k 4.32k 164.52k 69.75% - Latency Distribution - 50% 509.00us - 75% 635.00us - 90% 800.00us - 99% 1.41ms - 6021199 requests in 10.01s, 769.46MB read -Requests/sec: 601482.51 -Transfer/sec: 76.86MB - -zap on  newwrk [$!?] via ↯ v0.11.0-dev.2837+b55b8e774 via  impure (nix-shell) took 11s -➜ -``` - -# sanic - - diff --git a/wrk/axum/hello-axum/Cargo.lock b/wrk/axum/hello-axum/Cargo.lock deleted file mode 100644 index e7d07d9..0000000 --- a/wrk/axum/hello-axum/Cargo.lock +++ /dev/null @@ -1,752 +0,0 @@ -# This file is automatically @generated by Cargo. -# It is not intended for manual editing. -version = 3 - -[[package]] -name = "async-trait" -version = "0.1.68" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b9ccdd8f2a161be9bd5c023df56f1b2a0bd1d83872ae53b71a84a12c9bf6e842" -dependencies = [ - "proc-macro2", - "quote", - "syn 2.0.15", -] - -[[package]] -name = "autocfg" -version = "1.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa" - -[[package]] -name = "axum" -version = "0.5.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "acee9fd5073ab6b045a275b3e709c163dd36c90685219cb21804a147b58dba43" -dependencies = [ - "async-trait", - "axum-core", - "bitflags", - "bytes", - "futures-util", - "http", - "http-body", - "hyper", - "itoa", - "matchit", - "memchr", - "mime", - "percent-encoding", - "pin-project-lite", - "serde", - "serde_json", - "serde_urlencoded", - "sync_wrapper", - "tokio", - "tower", - "tower-http", - "tower-layer", - "tower-service", -] - -[[package]] -name = "axum-core" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "37e5939e02c56fecd5c017c37df4238c0a839fa76b7f97acdd7efb804fd181cc" -dependencies = [ - "async-trait", - "bytes", - "futures-util", - "http", - "http-body", - "mime", - "tower-layer", - "tower-service", -] - -[[package]] -name = "bitflags" -version = "1.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a" - -[[package]] -name = "bytes" -version = "1.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "89b2fd2a0dcf38d7971e2194b6b6eebab45ae01067456a7fd93d5547a61b70be" - -[[package]] -name = "cfg-if" -version = "1.0.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd" - -[[package]] -name = "fnv" -version = "1.0.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1" - -[[package]] -name = "form_urlencoded" -version = "1.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a9c384f161156f5260c24a097c56119f9be8c798586aecc13afbcbe7b7e26bf8" -dependencies = [ - "percent-encoding", -] - -[[package]] -name = "futures-channel" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "955518d47e09b25bbebc7a18df10b81f0c766eaf4c4f1cccef2fca5f2a4fb5f2" -dependencies = [ - "futures-core", -] - -[[package]] -name = "futures-core" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4bca583b7e26f571124fe5b7561d49cb2868d79116cfa0eefce955557c6fee8c" - -[[package]] -name = "futures-task" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "76d3d132be6c0e6aa1534069c705a74a5997a356c0dc2f86a47765e5617c5b65" - -[[package]] -name = "futures-util" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "26b01e40b772d54cf6c6d721c1d1abd0647a0106a12ecaa1c186273392a69533" -dependencies = [ - "futures-core", - "futures-task", - "pin-project-lite", - "pin-utils", -] - -[[package]] -name = "hello-axum" -version = "0.1.0" -dependencies = [ - "axum", - "tokio", -] - -[[package]] -name = "hermit-abi" -version = "0.2.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ee512640fe35acbfb4bb779db6f0d80704c2cacfa2e39b601ef3e3f47d1ae4c7" -dependencies = [ - "libc", -] - -[[package]] -name = "http" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bd6effc99afb63425aff9b05836f029929e345a6148a14b7ecd5ab67af944482" -dependencies = [ - "bytes", - "fnv", - "itoa", -] - -[[package]] -name = "http-body" -version = "0.4.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d5f38f16d184e36f2408a55281cd658ecbd3ca05cce6d6510a176eca393e26d1" -dependencies = [ - "bytes", - "http", - "pin-project-lite", -] - -[[package]] -name = "http-range-header" -version = "0.3.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0bfe8eed0a9285ef776bb792479ea3834e8b94e13d615c2f66d03dd50a435a29" - -[[package]] -name = "httparse" -version = "1.8.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d897f394bad6a705d5f4104762e116a75639e470d80901eed05a860a95cb1904" - -[[package]] -name = "httpdate" -version = "1.0.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c4a1e36c821dbe04574f602848a19f742f4fb3c98d40449f11bcad18d6b17421" - -[[package]] -name = "hyper" -version = "0.14.26" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ab302d72a6f11a3b910431ff93aae7e773078c769f0a3ef15fb9ec692ed147d4" -dependencies = [ - "bytes", - "futures-channel", - "futures-core", - "futures-util", - "http", - "http-body", - "httparse", - "httpdate", - "itoa", - "pin-project-lite", - "socket2", - "tokio", - "tower-service", - "tracing", - "want", -] - -[[package]] -name = "itoa" -version = "1.0.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "453ad9f582a441959e5f0d088b02ce04cfe8d51a8eaf077f12ac6d3e94164ca6" - -[[package]] -name = "libc" -version = "0.2.142" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6a987beff54b60ffa6d51982e1aa1146bc42f19bd26be28b0586f252fccf5317" - -[[package]] -name = "lock_api" -version = "0.4.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "435011366fe56583b16cf956f9df0095b405b82d76425bc8981c0e22e60ec4df" -dependencies = [ - "autocfg", - "scopeguard", -] - -[[package]] -name = "log" -version = "0.4.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "abb12e687cfb44aa40f41fc3978ef76448f9b6038cad6aef4259d3c095a2382e" -dependencies = [ - "cfg-if", -] - -[[package]] -name = "matchit" -version = "0.5.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "73cbba799671b762df5a175adf59ce145165747bb891505c43d09aefbbf38beb" - -[[package]] -name = "memchr" -version = "2.5.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d" - -[[package]] -name = "mime" -version = "0.3.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a" - -[[package]] -name = "mio" -version = "0.8.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5b9d9a46eff5b4ff64b45a9e316a6d1e0bc719ef429cbec4dc630684212bfdf9" -dependencies = [ - "libc", - "log", - "wasi", - "windows-sys 0.45.0", -] - -[[package]] -name = "num_cpus" -version = "1.15.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0fac9e2da13b5eb447a6ce3d392f23a29d8694bff781bf03a16cd9ac8697593b" -dependencies = [ - "hermit-abi", - "libc", -] - -[[package]] -name = "once_cell" -version = "1.17.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b7e5500299e16ebb147ae15a00a942af264cf3688f47923b8fc2cd5858f23ad3" - -[[package]] -name = "parking_lot" -version = "0.12.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f" -dependencies = [ - "lock_api", - "parking_lot_core", -] - -[[package]] -name = "parking_lot_core" -version = "0.9.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9069cbb9f99e3a5083476ccb29ceb1de18b9118cafa53e90c9551235de2b9521" -dependencies = [ - "cfg-if", - "libc", - "redox_syscall", - "smallvec", - "windows-sys 0.45.0", -] - -[[package]] -name = "percent-encoding" -version = "2.2.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "478c572c3d73181ff3c2539045f6eb99e5491218eae919370993b890cdbdd98e" - -[[package]] -name = "pin-project" -version = "1.0.12" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ad29a609b6bcd67fee905812e544992d216af9d755757c05ed2d0e15a74c6ecc" -dependencies = [ - "pin-project-internal", -] - -[[package]] -name = "pin-project-internal" -version = "1.0.12" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "069bdb1e05adc7a8990dce9cc75370895fbe4e3d58b9b73bf1aee56359344a55" -dependencies = [ - "proc-macro2", - "quote", - "syn 1.0.109", -] - -[[package]] -name = "pin-project-lite" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e0a7ae3ac2f1173085d398531c705756c94a4c56843785df85a60c1a0afac116" - -[[package]] -name = "pin-utils" -version = "0.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184" - -[[package]] -name = "proc-macro2" -version = "1.0.56" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2b63bdb0cd06f1f4dedf69b254734f9b45af66e4a031e42a7480257d9898b435" -dependencies = [ - "unicode-ident", -] - -[[package]] -name = "quote" -version = "1.0.26" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4424af4bf778aae2051a77b60283332f386554255d722233d09fbfc7e30da2fc" -dependencies = [ - "proc-macro2", -] - -[[package]] -name = "redox_syscall" -version = "0.2.16" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fb5a58c1855b4b6819d59012155603f0b22ad30cad752600aadfcb695265519a" -dependencies = [ - "bitflags", -] - -[[package]] -name = "ryu" -version = "1.0.13" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f91339c0467de62360649f8d3e185ca8de4224ff281f66000de5eb2a77a79041" - -[[package]] -name = "scopeguard" -version = "1.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d29ab0c6d3fc0ee92fe66e2d99f700eab17a8d57d1c1d3b748380fb20baa78cd" - -[[package]] -name = "serde" -version = "1.0.160" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bb2f3770c8bce3bcda7e149193a069a0f4365bda1fa5cd88e03bca26afc1216c" - -[[package]] -name = "serde_json" -version = "1.0.96" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "057d394a50403bcac12672b2b18fb387ab6d289d957dab67dd201875391e52f1" -dependencies = [ - "itoa", - "ryu", - "serde", -] - -[[package]] -name = "serde_urlencoded" -version = "0.7.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd" -dependencies = [ - "form_urlencoded", - "itoa", - "ryu", - "serde", -] - -[[package]] -name = "signal-hook-registry" -version = "1.4.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d8229b473baa5980ac72ef434c4415e70c4b5e71b423043adb4ba059f89c99a1" -dependencies = [ - "libc", -] - -[[package]] -name = "smallvec" -version = "1.10.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a507befe795404456341dfab10cef66ead4c041f62b8b11bbb92bffe5d0953e0" - -[[package]] -name = "socket2" -version = "0.4.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "64a4a911eed85daf18834cfaa86a79b7d266ff93ff5ba14005426219480ed662" -dependencies = [ - "libc", - "winapi", -] - -[[package]] -name = "syn" -version = "1.0.109" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237" -dependencies = [ - "proc-macro2", - "quote", - "unicode-ident", -] - -[[package]] -name = "syn" -version = "2.0.15" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a34fcf3e8b60f57e6a14301a2e916d323af98b0ea63c599441eec8558660c822" -dependencies = [ - "proc-macro2", - "quote", - "unicode-ident", -] - -[[package]] -name = "sync_wrapper" -version = "0.1.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2047c6ded9c721764247e62cd3b03c09ffc529b2ba5b10ec482ae507a4a70160" - -[[package]] -name = "tokio" -version = "1.28.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c3c786bf8134e5a3a166db9b29ab8f48134739014a3eca7bc6bfa95d673b136f" -dependencies = [ - "autocfg", - "bytes", - "libc", - "mio", - "num_cpus", - "parking_lot", - "pin-project-lite", - "signal-hook-registry", - "socket2", - "tokio-macros", - "windows-sys 0.48.0", -] - -[[package]] -name = "tokio-macros" -version = "2.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "630bdcf245f78637c13ec01ffae6187cca34625e8c63150d424b59e55af2675e" -dependencies = [ - "proc-macro2", - "quote", - "syn 2.0.15", -] - -[[package]] -name = "tower" -version = "0.4.13" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b8fa9be0de6cf49e536ce1851f987bd21a43b771b09473c3549a6c853db37c1c" -dependencies = [ - "futures-core", - "futures-util", - "pin-project", - "pin-project-lite", - "tokio", - "tower-layer", - "tower-service", - "tracing", -] - -[[package]] -name = "tower-http" -version = "0.3.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f873044bf02dd1e8239e9c1293ea39dad76dc594ec16185d0a1bf31d8dc8d858" -dependencies = [ - "bitflags", - "bytes", - "futures-core", - "futures-util", - "http", - "http-body", - "http-range-header", - "pin-project-lite", - "tower", - "tower-layer", - "tower-service", -] - -[[package]] -name = "tower-layer" -version = "0.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c20c8dbed6283a09604c3e69b4b7eeb54e298b8a600d4d5ecb5ad39de609f1d0" - -[[package]] -name = "tower-service" -version = "0.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b6bc1c9ce2b5135ac7f93c72918fc37feb872bdc6a5533a8b85eb4b86bfdae52" - -[[package]] -name = "tracing" -version = "0.1.37" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8ce8c33a8d48bd45d624a6e523445fd21ec13d3653cd51f681abf67418f54eb8" -dependencies = [ - "cfg-if", - "log", - "pin-project-lite", - "tracing-core", -] - -[[package]] -name = "tracing-core" -version = "0.1.30" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "24eb03ba0eab1fd845050058ce5e616558e8f8d8fca633e6b163fe25c797213a" -dependencies = [ - "once_cell", -] - -[[package]] -name = "try-lock" -version = "0.2.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3528ecfd12c466c6f163363caf2d02a71161dd5e1cc6ae7b34207ea2d42d81ed" - -[[package]] -name = "unicode-ident" -version = "1.0.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e5464a87b239f13a63a501f2701565754bae92d243d4bb7eb12f6d57d2269bf4" - -[[package]] -name = "want" -version = "0.3.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1ce8a968cb1cd110d136ff8b819a556d6fb6d919363c61534f6860c7eb172ba0" -dependencies = [ - "log", - "try-lock", -] - -[[package]] -name = "wasi" -version = "0.11.0+wasi-snapshot-preview1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423" - -[[package]] -name = "winapi" -version = "0.3.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419" -dependencies = [ - "winapi-i686-pc-windows-gnu", - "winapi-x86_64-pc-windows-gnu", -] - -[[package]] -name = "winapi-i686-pc-windows-gnu" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6" - -[[package]] -name = "winapi-x86_64-pc-windows-gnu" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f" - -[[package]] -name = "windows-sys" -version = "0.45.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0" -dependencies = [ - "windows-targets 0.42.2", -] - -[[package]] -name = "windows-sys" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9" -dependencies = [ - "windows-targets 0.48.0", -] - -[[package]] -name = "windows-targets" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071" -dependencies = [ - "windows_aarch64_gnullvm 0.42.2", - "windows_aarch64_msvc 0.42.2", - "windows_i686_gnu 0.42.2", - "windows_i686_msvc 0.42.2", - "windows_x86_64_gnu 0.42.2", - "windows_x86_64_gnullvm 0.42.2", - "windows_x86_64_msvc 0.42.2", -] - -[[package]] -name = "windows-targets" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7b1eb6f0cd7c80c79759c929114ef071b87354ce476d9d94271031c0497adfd5" -dependencies = [ - "windows_aarch64_gnullvm 0.48.0", - "windows_aarch64_msvc 0.48.0", - "windows_i686_gnu 0.48.0", - "windows_i686_msvc 0.48.0", - "windows_x86_64_gnu 0.48.0", - "windows_x86_64_gnullvm 0.48.0", - "windows_x86_64_msvc 0.48.0", -] - -[[package]] -name = "windows_aarch64_gnullvm" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8" - -[[package]] -name = "windows_aarch64_gnullvm" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "91ae572e1b79dba883e0d315474df7305d12f569b400fcf90581b06062f7e1bc" - -[[package]] -name = "windows_aarch64_msvc" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43" - -[[package]] -name = "windows_aarch64_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b2ef27e0d7bdfcfc7b868b317c1d32c641a6fe4629c171b8928c7b08d98d7cf3" - -[[package]] -name = "windows_i686_gnu" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f" - -[[package]] -name = "windows_i686_gnu" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "622a1962a7db830d6fd0a69683c80a18fda201879f0f447f065a3b7467daa241" - -[[package]] -name = "windows_i686_msvc" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060" - -[[package]] -name = "windows_i686_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4542c6e364ce21bf45d69fdd2a8e455fa38d316158cfd43b3ac1c5b1b19f8e00" - -[[package]] -name = "windows_x86_64_gnu" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36" - -[[package]] -name = "windows_x86_64_gnu" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ca2b8a661f7628cbd23440e50b05d705db3686f894fc9580820623656af974b1" - -[[package]] -name = "windows_x86_64_gnullvm" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3" - -[[package]] -name = "windows_x86_64_gnullvm" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7896dbc1f41e08872e9d5e8f8baa8fdd2677f29468c4e156210174edc7f7b953" - -[[package]] -name = "windows_x86_64_msvc" -version = "0.42.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0" - -[[package]] -name = "windows_x86_64_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1a515f5799fe4961cb532f983ce2b23082366b898e52ffbce459c86f67c8378a" diff --git a/wrk/axum/hello-axum/Cargo.md b/wrk/axum/hello-axum/Cargo.md deleted file mode 100644 index 0700a75..0000000 --- a/wrk/axum/hello-axum/Cargo.md +++ /dev/null @@ -1,129 +0,0 @@ -# 60 dependencies!!! - -```console -➜ cargo build - Updating crates.io index - Downloaded percent-encoding v2.2.0 - Downloaded sync_wrapper v0.1.2 - Downloaded async-trait v0.1.68 - Downloaded unicode-ident v1.0.8 - Downloaded tracing v0.1.37 - Downloaded mime v0.3.17 - Downloaded http-body v0.4.5 - Downloaded bytes v1.4.0 - Downloaded httpdate v1.0.2 - Downloaded httparse v1.8.0 - Downloaded http v0.2.9 - Downloaded lock_api v0.4.9 - Downloaded num_cpus v1.15.0 - Downloaded parking_lot v0.12.1 - Downloaded pin-project v1.0.12 - Downloaded parking_lot_core v0.9.7 - Downloaded form_urlencoded v1.1.0 - Downloaded log v0.4.17 - Downloaded memchr v2.5.0 - Downloaded matchit v0.5.0 - Downloaded pin-project-lite v0.2.9 - Downloaded scopeguard v1.1.0 - Downloaded pin-utils v0.1.0 - Downloaded once_cell v1.17.1 - Downloaded serde_urlencoded v0.7.1 - Downloaded pin-project-internal v1.0.12 - Downloaded ryu v1.0.13 - Downloaded quote v1.0.26 - Downloaded proc-macro2 v1.0.56 - Downloaded signal-hook-registry v1.4.1 - Downloaded socket2 v0.4.9 - Downloaded tower-service v0.3.2 - Downloaded tower-layer v0.3.2 - Downloaded tower v0.4.13 - Downloaded autocfg v1.1.0 - Downloaded syn v2.0.15 - Downloaded try-lock v0.2.4 - Downloaded futures-task v0.3.28 - Downloaded futures-core v0.3.28 - Downloaded fnv v1.0.7 - Downloaded bitflags v1.3.2 - Downloaded futures-util v0.3.28 - Downloaded hyper v0.14.26 - Downloaded axum v0.5.17 - Downloaded smallvec v1.10.0 - Downloaded want v0.3.0 - Downloaded axum-core v0.2.9 - Downloaded mio v0.8.6 - Downloaded tokio-macros v2.1.0 - Downloaded serde v1.0.160 - Downloaded tower-http v0.3.5 - Downloaded serde_json v1.0.96 - Downloaded syn v1.0.109 - Downloaded futures-channel v0.3.28 - Downloaded tracing-core v0.1.30 - Downloaded itoa v1.0.6 - Downloaded cfg-if v1.0.0 - Downloaded http-range-header v0.3.0 - Downloaded libc v0.2.142 - Downloaded tokio v1.28.0 - Downloaded 60 crates (4.1 MB) in 2.81s - Compiling proc-macro2 v1.0.56 - Compiling unicode-ident v1.0.8 - Compiling quote v1.0.26 - Compiling libc v0.2.142 - Compiling cfg-if v1.0.0 - Compiling autocfg v1.1.0 - Compiling log v0.4.17 - Compiling futures-core v0.3.28 - Compiling pin-project-lite v0.2.9 - Compiling bytes v1.4.0 - Compiling itoa v1.0.6 - Compiling futures-task v0.3.28 - Compiling parking_lot_core v0.9.7 - Compiling futures-util v0.3.28 - Compiling syn v1.0.109 - Compiling smallvec v1.10.0 - Compiling scopeguard v1.1.0 - Compiling once_cell v1.17.1 - Compiling pin-utils v0.1.0 - Compiling fnv v1.0.7 - Compiling serde v1.0.160 - Compiling tower-service v0.3.2 - Compiling futures-channel v0.3.28 - Compiling httparse v1.8.0 - Compiling tower-layer v0.3.2 - Compiling async-trait v0.1.68 - Compiling try-lock v0.2.4 - Compiling serde_json v1.0.96 - Compiling ryu v1.0.13 - Compiling memchr v2.5.0 - Compiling percent-encoding v2.2.0 - Compiling http-range-header v0.3.0 - Compiling httpdate v1.0.2 - Compiling bitflags v1.3.2 - Compiling mime v0.3.17 - Compiling sync_wrapper v0.1.2 - Compiling matchit v0.5.0 - Compiling http v0.2.9 - Compiling tracing-core v0.1.30 - Compiling form_urlencoded v1.1.0 - Compiling lock_api v0.4.9 - Compiling tokio v1.28.0 - Compiling want v0.3.0 - Compiling tracing v0.1.37 - Compiling syn v2.0.15 - Compiling http-body v0.4.5 - Compiling num_cpus v1.15.0 - Compiling socket2 v0.4.9 - Compiling signal-hook-registry v1.4.1 - Compiling mio v0.8.6 - Compiling parking_lot v0.12.1 - Compiling serde_urlencoded v0.7.1 - Compiling tokio-macros v2.1.0 - Compiling pin-project-internal v1.0.12 - Compiling axum-core v0.2.9 - Compiling pin-project v1.0.12 - Compiling tower v0.4.13 - Compiling hyper v0.14.26 - Compiling tower-http v0.3.5 - Compiling axum v0.5.17 - Compiling hello-axum v0.1.0 (/home/rs/code/github.com/zigzap/zap/wrk/axum/hello-axum) - Finished dev [unoptimized + debuginfo] target(s) in 53.19s -``` diff --git a/wrk/axum/hello-axum/Cargo.toml b/wrk/axum/hello-axum/Cargo.toml deleted file mode 100644 index 26b3b91..0000000 --- a/wrk/axum/hello-axum/Cargo.toml +++ /dev/null @@ -1,10 +0,0 @@ -[package] -name = "hello-axum" -version = "0.1.0" -edition = "2021" - -# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html - -[dependencies] -axum = "0.5" -tokio = { version = "1", features = ["full"] } diff --git a/wrk/axum/hello-axum/src/main.rs b/wrk/axum/hello-axum/src/main.rs deleted file mode 100644 index 7ab437a..0000000 --- a/wrk/axum/hello-axum/src/main.rs +++ /dev/null @@ -1,29 +0,0 @@ -use axum::{routing::get, Router}; -use std::net::SocketAddr; - -#[tokio::main] -async fn main() { - // Route all requests on "/" endpoint to anonymous handler. - // - // A handler is an async function which returns something that implements - // `axum::response::IntoResponse`. - - // A closure or a function can be used as handler. - - let app = Router::new().route("/", get(handler)); - // Router::new().route("/", get(|| async { "Hello, world!" })); - - // Address that server will bind to. - let addr = SocketAddr::from(([127, 0, 0, 1], 3000)); - - // Use `hyper::server::Server` which is re-exported through `axum::Server` to serve the app. - axum::Server::bind(&addr) - // Hyper server takes a make service. - .serve(app.into_make_service()) - .await - .unwrap(); -} - -async fn handler() -> &'static str { - "Hello from axum!!" -} diff --git a/wrk/cpp/build.zig b/wrk/cpp/build.zig deleted file mode 100644 index caa0656..0000000 --- a/wrk/cpp/build.zig +++ /dev/null @@ -1,39 +0,0 @@ -const std = @import("std"); - -pub fn build(b: *std.Build) void { - const target = b.standardTargetOptions(.{}); - - const optimize = b.standardOptimizeOption(.{}); - - const exe = b.addExecutable(.{ - .name = "cpp-beast", - .target = target, - .optimize = optimize, - }); - exe.addIncludePath(.{ .path = "." }); - exe.addCSourceFiles(&.{"main.cpp"}, &.{ - "-Wall", - "-Wextra", - "-Wshadow", - }); - const libasio_dep = b.dependency("beast", .{ - .target = target, - .optimize = optimize, - }); - const libasio = libasio_dep.artifact("beast"); - for (libasio.include_dirs.items) |include| { - exe.include_dirs.append(include) catch {}; - } - exe.linkLibrary(libasio); - exe.linkLibCpp(); - - b.installArtifact(exe); - const run_cmd = b.addRunArtifact(exe); - run_cmd.step.dependOn(b.getInstallStep()); - if (b.args) |args| { - run_cmd.addArgs(args); - } - - const run_step = b.step("run", "Run C++ Http Server"); - run_step.dependOn(&run_cmd.step); -} diff --git a/wrk/cpp/build.zig.zon b/wrk/cpp/build.zig.zon deleted file mode 100644 index ff48e0d..0000000 --- a/wrk/cpp/build.zig.zon +++ /dev/null @@ -1,10 +0,0 @@ -.{ - .name = "cpp-beast", - .version = "0.1.0", - .dependencies = .{ - .beast = .{ - .url = "https://github.com/kassane/beast/archive/df69ba4d48fbe874730f6a28e9528d9ef7a9547c.tar.gz", - .hash = "1220548f8727394522081ab48ed2f7111c20fa5f051ff287ec3c3f82340faa5d68c2", - }, - }, -} diff --git a/wrk/cpp/hello.html b/wrk/cpp/hello.html deleted file mode 100644 index 205d9a7..0000000 --- a/wrk/cpp/hello.html +++ /dev/null @@ -1 +0,0 @@ -Hello from C++!! diff --git a/wrk/cpp/main.cpp b/wrk/cpp/main.cpp deleted file mode 100644 index 3241b9b..0000000 --- a/wrk/cpp/main.cpp +++ /dev/null @@ -1,80 +0,0 @@ -#include -#include -#include -#include -#include - -namespace beast = boost::beast; -namespace http = beast::http; -namespace net = boost::asio; -using tcp = net::ip::tcp; - -std::string read_html_file(const std::string& file_path) { - std::ifstream file(file_path); - if (!file) { - return "File not found: " + file_path; - } - std::string content((std::istreambuf_iterator(file)), std::istreambuf_iterator()); - file.close(); - return content; -} - -void handle_client(tcp::socket socket, const std::string& msg) { - try { - // Construct an HTTP response with the HTML content - http::response response; - response.version(11); - response.result(http::status::ok); - response.reason("OK"); - response.set(http::field::server, "C++ Server"); - response.set(http::field::content_type, "text/html"); - response.body() = msg; - response.prepare_payload(); - - // Send the response to the client - http::write(socket, response); - } catch (const std::exception& e) { - std::cerr << "Error: " << e.what() << std::endl; - } -} - -int main() { - try { - net::io_context io_context{BOOST_ASIO_CONCURRENCY_HINT_UNSAFE_IO}; - - // Create an endpoint to bind to - tcp::endpoint endpoint(tcp::v4(), 8070); - - // Create and bind the acceptor - tcp::acceptor acceptor(io_context, endpoint); - std::cout << "Server listening on port 8070..." << std::endl; - - // static 17-byte string - std::string msg = "Hello from C++!!!"; - // or - // Read HTML content from a file (e.g., "index.html") - // std::string html_content = read_html_file("hello.html"); - - // std::cout << "str len: " << (html_content.length() == msg.length()) << std::boolalpha << "\n"; - - // Create a thread pool with 4 threads - net::thread_pool pool(4); - - while (true) { - // Wait for a client to connect - tcp::socket socket(io_context); - acceptor.accept(socket); - - // Post a task to the thread pool to handle the client request - net::post(pool, [socket = std::move(socket), msg]() mutable { - handle_client(std::move(socket), msg); - }); - } - - // The thread pool destructor will ensure that all threads are joined properly. - } catch (const std::exception& e) { - std::cerr << "Error: " << e.what() << std::endl; - } - - return 0; -} diff --git a/wrk/csharp/Program.cs b/wrk/csharp/Program.cs deleted file mode 100644 index 1b1f7bf..0000000 --- a/wrk/csharp/Program.cs +++ /dev/null @@ -1,8 +0,0 @@ -var builder = WebApplication.CreateBuilder(args); -builder.Logging.ClearProviders(); - -var app = builder.Build(); - -app.MapGet("/", () => "Hello from C#"); - -app.Run(); diff --git a/wrk/csharp/Properties/launchSettings.json b/wrk/csharp/Properties/launchSettings.json deleted file mode 100644 index d790ec0..0000000 --- a/wrk/csharp/Properties/launchSettings.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "$schema": "https://json.schemastore.org/launchsettings.json", - "profiles": { - "http": { - "commandName": "Project", - "dotnetRunMessages": true, - "launchBrowser": true, - "launchUrl": "swagger", - "applicationUrl": "http://localhost:5026", - "environmentVariables": { - "ASPNETCORE_ENVIRONMENT": "Development" - } - } - } -} \ No newline at end of file diff --git a/wrk/csharp/csharp.csproj b/wrk/csharp/csharp.csproj deleted file mode 100644 index 274b6dd..0000000 --- a/wrk/csharp/csharp.csproj +++ /dev/null @@ -1,8 +0,0 @@ - - - net8.0 - enable - enable - true - - diff --git a/wrk/go/main.go b/wrk/go/main.go deleted file mode 100644 index 508f696..0000000 --- a/wrk/go/main.go +++ /dev/null @@ -1,16 +0,0 @@ -package main - -import ( - "fmt" - "net/http" -) - -func hello(w http.ResponseWriter, req *http.Request) { - fmt.Fprintf(w, "hello from GO!!!\n") -} - -func main() { - print("listening on 0.0.0.0:8090\n") - http.HandleFunc("/hello", hello) - http.ListenAndServe(":8090", nil) -} diff --git a/wrk/graph.py b/wrk/graph.py deleted file mode 100644 index b446d98..0000000 --- a/wrk/graph.py +++ /dev/null @@ -1,90 +0,0 @@ -import re -import os -import matplotlib.pyplot as plt -from matplotlib.ticker import FuncFormatter -from collections import defaultdict -import statistics - -directory = "./wrk" # Replace with the actual directory path - -requests_sec = defaultdict(list) -transfers_sec = defaultdict(list) - -mean_requests = {} -mean_transfers = {} - - -def plot(kind='', title='', ylabel='', means=None): - # Sort the labels and requests_sec lists together based on the requests_sec values - labels = [] - values = [] - - # silly, I know - for k, v in means.items(): - labels.append(k) - values.append(v) - - # sort the labels and value lists - labels, values = zip(*sorted(zip(labels, values), key=lambda x: x[1], reverse=True)) - - # Plot the graph - plt.figure(figsize=(10, 6)) # Adjust the figure size as needed - bars = plt.bar(labels, values) - plt.xlabel("Subject") - plt.ylabel(ylabel) - plt.title(title) - plt.xticks(rotation=45) # Rotate x-axis labels for better readability - - # Display the actual values on top of the bars - for bar in bars: - yval = bar.get_height() - plt.text(bar.get_x() + bar.get_width() / 2, yval, f'{yval:,.2f}', ha='center', va='bottom') - - plt.tight_layout() # Adjust the spacing of the graph elements - png_name = f"{directory}/{kind.lower()}_graph.png" - plt.savefig(png_name) # Save the graph as a PNG file - print(f"Generated: {png_name}") - - -if __name__ == '__main__': - if not os.path.isdir(".git"): - print("Please run from root directory of the repository!") - print("e.g. python wrk/graph.py") - import sys - sys.exit(1) - - # Iterate over the files in the directory - for filename in os.listdir(directory): - if filename.endswith(".perflog"): - label = os.path.splitext(filename)[0] - file_path = os.path.join(directory, filename) - - with open(file_path, "r") as file: - lines = file.readlines() - for line in lines: - # Extract the Requests/sec value using regular expressions - match = re.search(r"Requests/sec:\s+([\d.]+)", line) - if match: - requests_sec[label].append(float(match.group(1))) - match = re.search(r"Transfer/sec:\s+([\d.]+)", line) - if match: - value = float(match.group(1)) - if 'KB' in line: - value *= 1024 - elif 'MB' in line: - value *= 1024 * 1024 - value /= 1024.0 * 1024 - transfers_sec[label].append(value) - - # calculate means - for k, v in requests_sec.items(): - mean_requests[k] = statistics.mean(v) - - for k, v in transfers_sec.items(): - mean_transfers[k] = statistics.mean(v) - - # save the plots - plot(kind='req_per_sec', title='Requests/sec Comparison', - ylabel='requests/sec', means=mean_requests) - plot(kind='xfer_per_sec', title='Transfer/sec Comparison', - ylabel='transfer/sec [MB]', means=mean_transfers) diff --git a/wrk/measure.sh b/wrk/measure.sh deleted file mode 100755 index 4b8e078..0000000 --- a/wrk/measure.sh +++ /dev/null @@ -1,104 +0,0 @@ -#! /usr/bin/env bash -THREADS=4 -CONNECTIONS=400 -DURATION_SECONDS=10 - -SUBJECT=$1 - -if echo $(uname) -eq "Darwin" ; then -TSK_SRV="" -TSK_LOAD="" -else -TSK_SRV="taskset -c 0,1,2,3" -TSK_LOAD="taskset -c 4,5,6,7" -fi - -if [ "$SUBJECT" = "" ] ; then - echo "usage: $0 subject # subject: zig or go" - exit 1 -fi - -if [ "$SUBJECT" = "zig-zap" ] ; then - zig build -Doptimize=ReleaseFast wrk > /dev/null - $TSK_SRV ./zig-out/bin/wrk & - PID=$! - URL=http://127.0.0.1:3000 -fi - -if [ "$SUBJECT" = "zigstd" ] ; then - zig build -Doptimize=ReleaseFast wrk_zigstd > /dev/null - $TSK_SRV ./zig-out/bin/wrk_zigstd & - PID=$! - URL=http://127.0.0.1:3000 -fi - -if [ "$SUBJECT" = "go" ] ; then - cd wrk/go && go build main.go - $TSK_SRV ./main & - PID=$! - URL=http://127.0.0.1:8090/hello -fi - -if [ "$SUBJECT" = "python" ] ; then - $TSK_SRV python wrk/python/main.py & - PID=$! - URL=http://127.0.0.1:8080 -fi - -if [ "$SUBJECT" = "python-sanic" ] ; then - $TSK_SRV python wrk/sanic/sanic-app.py & - PID=$! - URL=http://127.0.0.1:8000 -fi - -if [ "$SUBJECT" = "rust-bythebook" ] ; then - cd wrk/rust/bythebook && cargo build --release - $TSK_SRV ./target/release/hello & - PID=$! - URL=http://127.0.0.1:7878 -fi - -if [ "$SUBJECT" = "rust-bythebook-improved" ] ; then - cd wrk/rust/bythebook-improved && cargo build --release - $TSK_SRV ./target/release/hello & - PID=$! - URL=http://127.0.0.1:7878 -fi - - -if [ "$SUBJECT" = "rust-clean" ] ; then - cd wrk/rust/clean && cargo build --release - $TSK_SRV ./target/release/hello & - PID=$! - URL=http://127.0.0.1:7878 -fi - -if [ "$SUBJECT" = "rust-axum" ] ; then - cd wrk/axum/hello-axum && cargo build --release - $TSK_SRV ./target/release/hello-axum & - PID=$! - URL=http://127.0.0.1:3000 -fi - -if [ "$SUBJECT" = "csharp" ] ; then - cd wrk/csharp && dotnet publish csharp.csproj -o ./out - $TSK_SRV ./out/csharp --urls "http://127.0.0.1:5026" & - PID=$! - URL=http://127.0.0.1:5026 -fi - -if [ "$SUBJECT" = "cpp-beast" ] ; then - cd wrk/cpp && zig build -Doptimize=ReleaseFast - $TSK_SRV ./zig-out/bin/cpp-beast 127.0.0.1 8070 . & - PID=$! - URL=http://127.0.0.1:8070 -fi - -sleep 1 -echo "========================================================================" -echo " $SUBJECT" -echo "========================================================================" -$TSK_LOAD wrk -c $CONNECTIONS -t $THREADS -d $DURATION_SECONDS --latency $URL - -kill $PID - diff --git a/wrk/measure_all.sh b/wrk/measure_all.sh deleted file mode 100755 index 0e80a59..0000000 --- a/wrk/measure_all.sh +++ /dev/null @@ -1,32 +0,0 @@ -#! /usr/bin/env bash - -if [ ! -d ".git" ] ; then - echo "This script must be run from the root directory of the repository!" - echo "./wrk/measure_all.sh" - exit 1 -fi - -SUBJECTS="$1" - -if [ "$SUBJECTS" = "README" ] ; then - rm -f wrk/*.perflog - SUBJECTS="zig-zap go python-sanic rust-axum csharp cpp-beast" - # above targets csharp and cpp-beast are out of date! - SUBJECTS="zig-zap go python-sanic rust-axum" -fi - -if [ -z "$SUBJECTS" ] ; then - SUBJECTS="zig-zap go python python-sanic rust-bythebook rust-bythebook-improved rust-clean rust-axum csharp cpp-beast" - # above targets csharp and cpp-beast are out of date! - SUBJECTS="zig-zap go python python-sanic rust-bythebook rust-bythebook-improved rust-clean rust-axum" -fi - -for S in $SUBJECTS; do - L="$S.perflog" - rm -f wrk/$L - for R in 1 2 3 ; do - ./wrk/measure.sh $S | tee -a wrk/$L - done -done - -echo "Finished" diff --git a/wrk/other_measurements.md b/wrk/other_measurements.md deleted file mode 100644 index 7cd695f..0000000 --- a/wrk/other_measurements.md +++ /dev/null @@ -1,52 +0,0 @@ -# other measurements - -## zap wrk 'example' with and without logging - -**NO** performance regressions observable: - -With `logging=true`: - -``` -[nix-shell:~/code/github.com/renerocksai/zap]$ ./wrk/measure.sh zig > out 2> /dev/null - -[nix-shell:~/code/github.com/renerocksai/zap]$ cat out -======================================================================== - zig -======================================================================== -Running 10s test @ http://127.0.0.1:3000 - 4 threads and 400 connections - Thread Stats Avg Stdev Max +/- Stdev - Latency 343.91us 286.75us 18.37ms 95.58% - Req/Sec 162.61k 3.61k 174.96k 76.75% - Latency Distribution - 50% 302.00us - 75% 342.00us - 90% 572.00us - 99% 697.00us - 6470789 requests in 10.01s, 0.96GB read -Requests/sec: 646459.59 -Transfer/sec: 98.03MB -``` - -With `logging=false`: - -``` -[nix-shell:~/code/github.com/renerocksai/zap]$ ./wrk/measure.sh zig -Listening on 0.0.0.0:3000 -======================================================================== - zig -======================================================================== -Running 10s test @ http://127.0.0.1:3000 - 4 threads and 400 connections - Thread Stats Avg Stdev Max +/- Stdev - Latency 336.10us 122.28us 14.67ms 88.55% - Req/Sec 159.82k 7.71k 176.75k 56.00% - Latency Distribution - 50% 310.00us - 75% 343.00us - 90% 425.00us - 99% 699.00us - 6359415 requests in 10.01s, 0.94GB read -Requests/sec: 635186.96 -Transfer/sec: 96.32MB -``` diff --git a/wrk/python/main.py b/wrk/python/main.py deleted file mode 100644 index f3c77d1..0000000 --- a/wrk/python/main.py +++ /dev/null @@ -1,32 +0,0 @@ -# Python 3 server example -from http.server import BaseHTTPRequestHandler, HTTPServer - -hostName = "127.0.0.1" -serverPort = 8080 - - -class MyServer(BaseHTTPRequestHandler): - def do_GET(self): - try: - self.send_response(200) - self.send_header("Content-type", "text/html") - self.end_headers() - self.wfile.write(bytes("HI FROM PYTHON!!!", "utf-8")) - except: - pass - - def log_message(self, format, *args): - return - - -if __name__ == "__main__": - webServer = HTTPServer((hostName, serverPort), MyServer) - print("Server started http://%s:%s" % (hostName, serverPort)) - - try: - webServer.serve_forever() - except KeyboardInterrupt: - pass - - webServer.server_close() - print("Server stopped.") diff --git a/wrk/rust/bythebook-improved/.gitignore b/wrk/rust/bythebook-improved/.gitignore deleted file mode 100644 index 6985cf1..0000000 --- a/wrk/rust/bythebook-improved/.gitignore +++ /dev/null @@ -1,14 +0,0 @@ -# Generated by Cargo -# will have compiled files and executables -debug/ -target/ - -# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries -# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html -Cargo.lock - -# These are backup files generated by rustfmt -**/*.rs.bk - -# MSVC Windows builds of rustc generate these, which store debugging information -*.pdb diff --git a/wrk/rust/bythebook-improved/Cargo.toml b/wrk/rust/bythebook-improved/Cargo.toml deleted file mode 100644 index c9ba87b..0000000 --- a/wrk/rust/bythebook-improved/Cargo.toml +++ /dev/null @@ -1,9 +0,0 @@ -[package] -name = "hello" -version = "0.1.0" -edition = "2021" - -# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html - -[dependencies] -# crossbeam = { version = "0.8.2", features = ["crossbeam-channel"] } diff --git a/wrk/rust/bythebook-improved/src/lib.rs b/wrk/rust/bythebook-improved/src/lib.rs deleted file mode 100644 index 6e5d88d..0000000 --- a/wrk/rust/bythebook-improved/src/lib.rs +++ /dev/null @@ -1,101 +0,0 @@ -//Crossbeam should, but does not make this faster. -//use crossbeam::channel::bounded; -use std::{net::TcpStream, sync::mpsc, thread}; -type Job = (fn(TcpStream), TcpStream); - -type Sender = mpsc::Sender; -//type Sender = crossbeam::channel::Sender; - -type Receiver = mpsc::Receiver; -//type Receiver = crossbeam::channel::Receiver; - -pub struct ThreadPool { - workers: Vec, - senders: Vec, - - next_sender: usize, -} - -impl ThreadPool { - /// Create a new ThreadPool. - /// - /// The size is the number of threads in the pool. - /// - /// # Panics - /// - /// The `new` function will panic if the size is zero. - pub fn new(size: usize) -> ThreadPool { - assert!(size > 0); - - let mut workers = Vec::with_capacity(size); - let mut senders = Vec::with_capacity(size); - - for id in 0..size { - //let (sender, receiver) = bounded(2); - let (sender, receiver) = mpsc::channel(); - senders.push(sender); - workers.push(Worker::new(id, receiver)); - } - - ThreadPool { - workers, - senders, - next_sender: 0, - } - } - /// round robin over available workers to ensure we never have to buffer requests - pub fn execute(&mut self, handler: fn(TcpStream), stream: TcpStream) { - let job = (handler, stream); - self.senders[self.next_sender].send(job).unwrap(); - //self.senders[self.next_sender].try_send(job).unwrap(); - self.next_sender += 1; - if self.next_sender == self.senders.len() { - self.next_sender = 0; - } - } -} - -impl Drop for ThreadPool { - fn drop(&mut self) { - self.senders.clear(); - - for worker in &mut self.workers { - println!("Shutting down worker {}", worker.id); - if let Some(thread) = worker.thread.take() { - thread.join().unwrap(); - } - } - } -} - -struct Worker { - id: usize, - thread: Option>, -} - -impl Worker { - fn new(id: usize, receiver: Receiver) -> Worker { - let thread = thread::spawn(move || Self::work(receiver)); - - Worker { - id, - thread: Some(thread), - } - } - - fn work(receiver: Receiver) { - loop { - let message = receiver.recv(); - match message { - Ok((handler, stream)) => { - // println!("Worker got a job; executing."); - handler(stream); - } - Err(_) => { - // println!("Worker disconnected; shutting down."); - break; - } - } - } - } -} diff --git a/wrk/rust/bythebook-improved/src/main.rs b/wrk/rust/bythebook-improved/src/main.rs deleted file mode 100644 index 8b22471..0000000 --- a/wrk/rust/bythebook-improved/src/main.rs +++ /dev/null @@ -1,34 +0,0 @@ -use hello::ThreadPool; -use std::io::prelude::*; -use std::net::TcpListener; -use std::net::TcpStream; - -fn main() { - let listener = TcpListener::bind("127.0.0.1:7878").unwrap(); - //Creating a massive amount of threads so we can always have one ready to go. - let mut pool = ThreadPool::new(128); - - for stream in listener.incoming() { - let stream = stream.unwrap(); - //handle_connection(stream); - pool.execute(handle_connection, stream); - } - - println!("Shutting down."); -} - -fn handle_connection(mut stream: TcpStream) { - stream.set_nodelay(true).expect("set_nodelay call failed"); - loop{ - let mut buffer = [0; 1024]; - match stream.read(&mut buffer){ - Err(_)=>return, - Ok(0)=>return, - Ok(_v)=>{}, - } - - let response_bytes = b"HTTP/1.1 200 OK\r\nContent-Length: 16\r\nConnection: keep-alive\r\n\r\nHELLO from RUST!"; - - stream.write_all(response_bytes).unwrap(); - } -} diff --git a/wrk/rust/bythebook/.gitignore b/wrk/rust/bythebook/.gitignore deleted file mode 100644 index 6985cf1..0000000 --- a/wrk/rust/bythebook/.gitignore +++ /dev/null @@ -1,14 +0,0 @@ -# Generated by Cargo -# will have compiled files and executables -debug/ -target/ - -# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries -# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html -Cargo.lock - -# These are backup files generated by rustfmt -**/*.rs.bk - -# MSVC Windows builds of rustc generate these, which store debugging information -*.pdb diff --git a/wrk/rust/bythebook/Cargo.toml b/wrk/rust/bythebook/Cargo.toml deleted file mode 100644 index fb1ec2c..0000000 --- a/wrk/rust/bythebook/Cargo.toml +++ /dev/null @@ -1,8 +0,0 @@ -[package] -name = "hello" -version = "0.1.0" -edition = "2021" - -# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html - -[dependencies] diff --git a/wrk/rust/bythebook/hello.html b/wrk/rust/bythebook/hello.html deleted file mode 100644 index a2b3773..0000000 --- a/wrk/rust/bythebook/hello.html +++ /dev/null @@ -1 +0,0 @@ -Hello from RUST! diff --git a/wrk/rust/bythebook/src/lib.rs b/wrk/rust/bythebook/src/lib.rs deleted file mode 100644 index 936d014..0000000 --- a/wrk/rust/bythebook/src/lib.rs +++ /dev/null @@ -1,92 +0,0 @@ -use std::{ - sync::{mpsc, Arc, Mutex}, - thread, -}; - -pub struct ThreadPool { - workers: Vec, - sender: Option>, -} - -type Job = Box; - -impl ThreadPool { - /// Create a new ThreadPool. - /// - /// The size is the number of threads in the pool. - /// - /// # Panics - /// - /// The `new` function will panic if the size is zero. - pub fn new(size: usize) -> ThreadPool { - assert!(size > 0); - - let (sender, receiver) = mpsc::channel(); - - let receiver = Arc::new(Mutex::new(receiver)); - - let mut workers = Vec::with_capacity(size); - - for id in 0..size { - workers.push(Worker::new(id, Arc::clone(&receiver))); - } - - ThreadPool { - workers, - sender: Some(sender), - } - } - - pub fn execute(&self, f: F) - where - F: FnOnce() + Send + 'static, - { - let job = Box::new(f); - - self.sender.as_ref().unwrap().send(job).unwrap(); - } -} - -impl Drop for ThreadPool { - fn drop(&mut self) { - drop(self.sender.take()); - - for worker in &mut self.workers { - println!("Shutting down worker {}", worker.id); - - if let Some(thread) = worker.thread.take() { - thread.join().unwrap(); - } - } - } -} - -struct Worker { - id: usize, - thread: Option>, -} - -impl Worker { - fn new(id: usize, receiver: Arc>>) -> Worker { - let thread = thread::spawn(move || loop { - let message = receiver.lock().unwrap().recv(); - - match message { - Ok(job) => { - // println!("Worker got a job; executing."); - - job(); - } - Err(_) => { - // println!("Worker disconnected; shutting down."); - break; - } - } - }); - - Worker { - id, - thread: Some(thread), - } - } -} diff --git a/wrk/rust/bythebook/src/main.rs b/wrk/rust/bythebook/src/main.rs deleted file mode 100644 index 34a7474..0000000 --- a/wrk/rust/bythebook/src/main.rs +++ /dev/null @@ -1,43 +0,0 @@ -use hello::ThreadPool; -// use std::fs; -use std::io::prelude::*; -use std::net::TcpListener; -use std::net::TcpStream; -// use std::thread; -// use std::time::Duration; - -fn main() { - let listener = TcpListener::bind("127.0.0.1:7878").unwrap(); - let pool = ThreadPool::new(4); - - // for stream in listener.incoming().take(2) { - for stream in listener.incoming() { - let stream = stream.unwrap(); - - pool.execute(|| { - handle_connection(stream); - }); - } - - println!("Shutting down."); -} - -fn handle_connection(mut stream: TcpStream) { - let mut buffer = [0; 1024]; - stream.read(&mut buffer).unwrap(); - - - let status_line = "HTTP/1.1 200 OK"; - - let contents = "HELLO from RUST!"; - - let response = format!( - "{}\r\nContent-Length: {}\r\n\r\n{}", - status_line, - contents.len(), - contents - ); - - stream.write_all(response.as_bytes()).unwrap(); - stream.flush().unwrap(); -} diff --git a/wrk/rust/clean/.gitignore b/wrk/rust/clean/.gitignore deleted file mode 100644 index 6985cf1..0000000 --- a/wrk/rust/clean/.gitignore +++ /dev/null @@ -1,14 +0,0 @@ -# Generated by Cargo -# will have compiled files and executables -debug/ -target/ - -# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries -# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html -Cargo.lock - -# These are backup files generated by rustfmt -**/*.rs.bk - -# MSVC Windows builds of rustc generate these, which store debugging information -*.pdb diff --git a/wrk/rust/clean/Cargo.toml b/wrk/rust/clean/Cargo.toml deleted file mode 100644 index cf97cf6..0000000 --- a/wrk/rust/clean/Cargo.toml +++ /dev/null @@ -1,8 +0,0 @@ -[package] -name = "hello" -version = "0.1.0" -edition = "2021" - - -[dependencies] - diff --git a/wrk/rust/clean/hello.html b/wrk/rust/clean/hello.html deleted file mode 100644 index a2b3773..0000000 --- a/wrk/rust/clean/hello.html +++ /dev/null @@ -1 +0,0 @@ -Hello from RUST! diff --git a/wrk/rust/clean/src/lib.rs b/wrk/rust/clean/src/lib.rs deleted file mode 100644 index 6e5d88d..0000000 --- a/wrk/rust/clean/src/lib.rs +++ /dev/null @@ -1,101 +0,0 @@ -//Crossbeam should, but does not make this faster. -//use crossbeam::channel::bounded; -use std::{net::TcpStream, sync::mpsc, thread}; -type Job = (fn(TcpStream), TcpStream); - -type Sender = mpsc::Sender; -//type Sender = crossbeam::channel::Sender; - -type Receiver = mpsc::Receiver; -//type Receiver = crossbeam::channel::Receiver; - -pub struct ThreadPool { - workers: Vec, - senders: Vec, - - next_sender: usize, -} - -impl ThreadPool { - /// Create a new ThreadPool. - /// - /// The size is the number of threads in the pool. - /// - /// # Panics - /// - /// The `new` function will panic if the size is zero. - pub fn new(size: usize) -> ThreadPool { - assert!(size > 0); - - let mut workers = Vec::with_capacity(size); - let mut senders = Vec::with_capacity(size); - - for id in 0..size { - //let (sender, receiver) = bounded(2); - let (sender, receiver) = mpsc::channel(); - senders.push(sender); - workers.push(Worker::new(id, receiver)); - } - - ThreadPool { - workers, - senders, - next_sender: 0, - } - } - /// round robin over available workers to ensure we never have to buffer requests - pub fn execute(&mut self, handler: fn(TcpStream), stream: TcpStream) { - let job = (handler, stream); - self.senders[self.next_sender].send(job).unwrap(); - //self.senders[self.next_sender].try_send(job).unwrap(); - self.next_sender += 1; - if self.next_sender == self.senders.len() { - self.next_sender = 0; - } - } -} - -impl Drop for ThreadPool { - fn drop(&mut self) { - self.senders.clear(); - - for worker in &mut self.workers { - println!("Shutting down worker {}", worker.id); - if let Some(thread) = worker.thread.take() { - thread.join().unwrap(); - } - } - } -} - -struct Worker { - id: usize, - thread: Option>, -} - -impl Worker { - fn new(id: usize, receiver: Receiver) -> Worker { - let thread = thread::spawn(move || Self::work(receiver)); - - Worker { - id, - thread: Some(thread), - } - } - - fn work(receiver: Receiver) { - loop { - let message = receiver.recv(); - match message { - Ok((handler, stream)) => { - // println!("Worker got a job; executing."); - handler(stream); - } - Err(_) => { - // println!("Worker disconnected; shutting down."); - break; - } - } - } - } -} diff --git a/wrk/rust/clean/src/main.rs b/wrk/rust/clean/src/main.rs deleted file mode 100644 index cda767c..0000000 --- a/wrk/rust/clean/src/main.rs +++ /dev/null @@ -1,32 +0,0 @@ -use std::io::prelude::*; -use std::net::TcpListener; -use std::net::TcpStream; - -fn main() { - let listener = TcpListener::bind("127.0.0.1:7878").unwrap(); - - for stream in listener.incoming() { - let stream = stream.unwrap(); - //handle_connection(stream); - std::thread::spawn(||{handle_connection(stream)}); - } - - println!("Shutting down."); -} - -fn handle_connection(mut stream: TcpStream) { - stream.set_nodelay(true).expect("set_nodelay call failed"); - loop{ - let mut buffer = [0; 1024]; - match stream.read(&mut buffer){ - Err(_)=>return, - Ok(0)=>return, - Ok(_v)=>{}, - } - - let response_bytes = b"HTTP/1.1 200 OK\r\nContent-Length: 16\r\nConnection: keep-alive\r\n\r\nHELLO from RUST!"; - - stream.write_all(response_bytes).unwrap(); - } - -} diff --git a/wrk/samples/README_req_per_sec.png b/wrk/samples/README_req_per_sec.png deleted file mode 100644 index cfd7ce0..0000000 Binary files a/wrk/samples/README_req_per_sec.png and /dev/null differ diff --git a/wrk/samples/README_xfer_per_sec.png b/wrk/samples/README_xfer_per_sec.png deleted file mode 100644 index 275c2b7..0000000 Binary files a/wrk/samples/README_xfer_per_sec.png and /dev/null differ diff --git a/wrk/samples/laptop_req_per_sec_graph.png b/wrk/samples/laptop_req_per_sec_graph.png deleted file mode 100644 index 1e9e66f..0000000 Binary files a/wrk/samples/laptop_req_per_sec_graph.png and /dev/null differ diff --git a/wrk/samples/laptop_xfer_per_sec_graph.png b/wrk/samples/laptop_xfer_per_sec_graph.png deleted file mode 100644 index 1aee703..0000000 Binary files a/wrk/samples/laptop_xfer_per_sec_graph.png and /dev/null differ diff --git a/wrk/samples/req_per_sec_graph.png b/wrk/samples/req_per_sec_graph.png deleted file mode 100644 index 235a0ed..0000000 Binary files a/wrk/samples/req_per_sec_graph.png and /dev/null differ diff --git a/wrk/samples/workstation_req_per_sec_graph.png b/wrk/samples/workstation_req_per_sec_graph.png deleted file mode 100644 index db57f20..0000000 Binary files a/wrk/samples/workstation_req_per_sec_graph.png and /dev/null differ diff --git a/wrk/samples/workstation_xfer_per_sec_graph.png b/wrk/samples/workstation_xfer_per_sec_graph.png deleted file mode 100644 index 4bbb13f..0000000 Binary files a/wrk/samples/workstation_xfer_per_sec_graph.png and /dev/null differ diff --git a/wrk/samples/xfer_per_sec_graph.png b/wrk/samples/xfer_per_sec_graph.png deleted file mode 100644 index 73fe3cd..0000000 Binary files a/wrk/samples/xfer_per_sec_graph.png and /dev/null differ diff --git a/wrk/sanic/sanic-app.py b/wrk/sanic/sanic-app.py deleted file mode 100644 index a382282..0000000 --- a/wrk/sanic/sanic-app.py +++ /dev/null @@ -1,12 +0,0 @@ -from sanic import Sanic -from sanic.response import html - -app = Sanic("sanic-app") - - -@app.route('/') -async def test(request): - return html("Hello from sanic!", 200) - -if __name__ == '__main__': - app.run() diff --git a/wrk/zig/main.zig b/wrk/zig/main.zig deleted file mode 100644 index ef68612..0000000 --- a/wrk/zig/main.zig +++ /dev/null @@ -1,24 +0,0 @@ -const std = @import("std"); -const zap = @import("zap"); - -fn on_request_minimal(r: zap.Request) !void { - try r.sendBody("Hello from ZAP!!!"); -} - -pub fn main() !void { - var listener = zap.HttpListener.init(.{ - .port = 3000, - .on_request = on_request_minimal, - .log = false, - .max_clients = 100000, - }); - try listener.listen(); - - std.debug.print("Listening on 0.0.0.0:3000\n", .{}); - - // start worker threads - zap.start(.{ - .threads = 4, - .workers = 4, // empirical tests: yield best perf on my machine - }); -} diff --git a/wrk/zigstd/main.zig b/wrk/zigstd/main.zig deleted file mode 100644 index 45f9273..0000000 --- a/wrk/zigstd/main.zig +++ /dev/null @@ -1,33 +0,0 @@ -const std = @import("std"); - -pub fn main() !void { - // var gpa = std.heap.GeneralPurposeAllocator(.{ - // .thread_safe = true, - // }){}; - // const allocator = gpa.allocator(); - - const address = try std.net.Address.parseIp("127.0.0.1", 3000); - var http_server = try address.listen(.{ - .reuse_address = true, - }); - - var read_buffer: [2048]u8 = undefined; - - // const max_header_size = 8192; - - while (true) { - const connection = try http_server.accept(); - defer connection.stream.close(); - var server = std.http.Server.init(connection, &read_buffer); - - var request = try server.receiveHead(); - const server_body: []const u8 = "HI FROM ZIG STD!\n"; - - try request.respond(server_body, .{ - .extra_headers = &.{ - .{ .name = "content_type", .value = "text/plain" }, - .{ .name = "connection", .value = "close" }, - }, - }); - } -}