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, 58 insertions, 0 deletions

diff --git a/tools/unitctl/pkg/brew/unitctl.rb b/tools/unitctl/pkg/brew/unitctl.rb
new file mode 100644
index 00000000..771f2806
--- /dev/null
+++ b/tools/unitctl/pkg/brew/unitctl.rb
@@ -0,0 +1,29 @@
+class Unitctl < Formula
+  desc "CLI interface to the NGINX UNIT Control API"
+  homepage "https://github.com/nginxinc/unit-rust-sdk"
+  version "0.3.0"
+  package_name = "unitctl"
+  src_repo = "https://github.com/nginxinc/unit-rust-sdk"
+
+  if OS.mac? and Hardware::CPU.intel?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_v#{version}_x86_64-apple-darwin.tar.gz"
+      sha256 "3e476850d1fc08aabc3cb25d19d42d171f52d55cea887aec754d47d1142c3638"
+  elsif OS.mac? and Hardware::CPU.arm?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_aarch64-apple-darwin.tar.gz"
+      sha256 "c1ec83ae67c08640f1712fba1c8aa305c063570fb7f96203228bf75413468bab"
+  elsif OS.linux? and Hardware::CPU.intel?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_x86_64-unknown-linux-gnu.tar.gz"
+      sha256 "9616687a7e4319c8399c0071059e6c1bb80b7e5b616714edc81a92717264a70f"
+  elsif OS.linux? and Hardware::CPU.arm? and Hardware::CPU.is_64_bit?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_aarch64-unknown-linux-gnu.tar.gz"
+      sha256 "88c2c7a8bc3d1930080c2b9a397a33e156ae4f876903b6565775270584055534"
+  else
+      odie "Unsupported architecture"
+  end
+
+
+  def install
+    bin.install "unitctl"
+    man1.install "unitctl.1.gz"
+  end
+end
diff --git a/tools/unitctl/pkg/brew/unitctl.rb.template b/tools/unitctl/pkg/brew/unitctl.rb.template
new file mode 100644
index 00000000..db6991f6
--- /dev/null
+++ b/tools/unitctl/pkg/brew/unitctl.rb.template
@@ -0,0 +1,29 @@
+class Unitctl < Formula
+  desc "CLI interface to the NGINX UNIT Control API"
+  homepage "https://github.com/nginxinc/unit-rust-sdk"
+  version "$VERSION"
+  package_name = "$PACKAGE_NAME"
+  src_repo = "$SRC_REPO"
+
+  if OS.mac? and Hardware::CPU.intel?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_v#{version}_x86_64-apple-darwin.tar.gz"
+      sha256 "$X86_64_APPLE_DARWIN_SHA256"
+  elsif OS.mac? and Hardware::CPU.arm?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_aarch64-apple-darwin.tar.gz"
+      sha256 "$AARCH64_APPLE_DARWIN_SHA256"
+  elsif OS.linux? and Hardware::CPU.intel?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_x86_64-unknown-linux-gnu.tar.gz"
+      sha256 "$X86_64_UNKNOWN_LINUX_GNU_SHA256"
+  elsif OS.linux? and Hardware::CPU.arm? and Hardware::CPU.is_64_bit?
+      url "#{src_repo}/releases/download/v#{version}/#{package_name}_#{version}_aarch64-unknown-linux-gnu.tar.gz"
+      sha256 "$AARCH64_UNKNOWN_LINUX_GNU_SHA256"
+  else
+      odie "Unsupported architecture"
+  end
+
+
+  def install
+    bin.install "unitctl"
+    man1.install "unitctl.1.gz"
+  end
+end