ipython-postfix-completion 0.1.1__tar.gz → 0.2.0__tar.gz

ipython_postfix_completion-0.2.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+## [0.2.0] - 2026-08-09
+
+### Added
+
+- Smart Tab navigation over Python string and bracket closing tokens.
+- Editable `key` placeholder for the built-in `.var` template.
+- Runtime configuration for enabling or disabling Smart Tab.
+- CI coverage for Python 3.11–3.14 and IPython 9.x.
+
+### Changed
+
+- `.var` now expands `expr.var` to `key = expr` and selects `key`.
+- Smart Tab navigation is enabled by default in terminal IPython.
+- IPython 10+ is not currently supported.
+
+### Migration from 0.1.x
+
+The `.var` expansion changed from `expr = ` to `key = expr`. Users who
+depend on the old cursor position or assignment shape should keep using a
+custom template until they migrate.
+
+## [0.1.1] - 2026-07-10
+
+- Added the `.var` and `.await` templates.
+
+## [0.1.0] - 2026-07-05
+
+- Initial release.

{ipython_postfix_completion-0.1.1 → ipython_postfix_completion-0.2.0}/MANIFEST.in

@@ -1,3 +1,4 @@
 include LICENSE
 include README.md
+include CHANGELOG.md
 recursive-include tests *.py

{ipython_postfix_completion-0.1.1/ipython_postfix_completion.egg-info → ipython_postfix_completion-0.2.0}/PKG-INFO

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: ipython-postfix-completion
-Version: 0.1.1
+Version: 0.2.0
 Summary: Configurable postfix completion extension for IPython.
 Author: IPython Postfix Completion Contributors
 License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/fishandsheep/ipython-postfix-completion
+Project-URL: Repository, https://github.com/fishandsheep/ipython-postfix-completion
+Project-URL: Issues, https://github.com/fishandsheep/ipython-postfix-completion/issues
+Project-URL: Changelog, https://github.com/fishandsheep/ipython-postfix-completion/blob/main/CHANGELOG.md
 Keywords: ipython,completion,postfix,extension
 Classifier: Framework :: IPython
 Classifier: Intended Audience :: Developers
@@ -12,16 +16,19 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: ipython>=9.0
+Requires-Dist: ipython<10,>=9.0
 Requires-Dist: traitlets>=5.13
 Provides-Extra: test
 Requires-Dist: pytest>=7; extra == "test"
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: ipython-postfix-completion[test]; extra == "dev"
 Dynamic: license-file
@@ -60,6 +67,10 @@ To load it automatically, add this to `ipython_config.py`:
 c.InteractiveShellApp.extensions = ["ipython_postfix_completion"]
 ```
 
+Smart Tab key bindings are supported in terminal IPython. Postfix matcher
+completion can also work in other IPython frontends, but this package does not
+promise frontend-specific Tab behavior outside the terminal.
+
 ## Quick Example: Add a `for` Template
 
 Add a template for the current IPython session:
@@ -130,11 +141,59 @@ c.PostfixCompletionConfig.templates = {
 c.PostfixCompletionConfig.disabled_templates = ["tuple"]
 ```
 
+Smart Tab jump is enabled by default. Disable it while keeping postfix
+completion with:
+
+```python
+c.PostfixCompletionConfig.smart_tab_jump = False
+```
+
 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.
 
+## `.var` Placeholder
+
+The built-in `.var` template creates an assignment and selects `key` as an
+editable placeholder:
+
+```text
+"hello".var<Tab>  ->  key = "hello"
+                       ^^^ selected
+```
+
+While `key` remains selected:
+
+- Tab accepts `key` and moves cursor to the end of the assignment.
+- Enter behaves like Tab for this selection only; press Enter again to submit.
+- Any other typed text replaces `key` with a custom variable name.
+
+In 0.1.x, `.var` produced `expr = ` with the cursor after the assignment
+target. Version 0.2.0 changes this to `key = expr` with an editable
+placeholder; use a custom template if you need the old behavior.
+
+## Smart Tab Jump
+
+When cursor is immediately before a valid Python closing token, Tab moves over
+it without changing source text. Repeated Tab presses exit nested constructs:
+
+```text
+"hello|"                 -> "hello"|
+print("hello|")          -> print("hello"|) -> print("hello")|
+print(f"{name|}")        -> print(f"{name}|") -> print(f"{name}"|) -> print(f"{name}")|
+items[index|]            -> items[index]|
+list[dict[str, int|]]    -> list[dict[str, int]|] -> list[dict[str, int]]|
+{"name": value|}         -> {"name": value}|
+```
+
+`|` marks cursor and is not typed. Supported closers are single and triple
+quotes plus `)`, `]`, and `}`. Detection follows Python tokens, including
+multiline input, string prefixes, and f-string expressions. Tab still accepts
+the `.var` name selection or an exact postfix template first; otherwise it
+falls back to IPython completion or indentation. Ambiguous `< >`, colon, and
+comma are intentionally excluded.
+
 ## Built-in Templates
 
 Default templates:
