Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Document .ignore pkg repo functionality #1385

Merged
merged 1 commit into from Sep 21, 2022
Merged

Document .ignore pkg repo functionality #1385

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
11 changes: 9 additions & 2 deletions wiki/pages/Managing-Packages.md
View file
Open in desktop
Expand Up @@ -28,6 +28,9 @@ Via API:
1 # -1: pkg not found; 0: pkg already ignored; 1: pkg ignored
```

Both of these options generate a *.ignore\<version\>* file (e.g.
*.ignore3.1.2*) next to the package version directory.

You can also do the reverse (ie unignore a package). Use the `-u` option of
`rez-pkg-ignore`, or the `unignore_package` function on the package repository
object.
Expand Down Expand Up @@ -161,14 +164,18 @@ Via API:
>>> remove_package("python", "3.7.4", "/packages")
```

During the removal process, package versions will first be ignored so that
partially-deleted versions are not visible.

It can be useful to ignore packages that you don't want to use anymore, and
actually remove them at a later date. This gives you a safety buffer in case
current runtimes are using the package - they won't be affected if the package is
ignored, but could break if it is removed.

To facilitate this workflow, `rez-rm` lets you remove all packages that have
been ignored for longer than N days. Here we remove all packages that have been
ignored for 30 days or longer:
been ignored for longer than N days (using the timestamp of the
*.ignore\<version\>* file). Here we remove all packages that have been ignored
for 30 days or longer:

```
]$ rez-rm --ignored-since=30 -v
Expand Down