fakesshagent 0.1__tar.gz

fakesshagent-0.1/.gitignore

@@ -0,0 +1,7 @@
+html/
+.mypy_cache/
+.pytest_cache/
+__pycache__/
+*.swp
+.coverage*
+.hypothesis/

fakesshagent-0.1/.gitmodules

@@ -0,0 +1,4 @@
+[submodule "docs/wishlist"]
+	path = docs/wishlist
+	url = ./
+	branch = wishlist

fakesshagent-0.1/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

fakesshagent-0.1/CHANGELOG.md

@@ -0,0 +1 @@
+(See docs/ directory.)

fakesshagent-0.1/LICENSE.txt

@@ -0,0 +1,13 @@
+zlib License
+
+Copyright 2026 Marco Ricci <software@the13thletter.info>
+
+This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
+
+ 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
+
+ 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
+
+ 3. This notice may not be removed or altered from any source distribution.

fakesshagent-0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.5
+Name: fakesshagent
+Version: 0.1
+Summary: A non-hardened implementation of the SSH agent protocol, for use in testing.
+Project-URL: Documentation, https://the13thletter.info/fakesshagent/
+Project-URL: Issues, https://the13thletter.info/fakesshagent/latest/wishlist/
+Project-URL: Source, https://git.schokokeks.org/fakesshagent.git
+Author-email: Marco Ricci <software@the13thletter.info>
+License-Expression: Zlib
+License-File: LICENSE.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+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: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: derivepassphrase-sshagentsocketprovider>=1.0
+Requires-Dist: typing-extensions
+Provides-Extra: dev
+Requires-Dist: coverage-enable-subprocess>=1.0; extra == 'dev'
+Requires-Dist: coverage[toml]>=7.4; extra == 'dev'
+Requires-Dist: hatch>=1.10; extra == 'dev'
+Requires-Dist: hypothesis!=6.130.13,!=6.131.*,!=6.132.*,!=6.133.*,!=6.134.*,!=6.135.0,!=6.135.1; (python_version < '3.10') and extra == 'dev'
+Requires-Dist: hypothesis<6.156; (platform_python_implementation == 'PyPy' and python_version < '3.11') and extra == 'dev'
+Requires-Dist: hypothesis>=6.131.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: packaging; extra == 'dev'
+Requires-Dist: pytest-randomly>=3.15; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6.0; extra == 'dev'
+Requires-Dist: pytest-xdist[psutil]>=3.6.0; (platform_python_implementation != 'PyPy') and extra == 'dev'
+Requires-Dist: pytest<8.4; (python_version < '3.10') and extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.16.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# fakesshagent
+
+[![PyPI - Version](https://img.shields.io/pypi/v/fakesshagent.svg)](https://pypi.org/project/fakesshagent)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fakesshagent.svg)](https://pypi.org/project/fakesshagent)
+
+A non-hardened implementation of the SSH agent protocol, for use in testing.
+
+`fakesshagent` was originally written to test [`derivepassphrase`][DERIVEPASSPHRASE]'s SSH agent interactions.
+As such, `fakesshagent` also registers as an abstract SSH agent socket provider for [`derivepassphrase`][DERIVEPASSPHRASE].
+(The implementation is based on memory buffers, not external I/O with sockets.)
+
+In this first release, `fakesshagent` provides exactly the operations needed for use with `derivepassphrase`:
+listing available keys, and deterministically signing a fixed message (if possible with this key type), for a set of known test keys.
+See the wishlist for planned features of subsequent releases.
+
+[DERIVEPASSPHRASE]: https://the13thletter.info/derivepassphrase/
+
+-----
+
+## Installation
+
+`fakesshagent` is a pure Python package, and may be easily installed with any `pip`-compatible Python package manager such as `pip`, `pipx`, or `uv`.
+
+```console
+pip install fakesshagent
+```
+
+`fakesshagent` requires Python 3.9 or higher as well as the [typing-extensions package][TYPING_EXTENSIONS] and the [`derivepassphrase-sshagentsocketprovider` package][SASP] for its core functionality and programmatic interface.
+
+[TYPING_EXTENSIONS]: https://pypi.org/project/typing-extensions/
+[SASP]: https://pypi.org/project/derivepassphrase-sshagentsocketprovider/
+
+## License
+
+`fakesshagent` is distributed under the terms of the [zlib/libpng](https://spdx.org/licenses/Zlib.html) license.

fakesshagent-0.1/README.md

@@ -0,0 +1,35 @@
+# fakesshagent
+
+[![PyPI - Version](https://img.shields.io/pypi/v/fakesshagent.svg)](https://pypi.org/project/fakesshagent)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fakesshagent.svg)](https://pypi.org/project/fakesshagent)
+
+A non-hardened implementation of the SSH agent protocol, for use in testing.
+
+`fakesshagent` was originally written to test [`derivepassphrase`][DERIVEPASSPHRASE]'s SSH agent interactions.
+As such, `fakesshagent` also registers as an abstract SSH agent socket provider for [`derivepassphrase`][DERIVEPASSPHRASE].
+(The implementation is based on memory buffers, not external I/O with sockets.)
+
+In this first release, `fakesshagent` provides exactly the operations needed for use with `derivepassphrase`:
+listing available keys, and deterministically signing a fixed message (if possible with this key type), for a set of known test keys.
+See the wishlist for planned features of subsequent releases.
+
+[DERIVEPASSPHRASE]: https://the13thletter.info/derivepassphrase/
+
+-----
+
+## Installation
+
+`fakesshagent` is a pure Python package, and may be easily installed with any `pip`-compatible Python package manager such as `pip`, `pipx`, or `uv`.
+
+```console
+pip install fakesshagent
+```
+
+`fakesshagent` requires Python 3.9 or higher as well as the [typing-extensions package][TYPING_EXTENSIONS] and the [`derivepassphrase-sshagentsocketprovider` package][SASP] for its core functionality and programmatic interface.
+
+[TYPING_EXTENSIONS]: https://pypi.org/project/typing-extensions/
+[SASP]: https://pypi.org/project/derivepassphrase-sshagentsocketprovider/
+
+## License
+
+`fakesshagent` is distributed under the terms of the [zlib/libpng](https://spdx.org/licenses/Zlib.html) license.

fakesshagent-0.1/docs/Keep_a_changelog-E05735.svg

@@ -0,0 +1,2 @@
+<!-- Originally downloaded from https://img.shields.io/badge/Keep-a-changelog-E05735?logoColor=fff&logo=keepachangelog&logoSize=auto on 2024-07-21. Used under CC0, as per https://github.com/badges/shields/blob/1e4c8f54d7743381e723a1ca3f79db7868c2f95e/LICENSE . -->
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="127.21161107182145" height="20" role="img" aria-label="Keep a changelog"><title>Keep a changelog</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="127.21161107182145" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="0" height="20" fill="#555"/><rect x="0" width="127.21161107182145" height="20" fill="#e05735"/><rect width="127.21161107182145" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><image x="5" y="3" width="14.21161107182145" height="14" xlink:href="data:image/svg+xml;base64,PHN2ZyBmaWxsPSIjZmZmIiByb2xlPSJpbWciIHZpZXdCb3g9IjAgMCAyNCAyMy42NDI3NjMyMTAwOTQ4NjYiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHRpdGxlPktlZXAgYSBDaGFuZ2Vsb2c8L3RpdGxlPjxwYXRoIGQ9Ik05LjgwMzEgMC4wMDAzQzkuMTA4MSAtMC4wMDQ3IDguNDEzMSAwLjA2MTMgNy43MjAxIDAuMjAxM0M1LjYzOTEgMC42MTgzIDMuOTc0MSAxLjY0OTMgMi43NzAxIDMuMjY2M0MxLjIzMjEgNS4zMzYzIDAuMzY3MSA3Ljg5MzMgMC4wNDkxIDExLjMxMzNDLTAuMDc1OSAxMi42NjYzIDAuMDU3MSAxNC4wMjQzIDAuMjMwMSAxNS41MjkzQzAuNDI4MyAxNy40MzczIDEuMTcyNyAxOS4yNDc3IDIuMzc0MSAyMC43NDMzQzMuMzA3MSAyMS45MDAzIDQuMzc4MSAyMi42NjAzIDUuNjQ2MSAyMy4wNjczQzYuNzI1MyAyMy40MTU2IDcuODQ4NiAyMy42MDg5IDguOTgyMSAyMy42NDEzQzkuMjQ3NiAyMy42NDcxIDkuNTEzMSAyMy42MzU4IDkuNzc3MSAyMy42MDczTDEwLjE5MzEgMjMuNTY2M0MxMC43Njc0IDIzLjUwOTYgMTEuMzQxMSAyMy40NDc2IDExLjkxNDEgMjMuMzgwM0MxNC40OTUgMjMuMDgyNyAxNy4wMDAxIDIyLjMxNzkgMTkuMzA3MSAyMS4xMjMzQzIxLjMxNDEgMjAuMDc1MyAyMi43MTcxIDE4LjUyOTMgMjMuNDc3MSAxNi41MjYzQzIzLjgzMTEgMTUuNTk2MyAyNC4wMDAxIDE0LjgxMzMgMjQuMDAwMSAxNC4wODEzQzI0IDEzLjgyNTkgMjMuOTc4NiAxMy41NzEgMjMuOTM2MSAxMy4zMTkzQzIzLjUzMTEgMTAuOTQwMyAyMi43MDExIDguODkxMyAyMS4zODExIDcuMDU1M0MxOS43NDcxIDQuNzc5MyAxOC4wOTMxIDMuMTc3MyAxNi4xNzkxIDIuMDEwM0MxMy45OTMxIDAuNjgxMyAxMS44OTAxIDAuMDE0MyA5LjgwMzEgMC4wMDEzWk05LjM2NDEgMS4wNjQzQzEwLjEzNDEgMS4wNDMzIDEwLjkyNDEgMS4xMjIzIDExLjc0MDEgMS4zMDEzSDExLjczOTFDMTQuNDY5MSAxLjg5ODMgMTYuODc2MSAzLjMwMzMgMTguODkzMSA1LjQ3NDNDMjEuMTgxMSA3LjkzNDMgMjIuNDg0MSAxMC41MTkzIDIyLjg4MTEgMTMuMzczM0MyMi45NTIxIDEzLjkwMTMgMjIuODY4MSAxNC40ODczIDIyLjc4NTEgMTQuOTk1M0MyMi4zOTcxIDE3LjMyMjMgMjEuMTIyMSAxOS4wNTgzIDE4Ljk5OTEgMjAuMTU1M0MxNi43NjA1IDIxLjMwNjIgMTQuMzMzMyAyMi4wNDUzIDExLjgzMzEgMjIuMzM3M0MxMS4yNzUxIDIyLjQwMzMgMTAuNzEzMSAyMi40NjAzIDEwLjA3NjEgMjIuNTI0M0w5Ljk4ODEgMjIuNTM0M0M5LjQzNjMgMjIuNTkxNSA4Ljg3OTUgMjIuNTgxNSA4LjMzMDEgMjIuNTA0M0M3LjY0MDEgMjIuNDA2MyA2Ljg1ODEgMjIuMjk0MyA2LjEwNjEgMjIuMTE1M0M0LjMzOTEgMjEuNjk1MyAzLjAzNzEgMjAuNDkzMyAyLjEyODEgMTguNDU3M0MxLjQ0NDEgMTYuOTE5MyAxLjA5MDEgMTUuMjEyMyAxLjA0NzEgMTMuMjI0M0MwLjk4NjUgMTAuOTA1MiAxLjM3NjcgOC41OTY1IDIuMTk2MSA2LjQyNjNDMi44MTYxIDQuNzg1MyAzLjcxMzEgMi45NzMzIDUuNjU4MSAyLjAwODNDNi44MDg3IDEuNDI0MSA4LjA3NDMgMS4xMDE3IDkuMzY0MSAxLjA2NDNaTTEwLjQ3MjEgMi41MzQzQzkuNzA5MyAyLjU1OTggOC45NTQ1IDIuNjk4IDguMjMyMSAyLjk0NDNDNi42MzIxIDMuNDY5MyA1LjUxNDEgNC4yNDgzIDQuNzA5MSA1LjM4MjNDMy4yMTAxIDcuNTAwMyAyLjQzNDEgOS45NjIzIDIuMzk5MSAxMi43MDczQzIuMzM3MiAxNC4yMTE0IDIuNjExNSAxNS43MTA1IDMuMjAyMSAxNy4wOTUzQzQuMjgzMSAxOS42NjQzIDYuMjU1MSAyMS4xNTkzIDguOTA5MSAyMS40MjEzQzExLjcwNTEgMjEuNjkxMyAxNC40NTIxIDIxLjA0MDMgMTcuMDg3MSAxOS40ODQzQzE4LjIwNjUgMTguODQyMiAxOS4xNTY3IDE3Ljk0MjcgMTkuODU5MSAxNi44NjAzQzIwLjYxMzIgMTUuNzEzNCAyMS4wMTg4IDE0LjM3MjcgMjEuMDI3MSAxMy4wMDAzQzIxLjAyNzEgMTAuODM4MyAyMC4wMTIxIDguNTMwMyAxNy45NzgxIDYuMTM4M0MxNy43NjIyIDUuODg0NiAxNy41MjY4IDUuNjQ4MyAxNy4yNzQxIDUuNDMxM0MxNC45NDExIDMuNDI1MyAxMi43MDcxIDIuNDY1MyAxMC40NzIxIDIuNTMzM1pNMTAuNTcxMSAzLjU2OTNDMTIuMDYzMSAzLjU0NzMgMTMuNTg2MSA0LjA0NDMgMTUuMjQzMSA1LjA3NzNDMTcuMDI2MSA2LjE5NDMgMTguNDA0MSA3Ljg0MDMgMTkuMzM0MSA5Ljk4NjNDMjAuMjIxMSAxMi4wMDYzIDIwLjIzOTEgMTMuOTI0MyAxOS4zOTIxIDE1LjY4MjNDMTguNzU5NCAxNi45NTc3IDE3Ljc0MjcgMTguMDAyNyAxNi40ODUxIDE4LjY3MDNDMTQuMjMyMSAxOS45MDIzIDEyLjE3MDEgMjAuNDQ2MyAxMC4wMjcxIDIwLjM4MzNIMTAuMDA1MUM4LjQ1NTEgMjAuNDQzMyA3LjExNTEgMjAuMDYzMyA1LjkwNzEgMTkuMjIwM0M1LjIwNzEgMTguNzMyMyA0LjY2NjEgMTguMDE4MyA0LjI1MjEgMTcuMDM3M0MzLjY3NzYgMTUuNjg1OSAzLjM4MTEgMTQuMjMyNyAzLjM4MDEgMTIuNzY0M0MzLjM5NzkgMTEuMDk0OSAzLjc0NTkgOS40NDU1IDQuNDA0MSA3LjkxMTNDNC42NTQgNy4zNDkzIDQuOTQ2MiA2LjgwNyA1LjI3ODEgNi4yODkzTDUuNDQxMSA2LjAxOTNDNi4xMTExIDQuOTExMyA3LjE2NjEgNC4zODAzIDguNTQ0MSAzLjkyMDNDOS4xOTggMy43MDA4IDkuODgxNiAzLjU4MjggMTAuNTcxMSAzLjU3MDNaTTEwLjYwMTEgNS4xODkzQzkuNDIxMSA1LjIyNjMgOC4zMjExIDUuNjU0MyA3LjMxMjEgNi40NzIzQzUuOTE3MSA3LjYwMjMgNS4wODIxIDkuMTkyMyA0LjY4MjEgMTEuNDY1M0M0LjM5MjcgMTMuMDM1NCA0LjYzMDQgMTQuNjU3MiA1LjM1ODEgMTYuMDc4M0M2LjQyMDEgMTguMTMyMyA4LjE1ODEgMTkuMTg4MyAxMC4zODQxIDE5LjEyODNIMTAuMzkyMUMxMy4zNTAxIDE4Ljk3MzMgMTUuNTAyMSAxNy44NzkzIDE2Ljk2NTEgMTUuNzgxM0MxNy42NDczIDE0LjgzNjEgMTguMDE3OCAxMy43MDE4IDE4LjAyNTEgMTIuNTM2M0MxOC4wMjMxIDExLjk4MTIgMTcuOTQxNiAxMS40MjkyIDE3Ljc4MzEgMTAuODk3M0MxNy4wNjMxIDguNDYyMyAxNS42MjIxIDYuNzUyMyAxMy40OTMxIDUuODEyM0MxMi40ODQxIDUuMzY3MyAxMS41MTkxIDUuMTYwMyAxMC42MDExIDUuMTg4M1pNMTAuOTEzMSA2LjI1MzNDMTEuNjgzMSA2LjI2MTMgMTIuNDYwMSA2LjQ0NDMgMTMuMjYzMSA2LjgwMzNDMTUuMTI1MSA3LjYzNjMgMTYuMzM2MSA5LjEzNTMgMTYuODYxMSAxMS4yNjUzQzE3LjM4NzEgMTMuMzk1MyAxNi41OTExIDE1LjQ3MDMgMTQuNzk1MSAxNi42ODgzQzEzLjMxNjEgMTcuNjg3MyAxMS44NjUxIDE4LjEzNTMgMTAuMzU3MSAxOC4wNTUzSDEwLjMxNzFDOS4zMTMxIDE4LjEzNTMgOC4zMjMxIDE3LjgyOTMgNy4zNzQxIDE3LjE0NTNDNi43ODIgMTYuNzEzNyA2LjMzMjcgMTYuMTE0NiA2LjA4NDEgMTUuNDI1M0M1Ljc0NzggMTQuNTU1MyA1LjU3MzYgMTMuNjMxIDUuNTcwMSAxMi42OTgzQzUuNTgzOSAxMS41MzIyIDUuODM4MiAxMC4zODE1IDYuMzE3MSA5LjMxODNDNi45OTMxIDcuNzYyMyA4LjA0MTEgNi44MTUzIDkuNTMyMSA2LjQyNTNDOS45OTIxIDYuMzA1MyAxMC40NTExIDYuMjQ3MyAxMC45MTIxIDYuMjUzM1pNOS40NTUxIDguNTc5M1YxNS40NjEzSDEwLjYxMDFWMTMuNTUzM0wxMi4yOTAxIDE1LjQ2MTNIMTMuNzUyMUwxMS40NzkxIDEyLjk2MTNMMTMuMzUwMSAxMS4wMDMzSDExLjg0MTFMMTAuNjEwMSAxMi4zNDAzVjguNTc5M1oiLz48L3N2Zz4="/><text aria-hidden="true" x="727.1161107182145" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="990">Keep a changelog</text><text x="727.1161107182145" y="140" transform="scale(.1)" fill="#fff" textLength="990">Keep a changelog</text></g></svg>

fakesshagent-0.1/docs/SemVer-3F4551.svg

@@ -0,0 +1,2 @@
+<!-- Originally downloaded from https://img.shields.io/badge/SemVer-3F4551?logoColor=fff&logo=semver&logoSize=auto on 2024-07-21. Used under CC0, as per https://github.com/badges/shields/blob/1e4c8f54d7743381e723a1ca3f79db7868c2f95e/LICENSE . -->
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="71.00018479842694" height="20" role="img" aria-label="SemVer"><title>SemVer</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="71.00018479842694" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="0" height="20" fill="#555"/><rect x="0" width="71.00018479842694" height="20" fill="#3f4551"/><rect width="71.00018479842694" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><image x="5" y="3" width="14.00018479842695" height="14" xlink:href="data:image/svg+xml;base64,PHN2ZyBmaWxsPSJ3aGl0ZXNtb2tlIiByb2xlPSJpbWciIHZpZXdCb3g9IjAgMCAyNCAyNC4wMDAzNzU5MjkyNjAxNTUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHRpdGxlPlNlbVZlcjwvdGl0bGU+PHBhdGggZD0iTTAuMzU3IDkuMDI0NkMtMC41OTQzIDEyLjg0ODcgMC4zODExIDE2Ljg5NjUgMi45NyAxOS44Njc2QzUuNTU4IDIyLjgzNjkgOS40MzM5IDI0LjM1NCAxMy4zNSAyMy45MzA2QzIxLjExOCAyMy4yMjc2IDI2LjQzNiAxNC4xMzE2IDIyLjg2NyA3LjEzMDZDMjIuNDUxIDUuOTQwNiAyMC43OTcgNi43NjI2IDIwLjk2NCA3LjcyNjZDMjEuMjUxIDguNDI2NiAyMS40OSA5LjE0NzYgMjEuNjc3IDkuODgxNkMyMi41MzI1IDEzLjc3NTcgMjAuOTg5IDE3LjgwNTQgMTcuNzUxIDIwLjEzMTZDMTIuNzA2NiAyMy43NTI1IDUuNjE0OSAyMS45MjgyIDIuOTQ0IDE2LjMyMjZDMS4yMjY3IDEyLjcyNDMgMS44MTQ4IDguNDQ5NCA0LjQ0IDUuNDQ4NkM1LjcyNDEgMy45ODE0IDcuNDEwNCAyLjkyMyA5LjI5IDIuNDA0NkMxMS42Mjc4IDEuNzQzNSAxNC4xMjc0IDEuOTY4MiAxNi4zMSAzLjAzNTZDMTYuNDY2OCAzLjExNTIgMTYuNTM0NyAzLjMwMzEgMTYuNDY1IDMuNDY0NkwxMi41MDMgMTQuMDg0NkMxMi4zOTYgMTQuODk0NiAxMS44MTMgMTQuODcwNiAxMS43MDYgMTQuMDg0Nkw5LjMyNiA2LjcxNDZDOS4yMTY1IDYuMjkyMiA4LjkzNjYgNS45MzQ0IDguNTUzIDUuNzI2NkM3LjM2MyA1LjE2NjYgNS40NiA2LjM5MzYgNi4xNzQgNy44ODE2TDEwLjA4OCAxOC4zMjI2QzEwLjYxMiAxOS43MTU2IDExLjExMSAyMC4xNTY2IDEyLjE0NiAyMC4xNTY2UzEzLjY4MSAxOS43MTY2IDE0LjIwNCAxOC4zMjI2TDIwIDMuOTQwNkMyMC4xNTU5IDMuNTA2IDIwLjAwNTQgMy4wMjA3IDE5LjYzMSAyLjc1MDZDMTMuMSAtMi45MDY0IDIuMzIgMC42NDE2IDAuMzU3IDkuMDIzNloiLz48L3N2Zz4="/><text aria-hidden="true" x="445.0018479842695" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">SemVer</text><text x="445.0018479842695" y="140" transform="scale(.1)" fill="#fff" textLength="430">SemVer</text></g></svg>

fakesshagent-0.1/docs/changelog.md

@@ -0,0 +1,53 @@
+# Changelog for `fakesshagent`
+
+[![Keeping a changelog][CHANGELOG_BADGE]][KEEP_A_CHANGELOG]
+[![Using Semantic Versioning][SEMVER_BADGE]][SEMANTIC_VERSIONING]
+
+  [CHANGELOG_BADGE]: Keep_a_changelog-E05735.svg
+  [SEMVER_BADGE]: SemVer-3F4551.svg
+  [KEEP_A_CHANGELOG]: https://keepachangelog.com/en/1.1.0/ 'Keeping a changelog'
+  [SEMANTIC_VERSIONING]: https://semver.org/ 'Using Semantic Versioning'
+
+??? info "Definition: the <q>public API</q> of `fakesshagent`"
+
+    The <dfn>public API</dfn>, as defined by Semantic Versioning, is
+    outlined in the Reference section: the set of documented
+    modules, classes, attributes, methods, functions and function
+    parameters, and the documented behavior, options and arguments of the
+    command-line tools.
+
+    Certain **exceptions to this rule** are explicitly and prominently
+    marked as implementation details/not part of the public API.
+
+??? info "Interpretation of the version number"
+
+    The terminology <b>major</b>, <b>minor</b> and <b>patch</b> follows the
+    Semantic Versioning and Keep a Changelog definitions.
+
+      * For version numbers with major version zero, *any* new release may
+        effectively constitute a new <b>major</b> release.
+      * For version numbers with major version one or higher,
+          * <b>Fixed</b> entries justify a <b>patch</b> release;
+          * <b>Added</b> and <b>Deprecated</b> entries justify
+            a <b>minor</b> release;
+          * <b>Changed</b> and <b>Removed</b> entries justify a <b>major</b>
+            release.
+          * <b>Security</b> can justify any type of release; if <b>major</b>
+            or <b>minor</b>, these are accompanied by corresponding entries
+            of the respective types above.
+
+!!! abstract inline end "Legend: symbols"
+
+    <ul style="list-style-type: none;">
+    <li>:material-bug: --- a related bug entry from the wishlist page
+    <li>:material-file-document-plus-outline: --- a related wishlist entry from the wishlist page
+    </ul>
+
+<aside markdown><small>
+(All entries are from the perspective of a user of the program or the API.
+As an exception, entries partaining to developers of `fakesshagent` are
+specifically marked as such.)
+</small></aside>
+
+<!-- scriv changelog start -->
+

fakesshagent-0.1/docs/explanation/faq-altered-versions.md

@@ -0,0 +1,26 @@
+# How to comply with the "altered versions" clause of the license
+
+!!! abstract inline end "Local version identifiers reserved by upstream `fakesshagent`"
+
+    *   `jvm` -- Indicates a build of `fakesshagent` running on the Java Virtual Machine.
+
+**Short answer:** change the package name and/or include a [PEP 440][] "local version identifier" in the version number.
+If `fakesshagent` ever rebrands, this applies to rebranded names too.
+We try not to clash with anyone else, and will yank our offending releases if we do.
+
+**Long answer:** We, upstream `fakesshagent`, reserve the name `fakesshagent` and certain version numbers for ourselves.
+Specifically, our version numbers adhere to [PEP 440][] (or newer revisions) and generally do not include a "local version identifier" (except for the reserved ones mentioned in the info box).
+To mark an altered version, we thus recommend that you change the software package name `fakesshagent`, or use a version number with a different local version identifier.
+If we (upstream) decide to use a new local version identifier, we will avoid all clashing local version identifiers we are aware of, and if informed of a clashing local version identifier after our release, will yank our offending version(s).
+
+Should we (upstream) change the package name, we shall apply the same guidelines and checks concerning local version identifiers to the new package name.
+A change of package name does *not* by itself imply permission to use the old package name for future releases of altered versions without marking them.
+
+---
+
+See also [the zlib project's take on how to mark altered versions (question #24)][ZLIB_FAQ].
+Like them, we recommend keeping our upstream Changelog (up to the point where you introduced modifications) and describing your modifications both there and in the README, in the appropriate level of detail.
+We also request (but do not require) that you provide clear instructions in the README (and potentially other suitable places) on where and how to report problems that stem from your modifications, not from the upstream software package.
+
+[PEP 440]: https://peps.python.org/pep-0440/
+[ZLIB_FAQ]: https://github.com/madler/zlib/blob/v1.3.1/FAQ

fakesshagent-0.1/docs/explanation/index.md

@@ -0,0 +1,8 @@
+---
+title: Explanation overview
+---
+
+* [How to comply with the "altered versions" clause of the
+  license][FAQ_ALTERED_VERSIONS]
+
+[FAQ_ALTERED_VERSIONS]: faq-altered-versions.md

fakesshagent-0.1/docs/index.md

@@ -0,0 +1 @@
+--8<-- "README.md"

fakesshagent-0.1/docs/mkdocstrings_recommended_styles.css

@@ -0,0 +1,35 @@
+/* Indentation. */
+div.doc-contents:not(.first) {
+  padding-left: 25px;
+  border-left: .05rem solid var(--md-typeset-table-color);
+}
+
+/* Mark external links as such. */
+div[data-md-component="content"] a:not(.md-icon):is([href^="https://"], [href^="http://"], [href^="//"])::after,
+a.external::after,
+a.autorefs-external::after {
+  /* https://primer.style/octicons/arrow-up-right-24 */
+  mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  content: ' ';
+
+  display: inline-block;
+  vertical-align: middle;
+  position: relative;
+
+  height: 1em;
+  width: 1em;
+  background-color: currentColor;
+}
+
+/* ... but don't mark badges as external */
+div[data-md-component="content"] a:not(.md-icon):is([href^="https://"], [href^="http://"], [href^="//"]):has(img[src^="https://img.shields.io/"], img[src="Keep_a_changelog-E05735.svg"], img[src="../Keep_a_changelog-E05735.svg"], img[src="SemVer-3F4551.svg"], img[src="../SemVer-3F4551.svg"])::after {
+    content: '';
+    width: 0em;
+    height: 0em;
+}
+
+a.external:hover::after,
+a.autorefs-external:hover::after {
+  background-color: var(--md-accent-fg-color);
+}

fakesshagent-0.1/docs/pycompatibility.md

@@ -0,0 +1,87 @@
+# Compatibility of `fakesshagent` with different Python versions
+
+## Python 3.15  {#py3.15}
+
+Currently supported without any known issues.
+
+## Python 3.14  {#py3.14}
+
+Currently supported without any known issues.
+
+### After end-of-life {#after-eol-py3.14}
+
+After Python 3.14 reaches end-of-life, future `fakesshagent` versions may make use of the following Python functionality:
+
+  * lazy imports
+  * the `frozendict` type
+
+The declared minimum required Python version will then be updated accordingly.
+
+## Python 3.13  {#py3.13}
+
+Currently supported without any known issues.
+
+### After end-of-life {#after-eol-py3.13}
+
+After Python 3.13 reaches end-of-life, future `fakesshagent` versions may make use of the following Python functionality:
+
+  * template strings
+
+The declared minimum required Python version will then be updated accordingly.
+
+## Python 3.12  {#py3.12}
+
+Currently supported without any known issues.
+
+### After end-of-life {#after-eol-py3.12}
+
+Python 3.13 does not offer significantly different functionality than Python 3.12.
+There are thus no plans to make use of additional functionality once Python 3.12 reaches end-of-life.
+
+## Python 3.11  {#py3.11}
+
+Currently supported without any known issues.
+
+### After end-of-life {#after-eol-py3.11}
+
+After Python 3.11 reaches end-of-life, future `fakesshagent` versions may make use of the following Python functionality:
+
+  * complex expressions in f-strings
+  * type parameter syntax and the `type` statement
+
+The declared minimum required Python version will then be updated accordingly.
+
+## Python 3.10  {#py3.10}
+
+Currently supported without any known issues.
+
+### After end-of-life {#after-eol-py3.10}
+
+After Python 3.10 reaches end-of-life, future `fakesshagent` versions may make use of the following Python functionality:
+
+  * exception groups
+  * exception notes
+  * [`contextlib.chdir`][]
+
+The declared minimum required Python version will be then updated accordingly.
+
+## Python 3.9  {#py3.9}
+
+End-of-life since October 2025, but still supported at least until `fakesshagent` v1.0, without any known issues.
+
+### After end-of-life {#after-eol-py3.9}
+
+After Python 3.9 reaches end-of-life, future `fakesshagent` versions may make use of the following Python functionality:
+
+  * structural pattern matching (`match`/`case` blocks)
+  * parenthesized `with` statements
+
+The declared minimum required Python version will be then updated accordingly.
+
+## Python 3.8 and below  {#py3.8-and-below}
+
+These versions were never explicitly supported, neither in CPython nor in PyPy.
+
+## PyPy
+
+As per the respective CPython version above.

fakesshagent-0.1/docs/upgrade-notes.md

@@ -0,0 +1,4 @@
+# Upgrade notes for `fakesshagent`
+
+(Nothing yet.
+Once there is something, this will be listed here, oldest version first.)

fakesshagent-0.1/docs/wishlist/index.md

@@ -0,0 +1,45 @@
+# Bugs & wishlist items
+
+<small>(… a.k.a. "things to fix" and "things to add".)</small>
+
+!!! abstract inline end "Legend: Formatting"
+      - [scheduled for next release](index.md){: .scheduled-next }
+      - [scheduled for some future release](index.md){: .scheduled }
+      - [yet to be scheduled](index.md){: .unscheduled }
+
+???+ bug "things to fix"
+    <i>no entries</i>
+
+???+ wish "things to add"
+    - [sans-io][]{: .scheduled-next }
+
+??? bug-success "things fixed"
+    <i>no entries</i>
+
+??? wish-success "things added"
+    <i>no entries</i>
+
+??? note "About this wishlist"
+
+    This is the list of bugs and wishes for `fakesshagent`.
+    It uses the same terminology and style as [PuTTY's wishlist][PUTTY_WISHLIST].
+    By design, the list distinguishes solely between bugs and wishes, and focuses strongly on the facts, not on the plans for implementation.[^bug-tracking-concerns]
+    The entries are named, not numbered, and the summaries are written by hand.
+
+    The list is built statically; there is no interactive way to submit entries or commentary on an entry, or to run search queries against the entry database.
+    To submit entries or commentary, contact the authors directly; see the website imprint and the embedded author info in version control.
+    To run search queries or other automated queries against the entry database, check out the `wishlist` branch from version control and parse the entry files directly.
+
+    See also the [entry format specification][ENTRY_SPEC].
+
+[^bug-tracking-concerns]:
+    See also the essay [Separation of concerns in a bug tracker][BUG_TRACKING_CONCERNS] by PuTTY's principal author, Simon Tatham.
+    Like PuTTY, `fakesshagent` is a "more serious free-software hobby project" developed by one principal author who also cannot definitively commit to any specific time plan.
+    As such, `fakesshagent` also does not have a formal plans table (beyond the very coarse <b>Priority</b> field).
+
+  [sans-io]: sans-io.md
+
+  [ENTRY_SPEC]: spec.md
+
+  [PUTTY_WISHLIST]: https://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/ "PuTTY Known Bugs and Wish List"
+  [BUG_TRACKING_CONCERNS]: https://www.chiark.greenend.org.uk/~sgtatham/quasiblog/bugtracker-separate/ 'Simon Tatham: "Separation of concerns in a bug tracker"'

fakesshagent-0.1/docs/wishlist/sans-io.md

@@ -0,0 +1,32 @@
+# `fakesshagent` wish sans-io
+
+???+ wish "Wish details: `fakesshagent` should be a Sans-I/O implementation of the SSH agent protocol"
+    <table id="bug-summary" markdown>
+        <tr><th scope=col>Class<td><i>wish</i><td>This is a request for an enhancement.
+        <tr><th scope=col>Priority<td><i>high</i><td>This should be fixed in the next release.
+        <tr><th scope=col>Difficulty<td><i>fun</i><td>Just needs tuits, and not many of them.
+        <tr><th scope=col>Requested-in<td colspan=2>0.1
+    </table>
+
+The fake/stub SSH agent in version 0.1 of `fakesshagent` is almost a [Sans-I/O][SANS_IO] protocol parser.[^sans-io]
+However, it currently neither has separate business logic---the "stub" part is intertwined with the "parser" part---nor does it implement a Sans-I/O-style "stream of events" interface (because the business logic is not yet separate).
+It should have/do both.
+
+Actually separating the business logic from the parser, Sans-I/O-style, would also enable porting the remaining SSH test double of [`derivepassphrase`][DERIVEPASSPHRASE]: the `AgentRequestResponseQueue`, which maps protocol requests to a list of protocol responses.[^difference-queue-and-stub-agent]
+The queue thus already operates on (a primitive version of) the event-based interface.
+
+* * *
+
+<b>Therefore</b>, rewrite the fake/stub agent into a parser and a (proper) stub agent, and have the parser expose a Sans-I/O-style "stream of events" interface.
+
+[^sans-io]:
+  In a Sans-I/O network protocol parser, the parser and the network I/O machinery are completely separate, enabling the parser to be used under all kinds of different I/O paradigms.
+  Porting I/O paradigms is usually practically infeasible, and if the protocol parser were intertwined with the I/O, then the parser would likely need to be rewritten from scratch.
+
+[^difference-queue-and-stub-agent]:
+  The `AgentRequestResponseQueue` differs from the fake/stub agent in that the queue only understands the protocol framing, not the protocol contents.
+  The queue requires and enforces well-formed requests and responses, and will always answer the same request in the same way, irrespective of session state.
+  It is thus less flexible, but also easier to set up.
+
+[DERIVEPASSPHRASE]: https://the13thletter.info/derivepassphrase/
+[SANS_IO]: https://sans-io.readthedocs.io/

fakesshagent-0.1/docs/wishlist/spec.md

@@ -0,0 +1,92 @@
+# bug and wish entry specification
+
+All bug and wish entries consist of a <dfn>header</dfn>, describing the properties of this entry, and a <dfn>summary</dfn> below.
+
+The system is mostly compatible with PuTTY's wishlist; differences are marked below.
+Unlike PuTTY, the entry files are not RFC822-like plain text, but rather Markdown files (with some raw HTML parts), to cleanly integrate with the rest of the documentation.
+(The Markdown+HTML files are still very regular, and thus should still be reasonably parsable.)
+
+## The header
+
+The header is a table with fixed keys.
+For some of the keys, if they have only a fixed amount of values they can take on, then they have a specific interpretation text that accompanies them.
+In the order of appearance:
+
+Summary
+:   A brief description of the bug, in plain text.
+    Comparable to subject lines in e-mail.
+
+Class
+:   What kind of entry is this?[^distinguishing-between-bugs-and-wishes]
+
+    | value  | interpretation                                   |
+    | ------ | ------------------------------------------------ |
+    | `bug`  | This is clearly an actual problem we want fixed. |
+    | `wish` | This is a request for an enhancement.            |
+
+    (Unlike PuTTY, we do not further differentiate between `semi-bug`, `vulnerability` and `bug` at the class level.)
+
+Priority
+:   How urgent is this entry?
+    An anchored ordinal scale with subjective interpretation.
+
+    | value                              | interpretation                                                                |
+    | ---------------------------------- | ----------------------------------------------------------------------------- |
+    | `high`                             | This should be fixed in the next release.                                     |
+    | `medium`                           | This should be fixed one day.                                                 |
+    | `low`                              | We aren't sure whether to fix this or not.                                    |
+    | `historic` (bug), `dormant` (wish) | This issue is old and we don't think it still has value on the main wishlist. |
+    | `never`                            | We don't ever intend to fix this.                                             |
+
+Difficulty
+:   How difficult is this entry to fix/implement?
+    An anchored ordinal scale with subjective interpretation.
+
+    | value    | interpretation                                             |
+    | -------- | ---------------------------------------------------------- |
+    | `fun`    | Just needs tuits, and not many of them.                    |
+    | `tricky` | Needs many tuits.                                          |
+    | `taxing` | Needs external things we don't have (standards, users etc) |
+    | `mayhem` | Probably impossible                                        |
+
+Present-in:
+:   For bugs only: A space-separated list of version numbers (for releases), dates or version control commit IDs (for snapshots) that the bug has been observed in.
+    Dates are formatted as ISO 8601 `YYYY-MM-DD` dates, version numbers and commit IDs in their natural format without additional adornments.
+
+    (PuTTY also factually uses <b>Present-in</b> for wishes.)
+
+Absent-in:
+:   For bugs only: A space-separated list of version numbers (for releases), dates or version control commit IDs (for snapshots) that the bug has been observed *not* in.
+    Same formatting as for <b>Present-in</b>.
+
+Requested-in:
+:   For wishes only: A space-separated list of version numbers (for releases) or version control commit IDs (for snapshots), or a single date that the wish was requested in/on.
+
+    (PuTTY uses <b>Present-in</b> for this purpose.)
+
+Fixed-in:
+:   A space-separated list of version numbers (for releases), dates or version control commit IDs (for snapshots) that the bug was fixed in or the wish was implemented in.
+    Same formatting as for <b>Present-in</b>.
+    Version control commit IDs may be prefixed with `~` to indicate that the bug/wish was confirmed fixed/implemented in this commit <i>or an ancestor commit</i>.
+
+Depends:
+:   A space-separated list of other bug/wish entry names that must be fixed/implemented first.
+
+Blocks:
+:   A space-separated list of other bug/wish entry names that are waiting for this entry to be fixed/implemented.
+
+    (Not documented in PuTTY's wishlist entry specification, but in use across that wishlist.)
+
+[^distinguishing-between-bugs-and-wishes]:
+    A bug is specifically an entry describing an aspect of this software that, if not fixed, impedes or prohibits the user from accomplishing their goal with or within this software.
+    Every other entry is a wish.
+
+## The summary
+
+The summary is a free-form prose summary of the bug or wish.
+It is intended to be easily scannable, like a good commit message, and likely benefits from many of the same writing conventions.
+In particular, the summary *should not* be a chronological listing of events or messages related to this bug or wish, but rather a proper summarization of those events, messages, and related facts and opinions.
+
+Specific to this system, the summary always contains a paragraph beginning with <b>Therefore</b> that describes the action to take for this entry.
+If applicable, a sentence beginning with <b>Until then</b> within that paragraph contains workarounds or partial solutions that will be applied or have already been applied.
+Except for optional historical context that may follow this paragraph and is then hidden by default, the <b>Therefore</b> paragraph is the *last* paragraph of the summary.