feature:delete
Introduction
feature:delete removes a versioned snapshot, <feature>@<version>, from the local cache. It changes no product, but it warns you about every product in the workspace that pins that version.
splent feature:delete splent_io/splent_feature_notepad v1.2.7
🗂️ Cache directory: /workspace/.splent_cache/features/splent_io/splent_feature_notepad@v1.2.7
✅ No products depend on this version. Safe to delete.
🧹 Deleted: /workspace/.splent_cache/features/splent_io/splent_feature_notepad@v1.2.7
🎯 Feature version removed from cache.
Without a namespace, splent-io is used.
Deleting a version a product uses
When a product’s pyproject.toml names that version, the command lists the products and asks before it deletes.
🚨 The feature you are trying to delete is IN USE.
Feature: splent_io/splent_feature_notepad@v1.2.7
Used by the following products:
• my_first_app
⚠️ Deleting this version will break these products until they:
- detach this version, or
- upgrade to another version.
Do you really want to delete it anyway? [y/N]:
Those products break until they detach that version or move to another one. --force deletes without asking.
Reference
| Argument / Option | Description |
|---|---|
FEATURE_IDENTIFIER |
The full package name, with or without a namespace, such as splent_io/splent_feature_notepad |
VERSION |
The version to delete, such as v1.2.7 |
--force |
Delete without asking, even when a product uses the version |
Each of these exits 1.
| Message | What to do |
|---|---|
Invalid feature name '<name>' |
Use the full name, splent_feature_<name>, not the short one |
Invalid version '<version>' |
Use letters, digits, ., - and _ only |
Feature version not found in cache: <path> |
Check the version with feature:versions |
Refusing to delete <path>: it is not a cached feature folder inside <dir>. |
The entry is a symlink or lies elsewhere, so it is left alone |
Aborted. |
You answered no |
See also
feature:detachremoves a pinned feature from the product.feature:cloneputs a version back in the cache.