wip: long awaited refresh

Author: cilki

Cargo.lock

@@ -3,26 +3,47 @@ name = "wsx"
 description = "Cilki's WorkSpace eXplorer"
 version = "0.1.0"
 edition = "2021"
+authors = ["cilki"]
 repository = "https://github.com/cilki/wsx/"
+readme = "README.md"
+keywords = ["git", "workspace", "cli", "repository", "manager"]
+categories = ["command-line-utilities", "development-tools"]
 
 [dependencies]
-anyhow = "1.0.82"
-cmd_lib = "1.3.0"
-enum_dispatch = "0.3.13"
+anyhow = "1"
+cmd_lib = "1"
+crossterm = { version = "0.28", optional = true }
+enum_dispatch = "0.3"
 git-repository = { version = "0", optional = true }
-home = "0.5.9"
-log = "0.4.17"
-pico-args = "0.5.0"
+home = "0.5"
+log = "0.4"
+pico-args = "0.5"
+ratatui = { version = "0.29", optional = true }
 regex = "1"
 serde = { version = "1", features = ["derive"] }
-sha2 = "0.10.6"
+serde_json = { version = "1", optional = true }
+sha2 = "0.10"
 toml = "0"
-tracing = "0.1.40"
-tracing-subscriber = { version = "0.3.18", features = ["env-filter"] }
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 walkdir = "2"
 
+[dev-dependencies]
+tempfile = "3"
+
 [build-dependencies]
-built = { version = "0.7", features = ["cargo-lock", "dependency-tree", "git2", "chrono", "semver"] }
+built = { version = "0.7", features = [
+  "cargo-lock",
+  "dependency-tree",
+  "git2",
+  "chrono",
+  "semver",
+] }
 
 [features]
+default = ["github", "gitlab", "tui"]
+github = ["dep:serde_json"]
+gitlab = []
+tui = ["dep:crossterm", "dep:ratatui"]
+# Note: git_oxide feature currently has compilation issues with git-repository dependency
 git_oxide = ["dep:git-repository"]

Cargo.toml

@@ -1,27 +1,31 @@
 # WorkSpace eXplorer
 
-`wsx` is a command line utility for quickly cloning (and decloning) Git repositories
-into a local directory called a _workspace_.
+`wsx` is a command line utility for quickly cloning (and decloning) Git
+repositories into a local directory called a _workspace_.
 
 ### Workspaces
 
-Simply defined, a _working set_ is the set of all repositories you're able to work
-on at any given time. Even more simply, your _workspace_ is just the local directory
-where you keep your Git repositories.
+Simply defined, a _working set_ is the set of all repositories you're able to
+work on at any given time. Even more simply, your _workspace_ is just the local
+directory where you keep your Git repositories.
 
-The principle behind `wsx` is that your Git workspace should only consist of your
-_working set_. This reduces unnecessary noise as repositories accumulate in your
-workspace over time and improves indexing performance of your development tools.
-Adhering to this principle involves frequently cloning and deleting repositories
-from your workspace, which is exactly what `wsx` is designed to automate.
+The principle behind `wsx` is that your Git workspace should only consist of
+your _working set_. This reduces unnecessary noise as repositories accumulate in
+your workspace over time and improves indexing performance of your development
+tools. Adhering to this principle involves frequently cloning and deleting
+repositories from your workspace, which is exactly what `wsx` is designed to
+automate.
 
 When repositories are dropped from your workspace, they are cached locally so
 restoring them later can be done in an instant.
 
 ### Keep your working set clean
 
 ```sh
-# Clone a repository into the default workspace
+# Initialize a workspace in your current directory
+wsx init
+
+# Clone a repository
 wsx clone github.com/cilki/wsx
 
 # The repository's local path always reflects the remote path for identifiability
@@ -42,18 +46,17 @@ wsx drop github.com/cilki --force
 wsx clone github.com/cilki/wsx
 ```
 
-### Simple configuration
+### TUI Mode
 
-`wsx` attempts to read a configuration file from `~/.config/wsx.toml`. For example:
+Run `wsx` without arguments to launch an interactive TUI that lets you browse
+and select repositories from your configured remotes:
 
-```toml
-# Define any number of workspaces
-[[workspace]]
-name = "personal"
-path = "/home/user/workspace"
+```sh
+# Launch interactive repository browser
+wsx
 
-[[workspace]]
-name = "work"
-path = "/home/worker/workspace"
+# Use j/k or arrow keys to navigate
+# Press / to search/filter repositories
+# Press Enter to clone the selected repository
+# Press q to quit
 ```
-

README.md

@@ -0,0 +1,11 @@
+{ pkgs ? import (fetchTarball
+  "https://github.com/NixOS/nixpkgs/archive/nixos-unstable.tar.gz") { } }:
+
+with pkgs;
+
+mkShell rec {
+  nativeBuildInputs = [ pkg-config cargo rustc rust-analyzer rustfmt clippy ];
+  buildInputs = [ ];
+  LD_LIBRARY_PATH = lib.makeLibraryPath buildInputs;
+}
+