Add some credential manifest metadata and READMEs.

Author: ehuss

crates/credential/README.md

@@ -0,0 +1,8 @@
+# Cargo Credential Packages
+
+This directory contains Cargo packages for handling storage of tokens in a
+secure manner.
+
+`cargo-credential` is a generic library to assist writing a credential
+process. The other directories contain implementations that integrate with
+specific credential systems.

crates/credential/cargo-credential-1password/Cargo.toml

@@ -4,6 +4,8 @@ version = "0.1.0"
 authors = ["The Rust Project Developers"]
 edition = "2018"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rust-lang/cargo"
+description = "A Cargo credential process that stores tokens in a 1password vault."
 
 [dependencies]
 cargo-credential = { path = "../cargo-credential" }

crates/credential/cargo-credential-gnome-secret/Cargo.toml

@@ -4,6 +4,8 @@ version = "0.1.0"
 authors = ["The Rust Project Developers"]
 edition = "2018"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rust-lang/cargo"
+description = "A Cargo credential process that stores tokens with GNOME libsecret."
 
 [dependencies]
 cargo-credential = { path = "../cargo-credential" }

crates/credential/cargo-credential-macos-keychain/Cargo.toml

@@ -4,6 +4,8 @@ version = "0.1.0"
 authors = ["The Rust Project Developers"]
 edition = "2018"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rust-lang/cargo"
+description = "A Cargo credential process that stores tokens in a macOS keychain."
 
 [dependencies]
 cargo-credential = { path = "../cargo-credential" }

crates/credential/cargo-credential-wincred/Cargo.toml

@@ -4,6 +4,8 @@ version = "0.1.0"
 authors = ["The Rust Project Developers"]
 edition = "2018"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rust-lang/cargo"
+description = "A Cargo credential process that stores tokens with Windows Credential Manager."
 
 [dependencies]
 cargo-credential = { path = "../cargo-credential" }

crates/credential/cargo-credential/Cargo.toml

@@ -4,5 +4,7 @@ version = "0.1.0"
 authors = ["The Rust Project Developers"]
 edition = "2018"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rust-lang/cargo"
+description = "A library to assist writing Cargo credential helpers."
 
 [dependencies]

crates/credential/cargo-credential/README.md

@@ -0,0 +1,41 @@
+# cargo-credential
+
+This package is a library to assist writing a Cargo credential helper, which
+provides an interface to store tokens for authorizing access to a registry
+such as https://crates.io/.
+
+Documentation about credential processes may be found at
+https://doc.rust-lang.org/nightly/cargo/reference/unstable.html#credential-process
+
+Example implementations may be found at
+https://github.com/rust-lang/cargo/tree/master/crates/credential
+
+## Usage
+
+Create a Cargo project with this as a dependency:
+
+```toml
+# Add this to your Cargo.toml:
+
+[dependencies]
+cargo-credential = "0.1"
+```
+
+And then include a `main.rs` binary which implements the `Credential` trait, and calls
+the `main` function which will call the appropriate method of the trait:
+
+```rust
+// src/main.rs
+
+use cargo_credential::{Credential, Error};
+
+struct MyCredential;
+
+impl Credential for MyCredential {
+    /// implement trait methods here...
+}
+
+fn main() {
+    cargo_credential::main(MyCredential);
+}
+```