Skip to content

Add localstack convenience targets and tests #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AntonioCS merged 1 commit into from
Dec 15, 2025
Merged

Add localstack convenience targets and tests #34

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions modules/cloud_providers/localstack/localstack.mk
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,7 @@ $(strip \
)
endef

ifndef __MB_TEST_DISCOVERY__
#####################################################################################
# LocalStack-Specific Targets
#####################################################################################
Expand Down Expand Up @@ -162,6 +163,9 @@ localstack/version: ## Show LocalStack version
# Convenience Targets (Common Operations)
#####################################################################################

localstack/s3/ls: ## List S3 buckets or bucket contents (optional: bucket=my-bucket)
$(call localstack_cmd,s3 ls $(if $(value bucket),s3://$(bucket),))

localstack/s3/list-all: ## List all S3 buckets with details
$(call localstack_cmd,s3 ls)
echo ""
Expand All @@ -179,6 +183,9 @@ localstack/s3/list-all: ## List all S3 buckets with details
$(call mb_printf_warn,No buckets found)\
)

localstack/sqs/ls: ## List all SQS queues
$(call localstack_cmd,sqs list-queues)

localstack/sqs/purge-all: ## Purge all SQS queues (use with caution!)
$(call mb_printf_warn,Purging all SQS queues...)
$(let mb_invoke_run_in_shell,$(mb_on),\
Expand Down Expand Up @@ -217,4 +224,6 @@ localstack/aws/%: aws/% ;
localstack/aws: # Wrapper for localstack/aws/%
$(call mb_printf_info,Usage: make localstack/aws/<aws_target> (e.g.$(mb_comma) localstack/aws/s3/create/my-bucket))

endif # __MB_TEST_DISCOVERY__

endif # __MB_MODULES_LOCALSTACK__
172 changes: 172 additions & 0 deletions modules/cloud_providers/localstack/localstack_test.mk
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,172 @@
#####################################################################################
# Project: MakeBind
# File: modules/cloud_providers/localstack/localstack_test.mk
# Description: Tests for the localstack module
# Author: AntonioCS
# License: MIT License
#####################################################################################

include $(mb_core_path)/util.mk
include $(mb_core_path)/functions.mk

## Load AWS module dependencies (localstack wraps AWS module)
include $(mb_modules_path)/cloud_providers/aws/mod_config.mk
include $(mb_modules_path)/cloud_providers/aws/aws.mk

## Load localstack module
include $(mb_modules_path)/cloud_providers/localstack/mod_config.mk
include $(mb_modules_path)/cloud_providers/localstack/localstack.mk

######################################################################################
# localstack_cmd tests
######################################################################################

define test_modules_localstack_cmd_basic
$(eval mb_invoke_silent := $(mb_on))

## Test basic S3 command
$(eval $0_result := $(call localstack_cmd,s3 ls))
$(call mb_assert_contains,s3 ls,$($0_result),localstack_cmd should contain s3 ls)
$(call mb_assert_contains,--endpoint-url,$($0_result),localstack_cmd should contain endpoint-url)
$(call mb_assert_contains,$(localstack_endpoint_url),$($0_result),localstack_cmd should contain localstack endpoint)

## Test SQS command
$(eval $0_result := $(call localstack_cmd,sqs list-queues))
$(call mb_assert_contains,sqs list-queues,$($0_result),localstack_cmd should contain sqs list-queues)
$(call mb_assert_contains,--endpoint-url,$($0_result),localstack_cmd should contain endpoint-url)

$(eval mb_invoke_silent := $(mb_off))
endef

define test_modules_localstack_cmd_with_bucket_param
$(eval mb_invoke_silent := $(mb_on))

## Test S3 ls with bucket path
$(eval $0_result := $(call localstack_cmd,s3 ls s3://my-bucket))
$(call mb_assert_contains,s3 ls s3://my-bucket,$($0_result),localstack_cmd should contain bucket path)

$(eval mb_invoke_silent := $(mb_off))
endef

define test_modules_localstack_cmd_error_without_args
$(eval mb_invoke_silent := $(mb_on))

## Test that localstack_cmd requires an argument
## Note: This test validates the error path - mb_printf_error will be called
$(call mb_assert_was_called,mb_printf_error,1)
$(eval $0_result := $(call localstack_cmd,))

$(eval mb_invoke_silent := $(mb_off))
endef

######################################################################################
# localstack_api tests
######################################################################################

define test_modules_localstack_api_basic
$(eval mb_invoke_silent := $(mb_on))

## Test that localstack_api sets up the correct URL
## Note: We can't actually call the API in tests, but we can verify the function exists
$(call mb_assert,$(value localstack_api),localstack_api function should be defined)

$(eval mb_invoke_silent := $(mb_off))
endef

define test_modules_localstack_api_error_without_endpoint
$(eval mb_invoke_silent := $(mb_on))

## Test that localstack_api requires an endpoint argument
$(call mb_assert_was_called,mb_printf_error,1)
$(eval $0_result := $(call localstack_api,))

$(eval mb_invoke_silent := $(mb_off))
endef

######################################################################################
# localstack_api_check tests
######################################################################################

define test_modules_localstack_api_check_error_without_endpoint
$(eval mb_invoke_silent := $(mb_on))

## Test that localstack_api_check requires an endpoint argument
## Note: Expects 3 calls due to cascading errors:
## 1. localstack_api_check: endpoint required
## 2. localstack_api: endpoint path required (called internally)
## 3. localstack_api_check: error_msg (api call failed)
$(call mb_assert_was_called,mb_printf_error,3)
$(eval $0_result := $(call localstack_api_check,))

$(eval mb_invoke_silent := $(mb_off))
endef

######################################################################################
# localstack_api_json tests
######################################################################################

define test_modules_localstack_api_json_error_without_endpoint
$(eval mb_invoke_silent := $(mb_on))

## Test that localstack_api_json requires an endpoint argument
$(call mb_assert_was_called,mb_printf_error,1)
$(eval $0_result := $(call localstack_api_json,))

$(eval mb_invoke_silent := $(mb_off))
endef

######################################################################################
# Configuration tests
######################################################################################

define test_modules_localstack_config_defaults
$(call mb_assert_eq,eu-west-1,$(localstack_region),localstack_region should default to eu-west-1)
$(call mb_assert_eq,000000000000,$(localstack_account_id),localstack_account_id should default to 000000000000)
$(call mb_assert_eq,http://localhost:4566,$(localstack_endpoint_url),localstack_endpoint_url should default to http://localhost:4566)
$(call mb_assert_eq,local,$(localstack_exec_mode),localstack_exec_mode should default to local)
$(call mb_assert_eq,localstack,$(localstack_dk_container),localstack_dk_container should default to localstack)
$(call mb_assert_eq,localstack,$(localstack_dc_service),localstack_dc_service should default to localstack)
endef

######################################################################################
# Convenience target command generation tests
######################################################################################

define test_modules_localstack_s3_ls_command
$(eval mb_invoke_silent := $(mb_on))

## Test S3 ls generates correct command (without bucket)
$(eval $0_result := $(call localstack_cmd,s3 ls))
$(call mb_assert_contains,s3 ls,$($0_result),localstack/s3/ls should generate s3 ls command)
$(call mb_assert_contains,--endpoint-url $(localstack_endpoint_url),$($0_result),should include endpoint URL)

## Test S3 ls with bucket parameter
$(eval bucket := test-bucket)
$(eval $0_result := $(call localstack_cmd,s3 ls $(if $(value bucket),s3://$(bucket),)))
$(call mb_assert_contains,s3 ls s3://test-bucket,$($0_result),localstack/s3/ls with bucket should include bucket path)
$(eval undefine bucket)

$(eval mb_invoke_silent := $(mb_off))
endef

define test_modules_localstack_sqs_ls_command
$(eval mb_invoke_silent := $(mb_on))

## Test SQS ls generates correct command
$(eval $0_result := $(call localstack_cmd,sqs list-queues))
$(call mb_assert_contains,sqs list-queues,$($0_result),localstack/sqs/ls should generate sqs list-queues command)
$(call mb_assert_contains,--endpoint-url $(localstack_endpoint_url),$($0_result),should include endpoint URL)

$(eval mb_invoke_silent := $(mb_off))
endef

######################################################################################
# Function definition tests
######################################################################################

define test_modules_localstack_functions_defined
$(call mb_assert,$(value localstack_cmd),localstack_cmd function should be defined)
$(call mb_assert,$(value localstack_api),localstack_api function should be defined)
$(call mb_assert,$(value localstack_api_check),localstack_api_check function should be defined)
$(call mb_assert,$(value localstack_api_json),localstack_api_json function should be defined)
endef