Rename the project to Snaffle#15
Merged
Merged
Conversation
PyFetch was both unavailable and misleading. The name is taken on PyPI by an
unrelated "Python system information tool", so this project could never publish
under it; and `*fetch` in that space denotes neofetch-style system reporters,
so the name pointed people at the wrong category of tool entirely.
Snaffle is British slang for grabbing something quickly, which is what an HTTP
client does. Checked available on PyPI, valid as a Python identifier, and reads
as a verb on the command line.
BREAKING: the import package, the distribution, and the console script are all
now `snaffle`.
from pyfetch import HTTPClient # 2.x
from snaffle import HTTPClient # 3.0+
pyfetch GET https://example.com # 2.x
snaffle GET https://example.com # 3.0+
No compatibility shim, consistent with the 2.0.0 rename. Bumped to 3.0.0.
The changelog keeps the historical entries pointing at the names that were
actually shipped at the time; only the 3.0.0 entry describes the new one.
Verified: ruff, ruff format, mypy strict clean; 38 tests pass; 10-case CLI smoke
run passes against both entry points; wheel builds as
snaffle-3.0.0-py3-none-any.whl containing snaffle/py.typed.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
No backwards compatibility is being offered, so the upgrade guidance and the references to the previous name are dead weight. Removed the README's upgrade section and stripped the old name from the changelog; the version history stays and now describes what changed rather than what it used to be called. No mention of the old name remains in any tracked file. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why rename
Two concrete problems with the old name, both found by checking rather than assuming:
*fetchnames —neofetch,screenfetchand friends — denote system-info reporters. Anyone hearing it expected an ASCII distro logo, not an HTTP client.Confirmed available on PyPI, a valid Python identifier, and it reads as a verb on the command line. Shortlisted against ~150 candidates checked live against the PyPI API;
snarf— the Jargon File term for grabbing a file over a network, and the best conceptual fit — was already taken, as wereyoink,whippet,badger,ferret,magpie,pokeandknock.Breaking change
The import package, the distribution, and the console script are all
snaffle. Bumped to 3.0.0.No compatibility shim and no migration guidance — none is being offered, so the upgrade notes and every reference to the previous name were removed rather than left as dead weight.
git grepconfirms zero mentions across all tracked files. The changelog keeps its version history but now describes what changed rather than what things used to be called.README
Added the dictionary definition as an epigraph, plus a one-line usage example under the intro.
Testing
ruff format --check, mypy strict all clean.usage: snaffle—snaffle HELPandpython -m snaffle HELP.snaffle-3.0.0-py3-none-any.whland containssnaffle/py.typed; the CI check was updated to the new path.Follow-up after merge
The GitHub repository should be renamed to
maltemindedal/snaffle(GitHub redirects the old URL). The README and changelog already point at the new one. The local working directory can be renamed whenever convenient.🤖 Generated with Claude Code