✨ Add initial support for Docker operations and enhance project structure

Other improvements:
- Updated utility functions in `utils.py` for better command execution and date handling.
- Improved main menu navigation and service checks in `velez.py`.
- Replaced `setup.py` with `pyproject.toml` for better build and installation processes.
- Updated constant strings to capital case.
- Added `.pylintrc` to suppress some warning from external libs.
- Added `Makefile` for most important operations.
- Added utils function for converting data sizes, printing tables or working with dates.

Author: ChristophShyper

.pylintrc

@@ -0,0 +1,3 @@
+[MASTER]
+disable=
+    C0114, # missing-module-docstring

Makefile

@@ -0,0 +1,18 @@
+.PHONY: clean install install-dev reinstall test
+
+clean:
+	@rm -rf dist build *.egg-info
+
+install: clean
+	@python3 -m build --wheel
+	@pip3 install dist/*.whl
+
+install-dev: clean
+	@pip3 install -r requirements.txt
+
+reinstall: clean
+	@python3 -m build --wheel
+	@pip3 install dist/*.whl --force-reinstall
+
+test:
+	@pytest -v --tb=short

README.md

@@ -14,22 +14,33 @@ files before committing!
   />
 </a>
 
+
+## Advantages
+
+- Terragrunt **backend configuration** is read by invoking `terragrunt` command, so it is **always up to date** and resembles the 
+  **real state of the infrastructure**, not just hardcoded values in the code.
+- All operations are performed in the **context of the current directory**, so you don't have to worry about running
+  commands in the wrong environment.
+
+
 ## Disclaimer
 
-This project is in the early development stage and is not ready for production use. It is a work in progress and may
+**This project is in the early development stage and is not ready for production use. It is a work in progress and may
 contain bugs, incomplete features, incorrect documentation, backward incompatible changes or other issues.
-Use it at your own risk.
+Use it at your own risk before it reaches 1.x.x version. Read the documentation carefully and test it in a 
+safe environment before using it.**
 
 Since it operates on the infrastructure, user is responsible for the consequences of the actions taken by the tool and
 should review the code before using it.
 
 ![Velez](img/velez.jpg)
 
+
 ## Features
 
 Supporting following services/tools and operations on them:
 
-- Terragrunt operations `-tg`:
+- Terragrunt operations `-tg` or `--terragrunt`:
     - Walk directory structure containing Terragrunt modules.
     - Run Plan, Apply, Destroy and Output on a selected module or a specific target.
     - Taint and Untaint a resource.
@@ -41,15 +52,19 @@ Supporting following services/tools and operations on them:
         - Move a module to a new directory, including moving remote state.
         - Destroy resources and backend of the module.
         - Destroy backend of the module.
-- File operations `-f`:
+- File operations `-f` or :
     - Formatting all HCL files in the project.
     - Cleaning up temporary files in the project or a selected module.
-- GitHub operations `-gh`:
+- GitHub operations `-gh` or `--github`:
     - Source operations, like commit, amend, push, pull or rebase.
     - Branch operations, like create, change local or remote, delete local or remote.
     - Manage pull requests, like create, list in the repository or the whole organization.
     - Manage issues, like create, list in the repository or the whole organization.
     - Easily remove stale branches.
+- Docker operations `-d` or `--docker`:
+    - List images in the registry or save them to a file for later use.
+    - Manage organization members, like invites or removes.
+    - Manage organization groups.
 
 ## Installation
 
@@ -84,6 +99,14 @@ Framework is written in Python and can be installed as a package.
 
 ## Usage
 
+Tool is designed to speed up the work, so it expects some conditions:
+* It should be run in the project directory.
+* It should be run with the `direnv` or similar solution to load environment variables automatically.
+* It expects the project directory to be a Git repository.
+* It expects the project directory to be a Terragrunt project with a `root.hcl` (or other defined by `VELEZ_TG_ROOT_HCL`) file.
+* It expects the project directory to be a Docker project, with a project directory to be repository name and parent directory to be
+  organization name or personal account name (excluding `-` characters from the folder name).
+
 ### Help
 
 Run the CLI with the `--help` argument to see the available commands:
@@ -107,7 +130,7 @@ velez
 #### Terragrunt operations (`-tg` or `--terragrunt`)
 
 ```sh
-velez --terragrunt <operation> <module> <other-arguments>
+velez --terragrunt
 ```
 
 #### File operations (`-f` or `--file`)
@@ -167,18 +190,23 @@ velez -tg plan aws/dev-account
 
 Velez expects following environment variables to be set:
 
-| Variable                          | Description                                                                   | Required for operations | Default               |
-|-----------------------------------|-------------------------------------------------------------------------------|-------------------------|-----------------------|
-| `VELEZ_TG_ROOT_HCL`               | Relative path to the Terragrunt configuration file.                           | Terragrunt              | `root.hcl`            |
-| `VELEZ_TG_TEMP_CONFIG`            | Absolute path to a temporary file created to render Terragrunt configuration. | Terragrunt              | `/tmp/terragrunt.hcl` |
-| `GITHUB_TOKEN`                    | GitHub token for accessing the GitHub API.                                    | GitHub                  | `N/A`                 |
-| `VELEZ_GH_STALE_BRANCHES_DAYS`    | Number of days after which branches are considered stale.                     | GitHub                  | `45`                  |
-| `VELEZ_GH_STALE_BRANCHES_COMMITS` | Number of commits after which branches are considered stale.                  | GitHub                  | `30`                  |
-
-For the convenience, these variables can be set in a `.env` file in the project directory and use the `direnv` (
-mentioned above) to load them automatically for every project separately.
-
-Veles will read Terragrunt configuration and expand any dynamic config available statically.
+| Variable                        | Description                                                                                                                           | Required for operations | Default               |
+|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|-------------------------|-----------------------|
+| `VELEZ_TG_ROOT_HCL`             | Relative path to the Terragrunt configuration file.                                                                                   | Terragrunt              | `root.hcl`            |
+| `VELEZ_TG_TEMP_CONFIG`          | Absolute path to a temporary file created to render Terragrunt configuration.                                                         | Terragrunt              | `/tmp/terragrunt.hcl` |
+| `GITHUB_TOKEN`                  | GitHub token for accessing the GitHub API.                                                                                            | GitHub                  | `N/A`                 |
+| `GITHUB_STALE_BRANCHES_DAYS`    | Number of days after which branches are considered stale.                                                                             | GitHub                  | `45`                  |
+| `GITHUB_STALE_BRANCHES_COMMITS` | Number of commits after which branches are considered stale.                                                                          | GitHub                  | `30`                  |
+| `DOCKER_USERNAME`               | Docker username for logging in to the Docker registry.                                                                                | Docker                  | `N/A`                 |
+| `DOCKER_TOKEN`                  | Docker personal access token or organization access token for logging in to the Docker registry.                                      | Docker                  | `N/A`                 |
+| `DOCKER_REPOSITORY`             | Default Docker repository for operations.                                                                                             | Docker                  | current directory     |
+| `DOCKER_OWNER`                  | Default Docker owner of repositories.<br>Can be not set or set to Docker username for personal repositories, or to organization name. | Docker                  | parent directory      |
+| `DOCKER_STALE_IMAGES_DAYS`      | Number of days after which images are considered stale.                                                                               | Docker                  | `30`                  |
+
+For the convenience, these variables can be set in a `.envrc` or similar file in the project directory and use with the `direnv` (
+mentioned above; or other similar software) to load them automatically for every project separately and use inheritance for the convenience.
+
+Velez will read Terragrunt configuration to expand any dynamic load available config remotely.
 For example for each selected Terragrunt module backed configuration will be read to determine exact values of the S3
 bucket and DynamoDB table and key used for locking the state.
 

pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "velez"
+version = "0.3.0"
+description = "∀elez is a tool to easily manage complex Terragrunt configurations."
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "pick",
+    "boto3",
+    "python-hcl2",
+    "PyGithub",
+]
+authors = [
+    {name = "Krzysztof Szyper", email = "christoph@shyper.pro"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: System Administrators",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+velez = "velez.velez:main"
+
+[project.urls]
+"Homepage" = "https://github.com/devops-infra/velez"
+"Issues" = "https://github.com/devops-infra/velez/issues"
+
+[tool.setuptools]
+packages = ["velez"]

requirements.txt

@@ -3,3 +3,5 @@ setuptools==75.8.2
 boto3==1.37.7
 python-hcl2==6.1.1
 PyGithub==2.6.1
+pytest==8.3.4
+build==1.2.2

setup.py

@@ -0,0 +1,24 @@
+import unittest
+from velez.docker_ops import DockerOperations
+from unittest.mock import patch, MagicMock
+
+class TestDockerOperations(unittest.TestCase):
+
+    @patch('docker.from_env')
+    def setUp(self, mock_docker):
+        self.mock_velez = MagicMock()
+        self.docker_ops = DockerOperations(self.mock_velez)
+
+    @patch('builtins.input', return_value='username')
+    @patch('builtins.input', return_value='password')
+    def test_login(self, mock_input_username, mock_input_password):
+        self.docker_ops.login()
+        self.docker_ops.client.login.assert_called_with(username='username', password='password')
+
+    def test_list_repositories_menu(self):
+        with patch('velez.docker_ops.pick', return_value=("List last pushed tags", 0)):
+            self.docker_ops.list_repositories_menu()
+            # Add assertions for list_last_pushed_tags
+
+if __name__ == '__main__':
+    unittest.main()

tests/test_docker_ops.py

@@ -0,0 +1,58 @@
+import pytest
+from unittest.mock import patch, MagicMock, mock_open
+from velez.file_ops import FileOperations
+from velez.velez import Velez
+
+@pytest.fixture
+def file_ops():
+    velez = Velez()
+    return FileOperations(velez)
+
+@patch('velez.file_ops.run_command')
+def test_format_hcl_files_tf(mock_run_command, file_ops):
+    """Test format_hcl_files with Terraform."""
+    file_ops.velez.check_terragrunt = MagicMock(return_value=True)
+    file_ops.velez.get_tf_ot = MagicMock(return_value='terraform')
+    file_ops.format_hcl_files()
+    mock_run_command.assert_any_call(['terragrunt', 'hclfmt'])
+    mock_run_command.assert_any_call(['terraform', 'fmt', '-recursive', '.'])
+
+@patch('velez.file_ops.run_command')
+def test_format_hcl_files_ot(mock_run_command, file_ops):
+    """Test format_hcl_files with OpenTofu."""
+    file_ops.velez.check_terragrunt = MagicMock(return_value=True)
+    file_ops.velez.get_tf_ot = MagicMock(return_value='tofu')
+    file_ops.format_hcl_files()
+    mock_run_command.assert_any_call(['terragrunt', 'hclfmt'])
+    mock_run_command.assert_any_call(['tofu', 'fmt', '-recursive', '.'])
+
+@patch('builtins.input', return_value='')  # Mock input to return an empty string
+@patch('os.remove')
+@patch('shutil.rmtree')
+def test_clean_files(mock_rmtree, mock_remove, mock_input, file_ops):
+    """Test clean_files."""
+    with patch('os.walk') as mock_walk:
+        mock_walk.return_value = [
+            ('/path', ['.terraform'], ['.terraform.lock.hcl', 'tfplan']),
+            ('/path/.terraform', [], []),
+        ]
+        file_ops.clean_files('/path')
+        mock_rmtree.assert_any_call('/path/.terraform')
+        mock_remove.assert_any_call('/path/.terraform.lock.hcl')
+        mock_remove.assert_any_call('/path/tfplan')
+
+@patch('builtins.open', new_callable=mock_open, read_data='key = "value"')
+@patch('velez.file_ops.hcl2.load', return_value={"key": "value"})
+def test_load_hcl_file(mock_hcl_load, mock_file):
+    """Test load_hcl_file."""
+    result = FileOperations.load_hcl_file('dummy.hcl')
+    assert result == {"key": "value"}
+    mock_file.assert_called_once_with('dummy.hcl', 'r')
+    mock_hcl_load.assert_called_once()
+
+@patch('builtins.open', new_callable=mock_open, read_data='{"key": "value"}')
+def test_load_json_file(mock_file):
+    """Test load_json_file."""
+    result = FileOperations.load_json_file('dummy.json')
+    assert result == {"key": "value"}
+    mock_file.assert_called_once_with('dummy.json', 'r')