ipython-postfix-completion 0.1.0__tar.gz

ipython_postfix_completion-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, IPython Postfix Completion Contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

ipython_postfix_completion-0.1.0/MANIFEST.in

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

ipython_postfix_completion-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: ipython-postfix-completion
+Version: 0.1.0
+Summary: Configurable postfix completion extension for IPython.
+Author: IPython Postfix Completion Contributors
+License-Expression: BSD-3-Clause
+Keywords: ipython,completion,postfix,extension
+Classifier: Framework :: IPython
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: 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: traitlets>=5.13
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: ipython-postfix-completion[test]; extra == "dev"
+Dynamic: license-file
+
+# IPython Postfix Completion
+
+Configurable postfix completion extension for IPython.
+
+## Install
+
+From a local checkout:
+
+```bash
+python -m pip install -e .
+```
+
+From PyPI after publishing:
+
+```bash
+python -m pip install ipython-postfix-completion
+```
+
+## Load
+
+Inside IPython:
+
+```python
+%load_ext ipython_postfix_completion
+```
+
+To load it automatically, add this to `ipython_config.py`:
+
+```python
+c.InteractiveShellApp.extensions = ["ipython_postfix_completion"]
+```
+
+## Runtime Templates
+
+Add a template for the current session:
+
+```python
+%postfix_template add forin "for item in {expr}:\n{indent}    "
+```
+
+Use it:
+
+```python
+items.forin<Tab>
+```
+
+This expands to:
+
+```python
+for item in items:
+    
+```
+
+List effective templates:
+
+```python
+%postfix_template list
+```
+
+Disable a template for the current session:
+
+```python
+%postfix_template remove tuple
+```
+
+Reset one runtime change:
+
+```python
+%postfix_template reset forin
+```
+
+Reset all runtime changes:
+
+```python
+%postfix_template reset --all
+```
+
+## Persistent Config
+
+Add persistent templates in `ipython_config.py`:
+
+```python
+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.
+
+## Development
+
+Run tests:
+
+```bash
+python -m pip install -e ".[test]"
+python -m pytest
+```
+
+Build release artifacts:
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+```
+
+Publish to TestPyPI:
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+Publish to PyPI:
+
+```bash
+python -m twine upload dist/*
+```

ipython_postfix_completion-0.1.0/README.md

@@ -0,0 +1,122 @@
+# IPython Postfix Completion
+
+Configurable postfix completion extension for IPython.
+
+## Install
+
+From a local checkout:
+
+```bash
+python -m pip install -e .
+```
+
+From PyPI after publishing:
+
+```bash
+python -m pip install ipython-postfix-completion
+```
+
+## Load
+
+Inside IPython:
+
+```python
+%load_ext ipython_postfix_completion
+```
+
+To load it automatically, add this to `ipython_config.py`:
+
+```python
+c.InteractiveShellApp.extensions = ["ipython_postfix_completion"]
+```
+
+## Runtime Templates
+
+Add a template for the current session:
+
+```python
+%postfix_template add forin "for item in {expr}:\n{indent}    "
+```
+
+Use it:
+
+```python
+items.forin<Tab>
+```
+
+This expands to:
+
+```python
+for item in items:
+    
+```
+
+List effective templates:
+
+```python
+%postfix_template list
+```
+
+Disable a template for the current session:
+
+```python
+%postfix_template remove tuple
+```
+
+Reset one runtime change:
+
+```python
+%postfix_template reset forin
+```
+
+Reset all runtime changes:
+
+```python
+%postfix_template reset --all
+```
+
+## Persistent Config
+
+Add persistent templates in `ipython_config.py`:
+
+```python
+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.
+
+## Development
+
+Run tests:
+
+```bash
+python -m pip install -e ".[test]"
+python -m pytest
+```
+
+Build release artifacts:
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+```
+
+Publish to TestPyPI:
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+Publish to PyPI:
+
+```bash
+python -m twine upload dist/*
+```