Ministack: Free, open-source local AWS emulator - 60+ services, Terraform compatible, real databases. Free forever. MIT licensed.
Python awsaws-emulatoraws-localaws-sdkdevtoolsdockerdynamodbec2emulatorlambdalocalstacklocalstack-alternativeministackmock-awsopen-sourcepythons3sqsterraform
feat: SNS→SQS fanout, SQS→Lambda event source mapping (durable Lambda) (#1)
Nahuel Nucera8fd93d25368c
diff --git a/README.md b/README.mdindex b69272bc..657c1962 100644--- a/README.md+++ b/README.md@@ -386,7 +386,7 @@ pip install boto3 pytest duckdb docker cbor2# Start MiniStackdocker compose up -d-# Run the full test suite (54 tests across all 20 services)+# Run the full test suite (56 tests across all 20 services)pytest tests/ -v```@@ -399,7 +399,7 @@ tests/test_services.py::test_s3_put_get PASSED...tests/test_services.py::test_athena_workgroup PASSED-54 passed in 7.6s+56 passed in 7.6s```---diff --git a/index.html b/index.htmlnew file mode 100644index 00000000..effe6d3c--- /dev/null+++ b/index.html@@ -0,0 +1,277 @@+<!DOCTYPE html>+<html lang="en">+<head>+<meta charset="UTF-8">+<meta name="viewport" content="width=device-width, initial-scale=1.0">+<title>MiniStack — Free Open-Source Local AWS Emulator</title>+<meta name="description" content="Free, open-source LocalStack alternative. 20 AWS services on a single port. Real Postgres, Redis, Docker containers. MIT licensed, no account required.">+<meta property="og:title" content="MiniStack — Free Local AWS Emulator">+<meta property="og:description" content="LocalStack is no longer free. MiniStack is. 20 AWS services, real database containers, 2-second startup. MIT licensed.">+<meta property="og:url" content="https://ministack.org">+<meta property="og:image" content="https://ministack.org/og-image.png">+<meta property="og:type" content="website">+<meta name="twitter:card" content="summary_large_image">+<meta name="twitter:title" content="MiniStack — Free Local AWS Emulator">+<meta name="twitter:description" content="Free, open-source LocalStack alternative. 20 AWS services, real infrastructure, MIT licensed.">+<meta name="twitter:image" content="https://ministack.org/og-image.png">+<link rel="canonical" href="https://ministack.org">+<link rel="icon" href="logo.png" type="image/png">+<link rel="preconnect" href="https://fonts.googleapis.com">+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&family=Outfit:wght@400;500;600;700;800&display=swap" rel="stylesheet">+<style>+*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}+:root{--bg:#080a0f;--bg2:#0d1017;--bg3:#141820;--surface:#1a1f2b;--border:#1e2433;--border-b:#2a3040;--tx:#e4e8f0;--tx2:#8891a5;--tx3:#4d5568;--blue:#2d9bd6;--blueL:#45b8f0;--blueG:rgba(45,155,214,.15);--green:#22c55e;--red:#ef4444;--yellow:#eab308;--cyan:#06b6d4;--mono:'JetBrains Mono',monospace;--sans:'Outfit',system-ui,sans-serif}+html{scroll-behavior:smooth}+body{background:var(--bg);color:var(--tx);font-family:var(--sans);line-height:1.6;overflow-x:hidden;-webkit-font-smoothing:antialiased}+body::before{content:'';position:fixed;inset:0;background-image:url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.85' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E");opacity:.025;pointer-events:none;z-index:9999}+.gridbg{position:fixed;inset:0;background-image:linear-gradient(rgba(45,155,214,.04) 1px,transparent 1px),linear-gradient(90deg,rgba(45,155,214,.04) 1px,transparent 1px);background-size:80px 80px;pointer-events:none;z-index:0;mask-image:radial-gradient(ellipse 60% 40% at 50% 20%,#000 10%,transparent 70%)}+.glow{position:absolute;top:-100px;left:50%;transform:translateX(-50%);width:700px;height:500px;background:radial-gradient(ellipse,rgba(45,155,214,.12) 0%,rgba(45,155,214,.03) 40%,transparent 70%);pointer-events:none;z-index:0}+@keyframes fadeUp{from{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}}+@keyframes pulse{0%,100%{box-shadow:0 0 6px var(--green)}50%{box-shadow:0 0 14px var(--green),0 0 28px rgba(34,197,94,.2)}}+.a{opacity:0;animation:fadeUp .6s cubic-bezier(.16,1,.3,1) forwards}+.d1{animation-delay:.05s}.d2{animation-delay:.1s}.d3{animation-delay:.18s}.d4{animation-delay:.26s}.d5{animation-delay:.34s}.d6{animation-delay:.42s}.d7{animation-delay:.5s}.d8{animation-delay:.6s}++nav{position:fixed;top:0;left:0;right:0;z-index:100;padding:0 2rem;height:60px;display:flex;align-items:center;justify-content:space-between;background:rgba(8,10,15,.85);backdrop-filter:blur(16px) saturate(1.4);border-bottom:1px solid var(--border)}+.nlogo{display:flex;align-items:center;gap:10px;text-decoration:none}+.nlogo img{height:32px}.nlogo span{font-family:var(--mono);font-weight:700;font-size:1rem;color:var(--tx)}+.nr{display:flex;align-items:center;gap:1.5rem}+.nr a{color:var(--tx2);text-decoration:none;font-size:.88rem;font-weight:500;transition:color .2s}+.nr a:hover{color:var(--tx)}+.ghb{display:inline-flex;align-items:center;gap:7px;padding:7px 14px;background:var(--surface);border:1px solid var(--border-b);border-radius:8px;color:var(--tx);font-size:.82rem;font-weight:600;transition:all .2s}+.ghb:hover{border-color:var(--blue);background:var(--bg3)}+.ghb svg{width:16px;height:16px;fill:currentColor}++.hero{position:relative;z-index:1;padding:150px 2rem 80px;max-width:1000px;margin:0 auto;text-align:center}+.badge{display:inline-flex;align-items:center;gap:8px;padding:5px 14px;border-radius:100px;border:1px solid var(--border-b);background:var(--bg2);font-size:.8rem;font-family:var(--mono);color:var(--tx2);margin-bottom:1.8rem}+.badge .dot{width:7px;height:7px;border-radius:50%;background:var(--green);animation:pulse 2s infinite}+h1{font-size:clamp(2.5rem,6.5vw,4.5rem);font-weight:800;line-height:1.08;letter-spacing:-.035em;margin-bottom:1.2rem}+.bl{color:var(--blueL)}+.hsub{font-size:1.15rem;color:var(--tx2);max-width:580px;margin:0 auto 2.2rem;line-height:1.7}+.hsub strong{color:var(--tx);font-weight:600}+.hacts{display:flex;align-items:center;justify-content:center;gap:1rem;flex-wrap:wrap;margin-bottom:2rem}+.btn{display:inline-flex;align-items:center;gap:8px;padding:12px 24px;border-radius:9px;font-weight:700;font-size:.92rem;text-decoration:none;transition:all .25s;border:none;cursor:pointer}+.btn-b{background:var(--blue);color:#fff}.btn-b:hover{background:var(--blueL);transform:translateY(-2px);box-shadow:0 8px 30px rgba(45,155,214,.3)}+.btn-g{background:transparent;color:var(--tx);border:1px solid var(--border-b)}.btn-g:hover{background:var(--surface);border-color:var(--tx3);transform:translateY(-2px)}+.btn svg{width:17px;height:17px;fill:currentColor}+.cmd{display:inline-flex;align-items:center;gap:12px;padding:12px 20px;background:var(--bg2);border:1px solid var(--border);border-radius:9px;font-family:var(--mono);font-size:.88rem;cursor:pointer;transition:all .2s}+.cmd:hover{border-color:var(--blue)}+.cmd .p{color:var(--blue)}.cmd .c{color:var(--tx)}+.cmd .tg{font-family:var(--sans);font-size:.72rem;color:var(--tx3);padding:2px 8px;background:var(--surface);border-radius:4px}+.cmd.copied .tg{color:var(--green)}++.stats{display:flex;justify-content:center;gap:3rem;flex-wrap:wrap;padding:2rem 2rem 3rem;max-width:950px;margin:0 auto}+.sv{font-family:var(--mono);font-size:1.8rem;font-weight:700;color:var(--blueL)}+.sl{font-size:.78rem;color:var(--tx3);text-transform:uppercase;letter-spacing:.1em;margin-top:2px}++.callout{position:relative;z-index:1;max-width:800px;margin:0 auto 4rem;padding:0 2rem}+.cbox{display:flex;align-items:flex-start;gap:16px;padding:20px 24px;background:rgba(239,68,68,.06);border:1px solid rgba(239,68,68,.15);border-radius:10px}+.cbox-i{font-size:1.4rem;flex-shrink:0;margin-top:2px}+.cbox-t{font-size:.92rem;color:var(--tx2);line-height:1.6}.cbox-t strong{color:var(--tx)}++.tw{position:relative;z-index:1;max-width:800px;margin:0 auto 5rem;padding:0 2rem}+.term{background:var(--bg2);border:1px solid var(--border);border-radius:12px;overflow:hidden;box-shadow:0 20px 60px rgba(0,0,0,.4)}+.tb{display:flex;align-items:center;gap:7px;padding:12px 16px;background:var(--bg3);border-bottom:1px solid var(--border)}+.td{width:11px;height:11px;border-radius:50%}.td.r{background:#ff5f57}.td.y{background:#febc2e}.td.g{background:#28c840}+.tt{flex:1;text-align:center;font-family:var(--mono);font-size:.75rem;color:var(--tx3)}+.tc{padding:20px;font-family:var(--mono);font-size:.82rem;line-height:1.9;overflow-x:auto;white-space:pre}+.cm{color:var(--tx3)}.pr{color:var(--blue)}.fl{color:var(--cyan)}.st{color:var(--yellow)}.out{color:var(--tx2)}.ok{color:var(--green)}++.sec{position:relative;z-index:1;max-width:1060px;margin:0 auto;padding:4.5rem 2rem}+.stag{font-family:var(--mono);font-size:.75rem;text-transform:uppercase;letter-spacing:.14em;color:var(--blue);margin-bottom:.8rem}+.sec h2{font-size:clamp(1.7rem,3.5vw,2.5rem);font-weight:800;letter-spacing:-.02em;margin-bottom:.8rem}+.sdesc{color:var(--tx2);font-size:1rem;max-width:560px;margin-bottom:2.5rem}+.div{border:none;border-top:1px solid var(--border);margin:0 auto;max-width:1020px}++.sg{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:1px;background:var(--border);border:1px solid var(--border);border-radius:12px;overflow:hidden}+.sc{background:var(--bg2);padding:22px 20px;transition:background .2s}.sc:hover{background:var(--bg3)}+.si{font-size:1.3rem;margin-bottom:8px}.sn{font-weight:700;font-size:.92rem;margin-bottom:4px}+.sd{font-size:.76rem;color:var(--tx3);line-height:1.5}+.sp{display:inline-block;margin-top:8px;padding:2px 8px;background:var(--surface);border-radius:4px;font-family:var(--mono);font-size:.68rem;color:var(--tx2)}+.sp.real{background:rgba(45,155,214,.1);color:var(--blue);border:1px solid rgba(45,155,214,.2)}++.ct{width:100%;border-collapse:separate;border-spacing:0;border:1px solid var(--border);border-radius:12px;overflow:hidden;font-size:.88rem}+.ct th,.ct td{padding:14px 18px;text-align:left;border-bottom:1px solid var(--border)}+.ct th{background:var(--bg3);font-weight:600;font-size:.78rem;text-transform:uppercase;letter-spacing:.06em;color:var(--tx2)}+.ct th.hl{color:var(--blueL)}+.ct td{background:var(--bg2)}.ct tr:last-child td{border-bottom:none}+.w{color:var(--blueL);font-family:var(--mono);font-weight:700}.dm{color:var(--tx3)}++.fg{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:1.2rem}+.fc{padding:28px;background:var(--bg2);border:1px solid var(--border);border-radius:12px;transition:all .25s}+.fc:hover{border-color:var(--border-b);transform:translateY(-2px)}+.fi{width:40px;height:40px;background:var(--blueG);border:1px solid rgba(45,155,214,.15);border-radius:9px;display:flex;align-items:center;justify-content:center;font-size:1.1rem;margin-bottom:14px}+.ft{font-weight:700;margin-bottom:6px;font-size:.95rem}+.fd{font-size:.84rem;color:var(--tx2);line-height:1.6}++.fcta{position:relative;z-index:1;text-align:center;padding:5rem 2rem;max-width:650px;margin:0 auto}+.fcta h2{font-size:clamp(1.6rem,3.5vw,2.3rem);font-weight:800;letter-spacing:-.02em;margin-bottom:.8rem}+.fcta p{color:var(--tx2);margin-bottom:2rem;font-size:1rem}+footer{position:relative;z-index:1;border-top:1px solid var(--border);padding:1.8rem 2rem;text-align:center;font-size:.8rem;color:var(--tx3)}+footer a{color:var(--tx2);text-decoration:none}footer a:hover{color:var(--blue)}++@media(max-width:768px){.nr a:not(.ghb){display:none}.hero{padding:120px 1.5rem 50px}.stats{gap:1.5rem}.sv{font-size:1.4rem}.hacts{flex-direction:column}.sg{grid-template-columns:repeat(auto-fill,minmax(160px,1fr))}.ct{font-size:.78rem}.ct th,.ct td{padding:10px 12px}.tc{font-size:.72rem;padding:14px}}+@media(max-width:480px){.cmd{font-size:.76rem;padding:10px 14px}.sg{grid-template-columns:1fr 1fr}}+</style>+</head>+<body>+<div class="gridbg"></div>++<nav>+ <a href="/" class="nlogo"><img src="logo.png" alt="MiniStack"><span>MiniStack</span></a>+ <div class="nr">+ <a href="#services">Services</a>+ <a href="#comparison">Compare</a>+ <a href="#features">Features</a>+ <a href="https://github.com/Nahuel990/ministack" target="_blank" class="ghb">+ <svg viewBox="0 0 16 16"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg>+ Star+ </a>+ </div>+</nav>++<section class="hero">+ <div class="glow"></div>+ <div class="badge a d1"><span class="dot"></span>v1.0.11 · MIT licensed · free forever</div>+ <h1 class="a d2">The <span class="bl">free</span> LocalStack<br>replacement</h1>+ <p class="hsub a d3">LocalStack is no longer free. <strong>MiniStack is.</strong><br>20 AWS services on a single port — with <strong>real Postgres, Redis, and Docker containers</strong>. No account, no license key, no telemetry.</p>+ <div class="hacts a d4">+ <a href="https://github.com/Nahuel990/ministack" target="_blank" class="btn btn-b">+ <svg viewBox="0 0 16 16"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg>+ View on GitHub</a>+ <a href="https://hub.docker.com/r/nahuelnucera/ministack" target="_blank" class="btn btn-g">🐳 Docker Hub</a>+ </div>+ <div class="cmd a d5" onclick="cp(this)"><span class="p">$</span><span class="c">docker run -p 4566:4566 nahuelnucera/ministack</span><span class="tg">copy</span></div>+</section>++<div class="stats a d6">+ <div><div class="sv">20</div><div class="sl">AWS Services</div></div>+ <div><div class="sv">~2s</div><div class="sl">Startup</div></div>+ <div><div class="sv">~30MB</div><div class="sl">RAM at idle</div></div>+ <div><div class="sv">150MB</div><div class="sl">Docker Image</div></div>+ <div><div class="sv">56</div><div class="sl">Tests passing</div></div>+</div>++<div class="callout a d7">+ <div class="cbox">+ <span class="cbox-i">⚠️</span>+ <div class="cbox-t"><strong>LocalStack moved core services behind a paid plan.</strong> If you relied on LocalStack Community for local dev and CI/CD, MiniStack is your free, MIT-licensed drop-in replacement. No sign-up, no API key, no telemetry.</div>+ </div>+</div>++<div class="tw a d8">+ <div class="term">+ <div class="tb"><span class="td r"></span><span class="td y"></span><span class="td g"></span><span class="tt">ministack — bash</span></div>+ <div class="tc"><span class="cm"># Start MiniStack</span>+<span class="pr">$</span> docker run <span class="fl">-p</span> <span class="st">4566:4566</span> nahuelnucera/ministack++<span class="cm"># Works with any AWS tool — no config changes</span>+<span class="pr">$</span> aws <span class="fl">--endpoint-url=</span><span class="st">http://localhost:4566</span> s3 mb s3://my-bucket+<span class="out">make_bucket: my-bucket</span>++<span class="cm"># Real database — RDS spins up actual Postgres</span>+<span class="pr">$</span> aws <span class="fl">--endpoint-url=</span><span class="st">http://localhost:4566</span> rds create-db-instance \+ <span class="fl">--db-instance-identifier</span> mydb <span class="fl">--engine</span> postgres \+ <span class="fl">--master-username</span> admin <span class="fl">--master-user-password</span> secret+<span class="ok">✓ Real Postgres container running on localhost:15432</span>++<span class="cm"># Real Redis via ElastiCache</span>+<span class="pr">$</span> aws <span class="fl">--endpoint-url=</span><span class="st">http://localhost:4566</span> elasticache \+ create-cache-cluster <span class="fl">--cache-cluster-id</span> my-redis <span class="fl">--engine</span> redis+<span class="ok">✓ Real Redis container running on localhost:16379</span></div>+ </div>+</div>++<hr class="div">++<section class="sec" id="services">+ <div class="stag">20 Services</div>+ <h2>Everything you need, locally</h2>+ <p class="sdesc">Core AWS services plus real infrastructure — RDS runs actual databases, ElastiCache runs real Redis, ECS starts real Docker containers, Athena executes real SQL via DuckDB (when installed).</p>+ <div class="sg">+ <div class="sc"><div class="si">🪣</div><div class="sn">S3</div><div class="sd">Buckets, objects, copy, list, batch</div><span class="sp">REST/XML</span></div>+ <div class="sc"><div class="si">📨</div><div class="sn">SQS</div><div class="sd">Queues, send/receive, batch, visibility</div><span class="sp">JSON+Query</span></div>+ <div class="sc"><div class="si">📢</div><div class="sn">SNS</div><div class="sd">Topics, subscriptions, publish</div><span class="sp">Query/XML</span></div>+ <div class="sc"><div class="si">🗃️</div><div class="sn">DynamoDB</div><div class="sd">Tables, CRUD, query, scan, batch</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">⚡</div><div class="sn">Lambda</div><div class="sd">Real Python execution from zip</div><span class="sp">REST/JSON</span></div>+ <div class="sc"><div class="si">🔐</div><div class="sn">IAM</div><div class="sd">Users, roles, policies, keys</div><span class="sp">Query/XML</span></div>+ <div class="sc"><div class="si">🎫</div><div class="sn">STS</div><div class="sd">CallerIdentity, AssumeRole</div><span class="sp">Query/XML</span></div>+ <div class="sc"><div class="si">🔑</div><div class="sn">Secrets Manager</div><div class="sd">CRUD with versioning</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">📊</div><div class="sn">CW Logs</div><div class="sd">Groups, streams, events, filter</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">📐</div><div class="sn">SSM Params</div><div class="sd">String, SecureString, paths</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">🚌</div><div class="sn">EventBridge</div><div class="sd">Buses, rules, targets, events</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">🌊</div><div class="sn">Kinesis</div><div class="sd">Streams, shards, put/get records</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">📈</div><div class="sn">CW Metrics</div><div class="sd">Metrics, alarms, statistics</div><span class="sp">Query/XML</span></div>+ <div class="sc"><div class="si">✉️</div><div class="sn">SES</div><div class="sd">Send email, identities, quotas</div><span class="sp">Query/XML</span></div>+ <div class="sc"><div class="si">🔄</div><div class="sn">Step Functions</div><div class="sd">State machines, executions</div><span class="sp">JSON</span></div>+ <div class="sc"><div class="si">🐘</div><div class="sn">RDS</div><div class="sd">Real Postgres/MySQL containers</div><span class="sp real">Real Docker</span></div>+ <div class="sc"><div class="si">🔴</div><div class="sn">ElastiCache</div><div class="sd">Real Redis/Memcached containers</div><span class="sp real">Real Docker</span></div>+ <div class="sc"><div class="si">🐳</div><div class="sn">ECS</div><div class="sd">RunTask starts real containers</div><span class="sp real">Real Docker</span></div>+ <div class="sc"><div class="si">🧪</div><div class="sn">Glue</div><div class="sd">Catalog, crawlers, jobs</div><span class="sp real">Real Exec</span></div>+ <div class="sc"><div class="si">🔍</div><div class="sn">Athena</div><div class="sd">Real SQL via DuckDB (optional)</div><span class="sp real">DuckDB</span></div>+ </div>+</section>++<hr class="div">++<section class="sec" id="comparison">+ <div class="stag">Comparison</div>+ <h2>LocalStack vs MiniStack</h2>+ <p class="sdesc">Same developer experience. Fraction of the cost and footprint.</p>+ <table class="ct">+ <thead><tr><th>Feature</th><th>LocalStack Free</th><th>LocalStack Pro</th><th class="hl">MiniStack ⚡</th></tr></thead>+ <tbody>+ <tr><td>Core services (S3, SQS, DDB…)</td><td class="dm">Now paid</td><td>✅</td><td class="w">✅ Free</td></tr>+ <tr><td>Lambda, IAM, SSM, EventBridge</td><td class="dm">Paid</td><td>✅</td><td class="w">✅ Free</td></tr>+ <tr><td>RDS (real DB containers)</td><td class="dm">❌</td><td>✅</td><td class="w">✅ Real Postgres/MySQL</td></tr>+ <tr><td>ElastiCache (real Redis)</td><td class="dm">❌</td><td>✅</td><td class="w">✅ Real Redis</td></tr>+ <tr><td>ECS (real Docker)</td><td class="dm">❌</td><td>✅</td><td class="w">✅ Real Docker</td></tr>+ <tr><td>Athena (real SQL)</td><td class="dm">❌</td><td>✅</td><td class="w">✅ DuckDB (optional)</td></tr>+ <tr><td>Glue Catalog + Jobs</td><td class="dm">❌</td><td>✅</td><td class="w">✅</td></tr>+ <tr><td>Startup time</td><td class="dm">~15-30s</td><td class="dm">~15-30s</td><td class="w">~2s</td></tr>+ <tr><td>Memory at idle</td><td class="dm">~500MB</td><td class="dm">~500MB</td><td class="w">~30MB</td></tr>+ <tr><td>Docker image</td><td class="dm">~1 GB</td><td class="dm">~1 GB</td><td class="w">150 MB</td></tr>+ <tr><td>License</td><td class="dm">BSL (restricted)</td><td class="dm">Proprietary</td><td class="w">MIT</td></tr>+ <tr><td>Price</td><td class="dm">Now paid</td><td class="dm">$35+/mo</td><td class="w">$0 forever</td></tr>+ </tbody>+ </table>+</section>++<hr class="div">++<section class="sec" id="features">+ <div class="stag">Built different</div>+ <h2>Real infrastructure, not mocks</h2>+ <p class="sdesc">Where it matters most — RDS, ElastiCache, and ECS run real Docker containers. No fake endpoints, no stubbed responses.</p> <div class="fg">+ <div class="fc"><div class="fi">🐘</div><div class="ft">Real databases via RDS</div><div class="fd">CreateDBInstance spins up an actual Postgres or MySQL Docker container. Connect with psycopg2 — it's a real database.</div></div>+ <div class="fc"><div class="fi">🔴</div><div class="ft">Real Redis via ElastiCache</div><div class="fd">CreateCacheCluster starts an actual Redis container. Use redis-py, run SUBSCRIBE, use it as your session store.</div></div>+ <div class="fc"><div class="fi">🐳</div><div class="ft">Real containers via ECS</div><div class="fd">RunTask pulls and starts real Docker containers via the Docker socket. Test your ECS task definitions locally.</div></div>+ <div class="fc"><div class="fi">🔍</div><div class="ft">Real SQL via Athena</div><div class="fd">Queries execute via DuckDB when installed. Query S3 data with actual SQL, get actual result sets back. Falls back to mock results without it.</div></div>+ <div class="fc"><div class="fi">🔌</div><div class="ft">Full SDK compatibility</div><div class="fd">Works with boto3, AWS CLI, Terraform, CDK, Pulumi — any tool that speaks the AWS API.</div></div>+ <div class="fc"><div class="fi">🔓</div><div class="ft">MIT licensed forever</div><div class="fd">No BSL, no feature gates, no "community" vs "pro". Every service is free. Fork it, embed it. MIT is MIT.</div></div>+ </div>+</section>++<hr class="div">++<section class="fcta">+ <h2>Stop paying for local development</h2>+ <p>One command. 20 services. Real infrastructure. Free.</p>+ <div class="hacts" style="margin-bottom:1.5rem">+ <a href="https://github.com/Nahuel990/ministack" target="_blank" class="btn btn-b">+ <svg width="17" height="17" viewBox="0 0 16 16" fill="currentColor"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg>+ GitHub</a>+ <a href="https://hub.docker.com/r/nahuelnucera/ministack" target="_blank" class="btn btn-g">🐳 Docker Hub</a>+ </div>+ <div class="cmd" onclick="cp(this)"><span class="p">$</span><span class="c">docker run -p 4566:4566 nahuelnucera/ministack</span><span class="tg">copy</span></div>+</section>++<footer>Built by <a href="https://github.com/Nahuel990" target="_blank">Nahuel</a> · <a href="https://github.com/Nahuel990/ministack" target="_blank">GitHub</a> · MIT License · 2025</footer>++<script>+function cp(e){navigator.clipboard.writeText(e.querySelector('.c').textContent).then(()=>{const t=e.querySelector('.tg');t.textContent='copied!';e.classList.add('copied');setTimeout(()=>{t.textContent='copy';e.classList.remove('copied')},2e3)})}+const o=new IntersectionObserver(e=>{e.forEach(x=>{if(x.isIntersecting){x.target.classList.add('a');o.unobserve(x.target)}})},{threshold:.08,rootMargin:'0px 0px -30px 0px'});+document.querySelectorAll('.sec .stag,.sec h2,.sdesc,.sc,.fc,.ct,.cbox').forEach(e=>{if(!e.classList.contains('a')){e.style.opacity='0';o.observe(e)}});+</script>+</body>+</html>diff --git a/services/lambda_svc.py b/services/lambda_svc.pyindex c6b1d438..37cfd63b 100644--- a/services/lambda_svc.py+++ b/services/lambda_svc.py@@ -1,8 +1,11 @@"""Lambda Service Emulator.Supports: CreateFunction, DeleteFunction, GetFunction, ListFunctions,- Invoke, UpdateFunctionCode, UpdateFunctionConfiguration.+ Invoke, UpdateFunctionCode, UpdateFunctionConfiguration,+ CreateEventSourceMapping, DeleteEventSourceMapping,+ GetEventSourceMapping, ListEventSourceMappings, UpdateEventSourceMapping.Functions are stored in-memory. Invocation runs code in a subprocess (Python only) or returns mock results.+SQS event source mappings poll the queue in a background thread and invoke the Lambda with batches."""import os@@ -12,6 +15,7 @@ import base64import zipfileimport tempfileimport subprocess+import threadingimport loggingfrom core.responses import json_response, error_response_json, new_uuid@@ -21,7 +25,10 @@ logger = logging.getLogger("lambda")ACCOUNT_ID = "000000000000"REGION = "us-east-1"-_functions: dict = {} # function_name -> {config, code_zip, code_dir}+_functions: dict = {} # function_name -> {config, code_zip}+_esms: dict = {} # uuid -> esm dict+_poller_started = False+_poller_lock = threading.Lock()async def handle_request(method: str, path: str, headers: dict, body: bytes, query_params: dict) -> tuple:@@ -40,15 +47,28 @@ async def handle_request(method: str, path: str, headers: dict, body: bytes, quedata = {}# POST /2015-03-31/functions — CreateFunction- if method == "POST" and len(parts) == 3:+ if method == "POST" and len(parts) == 3 and parts[2] == "functions":return _create_function(data)# GET /2015-03-31/functions — ListFunctions- if method == "GET" and len(parts) == 3:+ if method == "GET" and len(parts) == 3 and parts[2] == "functions":return _list_functions()- func_name = parts[3] if len(parts) > 3 else None+ # Event Source Mappings: /2015-03-31/event-source-mappings+ if len(parts) >= 3 and parts[2] == "event-source-mappings":+ esm_id = parts[3] if len(parts) > 3 else None+ if method == "POST" and not esm_id:+ return _create_esm(data)+ if method == "GET" and not esm_id:+ return _list_esms(data)+ if method == "GET" and esm_id:+ return _get_esm(esm_id)+ if method == "PUT" and esm_id:+ return _update_esm(esm_id, data)+ if method == "DELETE" and esm_id:+ return _delete_esm(esm_id)+ func_name = parts[3] if len(parts) > 3 else Noneif not func_name:return error_response_json("InvalidRequest", "Missing function name", 400)@@ -79,6 +99,166 @@ async def handle_request(method: str, path: str, headers: dict, body: bytes, quereturn error_response_json("InvalidRequest", f"Unhandled Lambda path: {path}", 400)+# ---- Event Source Mappings ----++def _create_esm(data):+ esm_id = new_uuid()+ func_name = data.get("FunctionName", "")+ # Resolve to just the name if ARN given+ if ":" in func_name:+ func_name = func_name.split(":")[-1]++ esm = {+ "UUID": esm_id,+ "EventSourceArn": data.get("EventSourceArn", ""),+ "FunctionArn": f"arn:aws:lambda:{REGION}:{ACCOUNT_ID}:function:{func_name}",+ "FunctionName": func_name,+ "State": "Enabled",+ "BatchSize": data.get("BatchSize", 10),+ "MaximumBatchingWindowInSeconds": data.get("MaximumBatchingWindowInSeconds", 0),+ "LastModified": time.time(),+ "LastProcessingResult": "No records processed",+ "StartingPosition": data.get("StartingPosition", "LATEST"),+ "Enabled": True,+ }+ _esms[esm_id] = esm+ _ensure_poller()+ return json_response(esm)+++def _get_esm(esm_id):+ esm = _esms.get(esm_id)+ if not esm:+ return error_response_json("ResourceNotFoundException", f"ESM {esm_id} not found", 404)+ return json_response(esm)+++def _list_esms(data):+ func = data.get("FunctionName", "")+ if ":" in func:+ func = func.split(":")[-1]+ result = [e for e in _esms.values() if not func or e["FunctionName"] == func]+ return json_response({"EventSourceMappings": result})+++def _update_esm(esm_id, data):+ esm = _esms.get(esm_id)+ if not esm:+ return error_response_json("ResourceNotFoundException", f"ESM {esm_id} not found", 404)+ if "BatchSize" in data:+ esm["BatchSize"] = data["BatchSize"]+ if "Enabled" in data:+ esm["Enabled"] = data["Enabled"]+ esm["State"] = "Enabled" if data["Enabled"] else "Disabled"+ esm["LastModified"] = time.time()+ return json_response(esm)+++def _delete_esm(esm_id):+ esm = _esms.pop(esm_id, None)+ if not esm:+ return error_response_json("ResourceNotFoundException", f"ESM {esm_id} not found", 404)+ return json_response(esm)+++def _ensure_poller():+ global _poller_started+ with _poller_lock:+ if not _poller_started:+ t = threading.Thread(target=_poll_loop, daemon=True)+ t.start()+ _poller_started = True+++def _poll_loop():+ """Background thread: polls SQS queues for active ESMs and invokes Lambda."""+ while True:+ try:+ _poll_once()+ except Exception as e:+ logger.error(f"ESM poller error: {e}")+ time.sleep(1)+++def _poll_once():+ from services import sqs as _sqs++ for esm in list(_esms.values()):+ if not esm.get("Enabled", True):+ continue++ source_arn = esm.get("EventSourceArn", "")+ if "sqs" not in source_arn:+ continue++ func_name = esm["FunctionName"]+ if func_name not in _functions:+ continue++ # Resolve queue URL from ARN: arn:aws:sqs:region:account:queue-name+ queue_name = source_arn.split(":")[-1]+ queue_url = _sqs._queue_url(queue_name)+ queue = _sqs._queues.get(queue_url)+ if not queue:+ continue++ batch_size = esm.get("BatchSize", 10)+ now = time.time()++ # Grab up to batch_size visible messages+ batch = []+ for msg in list(queue["messages"]):+ if len(batch) >= batch_size:+ break+ if msg["visible_at"] <= now and msg.get("receipt_handle") is None:+ batch.append(msg)++ if not batch:+ continue++ # Mark as in-flight+ for msg in batch:+ msg["receipt_handle"] = new_uuid()+ msg["visible_at"] = now + 30 # visibility timeout++ # Build SQS event payload+ records = []+ for msg in batch:+ records.append({+ "messageId": msg["id"],+ "receiptHandle": msg["receipt_handle"],+ "body": msg["body"],+ "attributes": {+ "ApproximateReceiveCount": str(msg.get("receive_count", 1)),+ "SentTimestamp": str(int(msg["sent_at"] * 1000)),+ "SenderId": ACCOUNT_ID,+ "ApproximateFirstReceiveTimestamp": str(int(now * 1000)),+ },+ "messageAttributes": msg.get("attributes", {}),+ "md5OfBody": msg["md5"],+ "eventSource": "aws:sqs",+ "eventSourceARN": source_arn,+ "awsRegion": REGION,+ })++ event = {"Records": records}+ result = _execute_function(_functions[func_name], event)++ if result.get("error"):+ # On failure, make messages visible again immediately+ for msg in batch:+ msg["receipt_handle"] = None+ msg["visible_at"] = now+ esm["LastProcessingResult"] = "FAILED"+ logger.warning(f"ESM: Lambda {func_name} failed processing batch from {queue_name}")+ else:+ # Success — delete processed messages+ receipt_handles = {msg["receipt_handle"] for msg in batch}+ queue["messages"] = [m for m in queue["messages"] if m.get("receipt_handle") not in receipt_handles]+ esm["LastProcessingResult"] = f"OK — {len(batch)} records"+ logger.info(f"ESM: Lambda {func_name} processed {len(batch)} messages from {queue_name}")++def _create_function(data):name = data.get("FunctionName")if not name:diff --git a/services/sns.py b/services/sns.pyindex 9c38e753..3e15db63 100644--- a/services/sns.py+++ b/services/sns.py@@ -167,12 +167,63 @@ def _publish(params):"id": msg_id, "message": message, "subject": subject,"timestamp": time.time(),})- # In real LocalStack, this would fan out to subscribers+ _fanout(topic_arn, msg_id, message, subject)logger.info(f"SNS publish to {topic_arn}: {message[:100]}")return _xml(200, "PublishResponse", f"<PublishResult><MessageId>{msg_id}</MessageId></PublishResult>")+def _fanout(topic_arn: str, msg_id: str, message: str, subject: str):+ """Deliver SNS message to all confirmed subscribers."""+ import json as _json+ from services import sqs as _sqs++ topic = _topics.get(topic_arn)+ if not topic:+ return++ # SNS wraps the message in an envelope when delivering to SQS+ envelope = _json.dumps({+ "Type": "Notification",+ "MessageId": msg_id,+ "TopicArn": topic_arn,+ "Subject": subject or "",+ "Message": message,+ "Timestamp": time.strftime("%Y-%m-%dT%H:%M:%S.000Z", time.gmtime()),+ "SignatureVersion": "1",+ "Signature": "FAKE",+ "SigningCertURL": "",+ "UnsubscribeURL": "",+ })++ for sub in topic["subscriptions"]:+ if not sub.get("confirmed"):+ continue+ protocol = sub.get("protocol", "")+ endpoint = sub.get("endpoint", "")++ if protocol == "sqs":+ # endpoint is the SQS queue ARN: arn:aws:sqs:region:account:queue-name+ queue_name = endpoint.split(":")[-1]+ queue_url = _sqs._queue_url(queue_name)+ queue = _sqs._queues.get(queue_url)+ if queue:+ import hashlib as _hashlib+ queue["messages"].append({+ "id": new_uuid(),+ "body": envelope,+ "md5": _hashlib.md5(envelope.encode()).hexdigest(),+ "receipt_handle": None,+ "sent_at": time.time(),+ "visible_at": time.time(),+ "receive_count": 0,+ "attributes": {},+ })+ logger.info(f"SNS fanout → SQS {queue_name}")+ else:+ logger.warning(f"SNS fanout: SQS queue {queue_name} not found")++def _p(params, key, default=""):val = params.get(key, [default])return val[0] if isinstance(val, list) else valdiff --git a/tests/test_services.py b/tests/test_services.pyindex e6e8c43f..7b687bd4 100644--- a/tests/test_services.py+++ b/tests/test_services.py@@ -117,6 +117,27 @@ def test_sns_subscribe(sns):assert len(subs.get("Subscriptions", [])) >= 1+def test_sns_sqs_fanout(sns, sqs):+ # Create topic and queue+ topic_arn = sns.create_topic(Name="fanout-topic")["TopicArn"]+ q_url = sqs.create_queue(QueueName="fanout-queue")["QueueUrl"]+ q_arn = sqs.get_queue_attributes(QueueUrl=q_url, AttributeNames=["QueueArn"])["Attributes"]["QueueArn"]++ # Subscribe SQS queue to SNS topic+ sns.subscribe(TopicArn=topic_arn, Protocol="sqs", Endpoint=q_arn)++ # Publish to topic+ sns.publish(TopicArn=topic_arn, Message="hello fanout", Subject="test")++ # Message should appear in SQS queue+ msgs = sqs.receive_message(QueueUrl=q_url, MaxNumberOfMessages=1)+ assert len(msgs.get("Messages", [])) == 1+ import json+ body = json.loads(msgs["Messages"][0]["Body"])+ assert body["Message"] == "hello fanout"+ assert body["TopicArn"] == topic_arn++# ========== DynamoDB ==========def test_dynamodb_basic(ddb):@@ -245,6 +266,67 @@ def test_lambda_create_invoke(lam):# ========== IAM ==========+def test_lambda_esm_sqs(lam, sqs):+ """SQS → Lambda event source mapping: messages sent to SQS trigger Lambda."""+ import io, zipfile as zf++ # Clean up from previous runs+ try:+ lam.delete_function(FunctionName="esm-test-func")+ except Exception:+ pass++ # Lambda that records what it received+ code = (+ b"import json\n"+ b"received = []\n"+ b"def handler(event, context):\n"+ b" received.extend(event.get('Records', []))\n"+ b" return {'processed': len(event.get('Records', []))}\n"+ )+ buf = io.BytesIO()+ with zf.ZipFile(buf, "w") as z:+ z.writestr("index.py", code)++ lam.create_function(+ FunctionName="esm-test-func", Runtime="python3.9",+ Role="arn:aws:iam::000000000000:role/test-role",+ Handler="index.handler",+ Code={"ZipFile": buf.getvalue()},+ )++ q_url = sqs.create_queue(QueueName="esm-test-queue")["QueueUrl"]+ q_arn = sqs.get_queue_attributes(QueueUrl=q_url, AttributeNames=["QueueArn"])["Attributes"]["QueueArn"]++ # Create event source mapping+ resp = lam.create_event_source_mapping(+ EventSourceArn=q_arn,+ FunctionName="esm-test-func",+ BatchSize=5,+ Enabled=True,+ )+ esm_uuid = resp["UUID"]+ assert resp["State"] == "Enabled"++ # Send a message to SQS+ sqs.send_message(QueueUrl=q_url, MessageBody="trigger-lambda")++ # Wait for poller to pick it up (max 5s)+ import time+ for _ in range(10):+ time.sleep(0.5)+ msgs = sqs.receive_message(QueueUrl=q_url, MaxNumberOfMessages=1)+ if not msgs.get("Messages"):+ break # message was consumed by Lambda++ # Queue should be empty — Lambda consumed the message+ msgs = sqs.receive_message(QueueUrl=q_url, MaxNumberOfMessages=1)+ assert not msgs.get("Messages"), "Message should have been consumed by Lambda via ESM"++ # Cleanup+ lam.delete_event_source_mapping(UUID=esm_uuid)++def test_iam_role_user(iam):iam.create_role(RoleName="test-role",