e2b-dockerfile-utils
v0.1.2E2B Dockerfile utils - Dockerfile parser, shell lexer and .dockerignore matcher ported from BuildKit and Moby
$ uv add e2b-dockerfile-utilse2b-dockerfile-utils
Dockerfile parser and shell lexer ported from BuildKit and a .dockerignore matcher ported from moby/patternmatcher, with no runtime dependencies. Used by the E2B SDK to implement Template.from_dockerfile and to filter the build context.
from e2b_dockerfile_utils import ShellLex, parse_dockerfile_ast
ast = parse_dockerfile_ast(
"""
FROM node:24 AS build
ENV KEY="a b" OTHER=c
RUN <<EOF
npm ci
npm run build
EOF
"""
)
for instruction in ast.instructions:
print(instruction.name, instruction.flags, instruction.args)
lex = ShellLex(ast.escape_token)
lex.process_words('KEY="a b" OTHER=c') # ['KEY=a b', 'OTHER=c']
parse_dockerfile_ast handles parser directives (# escape=, # syntax=), comments (including inside line continuations), builder flags, JSON/exec forms and heredocs, and reports line numbers and warnings. ShellLex splits and unquotes words the way BuildKit does, preserving $VAR / ${VAR:-default} references for later expansion.
from e2b_dockerfile_utils import PatternMatcher
matcher = PatternMatcher(["node_modules", "*.log", "!keep.log"])
matcher.matches("node_modules/pkg/index.js") # True
matcher.matches("keep.log") # False
PatternMatcher applies .dockerignore semantics to slash-separated paths relative to the context root: a pattern matching a directory excludes everything under it, and ! patterns re-include paths (the last matching pattern wins). An invalid pattern raises a plain ValueError.
Details
- Version
- 0.1.2
- License
- Apache-2.0
- Python
- >=3.11
- Maintainer
- e2b
Release Cadence
Maintainers
- e2b · [email protected]