fprime-fpp-format

A formatter for the F Prime Prime (FPP) modeling language.

This package ships the fpp-format executable, a pretty-printer for .fpp source files.

Usage

# Format files in place
fpp-format path/to/model.fpp

# Check formatting without modifying (exit 1 if not formatted)
fpp-format --check path/to/model.fpp

# Format from stdin to stdout
cat path/to/model.fpp | fpp-format --stdin

# Override the indentation width and maximum line length
fpp-format --indent 4 --line-length 100 path/to/model.fpp

Options

Option	Description
`--check`	Check formatting without writing; exit `1` if a file is unformatted.
`--stdin`	Read from stdin and write to stdout (default when no files given).
`--recursive-includes`	Also follow `include` specifiers and format reachable `.fppi` fragments.
`--indent <N>`	Number of spaces per indentation level. Overrides `.fpp-format` (default: `2`).
`--line-length <N>`	Maximum line width before specs explode their clauses. Overrides `.fpp-format` (default: `80`).
`--entry <RULE>`	Select the parser entrypoint / grammar rule (see below).
`--help`	Print usage.

Configuration file (`.fpp-format`)

The indentation width and maximum line length can be set project-wide in a .fpp-format file. Starting from each formatted file's directory, fpp-format searches upward through parent directories for the nearest .fpp-format file (the same discovery model as .clang-format). The same file is honored by fprime-util format and by the language server's format-on-save, so the editor and CI always agree.

The file is a minimal key = value list; blank lines and # comments are ignored:

# .fpp-format
indent = 2
line-length = 80

Supported keys:

Key	Description	Default
`indent`	Spaces per indentation level.	`2`
`line-length`	Maximum line width before clauses break.	`80`

Precedence, lowest to highest: built-in defaults → .fpp-format file → --indent / --line-length command-line flags. A malformed .fpp-format file is a hard error on the command line (to avoid formatting with the wrong profile and reporting false --check failures); the language server logs it and falls back to defaults so an editor save never fails.

Entrypoint rule (`--entry`)

The formatter parses input starting from a specific grammar rule. A whole .fpp file is a module (the default), but other rules are needed when formatting include fragments.

Supported rules:

module (default)
component
topology
tlm-packet
tlm-packet-set

Recursive include formatting (`--recursive-includes`)

By default fpp-format formats only the files you name and does not touch .fppi fragments referenced via include. Pass --recursive-includes to also follow every include specifier and format the referenced fragments (recursively):

# Formats model.fpp and every .fppi it (transitively) includes
fpp-format --recursive-includes path/to/model.fpp

With --recursive-includes, include paths are resolved relative to the including file (matching the parser), each fragment is formatted exactly once even if included from several places, and include cycles are detected and reported as an error. The entrypoint for each fragment is derived from the context of its include — a fragment included in a component { ... } body is formatted as component members, one in a topology { ... } body as topology members, and so on, so you do not need --entry for fragments reached this way.

State-machine includes have no standalone entrypoint and are left untouched.

Note: the language-server integration never follows includes; it only ever formats the current document buffer.

Formatting a bare `.fppi` file

An .fppi file is not a standalone module — it is a fragment that is spliced in via an include specifier. When you format a fragment directly (rather than reaching it from a root .fpp), there is no include context to infer the rule from, so pass --entry to select the matching entrypoint:

# An .fppi included inside a `module { ... }` body (module-level members)
fpp-format --entry module commands.fppi

# An .fppi included inside a `component { ... }` body
fpp-format --entry component ports.fppi

# An .fppi included inside a `topology { ... }` body
fpp-format --entry topology connections.fppi

If you omit --entry, the module rule is used, which is correct for normal .fpp files and for .fppi fragments containing module-level members.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fprime_fpp_format-3.3.8.tar.gz (123.6 kB view details)

Uploaded Aug 20, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fprime_fpp_format-3.3.8-py3-none-win_amd64.whl (418.7 kB view details)

Uploaded Aug 20, 2026 Python 3Windows x86-64

fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (517.0 kB view details)

Uploaded Aug 20, 2026 Python 3manylinux: glibc 2.17+ x86-64

fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl (471.4 kB view details)

