cdhist 4.2__tar.gz → 4.4__tar.gz

{cdhist-4.2 → cdhist-4.4}/Makefile

@@ -9,10 +9,10 @@ check:
 
 build:
 	rm -rf dist
-	python3 -m build --sdist --wheel
+	uv build
 
 upload: build
-	twine3 upload dist/*
+	uv-publish
 
 doc:
 	update-readme-usage

{cdhist-4.2 → cdhist-4.4}/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: cdhist
-Version: 4.2
+Version: 4.4
 Summary: Program to provide a Linux cd history directory stack
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
-License: GPLv3
+License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/bulletmark/cdhist
 Keywords: bash,zsh,cd,fzf,git,worktree
 Classifier: Programming Language :: Python :: 3
@@ -85,14 +85,19 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+Note that `cd -1` is equivalent to the native `cd -` for the previous
+directory, `cd -2` is the directory before that, etc.
+
+Search back through stack for directory containing "string" in it's name and
+`cd` there:
 
 ```sh
 $ cd -/string
 ```
 
-Note, you can also type `string` at the `cd --` prompt to search.
+Note, you can also type the text `string` at the `cd --` prompt to search, although for
+frequent searching it is probably better to use an [integrated fuzzy
+finder](#fuzzy-finder-integration).
 
 Show help/usage:
 
@@ -192,16 +197,23 @@ E.g. to use [`fzf`][fzf]:
 source <(cdhist -i "cd -F fzf")
 ```
 
-Or, to use [`television`][television]:
+Or, to use [`television`][television] with [`exa`][exa] to show a preview of
+directory contents:
 
 ```sh
-source <(cdhist -i "cd -F \"tv --no-preview\"")
+source <(cdhist -i "cd -uF \"tv --preview 'exa --color=always -l@F=always {}'\"")
 ```
 
 Now when you type `cd --` you will be prompted with a list of directories via
 your fuzzy finder so you can search for a directory to select by fuzzy text
 matching.
 
+Note if you use [`television`][television] then it is suggested to set the
+`television` option `input_bar_position = bottom` in the `ui` section of your
+[`~/.config/television/config.toml`](https://github.com/alexpasmantier/television/blob/main/.config/config.toml)
+file so that the input bar is at the bottom of the screen and close where your
+terminal prompt usually is.
+
 In the following description, [`fzf`][fzf] will be used as it is by far the
 most popular fuzzy finder and the one used by the author. When you set up `fzf`
 [shell integration](https://junegunn.github.io/fzf/shell-integration/) then you
@@ -218,7 +230,7 @@ I disable that function in `fzf` by setting the `FZF_ALT_C_COMMAND` to an empty
 string before I source `fzf` in my `.bashrc` when [setting `fzf` up](https://junegunn.github.io/fzf/shell-integration/#setting-up-shell-integration).
 
 Then I set the following shell key binding in my `~/.inputrc` file (need to
-restart your shell to activate):
+restart your login shell/terminal to activate):
 
 ```sh
 "\ec": "cd --\n"
@@ -251,6 +263,11 @@ you don't then just specify the full path, e.g:
 source <(cdhist -i "cd -F /path-to/fzf")
 ```
 
+### Yazi Integration
+
+[`cdhist.yazi`][cdhist.yazi] is a [Yazi][yazi] plugin that provides cdhist
+functionality within the [Yazi][yazi] terminal file manager.
+
 ### GIT Worktree Integration
 
 [cdhist](http://github.com/bulletmark/cdhist) can be used to easily `cd`
@@ -415,3 +432,6 @@ Public License at <http://www.gnu.org/licenses/> for more details.
 [fzy]: https://github.com/jhawthorn/fzy
 [skim]: https://github.com/skim-rs/skim
 [television]: https://github.com/alexpasmantier/television
+[cdhist.yazi]: https://github.com/bulletmark/cdhist.yazi
+[yazi]: https://yazi-rs.github.io/
+[exa]: https://github.com/ogham/exa

cdhist-4.2/cdhist.egg-info/PKG-INFO → cdhist-4.4/README.md

@@ -1,15 +1,3 @@
-Metadata-Version: 2.2
-Name: cdhist
-Version: 4.2
-Summary: Program to provide a Linux cd history directory stack
-Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
-License: GPLv3
-Project-URL: Homepage, https://github.com/bulletmark/cdhist
-Keywords: bash,zsh,cd,fzf,git,worktree
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-
 ## CDHIST - Linux Directory History
 [![PyPi](https://img.shields.io/pypi/v/cdhist)](https://pypi.org/project/cdhist/)
 [![AUR](https://img.shields.io/aur/version/cdhist)](https://aur.archlinux.org/packages/cdhist/)
@@ -85,14 +73,19 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+Note that `cd -1` is equivalent to the native `cd -` for the previous
+directory, `cd -2` is the directory before that, etc.
+
+Search back through stack for directory containing "string" in it's name and
+`cd` there:
 
 ```sh
 $ cd -/string
 ```
 
-Note, you can also type `string` at the `cd --` prompt to search.
+Note, you can also type the text `string` at the `cd --` prompt to search, although for
+frequent searching it is probably better to use an [integrated fuzzy
+finder](#fuzzy-finder-integration).
 
 Show help/usage:
 
@@ -192,16 +185,23 @@ E.g. to use [`fzf`][fzf]:
 source <(cdhist -i "cd -F fzf")
 ```
 
-Or, to use [`television`][television]:
+Or, to use [`television`][television] with [`exa`][exa] to show a preview of
+directory contents:
 
 ```sh
-source <(cdhist -i "cd -F \"tv --no-preview\"")
+source <(cdhist -i "cd -uF \"tv --preview 'exa --color=always -l@F=always {}'\"")
 ```
 
 Now when you type `cd --` you will be prompted with a list of directories via
 your fuzzy finder so you can search for a directory to select by fuzzy text
 matching.
 
+Note if you use [`television`][television] then it is suggested to set the
+`television` option `input_bar_position = bottom` in the `ui` section of your
+[`~/.config/television/config.toml`](https://github.com/alexpasmantier/television/blob/main/.config/config.toml)
+file so that the input bar is at the bottom of the screen and close where your
+terminal prompt usually is.
+
 In the following description, [`fzf`][fzf] will be used as it is by far the
 most popular fuzzy finder and the one used by the author. When you set up `fzf`
 [shell integration](https://junegunn.github.io/fzf/shell-integration/) then you
@@ -218,7 +218,7 @@ I disable that function in `fzf` by setting the `FZF_ALT_C_COMMAND` to an empty
 string before I source `fzf` in my `.bashrc` when [setting `fzf` up](https://junegunn.github.io/fzf/shell-integration/#setting-up-shell-integration).
 
 Then I set the following shell key binding in my `~/.inputrc` file (need to
-restart your shell to activate):
+restart your login shell/terminal to activate):
 
 ```sh
 "\ec": "cd --\n"
@@ -251,6 +251,11 @@ you don't then just specify the full path, e.g:
 source <(cdhist -i "cd -F /path-to/fzf")
 ```
 
+### Yazi Integration
+
+[`cdhist.yazi`][cdhist.yazi] is a [Yazi][yazi] plugin that provides cdhist
+functionality within the [Yazi][yazi] terminal file manager.
+
 ### GIT Worktree Integration
 
 [cdhist](http://github.com/bulletmark/cdhist) can be used to easily `cd`
@@ -415,3 +420,6 @@ Public License at <http://www.gnu.org/licenses/> for more details.
 [fzy]: https://github.com/jhawthorn/fzy
 [skim]: https://github.com/skim-rs/skim
 [television]: https://github.com/alexpasmantier/television
+[cdhist.yazi]: https://github.com/bulletmark/cdhist.yazi
+[yazi]: https://yazi-rs.github.io/
+[exa]: https://github.com/ogham/exa

{cdhist-4.2 → cdhist-4.4}/cdhist/utils.py

@@ -7,6 +7,7 @@ import subprocess
 import sys
 from argparse import Namespace
 from pathlib import Path
+import shlex
 
 HOME = Path.home()
 
@@ -23,7 +24,7 @@ def unexpanduser(path: str | Path) -> str:
 
 def fuzzy_prompt(args: Namespace, dirlist: list[str]) -> str | None:
     res = subprocess.run(
-        args.fuzzy.split(), input='\n'.join(dirlist), stdout=subprocess.PIPE, text=True
+        shlex.split(args.fuzzy), input='\n'.join(dirlist), stdout=subprocess.PIPE, text=True
     )
 
     if res.returncode != 0:

cdhist-4.2/README.md → cdhist-4.4/cdhist.egg-info/PKG-INFO

@@ -1,3 +1,15 @@
+Metadata-Version: 2.4
+Name: cdhist
+Version: 4.4
+Summary: Program to provide a Linux cd history directory stack
+Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/bulletmark/cdhist
+Keywords: bash,zsh,cd,fzf,git,worktree
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
 ## CDHIST - Linux Directory History
 [![PyPi](https://img.shields.io/pypi/v/cdhist)](https://pypi.org/project/cdhist/)
 [![AUR](https://img.shields.io/aur/version/cdhist)](https://aur.archlinux.org/packages/cdhist/)
@@ -73,14 +85,19 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+Note that `cd -1` is equivalent to the native `cd -` for the previous
+directory, `cd -2` is the directory before that, etc.
+
+Search back through stack for directory containing "string" in it's name and
+`cd` there:
 
 ```sh
 $ cd -/string
 ```
 
-Note, you can also type `string` at the `cd --` prompt to search.
+Note, you can also type the text `string` at the `cd --` prompt to search, although for
+frequent searching it is probably better to use an [integrated fuzzy
+finder](#fuzzy-finder-integration).
 
 Show help/usage:
 
@@ -180,16 +197,23 @@ E.g. to use [`fzf`][fzf]:
 source <(cdhist -i "cd -F fzf")
 ```
 
-Or, to use [`television`][television]:
+Or, to use [`television`][television] with [`exa`][exa] to show a preview of
+directory contents:
 
 ```sh
-source <(cdhist -i "cd -F \"tv --no-preview\"")
+source <(cdhist -i "cd -uF \"tv --preview 'exa --color=always -l@F=always {}'\"")
 ```
 
 Now when you type `cd --` you will be prompted with a list of directories via
 your fuzzy finder so you can search for a directory to select by fuzzy text
 matching.
 
+Note if you use [`television`][television] then it is suggested to set the
+`television` option `input_bar_position = bottom` in the `ui` section of your
+[`~/.config/television/config.toml`](https://github.com/alexpasmantier/television/blob/main/.config/config.toml)
+file so that the input bar is at the bottom of the screen and close where your
+terminal prompt usually is.
+
 In the following description, [`fzf`][fzf] will be used as it is by far the
 most popular fuzzy finder and the one used by the author. When you set up `fzf`
 [shell integration](https://junegunn.github.io/fzf/shell-integration/) then you
@@ -206,7 +230,7 @@ I disable that function in `fzf` by setting the `FZF_ALT_C_COMMAND` to an empty
 string before I source `fzf` in my `.bashrc` when [setting `fzf` up](https://junegunn.github.io/fzf/shell-integration/#setting-up-shell-integration).
 
 Then I set the following shell key binding in my `~/.inputrc` file (need to
-restart your shell to activate):
+restart your login shell/terminal to activate):
 
 ```sh
 "\ec": "cd --\n"
@@ -239,6 +263,11 @@ you don't then just specify the full path, e.g:
 source <(cdhist -i "cd -F /path-to/fzf")
 ```
 
+### Yazi Integration
+
+[`cdhist.yazi`][cdhist.yazi] is a [Yazi][yazi] plugin that provides cdhist
+functionality within the [Yazi][yazi] terminal file manager.
+
 ### GIT Worktree Integration
 
 [cdhist](http://github.com/bulletmark/cdhist) can be used to easily `cd`
@@ -403,3 +432,6 @@ Public License at <http://www.gnu.org/licenses/> for more details.
 [fzy]: https://github.com/jhawthorn/fzy
 [skim]: https://github.com/skim-rs/skim
 [television]: https://github.com/alexpasmantier/television
+[cdhist.yazi]: https://github.com/bulletmark/cdhist.yazi
+[yazi]: https://yazi-rs.github.io/
+[exa]: https://github.com/ogham/exa

{cdhist-4.2 → cdhist-4.4}/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "cdhist"
 description = "Program to provide a Linux cd history directory stack"
 readme = "README.md"
+license = "GPL-3.0-or-later"
 requires-python = ">=3.8"
 keywords = ["bash", "zsh", "cd", "fzf", "git", "worktree"]
 classifiers = [
@@ -23,9 +24,6 @@ Homepage = "https://github.com/bulletmark/cdhist"
 [project.scripts]
 cdhist = "cdhist.cdhist:main"
 
-[project.license]
-text = "GPLv3"
-
 [tool.setuptools_scm]
 version_scheme = "post-release"