ummm (#604)

Author: aaylward

Cargo.lock

@@ -3,7 +3,9 @@ resolver = "2"
 
 members = [
     "rust/helloworld_tonic",
+    "rust/cards",
     "rust/doc_db",
+    "rust/wordchains",
     "protos/example_service",
     "protos/doc_db",
 ]
@@ -17,11 +19,11 @@ readme = "README.md"
 [workspace.dependencies]
 example_service = { path = "protos/example_service" }
 doc_db_proto = { path = "protos/doc_db" }
-prost = { version = "0.13.4" }
+prost = { version = "0.13.5" }
 prost-types = { version = "0.13.5", default-features = false }
 tonic = { version = "0.12.3", features = ["transport"] }
 tonic-build = "0.12.3"
-tokio = { version = "1.43.0", default-features = false, features = ["macros", "net", "rt-multi-thread", "signal"] }
+tokio = { version = "1.44.1", default-features = false, features = ["macros", "net", "rt-multi-thread", "signal"] }
 protoc-gen-tonic = "0.4.1"
 protoc-gen-prost = "0.4.0"
 mongodb = "3.2.3"

Cargo.toml

@@ -4,6 +4,7 @@
 
 ![MoonBase](static_content/moon.gif)
 
+## IDE Support
 ### IntelliJ
 Tested with [Bazel for IntelliJ](https://plugins.jetbrains.com/plugin/8609-bazel-for-intellij)
 
@@ -30,5 +31,54 @@ bazel run @hedron_compile_commands//:refresh_all
 code .
 ```
 
-### Importing a project?
+## Importing a project?
 See [IMPORTING](./IMPORTING.md)
+
+## Repository Contents
+
+This repository contains multiple projects implemented across various programming languages. Here's a summary of the major components:
+
+### Card Games
+- **Rust**: [`/rust/cards`](rust/cards) - Experimenting with moving card game engines to Rust
+- **C++**: [`/cpp/cards`](cpp/cards) - Golf rules implementation and some helpers
+- **Go**: [`/go/cards`](go/cards) - Experimenting with moving card game engines to Go
+
+### Document Database
+- **Rust**: [`doc_db`](rust/doc_db) - DocDB with Mongo backend
+- **Go**: [`doc_db`](go/doc_db) - DocDB WIP
+- **C++**: [`doc_db_client`](cpp/doc_db_client) - Document database client
+
+### Golf Services
+- **C++**:
+  - [`golf_service`](cpp/golf_service) - Golf websocket server
+  - [`golf_grpc`](cpp/golf_grpc) - Golf gRPC service
+- **Web**:
+  - [`golf_ui`](web/golf_ui) - Original golf UI
+  - [`golf_ui_2`](web/golf_ui_2) - Updated golf UI
+ 
+### Web Related
+- **C++**:
+  - [`lakitu`](cpp/lakitu) - GRPC wrapper for C++
+  - [`example_service`](cpp/example_service) - Example service
+- **Java**:
+  - [`lunarcat`](jvm/src/main/java/com/muchq/lunarcat) - Rest-style HTTP server
+- **Rust**:
+  - [`helloworld_tonic`](rust/helloworld_tonic) - gRPC example using Tonic
+- **Go**:
+  - [`resilience4g`](go/resilience4g) - Resilience4J for Go
+  - [`r3dr`](go/r3dr) - a url shortening service
+  - [`mucks`](go/mucks) - Router wrapper middleware
+  - [`example_grpc`](go/example_grpc) - gRPC example
+
+### Other Projects
+- **Rust**:
+  - [`wordchains`](rust/wordchains) - Word chain implementation
+- **C++**:
+  - [`so_leet`](cpp/so_leet) - Some leetcode
+  - [`futility`](cpp/futility) - Utilities for C++
+- **Go**:
+  - [`images`](go/images) - Some image processing tools
+  - [`clock`](go/clock) - a Clock
+- **JS**:
+  - [`flippymem`](web/flippymem) - Flippy memory game
+- **JVM**: [`java and scala stuff`](jvm) - Java/Scala projects

MODULE.bazel.lock

@@ -12,6 +12,3 @@ git_override(
 
 mongoose_ext = use_extension("//bazel/extensions:mongoose.bzl", "mongoose")
 use_repo(mongoose_ext, "mongoose_cc")
-
-raylib_ext = use_extension("//bazel/extensions:raylib.bzl", "raylib")
-use_repo(raylib_ext, "raylib")

README.md

@@ -25,7 +25,9 @@ crate.from_cargo(
         "//protos/example_service:Cargo.toml",
         "//protos/doc_db:Cargo.toml",
         "//rust/helloworld_tonic:Cargo.toml",
+        "//rust/cards:Cargo.toml",
         "//rust/doc_db:Cargo.toml",
+        "//rust/wordchains:Cargo.toml",
     ],
     supported_platform_triples = [
         "aarch64-apple-darwin",

bazel/cc.MODULE.bazel

@@ -0,0 +1,31 @@
+# Card Games - C++ Implementation
+
+This module provides a set of classes and utilities for building card games.
+
+## Related Projects
+
+- [Rust Implementation](../../rust/cards) (WIP)
+- [Go Implementation](../../go/cards) (WIP)
+
+## Components
+
+- Top level module contains core components for building card games.
+- [golf](./golf) is a mostly complete implementation of the game Golf.
+
+## Building
+
+This project uses Bazel for building:
+
+```bash
+bazel build //cpp/cards:...
+```
+
+## Testing
+
+```bash
+bazel test //cpp/cards:...
+```
+
+## IDE Support
+
+For optimal development experience, use CLion with the Bazel plugin or VSCode with the compile commands extractor as described in the main [README](../../README.md).

bazel/extensions/raylib.bzl

@@ -1,9 +1,6 @@
 #ifndef CPP_CARDS_CARD_H
 #define CPP_CARDS_CARD_H
 
-#include <string>
-#include <unordered_map>
-
 namespace cards {
 
 enum class Suit { Clubs, Diamonds, Hearts, Spades };

bazel/rust.MODULE.bazel

@@ -0,0 +1,31 @@
+# Document Database Client - C++ Implementation
+
+This directory contains a C++ client implementation for interacting with the document database system. It provides a high-performance interface for C++ applications to access the document database.
+
+## Related Projects
+
+This client implementation is part of a multi-language document database system. Related implementations can be found in:
+- [Rust Implementation](../../rust/doc_db)
+- [Go Implementation](../../go/doc_db)
+
+## Building
+
+This project uses Bazel for building:
+
+```bash
+bazel build //cpp/doc_db_client:...
+```
+
+## Testing
+
+```bash
+bazel test //cpp/doc_db_client:...
+```
+
+## Protocol Buffers
+
+This implementation uses protocol buffers for data serialization. The proto definitions can be found in the [protos](../../protos) directory.
+
+## IDE Support
+
+For optimal development experience, use CLion with the Bazel plugin or VSCode with the compile commands extractor as described in the main [README](../../README.md).

cpp/cards/README.md

@@ -1,28 +1,39 @@
-# Example GRPC Service
+# Example Service - C++ Implementation
 
-### Build
-```
-bazel build //cpp/example_service
-```
+This directory contains a C++ implementation of an example service. It serves as a reference implementation for building C++ services in this repository.
 
-### Run
-```
-bazel-bin/cpp/example_service/example_service
-```
+## Features
+
+- Service architecture
+- Protocol buffer integration
+- Error handling
+- Logging
+- Configuration management
+
+## Building
+
+This project uses Bazel for building:
 
-### Call
+```bash
+bazel build //cpp/example_service:...
 ```
-➜  ~ grpcurl -d '{"name": "Friend"}' -plaintext localhost:8080 example_service.Greeter/SayHello
-{
-  "message": "Hello Friend"
-}
+
+## Testing
+
+```bash
+bazel test //cpp/example_service:...
 ```
 
-### OCI
-# OCI
-```shell
-sudo apt install podman
-bazel run //cpp/example_service:oci_tarball
-podman run -p 8080:8089 example_cc_grpc
-grpcurl -d '{"name": "Friend"}' -plaintext localhost:8080 example_service.Greeter/SayHello
+## Running the Service
+
+```bash
+bazel run //cpp/example_service:server
 ```
+
+## Protocol Buffers
+
+This service uses protocol buffers for data serialization. The proto definitions can be found in the [protos](../../protos) directory.
+
+## IDE Support
+
+For optimal development experience, use CLion with the Bazel plugin or VSCode with the compile commands extractor as described in the main [README](../../README.md).

cpp/cards/card.h

@@ -0,0 +1,49 @@
+# Utility Library - C++ Implementation
+
+This directory contains a C++ utility library. It provides a collection of commonly used utilities and helper functions for C++ development.
+
+## Features
+
+- String manipulation
+- File operations
+- Memory management
+- Thread utilities
+- Logging
+- Error handling
+- Type conversions
+
+## Building
+
+This project uses Bazel for building:
+
+```bash
+bazel build //cpp/futility:...
+```
+
+## Testing
+
+```bash
+bazel test //cpp/futility:...
+```
+
+## Example Usage
+
+```cpp
+// Example of using utility functions
+#include "futility/string_utils.h"
+#include "futility/file_utils.h"
+
+int main() {
+    // String manipulation
+    std::string input = "Hello, World!";
+    auto trimmed = futility::Trim(input);
+
+    // File operations
+    auto content = futility::ReadFile("example.txt");
+    return 0;
+}
+```
+
+## IDE Support
+
+For optimal development experience, use CLion with the Bazel plugin or VSCode with the compile commands extractor as described in the main [README](../../README.md).