Improve rig repos available

- compact table by default
- new `rig repos available <name>` with nicer output.

Author: gaborcsardi

NEWS.md

@@ -3,6 +3,10 @@
 * rig now does not edit the shell startup files in admin mode,
   like rig 0.8.1 did on macOS. rig now only does this in user mode.
 
+* `rig repos available` now prints a compact table. New
+  `rig repos available <name>` shows complete information about a single
+  repository.
+
 # rig 0.10.0-alpha2 (pre-release)
 
 * rig now supports a **user mode** on all platforms, in addition to the

src/args.rs

@@ -1476,6 +1476,11 @@ pub fn rig_app() -> Command {
                         .long("json")
                         .num_args(0)
                         .required(false),
+                )
+                .arg(
+                    Arg::new("name")
+                        .help("Repository to show in detail, e.g. 'P3M' (case insensitive)")
+                        .required(false),
                 ),
         )
         .subcommand(

src/help-generated.in

@@ -43,7 +43,7 @@ const HELP_PROJ_SOLVE: &str = "\u{1b}[1m\u{1b}[34mDescription:\u{1b}[39m\u{1b}[2
 const ABOUT_PROJ: &str = "Manage R projects (experimental)";
 const HELP_PROJ: &str = "\u{1b}[1m\u{1b}[34mDescription:\u{1b}[39m\u{1b}[22m\n  Manage R projects (experimental).\n\n  A project is a directory with a package manifest, typically a\n  \u{1b}[32mDESCRIPTION\u{1b}[39m file, that declares the R packages the project depends on.\n  \u{1b}[32mrig proj\u{1b}[39m resolves those dependencies against the configured package\n  repositories and can install them into a project library.\n\n  \u{1b}[32mrig proj deps\u{1b}[39m shows the direct and recursive dependencies of the\n  project.\n  \u{1b}[32mrig proj solve\u{1b}[39m resolves the full dependency tree to a concrete set of\n  package versions, and can write the result to an \u{1b}[32mrenv.lock\u{1b}[39m file.\n  \u{1b}[32mrig proj deploy\u{1b}[39m installs the resolved dependencies into a package\n  library.\n\n  Dependencies are resolved with rig's built-in solver, so R does not need\n  to be running for \u{1b}[32mrig proj deps\u{1b}[39m and \u{1b}[32mrig proj solve\u{1b}[39m.\n\n  \u{1b}[32mrig proj\u{1b}[39m is currently experimental, and might change in future\n  versions. Feedback is appreciated.";
 const ABOUT_REPOS_AVAILABLE: &str = "List available R package repositories";
-const HELP_REPOS_AVAILABLE: &str = "\u{1b}[1m\u{1b}[34mDescription:\u{1b}[39m\u{1b}[22m\n  List the package repositories that rig knows about and can set up.\n\n  These are the repositories you can enable with \u{1b}[32m--with-repos\u{1b}[39m when running\n  \u{1b}[32mrig add\u{1b}[39m or \u{1b}[32mrig repos setup\u{1b}[39m.";
+const HELP_REPOS_AVAILABLE: &str = "\u{1b}[1m\u{1b}[34mDescription:\u{1b}[39m\u{1b}[22m\n  List the package repositories that rig knows about and can set up.\n\n  These are the repositories you can enable with \u{1b}[32m--with-repos\u{1b}[39m when running\n  \u{1b}[32mrig add\u{1b}[39m or \u{1b}[32mrig repos setup\u{1b}[39m.\n\n  Without arguments rig prints one row per repository: its name, whether it is\n  part of the default repository set, and its title.\n\n  Pass a repository name to see its description and its URLs, together with the\n  platforms, architectures and R versions each URL applies to. Repository names\n  are matched case insensitively.\n\n\u{1b}[1m\u{1b}[34mExamples:\u{1b}[39m\u{1b}[22m\n  # List all repositories rig knows about\n  rig repos available\n\n  # Show the URLs of one repository\n  rig repos available P3M";
 const ABOUT_REPOS_LIST: &str = "List configured R package repositories";
 const HELP_REPOS_LIST: &str = "\u{1b}[1m\u{1b}[34mDescription:\u{1b}[39m\u{1b}[22m\n  List the package repositories configured for an R version.\n\n  By default rig shows the repositories of the default R version; use\n  \u{1b}[32m--r-version\u{1b}[39m to pick another. Add \u{1b}[32m--all\u{1b}[39m to include repositories that\n  are not enabled by default, and \u{1b}[32m--raw\u{1b}[39m to show repository URLs without\n  resolving the \u{1b}[32m%\u{1b}[39m variables in them.";
 const ABOUT_REPOS_PACKAGE_INFO: &str = "Information about the package in the repositories";

src/help/repos-available.md

@@ -6,3 +6,20 @@ List the package repositories that rig knows about and can set up.
 
 These are the repositories you can enable with `--with-repos` when running
 `rig add` or `rig repos setup`.
+
+Without arguments rig prints one row per repository: its name, whether it is
+part of the default repository set, and its title.
+
+Pass a repository name to see its description and its URLs, together with the
+platforms, architectures and R versions each URL applies to. Repository names
+are matched case insensitively.
+
+## Examples
+
+```sh
+# List all repositories rig knows about
+rig repos available
+
+# Show the URLs of one repository
+rig repos available P3M
+```

src/repos/config.rs

@@ -11,20 +11,6 @@ pub enum Enabled {
     OnPlatforms { platforms: Vec<String> },
 }
 
-impl Enabled {
-    /// A short human-readable description of the default-enabled state, used by
-    /// `rig repos list`.
-    pub fn describe(&self) -> String {
-        match self {
-            Enabled::Always(true) => "Yes".to_string(),
-            Enabled::Always(false) => "No".to_string(),
-            Enabled::OnPlatforms { platforms } => {
-                format!("On platforms: {}", platforms.join(" | "))
-            }
-        }
-    }
-}
-
 #[derive(Serialize, Deserialize, Debug, Clone)]
 pub struct RepoEntry {
     pub name: String,