Preserve marks in list buffers also in Emacs 29

Instead of relying on
'revert-buffer-restore-functions' (introduced in Emacs 30)
for preserving marks in 'kubed-list-mode' during
'revert-buffer', use a 'revert-buffer-function' to do so.

* kubed.el (kubed-list-revert): New function.
(kubed-list-mode): Use it.

; Highlight support for multi-cluster workflows

Motivated by https://github.com/eshelyaron/kubed/issues/6

* README.md:
* kubed.texi (Overview): Add multi-cluster support to
highlights short-list.

Update NEWS.org and bump version to 0.4.1

; * kubed.texi: More explicit alt text for images.

This helps with poorly indicated alt text, as in the HTML
version that the GNU ELPA server produces and displays.

See also Emacs bug#73425.

New commands for managing Kubernetes API proxies

* kubed.el (kubed--proxy-alist): New variable.
(kubed-stop-proxy, kubed-proxy): New commands, use it.
(kubed-prefix-map, kubed-menu-map): Bind 'kubed-proxy'.
* kubed-transient.el (kubed-transient-proxy): New transient.
(kubed-transient): Bind it.
* NEWS.org: Announce new commands.

; * kubed.texi: Add illustrative images.

; * kubed.texi: Update version, fix anchors.

New commands 'kubed-{transient-}scale-deployment'

* kubed-transient.el (kubed-transient-scale-deployment):
New transient.
(kubed-transient): Bind it.
* kubed.el (kubed-scale-deployment)
(kubed-deployments-scale): New commands.
* kubed.texi (Scale Deployment): New section.
(Usage): Update menu.
* NEWS.org: Announce new commands.

; Update NEWS.org and bump version to 0.4.0

; * kubed.texi (Transient Menus): Add a few words.

; Don't accept empty string as default namespace

* kubed.el (kubed-read-default-namespace-non-empty): New func.
(kubed-default-context-and-namespace): Use it.

; Fix spelling of "Kubernetes" in a few places

* NEWS.org
* kubed-transient.el
* kubed.el: Fix typos.

; Write some NEWS in preparation for version 0.4.0

Improve Tramp integration

* kubed-tramp.el: New file.
* kubed.el (kubed--static-if): No longer used, removed.
(kubed-edit-resource): Adapt.
(kubed-pods-dired, kubed-pods-shell): Use new Tramp method.
(kubed-remote-file-name-p): New function.
(kubed-local-context, kubed-local-namespace)
(kubed-local-context-and-namespace): Use it.

Improve handling of contexts with no configured namespace

* kubed.el (kubed--namespace): Fallback to prompting when no
default namespace is available.
(kubed-default-context-and-namespace): Prompt for default
namespace when there is none.
(kubed-current-namespace): Clarify that this function may
return nil.
(kubed-read-resource-name): Make CONTEXT argument
non-optional.
(kubed-read-resource-type): Update accordingly.

; Fix datetime formatting for '--since-time' argument

* kubed-transient.el
(kubed-transient-read-date): New function.
(kubed-transient-logs-for-resource)
(kubed-transient-logs): Use it.
* kubed.el (kubed-logs): Correct typo.

See https://github.com/eshelyaron/kubed/issues/5

; * kubed.el (pod): Fix thinko in last commit

':pad-keys' needs to come before suffixes.

(kubed-list-transient): Add type-specific suffixes

* kubed-transient.el (kubed-list-transient): Tweak layout;
add type-specific suffixes.
* kubed.el (kubed-list-transient-extra-suffixes): New var.
(kubed-define-resource): Set it to value of new keyword arg
':suffixes'.
(pod, deployment): Specify new keyword arg ':suffixes'.

; Minor cleanup for logs commands

* kubed.el: Declare 'kubed-transient-logs-for-*' functions;
autoload 'kubed-logs-for-*' commands.
(kubed-define-resource): DRY.

; * kubed.texi (Browse Resources): Elaborate about "g" key.

New transient menu 'kubed-transient-logs'

* kubed-transient.el (kubed-transient): Rearrange, delete
duplicate entry, bind 'kubed-transient-logs'.
(kubed-list-transient): Add TODO comment.
* kubed.el (kubed-list-logs): New command.
(kubed-list-create): Mark as specific to 'kubed-list-mode'.
(kubed-list-mode): Tweak comment.
(kubed-define-resource): Add ':logs' keyword argument for
generating 'kubed-logs-for-RESOURCE' commands.
(kubed-logs): Extend with more optional arguments, integrate
with new transient menu.

; * cobra.el (cobra-completion-table): Add TODO comment.

; * kubed.texi (Browse Resources): Fix typo.

Bind 'kubed-list-update' to "g" instead of "G"

