cdhist 4.2__tar.gz → 4.3__tar.gz

{cdhist-4.2/cdhist.egg-info → cdhist-4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cdhist
-Version: 4.2
+Version: 4.3
 Summary: Program to provide a Linux cd history directory stack
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License: GPLv3
@@ -85,14 +85,16 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+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 +194,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 {}'\"")
 ```
 
 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 +227,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 +260,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 +429,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.3}/README.md

@@ -73,14 +73,16 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+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 +182,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 {}'\"")
 ```
 
 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 +215,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 +248,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 +417,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.3}/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 → cdhist-4.3/cdhist.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cdhist
-Version: 4.2
+Version: 4.3
 Summary: Program to provide a Linux cd history directory stack
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License: GPLv3
@@ -85,14 +85,16 @@ Change immediately to directory corresponding to stack index 4:
 $ cd -4
 ```
 
-Search back through stack for directory containing "string" and `cd`
-there:
+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 +194,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 {}'\"")
 ```
 
 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 +227,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 +260,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 +429,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