ragedunicorn/busted repository overview

⁠Busted Alpine Docker Image

A lightweight Busted build on Alpine Linux for fast and reliable Lua unit testing.

⁠Quick Start

# Pull latest version
docker pull ragedunicorn/busted:latest

# Or pull specific version
docker pull ragedunicorn/busted:2.2.0-alpine3.23.4-1

# Run all specs in the spec/ directory
docker run -v $(pwd):/workspace ragedunicorn/busted:latest spec

⁠Features

• 🚀 Small footprint: Lightweight Alpine-based runtime image
• 📦 Busted 2.2.0: Latest stable version installed via LuaRocks
• 🔍 Rich assertions: Powered by luassert (mocks, spies, stubs)
• 🏗️ Multi-platform: Supports linux/amd64 and linux/arm64
• ⚡ CI-friendly: Built-in JUnit, TAP, JSON, and plain output formatters

⁠Supported Outputs

Lua versions: Lua 5.3 (default runtime in this image) Formatters: utfTerminal, plainTerminal, TAP, junit, json, gtest

⁠Usage Examples

⁠Run all specs

docker run -v $(pwd):/workspace ragedunicorn/busted:latest spec

⁠Run a single spec file

docker run -v $(pwd):/workspace ragedunicorn/busted:latest spec/calculator_spec.lua

⁠Filter tests by name

docker run -v $(pwd):/workspace ragedunicorn/busted:latest \
  --filter "math" spec

⁠Generate CI reports

# JUnit format for CI systems
docker run -v $(pwd):/workspace ragedunicorn/busted:latest \
  --output=junit spec > busted-report.xml

# TAP format
docker run -v $(pwd):/workspace ragedunicorn/busted:latest \
  --output=TAP spec

⁠Use a .busted configuration profile

docker run -v $(pwd):/workspace ragedunicorn/busted:latest --run=ci

⁠Tags

This image uses semantic versioning that includes all component versions:

Format: {busted_version}-alpine{alpine_version}-{build_number}

⁠Version Examples

• 2.2.0-alpine3.23.4-1 - Initial release with Busted 2.2.0 and Alpine 3.23.4
• 2.2.0-alpine3.23.4-2 - Rebuild of same versions (bug fixes, optimizations)
• 2.2.0-alpine3.23.5-1 - Alpine Linux patch update
• 2.3.0-alpine3.23.4-1 - Busted version update

When updates are available through automated dependency management, new releases are created with appropriate version tags.

⁠Links

• GitHub: https://github.com/RagedUnicorn/docker-busted⁠
• Issues: https://github.com/RagedUnicorn/docker-busted/issues⁠
• Releases: https://github.com/RagedUnicorn/docker-busted/releases⁠

⁠License

MIT License - See GitHub repository⁠ for details.