* kubed-transient.el (kubed-transient-create-ingress)
* kubed.el (kubed-list-mode-map)
* kubed.texi (Browse Resources): Update binding of
'kubed-list-update'.

Suggested by Augusto Stoffel <arstoffel@gmail.com>

Fix default namespace selection in other contexts

* kubed.el (kubed--namespace): New function.  Use it instead
of 'kubed-local-namespace' for contexts other than
'kubed-local-context'.

; Update NEWS.org and bump version to 0.3.2

New user option 'kubed-default-context-and-namespace'

* kubed.el (kubed-default-context-and-namespace): New user
option and function of same name.
(kubed-default-context, kubed-default-namespace): New funcs.
(kubed-local-namespace, kubed-local-context)
(kubed-local-context-and-namespace): Use them.  Adjust
calls to 'kubed-local-namespace'.
* kubed.texi (Context and Namespace): New section.

Teach additional commands about buffer-local contexts

* kubed.el (kubed-set-namespace): Update docstring.
(kubed-apply, kubed-run, kubed-logs, kubed-attach)
(kubed-forward-port-to-pod, kubed-stop-port-forward): Use
buffer-local context.

; Fix regex matching multi-hop Tramp file names

* kubed.el (kubed-local-namespace)
(kubed-local-context-and-namespace): Tweak regex.

Teach 'kubed-exec' about buffer-local contexts

* kubed.el (kubed-diff): Use buffer-local context and
change handling of prefix argument.
* kubed-transient.el (kubed-transient-exec): Add
"--context=" infix argument.

Teach 'kubed-diff' about buffer-local contexts

* kubed.el (kubed-diff): Use buffer-local context and
handle prefix arg.
* kubed-transient.el (kubed-transient-diff): Add
"--context=" infix argument.

Teach 'kubed-patch' about buffer-local contexts

* kubed.el (kubed-patch): Use buffer-local context and
handle prefix arg.
* kubed-transient.el (kubed-transient-patch): Add
"--context=" infix argument.

; (kubed-resource-names): Default to local context and namespace

Teach rollout commands about buffer-local contexts

* kubed-transient.el (kubed-transient-rollout): Add
"--context" infix argument.
* kubed.el (kubed-restart-deployment)
(kubed-watch-deployment-status): Use local context and
namespace.  Also add callback argument to 'watch' command.

; Use local context as default in some prompts

; (kubed-current-namespace): Use buffer-local context.

Use buffer-local context in 'kubed-list-*' commands

* kubed.el (kubed-define-resource): Use 'kubed-local-context'
instead of 'kubed-current-context' in generated 'kubed-list-*'
commands, and likewise for the namespace.

; (kubed-list-delete-marked): Update original buffer.

; Fix errors in last commit

* kubed.el (kubed-create-namespace, kubed-create): Restore
'interactive'.
(kubed-create-deployment): Use 'kubed-update', not
'kubed-list-update', in case we're called from other buffer.

Teach creation commands about buffer-local contexts

* kubed.el (kubed-list-create): Remove obsolete comment.
(kubed-define-resource): Refine interactive spec for
generated 'kubed-create-RESOURCE' commands.
(kubed-create-namespace, kubed-create-job)
(kubed-create-job-from-cronjob, kubed-create-deployment)
(kubed-create-cronjob, kubed-create-ingress, kubed-create):
Honor buffer-local context and namespace.
* kubed-transient.el (kubed-transient-create): Bind more
commands, add "--context=" infix arg, update layout.
(kubed-transient-create-cronjob)
(kubed-transient-create-ingress)
(kubed-transient-create-deployment)
(kubed-transient-create-job): Add "--context=" infix arg.

Teach edit commands about buffer-local contexts and namespaces

* kubed.el (kubed-edit-resource): Add interactive spec.
(kubed-define-resource): Refine interactive spec for
generated 'kubed-edit-RESOURCE' commands.
* kubed-transient.el (kubed-transient-edit): New transient.
(kubed-transient): Bind it.

Teach deletion commands about buffer-local contexts and namespaces

* kubed.el (kubed-delete-resources): Refine interactive spec.
(kubed-define-resource): Refine interactive spec for
generated 'kubed-delete-RESOURCES' commands.
* kubed-transient.el (kubed-transient-delete): New transient.
(kubed-transient): Bind it.

; (kubed-display-resource): Only ask for namespace when needed.

; Improve docstrings of resource-displaying commands

; * kubed.el (kubed-define-resource): Fix typo.

Consider buffer-local context+namespace in all display commands

* kubed-transient.el (kubed-transient-infix): Remove.
(kubed-transient-read-context): New function.
(kubed-transient-read-namespace): Take into account value of
"--context=" infix argument.
(kubed-transient-display): Add "--context=" infix argument.
* kubed.el (kubed-display-resource): Update interactive spec.
(kubed--static-if): Simplify empty "else" parts.
(kubed-define-resource): Update interactive spec for
generated 'kubed-display-RESOURCE' commands.
(kubed-local-context, kubed-local-namespace)
(kubed-local-context-and-namespace): New functions.

