Skip to content

(#1276) List command with last updated date #3775

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
Open
wants to merge 3 commits into
base: develop
Choose a base branch
from
Open

(#1276) List command with last updated date #3775

wants to merge 3 commits into from

Conversation

swaran18999
Copy link

@swaran18999 swaran18999 commented Aug 23, 2025 •
edited
Loading

Description Of Changes

  • Add --show-last-updated-date option to choco list to display the last date a package was installed/updated, formatted as yyyy-MM-dd HH:mm:ss. Falls back to “Last updated not available” when metadata is missing.
  • Add --order-by-last-updated-date option to choco list to order results by the package’s last installed/updated date by mapping to PackageOrder.LastPublished.
  • Update PowerShell tab completion (src/chocolatey.resources/helpers/ChocolateyTabExpansion.ps1) to include both new switches in the list command’s completion options.

Motivation and Context

  • Administrators and users often need quick visibility into when packages were last installed or updated, and to sort lists by recency for auditing and maintenance workflows. Previously, choco list did not expose this information nor allow sorting by it.
  • These additions improve usability by displaying last-change timestamps inline with list results.
  • This work addresses the needs discussed in issue Improving choco list with options to show dependencies and sort by date (and more) #1276

Testing

  • Flag parsing for --show-last-updated-date sets ShowLastUpdatedDate = true; defaults to false when omitted. Output includes formatted date yyyy-MM-dd HH:mm:ss when Published exists.
  • Sorting places packages in the expected order by last updated date.
  • Correct order when --order-by-last-updated-date is used.
  • Behavior is consistent with --id-only/--by-id-only (date not appended, sorting still applied).

Operating Systems Testing

  • Windows 10

Change Types Made

  • Bug fix (non-breaking change).
  • Feature / Enhancement (non-breaking change).
  • Breaking change (fix or feature that could cause existing functionality to change).
  • Documentation changes.
  • PowerShell code changes.

Change Checklist

  • Requires a change to the documentation.
  • Documentation has been updated.
  • Tests to cover my changes, have been added.
  • All new and existing tests passed?
  • PowerShell code changes: PowerShell v3 compatibility checked?

Related Issue

Partially fixes #1276

@swaran18999 swaran18999 changed the title List command with date List command with last updated date Aug 23, 2025
@swaran18999 swaran18999 changed the title List command with last updated date (#1276) List command with last updated date Aug 29, 2025
@vexx32 vexx32 self-assigned this Sep 10, 2025
vexx32
vexx32 requested changes Sep 10, 2025
View reviewed changes
Copy link
Member

@vexx32 vexx32 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks pretty solid, nice self-contained change, just a couple minor comments.

You will need to rebase this branch against develop when you're done, just so the merge history is a bit tidier.

src/chocolatey.resources/helpers/ChocolateyTabExpansion.ps1 Outdated
install = "--allow-downgrade --allow-empty-checksums --allow-empty-checksums-secure --apply-args-to-dependencies --apply-package-parameters-to-dependencies --cert='' --certpassword='' --disable-repository-optimizations --download-checksum='' --download-checksum-x64='' --download-checksum-type='' --download-checksum-type-x64='' --exit-when-reboot-detected --force-dependencies --forcex86 --ignore-checksum --ignore-dependencies --ignore-detected-reboot --ignore-package-exit-codes --include-configured-sources --install-arguments='' --not-silent --override-arguments --package-parameters='' --password='' --pin --prerelease --require-checksums --skip-hooks --skip-scripts --source='' --stop-on-first-failure --use-package-exit-codes --user='' --version=''"
license = ""
list = "--by-id-only --by-tag-only --detail --exact --id-only --id-starts-with --ignore-pinned --include-programs --page='' --page-size='' --prerelease --source='' --version=''"
list = "--by-id-only --by-tag-only --detail --exact --id-only --id-starts-with --ignore-pinned --include-programs --page='' --page-size='' --prerelease --order-by-last-updated-date --show-last-updated-date --source='' --version=''"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think most of our flags are given in alphabetical order in tab completion; could we put these in before --page?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

change has been made

src/chocolatey/infrastructure.app/services/NugetService.cs Outdated
if (!(packageInfo != null && packageInfo.IsPinned && config.ListCommand.IgnorePinned))
{
this.Log().Info(logger, () => "{0}{1}".FormatWith(package.Identity.Id, config.ListCommand.IdOnly ? string.Empty : " {0}{1}{2}{3}".FormatWith(
this.Log().Info(logger, () => "{0}{1}".FormatWith(package.Identity.Id, config.ListCommand.IdOnly ? string.Empty : " {0}{1}{2}{3} {4}".FormatWith(
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at how the other information is added here, it looks like the space before each arg is added below rather than here; I'm guessing that's probably due to not wanting to add trailing space and also to keep it simple to extend later on. For consistency's sake, can we do the same here? i.e., no space in this format string, but adding the space if the user is asking to show the last updated date -- similar to how the Approved / download cache information is done.

I think you can do that just by adding a space to the ToString() format string on line 284 and the "Last updated not available" string..

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

change has been made

@vexx32 vexx32 removed their assignment Sep 10, 2025
@swaran18999 swaran18999 force-pushed the list-command-with-date branch from 0b53340 to 7a04017 Compare September 23, 2025 00:58
@swaran18999
(chocolatey#1276) Add option to show last updated date in choco list
644bf84 
Add `--show-last-updated-date` option to the `list` command. When
enabled, this displays the last date the package was installed or
updated, alongside the usual metadata fields.

Previously, users had no clear indication of when a local package was
last changed. This new option provides better visibility and helps
with package management, especially when filtering or sorting package
lists by recency.

Implementation details:
- Introduced new switch `show-last-updated-date`.
- Logs formatted date via `package.Published` (or fallback string if
  unavailable).
- Integrated into existing `list` command output formatting.

With this change, users can more easily audit their package states
and track updates over time.
@swaran18999
(chocolatey#1276) Add tab completion support for new list options
0d400dc 
Update `ChocolateyTabExpansion.ps1` to include the new
`--show-last-updated-date` and `--order-by-last-updated-date` switches
in the `list` command's tab completion options.
@swaran18999
(chocolatey#1276) Refactor space changes and added last update dated
9537707
@swaran18999 swaran18999 force-pushed the list-command-with-date branch from 60dcb8a to 9537707 Compare September 23, 2025 01:08
@swaran18999 swaran18999 requested a review from vexx32 September 23, 2025 01:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@vexx32 vexx32 Awaiting requested review from vexx32

Requested changes must be addressed to merge this pull request.

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Improving choco list with options to show dependencies and sort by date (and more)
2 participants
@swaran18999 @vexx32