✨ Add cli based text generator

.github/workflows/rust.yml

@@ -0,0 +1,26 @@
+name: Rust
+
+on:
+  push:
+    branches: ['**']
+    paths:
+      - .github/workflows/rust.yml
+      - '**/*.rs'
+      - Cargo.toml
+      - Cargo.lock
+  pull_request:
+    branches: ['master']
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Build
+      run: cargo build --verbose
+    - name: Run tests
+      run: cargo test --verbose
+

.gitignore

@@ -11,5 +11,8 @@
 !Cargo.toml
 !Cargo.lock
 
+# give github related files a free pass
+!/.github/**/*
+
 # ... not when they are in subdirectories
 !*/

Cargo.toml

@@ -6,3 +6,8 @@ edition = "2021"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
+clap = { version = "4.5.4", features = ["derive"] }
+fastrand = "2.1.0"
+
+[dev-dependencies]
+regex = "1.10.4"

src/cli/mod.rs

@@ -0,0 +1,28 @@
+#[derive(clap::Parser)]
+#[clap(version, about)]
+pub struct Command {
+    #[command(subcommand)]
+    pub subcmd: SubCommand,
+}
+
+#[derive(clap::Subcommand)]
+pub enum SubCommand {
+    #[command(subcommand, aliases=["gen"])]
+    Generate(GenerateCmd),
+}
+
+#[derive(clap::Subcommand)]
+pub enum GenerateCmd {
+    Text {
+        #[clap(long, short, default_value = ".")]
+        path: String,
+        #[clap(long, default_value_t = false)]
+        to_stdout: bool,
+        #[clap(long, default_value_t = false)]
+        to_stderr: bool,
+        #[clap(long, short, default_value_t = 1024)]
+        size: u128,
+        #[clap(long, short, default_value_t = 1)]
+        count: u64,
+    },
+}

src/generator/mod.rs

@@ -0,0 +1,7 @@
+pub mod text;
+
+use std::io;
+
+pub trait Generator {
+    fn generate(&self, out: impl io::Write);
+}