Feature: Rename date fields (date -> updated; build-date -> built) (#349)

Author: Zweih

README.md

@@ -68,7 +68,7 @@ more ecosystems are added every week!
 * query packages using an expressive query language
   * supports full boolean logic (`and`, `or`, `not`, grouping)
   * supports fuzzy and strict matching
-  * supports range queries for `size`, `date`, and `build-date`
+  * supports range queries for `size`, `updated`, and `built`
   * supports presence/absence checks (`has:`, `no:`)
   * learn more about querying [here](#querying-with-where)
 * sort results by any field
@@ -79,7 +79,7 @@ more ecosystems are added every week!
 * query by:
   * name, version, origin, architecture, license
   * size on disk
-  * install or build date
+  * update or build time/date
   * package base or groups
   * dependencies, optional dependencies, reverse dependencies
   * package provisions, conflicts, replacements
@@ -266,16 +266,9 @@ qp [command] [args] [options]
   - use `select all,version` to list default fields + version
   - [see fields available for selection](#available-fields)
 - `where <query>` | `w <query>`: apply one or more queries to refine package results.
-  - supported query types:
-    - **string match** -> `field=value` (fuzzy) or `field==value` (strict)
-    - **range match** -> `field=start:end` (fuzzy) or `field==start:end` (strict)
-        - supports full ranges (`start:end`), open-ended ranges (`start:` or `:end`), and exact values (`value`)
-        - works with `date` and `size`
-    - **existence check** -> `has:field` or `no:field`
-  - use `and`, `or`, `not`, `q ... p` to build complex filters
   - learn more about querying [here](#querying-with-where)
 - `order <field>:<direction>` | `o <field>:<direction>`: sort results ascending or descending
-  - default sort is `date:asc`
+  - default sort is `updated:asc`
 - `limit <number>` | `l <number>`: limit the amount of packages to display (default: 20)
   - `limit all` | `l all`: display all packages
   - `limit end:<number>`: display last `n` packages
@@ -284,7 +277,7 @@ qp [command] [args] [options]
 ### options
 
 - `--no-headers`: omit column headers in table output (useful for scripting)
-- `--full-timestamp`: display the full timestamp (date and time) of package install/build instead of just the date
+- `--full-timestamp`: display the full timestamp (date and time) of package update/build instead of just the date
 - `--output`: format output as `table`, `kv` (key-value), `json` (default:`table`)
 - `--no-progress`: force no progress bar outside of non-interactive environments
 - `--no-cache`: disable cache loading/saving and force fresh package data loading
@@ -293,8 +286,8 @@ qp [command] [args] [options]
 
 ### available fields
 
-- `date` - installation date of the package
-- `build-date` - date the package was built
+- `updated` - when the package was last updated
+- `built` - when the package was built
 - `size` - package size on disk
 - `name` - package name
 - `reason` - installation reason (explicit/dependency)
@@ -372,7 +365,7 @@ each `where` query supports one of the following:
 - **range match**
   - `field=start:end` -> fuzzy match
   - `field==start:end` -> strict match
-  - works with `date` and `size`
+  - works with `updated`, `built`, and `size`
   - supports:
     - full ranges: `start:end`
     - open-ended ranges: `start:` or `:end`
@@ -471,7 +464,7 @@ qp w not superorphan and not name=gtk
 qp w name==bash and has:depends
 qp where size=100MB:2GB
 qp w name=python,cmake,yazi
-qp w date==2024-01-01
+qp w updated==2024-01-01
 qp where q name=vim or name=nvim p and not has:conflicts
 qp w not arch=x86_64
 qp w q has:depends or has:required-by p and not reason=explicit
@@ -489,8 +482,8 @@ qp w q has:depends or has:required-by p and not reason=explicit
 
 | field name | field type |
 |------------|------------|
-| date | range |
-| build-date | range |
+| updated | range |
+| built | range |
 | size | range |
 | name | string |
 | reason | string |
@@ -614,7 +607,7 @@ output format:
 - multiple short commands are supported using space separation (e.g. `s`, `w`, `l`, `o`), but **cannot** be combined as `swo` or `-swo`. use them like this:
   ```
   qp w name yay
-  qp s name,size w name=vim o date:asc l 10 # full query with shorthand
+  qp s name,size w name=vim o updated:asc l 10 # full query with shorthand
   ```
 
 - group queries with `q ... p` to clarify order of operations:
@@ -630,8 +623,8 @@ output format:
 
 - options that take arguments can be used in the `--<option>=<value>` form:
   ```
-  qp select name,date --limit=100
-  qp s name,date o name
+  qp select name,updated --limit=100
+  qp s name,updated o name
   ```
 
   boolean flags can be explicitly set using `--<option>=true` or `--<option>=false`:
@@ -664,9 +657,9 @@ output format:
    qp where reason=explicit limit all
    ```
 
- 3. show only dependencies installed on a specific date  
+ 3. show only dependencies updated on a specific date  
    ```
-   qp where reason=dependency and date=2025-03-01
+   qp where reason=dependency and update=2025-03-01
    ```
 
  4. show all packages sorted alphabetically by name
@@ -681,7 +674,7 @@ output format:
 
  6. show packages installed between January 1, 2025, and January 5, 2025  
    ```
-   qp where date=2025-01-01:2025-01-05
+   qp where updated=2025-01-01:2025-01-05
    ```
 
  7. sort all packages by their license, displaying name and license  
@@ -696,12 +689,12 @@ output format:
 
  9. show packages between 100MB and 1GB installed up to February 27, 2025
    ```
-   qp where size=100MB:1GB and date=:2025-02-27
+   qp where size=100MB:1GB and updated=:2025-02-27
    ```
 
 10. show all packages sorted by size in descending order, installed after January 1, 2025
    ```
-   qp where date=2025-01-01: order size:desc limit all
+   qp where updated=2025-01-01: order size:desc limit all
    ```
 
 11. search for installed packages containing "python"  
@@ -716,12 +709,12 @@ output format:
 
 13. search for packages with names containing "linux" installed between January 1 and March 30, 2025
    ```
-   qp where name=linux and date=2025-01-01:2025-03-30
+   qp where name=linux and updated=2025-01-01:2025-03-30
    ```
 
 14. search for packages containing "gtk" installed after January 1, 2025, and at least 5MB in size
    ```
-   qp where name=gtk and date=2025-01-01: and size=5MB:
+   qp where name=gtk and updated=2025-01-01: and size=5MB:
    ```
 
 15. show packages with name, version, and size
@@ -781,7 +774,7 @@ output format:
 
 26. show packages required by `vlc` and installed after January 1, 2025
    ```
-   qp where required-by=vlc and date=2025-01-01:
+   qp where required-by=vlc and updated=2025-01-01:
    ```
 
 27. show all packages that have `glibc` as a dependency and are required by `ffmpeg`

internal/config/help.go

@@ -18,7 +18,7 @@ Commands:
 
   where <query> | w <query>     Refine package results using one or more queries
                                 - Supports: field=value, field==value
-                                - Range: date=2024-01-01:2024-01-10
+                                - Range: updated=2024-01-01:2024-01-10
                                 - Existence: has:depends, no:conflicts
                                 - Depth: depends=package@2, required-by=pkg@3
 
@@ -37,13 +37,13 @@ Query Types:
       field=value       -> fuzzy match (e.g., name=gtk)
       field==value      -> exact match (e.g., name==bash)
 
-  - Range match (date, size):
+  - Range match (dates, sizes):
       field=start:end   -> fuzzy match
       field==start:end  -> exact match
       Examples:
         size=10MB:1GB
-        date==2024-01-01
-        date=2024-01-01: (open-ended range)
+        updated==2024-01-01
+        updated=2024-01-01: (open-ended range)
 
   - Existence check:
       has:field         -> field must exist or be non-empty
@@ -83,7 +83,7 @@ Match Behavior:
              strict = exact byte size
 
 Short Command Examples:
-  qp s name,size w name=vim o date:asc l 10
+  qp s name,size w name=vim o updated:asc l 10
   qp where name=gtk
   qp w name==bash
   qp w reason=explicit and size=50MB:

internal/config/legacy_query_parser.go

@@ -63,7 +63,7 @@ func convertLegacyQueries(
 ) []query.FieldQuery {
 	if dateFilter != "" {
 		queries = append(queries, query.FieldQuery{
-			Field:  consts.FieldDate,
+			Field:  consts.FieldUpdated,
 			Target: dateFilter,
 			Match:  consts.MatchFuzzy,
 		})

internal/consts/fields.go

@@ -17,8 +17,8 @@ const (
 	FieldUrl
 	FieldGroups
 	FieldSize
-	FieldDate
-	FieldBuildDate
+	FieldUpdated
+	FieldBuilt
 	FieldVersion
 	FieldDepends
 	FieldOptDepends
@@ -30,8 +30,8 @@ const (
 )
 
 const (
-	date        = "date"
-	buildDate   = "build-date"
+	updated     = "updated"
+	built       = "built"
 	size        = "size"
 	name        = "name"
 	reason      = "reason"
@@ -56,21 +56,23 @@ const (
 )
 
 var FieldTypeLookup = map[string]FieldType{
-	"d":    FieldDate,
+	"u":    FieldUpdated,
 	"n":    FieldName,
 	"r":    FieldReason,
 	"s":    FieldSize,
 	"v":    FieldVersion,
 	"D":    FieldDepends,
 	"R":    FieldRequiredBy,
 	"p":    FieldProvides,
-	"bd":   FieldBuildDate,
+	"bd":   FieldBuilt,
 	"type": FieldPkgType,
 
-	"alphabetical": FieldName, // legacy flag, to be deprecated
+	"date":         FieldUpdated, // legacy field
+	"build-date":   FieldBuilt,   // legacy field
+	"alphabetical": FieldName,    // legacy flag, to be deprecated
 
-	date:        FieldDate,
-	buildDate:   FieldBuildDate,
+	updated:     FieldUpdated,
+	built:       FieldBuilt,
 	size:        FieldSize,
 	name:        FieldName,
 	reason:      FieldReason,
@@ -95,8 +97,8 @@ var FieldTypeLookup = map[string]FieldType{
 }
 
 var FieldNameLookup = map[FieldType]string{
-	FieldDate:        date,
-	FieldBuildDate:   buildDate,
+	FieldUpdated:     updated,
+	FieldBuilt:       built,
 	FieldSize:        size,
 	FieldName:        name,
 	FieldReason:      reason,
@@ -122,15 +124,15 @@ var FieldNameLookup = map[FieldType]string{
 
 var (
 	DefaultFields = []FieldType{
-		FieldDate,
+		FieldUpdated,
 		FieldName,
 		FieldReason,
 		FieldSize,
 	}
 	// note: this is also the order the columns will be displayed in table output
 	ValidFields = []FieldType{
-		FieldDate,
-		FieldBuildDate,
+		FieldUpdated,
+		FieldBuilt,
 		FieldSize,
 		FieldName,
 		FieldReason,
@@ -180,7 +182,7 @@ var RelationFields = map[FieldType]struct{}{
 }
 
 var RangeFields = map[FieldType]struct{}{
-	FieldDate:      {},
-	FieldBuildDate: {},
-	FieldSize:      {},
+	FieldUpdated: {},
+	FieldBuilt:   {},
+	FieldSize:    {},
 }

internal/display/render_json.go

@@ -10,29 +10,29 @@ import (
 )
 
 type PkgInfoJSON struct {
-	InstallTimestamp int64    `json:"installTimestamp,omitempty"`
-	BuildTimestamp   int64    `json:"buildTimestamp,omitempty"`
-	Size             int64    `json:"size,omitempty"`
-	Name             string   `json:"name,omitempty"`
-	Reason           string   `json:"reason,omitempty"`
-	Version          string   `json:"version,omitempty"`
-	Origin           string   `json:"origin,omitempty"`
-	Arch             string   `json:"arch,omitempty"`
-	License          string   `json:"license,omitempty"`
-	Description      string   `json:"description,omitempty"`
-	Url              string   `json:"url,omitempty"`
-	Validation       string   `json:"validation,omitempty"`
-	PkgType          string   `json:"pkgtype,omitempty"`
-	PkgBase          string   `json:"pkgbase,omitempty"`
-	Packager         string   `json:"packager,omitempty"`
-	Groups           []string `json:"groups,omitempty"`
-	Conflicts        []string `json:"conflicts,omitempty"`
-	Replaces         []string `json:"replaces,omitempty"`
-	Depends          []string `json:"depends,omitempty"`
-	OptDepends       []string `json:"optDepends,omitempty"`
-	RequiredBy       []string `json:"requiredBy,omitempty"`
-	OptionalFor      []string `json:"optionalFor,omitempty"`
-	Provides         []string `json:"provides,omitempty"`
+	UpdateTimestamp int64    `json:"updateTimestamp,omitempty"`
+	BuildTimestamp  int64    `json:"buildTimestamp,omitempty"`
+	Size            int64    `json:"size,omitempty"`
+	Name            string   `json:"name,omitempty"`
+	Reason          string   `json:"reason,omitempty"`
+	Version         string   `json:"version,omitempty"`
+	Origin          string   `json:"origin,omitempty"`
+	Arch            string   `json:"arch,omitempty"`
+	License         string   `json:"license,omitempty"`
+	Description     string   `json:"description,omitempty"`
+	Url             string   `json:"url,omitempty"`
+	Validation      string   `json:"validation,omitempty"`
+	PkgType         string   `json:"pkgtype,omitempty"`
+	PkgBase         string   `json:"pkgbase,omitempty"`
+	Packager        string   `json:"packager,omitempty"`
+	Groups          []string `json:"groups,omitempty"`
+	Conflicts       []string `json:"conflicts,omitempty"`
+	Replaces        []string `json:"replaces,omitempty"`
+	Depends         []string `json:"depends,omitempty"`
+	OptDepends      []string `json:"optDepends,omitempty"`
+	RequiredBy      []string `json:"requiredBy,omitempty"`
+	OptionalFor     []string `json:"optionalFor,omitempty"`
+	Provides        []string `json:"provides,omitempty"`
 }
 
 func (o *OutputManager) renderJSON(pkgPtrs []*pkgdata.PkgInfo, fields []consts.FieldType) {
@@ -82,9 +82,9 @@ func getJsonValues(pkg *pkgdata.PkgInfo, fields []consts.FieldType) *PkgInfoJSON
 
 	for _, field := range fields {
 		switch field {
-		case consts.FieldDate:
-			filteredPackage.InstallTimestamp = pkg.GetInt(field)
-		case consts.FieldBuildDate:
+		case consts.FieldUpdated:
+			filteredPackage.UpdateTimestamp = pkg.GetInt(field)
+		case consts.FieldBuilt:
 			filteredPackage.BuildTimestamp = pkg.GetInt(field)
 		case consts.FieldSize:
 			filteredPackage.Size = pkg.GetInt(field)

internal/display/render_table.go

@@ -14,8 +14,8 @@ type tableContext struct {
 }
 
 var columnHeaders = map[consts.FieldType]string{
-	consts.FieldDate:        "DATE",
-	consts.FieldBuildDate:   "BUILD DATE",
+	consts.FieldUpdated:     "UPDATED",
+	consts.FieldBuilt:       "BUILT",
 	consts.FieldName:        "NAME",
 	consts.FieldReason:      "REASON",
 	consts.FieldSize:        "SIZE",
@@ -100,7 +100,7 @@ func renderRows(
 
 func getTableValue(pkg *pkgdata.PkgInfo, field consts.FieldType, ctx tableContext) string {
 	switch field {
-	case consts.FieldDate, consts.FieldBuildDate:
+	case consts.FieldUpdated, consts.FieldBuilt:
 		return formatDate(pkg.GetInt(field), ctx)
 
 	case consts.FieldSize: