tools: Add unitctl CLI

* Pull in entire unit-rust-sdk project
  * not included: CLA, COC, License
  * not included: duplicate openapi spec
  * not included: CI workflows
  * not included: changelog tooling
  * not included: commitsar tooling
  * not included: OpenAPI Web UI feature
* update links in unitctl manpage
* remove IDE configuration from .gitignore
* rename Containerfile.debian to Dockerfile
* simplify call to uname
* keep Readmes and Makefiles to 80 character lines
* outline specifically how to build unitctl
  for any desired target, and where to then
  find the binary for use
* remove a section on the vision of the CLI
  which was superfluous given the state of
  completeness of the code and its use in
  unit
* remove out of date feature proposals from readme
* makefile: do not run when Rustup is not present
* bump mio version to latest
* generate openapi client library on demand
  * generate-openapi only runs when not present
  * generate-openapi now a dependency of binary build targets
  * deleted autogenerated code
  * reverted readme and Cargo document to autogenerated state
  * add additional build requirement to Readme

Co-developed-by: Elijah Zupancic <e.zupancic@f5.com>
Signed-off-by: Elijah Zupancic <e.zupancic@f5.com>
Signed-off-by: Ava Hahn <a.hahn@f5.com>
Reviewed-by: Andrew Clayton <a.clayton@nginx.com> # non rust stuff
[ tools/cli => tools/unitctl and subject tweak - Andrew ]
Signed-off-by: Andrew Clayton <a.clayton@nginx.com>

2 files changed, 30 insertions, 0 deletions

diff --git a/tools/unitctl/unit-openapi/src/apis/error.rs b/tools/unitctl/unit-openapi/src/apis/error.rs
new file mode 100644
index 00000000..a4a1e354
--- /dev/null
+++ b/tools/unitctl/unit-openapi/src/apis/error.rs
@@ -0,0 +1,18 @@
+use crate::apis::Error;
+use std::error::Error as StdError;
+use std::fmt::{Display, Formatter};
+
+impl Display for Error {
+    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
+        match self {
+            Error::Api(e) => write!(f, "ApiError: {:#?}", e),
+            Error::Header(e) => write!(f, "HeaderError: {}", e),
+            Error::Http(e) => write!(f, "HttpError: {:#?}", e),
+            Error::Hyper(e) => write!(f, "HyperError: {:#?}", e),
+            Error::Serde(e) => write!(f, "SerdeError: {:#?}", e),
+            Error::UriError(e) => write!(f, "UriError: {:#?}", e),
+        }
+    }
+}
+
+impl StdError for Error {}
diff --git a/tools/unitctl/unit-openapi/src/lib.rs b/tools/unitctl/unit-openapi/src/lib.rs
new file mode 100644
index 00000000..a71f18d6
--- /dev/null
+++ b/tools/unitctl/unit-openapi/src/lib.rs
@@ -0,0 +1,12 @@
+#![allow(clippy::all)]
+#[macro_use]
+extern crate serde_derive;
+
+extern crate futures;
+extern crate hyper;
+extern crate serde;
+extern crate serde_json;
+extern crate url;
+
+pub mod apis;
+pub mod models;