Gitconfig - includeIf Conditions in Four Flavours
Every conditional-include form git supports — path prefix, case-insensitive path prefix, branch glob, and a condition on an existing remote URL — plus one unconditional include. Order matters: a later include overrides an earlier one, so a parser that gathers includes into a set rather than a list resolves the wrong identity.
[user]
name = Ada Fernsby
email = ada.fernsby@example.invalid
# Later includes win, and an includeIf is evaluated where it appears — moving one
# of these blocks changes which identity a repository ends up with.
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir/i:~/Work/"]
path = ~/.gitconfig-work
[includeIf "onbranch:release/**"]
path = ~/.gitconfig-release
[includeIf "hasconfig:remote.*.url:ssh://git@git.example.invalid/**"]
path = ~/.gitconfig-internal
[include]
path = ~/.gitconfig-aliases
Specifications
- Seed
- 20260807
- Repository Name
- ~/.gitconfig
- Includes
- 5
- Conditional Includes
- 4
- Conditions
- gitdir, gitdir/i, onbranch, hasconfig
- Line Endings
- LF
- Encoding
- UTF-8
Testing contract
Expected to pass- Scenario
- Resolve user.email for a repository under ~/work while checked out on release/4.3.
- Expected result
- Includes are applied in file order, so the last matching include wins; a set-based implementation that loses the ordering resolves a different identity.
What is a .gitconfig file?
A .gitconfig file holds Git configuration in an INI-like syntax: bracketed section headers, optional subsection names in quotes, and `key = value` pairs. The same grammar serves the system, global, and per-repository files, which are layered in that order, and values may be booleans, integers with `k`/`m`/`g` suffixes, colours, or paths. Comments begin with `#` or `;`.
How to use this file
Use an example .gitconfig file to test INI-style configuration parsers and Git tooling, checking quoted subsection names, value continuation, boolean coercion, and precedence when the same key appears more than once.
How to use this file for testing
“Gitconfig - includeIf Conditions in Four Flavours” is a deterministic Novus Examples fixture for Config parsing, Config testing, Visual diff / regression. TOML and INI configuration files with nested sections and typed values — for testing config parsers and loaders.
Documented properties for this file: seed 20260807 · UTF-8 · LF. Compare results against paired or grouped companions on this page when present (clean↔damaged, searchable↔scanned, or format twins) so scores stay reproducible across runs.
Download the file once, keep the path stable in CI or local scripts, and treat the spec table as the contract: dimensions, seeds, field lists, and roles are intentional. Corrupt or invalid samples are labelled as such — expect parsers to fail loudly rather than silently accept them.
Diff and patch fixtures name their target paths and the exact edge case they exercise — rename, mode change, binary hunk, CRLF↔LF, or missing trailing newline. Apply or render them against the documented before-state; every author, path, and hash is fictional.
Point your config loader at the file and assert it reads the documented sections and typed values, including any deliberately-tricky nesting or comments.
Related files
- txtCODEOWNERS - Overlapping Globs With Documented WinnersDeliberately overlapping rules so every interesting path matches two or three of them, which is the only way to test that a resolver applies last-match-wins rather than most-specific-wins. One rule has no owners at all, which clears inherited ownership instead of adding any.
- gitattributesGitattributes - LFS Filters, Linguist Hints and export-ignoreThe non-EOL half of the format: LFS filter/diff/merge triples, `linguist-generated` and `linguist-vendored` hints that hide files from language statistics and review, `export-ignore` entries that drop paths from `git archive`, and a `merge=union` driver for an append-only changelog. Attribute values are unquoted and space-separated, so column alignment is whitespace a parser must collapse.
- gitconfigGitconfig - Sections, Quoted Subsections and Shell AliasesA realistic global config exercising the whole INI-like grammar: bracketed sections, quoted subsection names that are case-sensitive while section names are not, values with size suffixes, a shell alias whose leading `!` changes how the rest is executed, and both comment characters.
- gitignoreGitignore - Escaped #, !, Bracket and Trailing SpaceEvery escape the format defines, including the one nobody expects: a trailing space is stripped from a pattern unless it is backslash-escaped, so `draft\ ` and `draft` ignore different files. Editors that trim trailing whitespace on save silently change what this file means.
- gitignoreGitignore - Globstar, Anchors and Character ClassesOne pattern per rule in the gitignore grammar: a leading slash that anchors to the containing directory, the same name unanchored, `**` in all three positions, `?` and `[...]` classes, and a trailing slash that matches only directories. Every line is a separate assertion for a matcher's test suite.
- gitignoreGitignore - Negation After a Directory Exclusion (No Effect)The single most misunderstood rule in the format: once `build/` excludes a directory, git does not descend into it, so `!build/keep.txt` is dead. The file is valid and the behaviour is documented — it is the author's expectation that is wrong, which is exactly why an ignore-matcher must reproduce it rather than being helpful.
Generated by generation/version_control.py. Free for any use, no attribution required — license.