feat: implement basic "install" command

[infinitewarp]

This PR demonstrates a prototype for how we might build out commands for installing, maintaining, and troubleshooting a quipucords server through this quipucordsctl package/program. The overall design is intended to enable more commands to be added easily over time or to add specific commands only in certain environments. Commands are dynamically loaded from the commands package; so, a user could install additional custom commands there, or maybe we would add a setting to load additional commands from another path. Maybe discovery-ci could benefit from this, but I doubt many of our "real" customer users would be interested in writing custom commands. Maybe SEAP or SAs would having some unique ideas for commands? If they did, we'd probably ask to incorporate them into the project properly.

This program is not intended to replace qpc which is a client for the quipucords service. This program does not interact with the quipucords APIs; this program manages the installation itself like the old quipucords-installer does.

This PR uses only standard library functionality from Python. It uses Poetry to install development dependencies (ruff, pytest), but the actual runtime has no dependencies outside Python 3.12 itself. This is a deliberate design choice because this tool will eventually be downstreamed and packaged and shipped to RHEL repos, and we do not have a great variety of useful modern third-party Python libraries available there. This project may eventually vendor some small third-party dependencies, but that is a discussion for a future day.

This PR currently includes only a partially-working install command. Effectively, it just creates directories, copies files, and invokes two systemctl commands. The code does include several placeholders and TODO comments where I intend to continue expanding this work. Next steps, assuming we agree on this approach, would be to implement setting the server password and Django secret, applying the "overrides" templates, and adding an uninstall command. We would build a proper setup.py and spec file to make everything RPM-installable. At that point, we would have feature parity with the old quipucords-installer, and we could start implementing new commands for checking container status/health, getting logs, dumping the database, etc.

Also, unlike quipucords-installer, high unit test coverage. Finally. 🎉

Currently, you can invoke the program like this:

$ python3.12 -m quipucordsctl
usage: quipucordsctl [-h] [-v] [-q] [-c OVERRIDE_CONF_DIR] {install} ...

positional arguments:
  {install}
    install             Install the Quipucords server.

options:
  -h, --help            show this help message and exit
  -v, --verbose         Increase verbose output
  -q, --quiet           Quiet output (overrides `-v`/`--verbose`)
  -c OVERRIDE_CONF_DIR, --override-conf-dir OVERRIDE_CONF_DIR
                        Override configuration directory

$ python3.12 -m quipucordsctl install
WARNING: quipucordsctl.commands.reset_server_password is not yet implemented.
WARNING: quipucordsctl.commands.reset_django_secret is not yet implemented.

Using multiple verbose flags drives the log level down (i.e. more output).

$ python3.12 -m quipucordsctl -vv install
INFO: Starting install command
WARNING: quipucordsctl.commands.reset_server_password is not yet implemented.
WARNING: quipucordsctl.commands.reset_django_secret is not yet implemented.
INFO: Generating config files
DEBUG: Ensuring data directory exists: /home/brasmith/.local/share/quipucords/data
DEBUG: Ensuring data directory exists: /home/brasmith/.local/share/quipucords/db
DEBUG: Ensuring data directory exists: /home/brasmith/.local/share/quipucords/log
DEBUG: Ensuring data directory exists: /home/brasmith/.local/share/quipucords/sshkeys
DEBUG: Ensuring config directory exists: /home/brasmith/.config/quipucords/env
DEBUG: Ensuring config directory exists: /home/brasmith/.config/containers/systemd
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords.network to /home/brasmith/.config/containers/systemd/quipucords.network
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords-db.container to /home/brasmith/.config/containers/systemd/quipucords-db.container
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords-celery-worker.container to /home/brasmith/.config/containers/systemd/quipucords-celery-worker.container
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords-app.container to /home/brasmith/.config/containers/systemd/quipucords-app.container
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords-redis.container to /home/brasmith/.config/containers/systemd/quipucords-redis.container
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/config/quipucords-server.container to /home/brasmith/.config/containers/systemd/quipucords-server.container
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-redis.env to /home/brasmith/.config/quipucords/env/env-redis.env
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-server.env to /home/brasmith/.config/quipucords/env/env-server.env
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-ansible.env to /home/brasmith/.config/quipucords/env/env-ansible.env
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-db.env to /home/brasmith/.config/quipucords/env/env-db.env
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-app.env to /home/brasmith/.config/quipucords/env/env-app.env
DEBUG: Copying /home/brasmith/projects/quipucordsctl/templates/env/env-celery-worker.env to /home/brasmith/.config/quipucords/env/env-celery-worker.env

Once we build setup.py and the spec file, the program would be invoked simply as quipucordsctl.

[codecov]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

[bruno-fs]

I love what I see here!

I only left one comment but feel free to ignore it.