---
id: sceptre-file-resolver
version: "1.0.6"
license: Apache2
license_treatment: permissive
maintenance: active
---

# sceptre-file-resolver — A Sceptre resolver to retrieve file content

License: permissive · Maintenance: active · Downloads: 115.1K/mo

## What it is and what it does

This package extends Sceptre, a CloudFormation orchestration tool, with a file resolver that injects file contents directly into stack parameters. Unlike Sceptre's built-in file_contents resolver, which only handles plain text, this resolver automatically detects file type by extension and parses JSON and YAML files into structured objects, passing them to parameters as native types. It also supports fetching files from remote URLs via HTTP, making it useful for pulling configuration from S3 buckets or other web sources.

You use it by adding a YAML tag `!file` to parameter definitions in your Sceptre stack configs, pointing to either a local file path or a URL. The resolver handles the fetch and parse transparently, so your CloudFormation templates receive properly typed data without manual conversion steps.

Use it for:

- Load JSON configuration objects from S3 into CloudFormation stack parameters without manual parsing.
- Inject YAML-formatted tag lists or metadata into stack parameters from a shared repository file.
- Fetch remote policy documents or template snippets from a URL and pass them as strings to parameters.
- Parameterize CloudFormation stacks with structured data from local files during deployment.
- Centralize configuration management by referencing external JSON/YAML files in Sceptre stack definitions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Sceptre resolver plugin that retrieves file contents from local paths or URLs and parses them as strings, JSON, or YAML objects based on file extension.

Yes, if you use Sceptre and need to inject structured file contents (JSON, YAML) or remote files into CloudFormation parameters. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it a safe addition. Not relevant if you only use plain-text file injection or do not use Sceptre.

## Install

pip install sceptre-file-resolver
uv add sceptre-file-resolver
poetry add sceptre-file-resolver

## Installing sceptre-file-resolver

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained as of 2026-08-10 with no known vulnerabilities. Depends on requests and sceptre, both widely used packages.

License in practice: Licensed under Apache2 (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install sceptre-file-resolver

# In a Sceptre config YAML:
parameters:
  config_data: !file path/to/config.json
  tags: !file https://example.com/tags.yaml

Requires sceptre to be installed and configured; the resolver is registered as a Sceptre plugin and only works within Sceptre stack configurations.

Verify before relying:

- Whether remote file fetching supports authentication (API keys, headers, or credentials).
- Error handling behavior when files are missing, malformed, or network requests fail.
- Support for Python versions beyond 3.6 and 3.7 (classifiers list only those two).

## Package facts

- License: Apache2 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 115.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sceptre resolver file contents, load json yaml from file sceptre, remote file resolver cloudformation, sceptre parameter file injection, fetch url contents sceptre, file resolver plugin sceptre, cloudformation, sceptre-plugin, infrastructure-as-code

[View on SkillFed](https://skillfed.io/packages/sceptre-file-resolver) · [View on PyPI](https://pypi.org/project/sceptre-file-resolver/)