Support selecting context in all 'kubed-list-*' commands

* kubed.el (kubed-define-resource): Improve docstring and
interactive spec of generated 'kubed-list-*' commands.

; * kubed-transient.el (kubed-list-transient): Fix typo.

; Fix typo

New commands for editing displayed resources

* kubed.el (kubed-display-resource-diff)
(kubed-display-resource-replace): New commands.
(kubed-display-resource-mode-map): Bind them.
(kubed-display-config): Fix typo.
(kubed-diff): Learn to use a buffer as DEFINITION.
* kubed.texi (Display Resource): Document new commands.
* NEWS.org: Mention it.

; * kubed.el (kubed-list-filter-operator-alist): Fix typo.

New list filter operators '<' and '>'

* kubed.el (kubed-list-filter-lt-operator)
(kubed-list-filter-gt-operator): New functions.
(kubed-list-filter-operator-alist): Add them.
* kubed.texi (List Filter): Document them.

; * kubed.el: Update Commentary.

; Update NEWS.org and bump version to 0.3.1

Add transient menu for help in resource list buffers

* kubed-transient.el (kubed-list-transient): New transient.
(kubed-list-mode-map): Bind it.
* kubed.texi (Browse Resources): Document it.

; New command 'kubed-list-create'

* kubed.el (kubed-list-create): New command.
(kubed-list-mode-map): Bind it.
(kubed-define-resource): Use it to simplify generated
'kubed-create-*' commands.

New command 'kubed-list-fit-column-width-to-content'

* kubed.el (kubed-list-column-number-at-point): New function.
(kubed-list-fit-column-width-to-content): New command.
(kubed-list-mode-map): Bind it.
* kubed.texi (Browse Resources): Document it.

Update installation instructions following inclusion in ELPA

* README.md (Getting Started)
* kubed.texi (Getting Started): Suggest installing from ELPA.

; Exclude README.md from ELPA tarball

(Browse Resources): Update common commands table.

; (kubed-display-resource-jump-to-list): Simplify.

; Update NEWS.org and bump version to 0.3.0

; Add .elpaignore file

; Update copyright notices for GNU ELPA

Support bookmarking resource list buffers

* kubed.el (kubed-list-go-to-line): New function, extracted
from...
(kubed-display-resource-jump-to-list): ...here.
(kubed-list-handle-bookmark, kubed-list-make-bookmark): New
functions.
(kubed-list-mode): Set 'bookmark-make-record-function'.

; Fix population of 'kubed--columns'

Major cleanup: simplify and extend resource lists

This is a big refactor that does the following:

- Significantly simplify 'kubed-define-resource', use common
  type-generic code in runtime instead of generating duplicate code
  for each type.

- Support multiple list buffers with per-buffer namespace
  and context.

- Drop 'kubed-all-namespaces-mode', at least for now.

; Tweak autoloading for transients

