ipython-postfix-completion 0.1.1

Configurable postfix completion extension for IPython.

IPython Postfix Completion

Configurable postfix completion extension for IPython.

Package on PyPI: ipython-postfix-completion

Install

Install into the current Python environment with uv:

uvx --with ipython-postfix-completion ipython

Install into the current ipython environment with uv:

uv tool install ipython --with ipython-postfix-completion

Load

Inside IPython:

%load_ext ipython_postfix_completion

To load it automatically, add this to ipython_config.py:

c.InteractiveShellApp.extensions = ["ipython_postfix_completion"]

Quick Example: Add a for Template

Add a template for the current IPython session:

%postfix_template add for "for item in {expr}:\n{indent}    "

Use it:

items.for<Tab>

It expands to:

for item in items:
    

Runtime templates only affect the current IPython session. Put templates in ipython_config.py if you want them to persist.

Runtime Magic

List effective templates:

%postfix_template list

Add or override a template for the current session:

%postfix_template add debug "print({expr}=)"
%postfix_template add forin "for item in {expr}:\n{indent}    "

Disable a template for the current session:

%postfix_template remove tuple

Reset one runtime change:

%postfix_template reset forin

Reset all runtime changes:

%postfix_template reset --all

Persistent Config

Add persistent templates in ipython_config.py:

c.PostfixCompletionConfig.templates = {
    "debug": "print({expr}=)",
    "forin": "for item in {expr}:\n{indent}    ",
}

c.PostfixCompletionConfig.disabled_templates = ["tuple"]

Template names must match [A-Za-z_][A-Za-z0-9_]*.

Templates must include {expr} and may also use {indent}. No other template fields are allowed.

Built-in Templates

Default templates:

Name	Expansion
print	print({expr})
len	len({expr})
not	not {expr}
par	({expr})
var	{expr} =
await	await {expr}
return	return {expr}
if	if {expr}:\n{indent}
while	while {expr}:\n{indent}
raise	raise {expr}
yield	yield {expr}
str	str({expr})
list	list({expr})
set	set({expr})
dict	dict({expr})
tuple	tuple({expr})

Use %postfix_template list in IPython to see the exact effective set, including custom and disabled templates.

Local Validation

Run tests:

uv run --extra test pytest -q

Build and check release artifacts:

uv run --extra dev python -m build
uv run --extra dev python -m twine check dist/*

Validate the wheel in a clean local virtual environment:

uv venv .venv-check
uv pip install --python .venv-check/bin/python dist/*.whl
.venv-check/bin/ipython

Then inside IPython:

%load_ext ipython_postfix_completion
%postfix_template add for "for item in {expr}:\n{indent}    "
%postfix_template list

Publish

Publishing uses GitHub Actions and PyPI Trusted Publishing. Configure the existing PyPI project once under Manage > Publishing > Add a new publisher:

Setting	Value
Owner	fishandsheep
Repository	ipython-postfix-completion
Workflow	publish.yml
Environment	pypi

For each release, update project.version in pyproject.toml, commit and push the change, then create a matching v tag. For example, after changing the version to 0.1.1:

git tag v0.1.1
git push origin v0.1.1

The workflow verifies the tag against project.version, runs tests, builds and checks both distributions, then publishes them to PyPI using a short-lived OIDC credential. The already-published 0.1.0 release cannot be uploaded again.