Documentation
¶
Overview ¶
Package jql hosts the `jira jql` command group for building, validating, and referencing JQL queries — the local query-construction helpers that complement the search commands.
Index ¶
- func AddDateFilterFlags(cmd *cobra.Command, builder *jql.BuildOptions)
- func AddFilterFlags(cmd *cobra.Command, builder *jql.BuildOptions)
- func AddJQLBuilderFlags(cmd *cobra.Command, builder *jql.BuildOptions)
- func AddSortFlags(cmd *cobra.Command, builder *jql.BuildOptions)
- func NewCommand() *cobra.Command
- func ReadCacheJSON(profile, resource string, v any) bool
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AddDateFilterFlags ¶ added in v0.3.2
func AddDateFilterFlags(cmd *cobra.Command, builder *jql.BuildOptions)
AddDateFilterFlags attaches the --updated/--created/--resolved timeframe flags to cmd. Shared by the full builder flag set and by `issue mine`, which carries its own reduced flag surface, so the date-flag grammar is defined once. Each value is a relative duration (-7d), an absolute date (2026-01-01), a comparator form (>=2026-01-01), or an A..B range — see jql.BuildOptions.
func AddFilterFlags ¶ added in v0.3.2
func AddFilterFlags(cmd *cobra.Command, builder *jql.BuildOptions)
AddFilterFlags attaches the JQL filter flags shared by every command that builds a query — every field except assignee/reporter. `issue mine` pins assignee = currentUser() in its runner, so exposing --assignee would fight the pin and --reporter has no place on an assignee-scoped command; those two are the only flags AddJQLBuilderFlags adds on top. Because every other filter is registered here once, a new filter appears on both `issue list` and `issue mine` by construction. Sort and date flags compose via AddSortFlags / AddDateFilterFlags, which both commands also call.
func AddJQLBuilderFlags ¶
func AddJQLBuilderFlags(cmd *cobra.Command, builder *jql.BuildOptions)
AddJQLBuilderFlags attaches the full JQL builder surface to cmd: the shared filter flags, plus the assignee/reporter filters that `issue mine` omits, and the sort and date flags.
func AddSortFlags ¶ added in v0.3.2
func AddSortFlags(cmd *cobra.Command, builder *jql.BuildOptions)
AddSortFlags attaches the --order-by/--desc sort flags to cmd. Shared by the full builder flag set and by `issue mine`, which carries its own reduced flag surface, so the sort defaults (field "updated", descending) are defined once and stay consistent across every command that builds a query.
func NewCommand ¶
NewCommand returns the `jql` command group for building JQL queries.
func ReadCacheJSON ¶
ReadCacheJSON loads a cache resource into v for the given profile, ignoring TTL so completion stays fast even when the cache is stale. Returns false silently on any error so completion never blocks the shell.
Types ¶
This section is empty.
Source Files