Fix handling of context names with non-alphanumeric characters

Hex-encode most non-alphanumeric characters in kubectl context names
in Tramp file names.  This allows our Tramp method to work with
context names that contain characters which are not allowed in the
host name part of Tramp file names, such as ':'.

This (hopefully) fixes the issue reported at
https://lists.sr.ht/~eshel/kubed-devel/%3C87ldqz70a6.fsf@gmail.com%3E

* kubed-common.el (kubed-tramp-method): Bump to v2.
* kubed-tramp.el (kubed-tramp--unhex)
(kubed-tramp--decode-context-name)
(kubed-tramp--v2-context): New functions.
(kubed-tramp-context, kubed-tramp-enable): Adjust.
* kubed.el (kubed--hex-encoding-table)
(kubed--hex-allowed-chars-table): New constants.
(kubed--encode-context-name): New function.
(kubed-remote-file-name): Use it.

; Improve prompts for log limits

* kubed-transient.el (kubed-transient-logs-for-resource):
(kubed-transient-logs): Improve some prompts.

(Prompted by https://github.com/eshelyaron/kubed/issues/13)

; Bundle image files for inclusion in the manual

* kubed.texi: adjust image references to cooperate with HTML
manual generation on the ELPA server (see Emacs bug#73425.)

(kubed-set-namespace): Improve message.

(kubed-list-next-column): Fix error when called at end of buffer.

; Update NEWS.org and bump version to 0.4.3

* kubed.el:
* kubed.texi:
* NEWS.org: Update for version 0.4.3

Fix prompt in logs line limit

Copyright-paperwork-exempt: yes

Fix 'kubed-list-delete-marked' in non-default context

* kubed.el (kubed-list-delete-marked): Respect
'kubed-list-context' and 'kubed-list-namespace'.

Fixes https://github.com/eshelyaron/kubed/issues/9

; Update copyright years

* kubed.el (kubed-define-resource): Improve docstring.

Addresses https://github.com/eshelyaron/kubed/issues/8

; Fix typo in NEWS.org

Copyright-paperwork-exempt: yes

; Update NEWS.org and bump version to 0.4.2

* kubed.el:
* kubed.texi:
* NEWS.org: Update for version 0.4.2

; * kubed.el (kubed-submit-bug-report): Fix docstring.

; Autoload 'kubed-tramp'

Ensure that 'kubed-tramp' is loaded by the time it is
needed, to avoid "Method 'kubedv1' is not known" errors.
Ideally, we'd like to load 'kubed-tramp' on the first
occasion of handling a '/kubedv1:...' remote file name.
However, Tramp does not facilitate loading extensions just
in time.  The best we can do is to arrange for 'kubed-tramp'
to be loaded right after Tramp.  This is too early, because
Tramp is often used without 'kubed-tramp', so we move some
definitions around so that it no longer pulls in 'kubed'.

See also preceding tramp-devel discussion here:
https://lists.gnu.org/archive/html/tramp-devel/2024-10/msg00005.html

* kubed-common.el: New file.
(kubed-tramp-method, kubed-kubectl-program): Move here from
'kubed' and 'kubed-tramp', respectively.
* kubed-tramp.el: Require 'kubed-common' instead of 'kubed'.
(kubed-tramp-method): Move to 'kubed-common'.
(kubed-tramp-remote-file-name): Remove in favor of new
'kubed-remote-file-name' in 'kubed'.
(kubed-tramp-enable): New function, arrange for it to be
called after 'tramp' is loaded.
* kubed.el: Require 'kubed-common'.
(kubed-kubectl-program): Move to 'kubed-common'.
(kubed-remote-file-name): New function, replaces
'kubed-tramp-remote-file-name'.
(pod): Use it.

; Use correct plural forms of resource types

* kubed.el (kubed-define-resource): Use provided plural form in
'mode-name' of generated major mode.

New user option 'kubed-list-mode-line-format'

* kubed.el (kubed-list-mode-line-format): New user option,
extracted from...
(kubed-define-resource): ...here.  Use it in 'mode-name' of
generated major modes.  This allows users to customize the indicator
we show in the mode line when update is in progress.
* kubed.texi (Browse Resources): Document new user option.
* NEWS.org: Announce it.

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.