new spec: mgc cli bucket policy basic usage

This patch adds specs covering the basic usage of the bucket policy
feature using the mgc cli.

The examples in here should include the same examples on the other
specs:

  - https://docs.magalu.cloud/docs/storage/object-storage/how-to/permissions/policies
  - https://github.com/MagaluCloud/s3-tester/blob/main/spec/091_bucket-policy_spec.sh

Author: fczuardi

docs/conftest.py

@@ -78,8 +78,9 @@ def mgc_path(default_profile):
     else:
         spec_dir = os.path.dirname(get_spec_path())
         path = os.path.join(spec_dir, default_profile.get(mgc_path_field_name))
-    if not os.path.isfile(path):
-        pytest.fail(f"The specified mgc_path '{path}' (absolute: {os.path.abspath(path)}) does not exist or is not a file.")
+    abspath = os.path.abspath(path) if path and os.path.isfile(path) else path
+    if not abspath:
+        pytest.fail(f"The specified mgc_path '{path}' (absolute: {abspath}) does not exist or is not a file.")
     return path
 
 @pytest.fixture

docs/policy_cli_test.py

@@ -0,0 +1,70 @@
+# ---
+# jupyter:
+#   kernelspec:
+#     name: s3-specs
+#     display_name: S3 Specs
+#   language_info:
+#     name: python
+# ---
+
+# # Bucket Policy via MGC CLI
+#
+# Restringir determinadas ações passíveis de serem executadas em um bucket, ou
+# compartilhar acessos de leitura e escrita com outros usuários (Principals),
+# são exemplos de possibilidades que a funcionalidade de Bucket Policy (políticas
+# do conteiner) permitem.
+#
+# A configuração, remoção e atualização de políticas em um bucket, por documentos
+# de policy (arquivos JSON) pode ser feita via MGC CLI. Este é o assunto desta
+# especificação.
+#
+
+# + tags=["parameters"]
+config = "../params.example.yaml"
+# -
+
+# + {"jupyter": {"source_hidden": true}}
+import pytest
+import logging
+import subprocess
+from shlex import split
+from s3_helpers import (
+    run_example,
+)
+pytestmark = [pytest.mark.basic, pytest.mark.cli]
+# -
+
+# ## Documentos relacionados
+#
+# Uma breve lista de outras referências sobre Bucket Policy
+#
+# - Docs Magalu Cloud: [Docs > Armazenamento > Object Storage > Como Fazer > Permissões > Bucket Policy](https://docs.magalu.cloud/docs/storage/object-storage/how-to/permissions/policies)
+# - s3-specs: [python/boto3 policies spec 1](https://magalucloud.github.io/s3-specs/runs/profiles_policies_test_br-ne1.html)
+# - s3-specs: [python/boto3 policies spec 2](https://magalucloud.github.io/s3-specs/runs/policies_test_test_br-ne1.html)
+# - s3-tester (specs legadas): [legacy s3-tester spec id:091](https://github.com/MagaluCloud/s3-tester/blob/main/spec/091_bucket-policy_spec.sh)
+# - AWS S3: [Bucket Policies for Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-policies.html)
+# - AWS S3: [Bucket policies](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/s3-example-bucket-policies.html)
+
+# ## Como fazer
+
+# ### Lista dos comandos disponíveis
+#
+# O manual de uso com os comandos disponíveis na CLI relacionados a Bucket Policy
+# pode ser consultado via terminal usando o comando abaixo:
+
+commands = [
+    "{mgc_path} object-storage buckets policy --help",
+]
+
+# + {"jupyter": {"source_hidden": true}}
+@pytest.mark.parametrize("cmd_template", commands)
+def test_cli_help_policy(cmd_template, mgc_path):
+    cmd = split(cmd_template.format(mgc_path=mgc_path))
+    result = subprocess.run(cmd, capture_output=True, text=True)
+
+    assert result.returncode == 0, f"Command failed with error: {result.stderr}"
+    logging.debug(f"Output from {cmd_template}: {result.stdout}")
+    assert all(snippet in result.stdout for snippet in ["delete", "get", "set"])
+
+run_example(__name__, "test_cli_help_policy", config=config)
+# -