@@ -145,7 +204,7 @@ Default templates:
 | `len` | `len({expr})` |
 | `not` | `not {expr}` |
 | `par` | `({expr})` |
-| `var` | `{expr} = ` |
+| `var` | `key = {expr}`; selects `key`; Tab or Enter accepts it |
 | `await` | `await {expr}` |
 | `return` | `return {expr}` |
 | `if` | `if {expr}:\n{indent}    ` |
@@ -167,6 +226,9 @@ Run tests:
 
 ```bash
 uv run --extra test pytest -q
+uv run --extra dev ruff check .
+uv run --extra dev ruff format --check .
+uv run --isolated --no-project --with "ipython>=9,<10" --with "traitlets>=5.13" --with "pip-audit>=2.7" pip-audit --strict --local
 ```
 
 Build and check release artifacts:
@@ -205,14 +267,16 @@ existing PyPI project once under **Manage > Publishing > Add a new publisher**:
 | 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`:
+the change, then create a matching `v` tag. For this release:
 
 ```bash
-git tag v0.1.1
-git push origin v0.1.1
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
 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.
+credential. PyPI versions are immutable: never reuse a published version or tag;
+fixes require the next version.
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes and migration guidance.

{ipython_postfix_completion-0.1.1 → ipython_postfix_completion-0.2.0}/README.md

@@ -32,6 +32,10 @@ To load it automatically, add this to `ipython_config.py`:
 c.InteractiveShellApp.extensions = ["ipython_postfix_completion"]
 ```
 
+Smart Tab key bindings are supported in terminal IPython. Postfix matcher
+completion can also work in other IPython frontends, but this package does not
+promise frontend-specific Tab behavior outside the terminal.
+
 ## Quick Example: Add a `for` Template
 
 Add a template for the current IPython session:
@@ -102,11 +106,59 @@ c.PostfixCompletionConfig.templates = {
 c.PostfixCompletionConfig.disabled_templates = ["tuple"]
 ```
 
+Smart Tab jump is enabled by default. Disable it while keeping postfix
+completion with:
+
+```python
+c.PostfixCompletionConfig.smart_tab_jump = False
+```
+
 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.
 
+## `.var` Placeholder
+
+The built-in `.var` template creates an assignment and selects `key` as an
+editable placeholder:
+
+```text
+"hello".var<Tab>  ->  key = "hello"
+                       ^^^ selected
+```
+
+While `key` remains selected:
+
+- Tab accepts `key` and moves cursor to the end of the assignment.
+- Enter behaves like Tab for this selection only; press Enter again to submit.
+- Any other typed text replaces `key` with a custom variable name.
+
+In 0.1.x, `.var` produced `expr = ` with the cursor after the assignment
+target. Version 0.2.0 changes this to `key = expr` with an editable
+placeholder; use a custom template if you need the old behavior.
+
+## Smart Tab Jump
+
+When cursor is immediately before a valid Python closing token, Tab moves over
+it without changing source text. Repeated Tab presses exit nested constructs:
+
+```text
+"hello|"                 -> "hello"|
+print("hello|")          -> print("hello"|) -> print("hello")|
+print(f"{name|}")        -> print(f"{name}|") -> print(f"{name}"|) -> print(f"{name}")|
+items[index|]            -> items[index]|
+list[dict[str, int|]]    -> list[dict[str, int]|] -> list[dict[str, int]]|
+{"name": value|}         -> {"name": value}|
+```
+
+`|` marks cursor and is not typed. Supported closers are single and triple
+quotes plus `)`, `]`, and `}`. Detection follows Python tokens, including
+multiline input, string prefixes, and f-string expressions. Tab still accepts
+the `.var` name selection or an exact postfix template first; otherwise it
+falls back to IPython completion or indentation. Ambiguous `< >`, colon, and
+comma are intentionally excluded.
+
 ## Built-in Templates
 
 Default templates:
@@ -117,7 +169,7 @@ Default templates:
 | `len` | `len({expr})` |
 | `not` | `not {expr}` |
 | `par` | `({expr})` |
-| `var` | `{expr} = ` |
+| `var` | `key = {expr}`; selects `key`; Tab or Enter accepts it |
 | `await` | `await {expr}` |
 | `return` | `return {expr}` |
 | `if` | `if {expr}:\n{indent}    ` |
@@ -139,6 +191,9 @@ Run tests:
 
 ```bash
 uv run --extra test pytest -q
+uv run --extra dev ruff check .
+uv run --extra dev ruff format --check .
+uv run --isolated --no-project --with "ipython>=9,<10" --with "traitlets>=5.13" --with "pip-audit>=2.7" pip-audit --strict --local
 ```
 
 Build and check release artifacts:
@@ -177,14 +232,16 @@ existing PyPI project once under **Manage > Publishing > Add a new publisher**:
 | 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`:
+the change, then create a matching `v` tag. For this release:
 
 ```bash
-git tag v0.1.1
-git push origin v0.1.1
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
 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.
+credential. PyPI versions are immutable: never reuse a published version or tag;
+fixes require the next version.
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes and migration guidance.