Uploaded Aug 20, 2026 Python 3macOS 11.0+ ARM64

File details

Details for the file fprime_fpp_format-3.3.8.tar.gz.

File metadata

Download URL: fprime_fpp_format-3.3.8.tar.gz
Upload date: Aug 20, 2026
Size: 123.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fprime_fpp_format-3.3.8.tar.gz
Algorithm	Hash digest
SHA256	`f5c4137382104968b06bebc468f87ffea994c01c4cba727599ae5fc229343822`
MD5	`efaa3f2258a8638ad0f15d4ae5ebfd70`
BLAKE2b-256	`5e8582bdd2c3bf1ec3c1d8bc668ce92fd2ee332eec4e8aedddf2b30b0ed7ac92`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fprime_fpp_format-3.3.8.tar.gz:

Publisher: pip.yml on fprime-community/fpp-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fprime_fpp_format-3.3.8.tar.gz
- Subject digest: f5c4137382104968b06bebc468f87ffea994c01c4cba727599ae5fc229343822
- Sigstore transparency entry: 2538861693
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: fprime-community/fpp-tools@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Branch / Tag: refs/tags/v3.3.8
- Owner: https://github.com/fprime-community
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pip.yml@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Trigger Event: release

File details

Details for the file fprime_fpp_format-3.3.8-py3-none-win_amd64.whl.

File metadata

Download URL: fprime_fpp_format-3.3.8-py3-none-win_amd64.whl
Upload date: Aug 20, 2026
Size: 418.7 kB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fprime_fpp_format-3.3.8-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`f8750d813870b39abafd7220e716f4ed53da5a91f0ec744d3a876d99bec02e2b`
MD5	`492362f32af2018425d71f4a21a72b62`
BLAKE2b-256	`3e23b2b856170ff13082b782a8a0d3b790b9a924f2219ede8b1c31669b51d538`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fprime_fpp_format-3.3.8-py3-none-win_amd64.whl:

Publisher: pip.yml on fprime-community/fpp-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fprime_fpp_format-3.3.8-py3-none-win_amd64.whl
- Subject digest: f8750d813870b39abafd7220e716f4ed53da5a91f0ec744d3a876d99bec02e2b
- Sigstore transparency entry: 2538861792
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: fprime-community/fpp-tools@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Branch / Tag: refs/tags/v3.3.8
- Owner: https://github.com/fprime-community
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pip.yml@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Trigger Event: release

File details

Details for the file fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Aug 20, 2026
Size: 517.0 kB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`3cb4f755a36f2cf55f3b9e00dc449b394868f10802eb856af95ae002bf044feb`
MD5	`74dc4388c9acb883e29e4d27bd1bc366`
BLAKE2b-256	`e76493feb6cb357ed564c36f655213a293a9349e264c813664f4bdb488eeb54c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: pip.yml on fprime-community/fpp-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fprime_fpp_format-3.3.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 3cb4f755a36f2cf55f3b9e00dc449b394868f10802eb856af95ae002bf044feb
- Sigstore transparency entry: 2538861948
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: fprime-community/fpp-tools@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Branch / Tag: refs/tags/v3.3.8
- Owner: https://github.com/fprime-community
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pip.yml@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Trigger Event: release

File details

Details for the file fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 20, 2026
Size: 471.4 kB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`5199b8be97f6836c4962f3f6b09408fb1a8bd7c6faa3fcd12ab697dce8aaa046`
MD5	`4fec06fad796395ec69c1594eddf8052`
BLAKE2b-256	`588041e780812dfbe2e2be52b57c36be3a25250f3d26fa602fcb89bb03a8b29e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl:

Publisher: pip.yml on fprime-community/fpp-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fprime_fpp_format-3.3.8-py3-none-macosx_11_0_arm64.whl
- Subject digest: 5199b8be97f6836c4962f3f6b09408fb1a8bd7c6faa3fcd12ab697dce8aaa046
- Sigstore transparency entry: 2538861873
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: fprime-community/fpp-tools@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Branch / Tag: refs/tags/v3.3.8
- Owner: https://github.com/fprime-community
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pip.yml@d86868ce5d3fbc02475705ffecac40cd8ea101e4
- Trigger Event: release