* kubed-transient.el (kubed-transient): Tweak autoloading
(https://github.com/eshelyaron/kubed/issues/1).

New manual section about displaying resources

* kubed.texi (Display Resource): New section.

New transient menu for displaying resources

* kubed-transient.el (kubed-transient-display): New command.
(kubed-transient): Bind it.
* kubed.el (kubed-display-resource-short-description)
(kubed-namespaced-p): New functions.
(kubed-display-resource): New command, use them.
(kubed-display-resource-handle-bookmark)
(kubed-display-resource-make-bookmark): Simplify.
(kubed-define-resource): Adjust generated
'kubed-display-RESOURCE' commands to honor namespace set in
'kubed-transient-display'.  Change binding of these commands
from suffix "g" to suffix "RET".
(kubed-api-resources): Add optional arg ONLY-NAMESPACED.
(kubed-prefix-map, kubed-menu-map): Bind 'kubed-define-resource'.

New command 'kubed-display-resource-jump-to-list'

* kubed.el (kubed-display-resource-jump-to-list): New command.
(kubed-display-resource-p): New function, use it as
'completion-predicate' property of new command.
(kubed-display-resource-mode-map): Bind new command.

; Move some user option definitions together

Always display message when done updating resources

* kubed.el (kubed-define-resource): In generated
'kubed-update-RESOURCEs', emit message in process sentinel regardless
of optional argument.

Support bookmarking Kubernetes resource buffers

* kubed.el (kubed-display-resource-info): New variable.
(kubed-display-resource-revert)
(kubed-display-resource-in-buffer)
(kubed-display-resource-handle-bookmark)
(kubed-display-resource-make-bookmark): New functions.
(kubed-display-resource-mode): New minor mode, enabled in
buffers that display resources in YAML format.
(kubed-define-resource): Use 'kubed-display-resource-in-buffer'
in definition of generated 'kubed-RESOURCE-description-buffer'.

; Add 'kubed-list-copy-as-kill' to context menus

* kubed.el (kubed-list-copy-as-kill): Fix typo.
(kubed-list-context-menu): New function.
(kubed-list-mode): Add it to 'context-menu-functions'.
* kubed.texi (Browsing Resources): Mention
'kubed-list-copy-as-kill'.

New commands that run kubectl with resource at point as arg

* kubed.el (kubed-define-resource): Also generate
'kubed-RESOURCEs-kubectl-command' command and bind it to "!"
in resource list buffers.
(kubed-read-kubectl-command): New function, extracted from..
(kubed-kubectl-command): ...here.

New command 'kubed-list-copy-as-kill'

* kubed.el (kubed-list-copy-as-kill): New command.
(kubed-list-mode-map): Bind it to "w".

(cobra-read-command-line): Fix handling of cons INITIAL arg

Update NEWS.org and bump version to 0.2.0

(List Filter): Document 'kubed-list-filter-operator-alist'

New user option 'kubed-list-filter-operator-alist'

* kubed.el (kubed-list-filter-operator-alist): New option.
(kubed-list-interpret-atomic-filter)
(kubed-list-validate-atomic-filter): Use it instead of hardcoding
operators "=" and "~".
(kubed-list-set-filter): Adjust docstring.

; * kubed.texi (Browsing Resources): Tweak wording.

; * kubed.texi (Browsing Resources): Fix markup.

Document a couple more 'tabulated-list-mode' commands

* kubed.texi (Browsing Resources): Extend.

Document resource lists and their filters

* kubed.texi (Usage): Add anchor for 'kubed-prefix-map'.
(Browsing Resources): Populate.
(List Filter): New node.

New commands for table navigation

* kubed.el (kubed-list-previous-column)
(kubed-list-next-column): New commands.
(kubed-list-mode-map): Bind them.

(kubed-list-read-filter-map): Bind 'completion-help-at-point'.

; * kubed.el (kubed-list-read-filter): Also complete operators.

; * kubed.el (kubed-list-read-filter): Fix typo.

Enhance 'kubed-list-read-filter'

Add in-minibuffer feedback for invalid filters and completion for
column names and column values.

* kubed.el (kubed-list-validate-atomic-filter)
(kubed-list-validate-filter): Refine validation.
(kubed--list-read-filter-target-buffer): New local var.
(kubed-list-try-read-filter): New command.
(kubed-list-read-filter-map): New keymap.
(kubed-list-read-filter): Use it, add completion support.

New command 'kubed-list-set-filter' in list buffers

* kubed.el: (kubed-list-filter-history-variable)
(kubed-list-filter): New buffer-local variables.
(kubed-list-interpret-atomic-filter)
(kubed-list-interpret-filter)
(kubed-list-validate-atomic-filter)
(kubed-list-validate-filter)
(kubed-list-read-filter): New functions.
(kubed-list-set-filter): New command.
(kubed-list-mode-map): Bind it.
(kubed-define-resource): Use it.

Add common parent mode for resource lists mode

Use multi-column layout for transient menus

* kubed-transient.el (kubed-transient)
(kubed-transient-attach, kubed-transient-diff)
(kubed-transient-exec, kubed-transient-run)
(kubed-transient-apply, kubed-transient-patch)
(kubed-transient-create, kubed-transient-create-cronjob)
(kubed-transient-create-ingress, kubed-transient-create-job)
(kubed-transient-create-deployment): Use multiple columns.

Ensure SPC is self-inserting when reading kubectl command line

* cobra.el (cobra-read-command-line): Ensure SPC key is
self-inserting in the minibuffer.

New command 'kubed-transient-rollout'

* kubed-transient.el (kubed-transient-rollout): New command.
(kubed-transient): Bind it.
* kubed.el (kubed-watch-deployment-status)
(kubed-restart-deployment): Use namespace argument from
transient when specified.

New command 'kubed-watch-deployment-status'

* kubed.el (kubed-watch-deployment-status): New command.
(kubed-restart-deployment-watch-status): New use option.
(kubed-restart-deployment): Use them.
(deployment): Bind it in prefix map and in list buffer.

; Fix 'restart' command name in deployments list buffer

Bind 'kubed-restart-deployment' in 'kubed-deployment-prefix-map'

New command 'kubed-restart-deployment'

* kubed.el (kubed-restart-deployment)
(kubed-deployments-restart): New commands.

; * kubed.el (kubed-define-resource): Remove extraneous quote.