pseek 3.4.0__tar.gz → 3.4.2__tar.gz

{pseek-3.4.0 → pseek-3.4.2}/.github/workflows/publish.yml

@@ -10,6 +10,10 @@ jobs:
 
     runs-on: ubuntu-latest
 
+    concurrency:
+      group: pseek-pypi-publish
+      cancel-in-progress: false
+
     permissions:
       contents: read
 
@@ -51,3 +55,4 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true

{pseek-3.4.0 → pseek-3.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pseek
-Version: 3.4.0
+Version: 3.4.2
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -174,6 +174,26 @@ To search for a query that starts with `-`, use `--` to mark the end of options:
 psk -- --path
 ```
 
+Of course the search query is optional. When no query is provided, Pseek displays the files and directories and file contents within the selected scope.
+
+All other filters still apply, including `--glob`, `--depth`, `--size`, ignore rules, and other filtering options.
+
+This makes Pseek useful as a flexible alternative to `ls` or `cat`, allowing you to inspect a filtered view of a directory tree and file contents.
+
+```bash
+# List files and directories and file contents
+psk
+
+# List only Python files
+psk --ext py
+
+# List everything up to depth 2
+psk --depth :2
+
+# List everything except the build directory
+psk --exclude build
+```
+
 ## Command Options
 
 | Option | Description |
@@ -309,6 +329,8 @@ psk apple --fuzzy
 
 Can match: `appl`, `appel`, `aple`
 
+> **Note:** To improve performance, highlighting of matches is automatically disabled if the `--fuzzy` flag is enabled and the `--word` flag is disabled.
+
 #### Fuzzy Similarity Threshold
 
 ```bash
@@ -339,6 +361,8 @@ Enable:
 psk '("error" or "warning") and not "debug"' --expr
 ```
 
+> **Note:** When using `--expr`, queries are double-quoted and backslashes have special meaning. Ordinary queries use JSON-style escaping, so `\n` and `\t` represent newline and tab characters, respectively. Use `\\n` or `\\t` to search for those literal sequences. Regex queries (`r"..."`) preserve regex escapes, which are interpreted by the regex engine.
+
 ### Supported Operators
 
 #### AND

{pseek-3.4.0 → pseek-3.4.2}/README.md

@@ -146,6 +146,26 @@ To search for a query that starts with `-`, use `--` to mark the end of options:
 psk -- --path
 ```
 
+Of course the search query is optional. When no query is provided, Pseek displays the files and directories and file contents within the selected scope.
+
+All other filters still apply, including `--glob`, `--depth`, `--size`, ignore rules, and other filtering options.
+
+This makes Pseek useful as a flexible alternative to `ls` or `cat`, allowing you to inspect a filtered view of a directory tree and file contents.
+
+```bash
+# List files and directories and file contents
+psk
+
+# List only Python files
+psk --ext py
+
+# List everything up to depth 2
+psk --depth :2
+
+# List everything except the build directory
+psk --exclude build
+```
+
 ## Command Options
 
 | Option | Description |
@@ -281,6 +301,8 @@ psk apple --fuzzy
 
 Can match: `appl`, `appel`, `aple`
 
+> **Note:** To improve performance, highlighting of matches is automatically disabled if the `--fuzzy` flag is enabled and the `--word` flag is disabled.
+
 #### Fuzzy Similarity Threshold
 
 ```bash
@@ -311,6 +333,8 @@ Enable:
 psk '("error" or "warning") and not "debug"' --expr
 ```
 
+> **Note:** When using `--expr`, queries are double-quoted and backslashes have special meaning. Ordinary queries use JSON-style escaping, so `\n` and `\t` represent newline and tab characters, respectively. Use `\\n` or `\\t` to search for those literal sequences. Regex queries (`r"..."`) preserve regex escapes, which are interpreted by the regex engine.
+
 ### Supported Operators
 
 #### AND

{pseek-3.4.0 → pseek-3.4.2}/pseek/cli.py

@@ -306,7 +306,7 @@ def check_rar_backend(archive_enabled: bool, tool_path: str, backend: str):
 
 
 @click.command()
-@click.argument('query')
+@click.argument('query', required=False)
 @click.argument('path', type=click.Path(exists=True, file_okay=False, dir_okay=True),
                 default='.', required=False)
 # Search type options

{pseek-3.4.0 → pseek-3.4.2}/pseek/parser.py

@@ -1,4 +1,4 @@
-import re, click
+import re, click, json
 from lark import Lark, Transformer
 from .utils import compile_regex
 from rapidfuzz import fuzz
@@ -139,6 +139,19 @@ PREFIXED_STRING: /(r|c|w|f|rc|cr|cw|wc|cf|fc|wf|fw|cwf|cfw|wcf|wfc|fcw|fwc)"([^"
 QUERY_PARSER = Lark(query_grammar, parser='lalr')
 
 
+def decode_expr_string(token: str, regex: bool = False) -> str:
+    """
+    Decode a quoted expression string.
+
+    Normal strings use JSON-style escaping.
+    """
+    if not regex:
+        return json.loads(token)
+
+    # Keep regex escapes such as \b, \d, and \w intact
+    return token[1:-1]
+
+
 class TreeToExpr(Transformer):
     """Transform parsed tree into expression tree (ExprNode subclasses)"""
     def __init__(self, fuzzy_level):
@@ -147,7 +160,7 @@ class TreeToExpr(Transformer):
 
     def string(self, s):
         """ Match normal quoted string: "foo" """
-        term = s[0][1:-1]  # Remove surrounding quotes (e.g., "foo" -> foo)
+        term = decode_expr_string(str(s[0]))
         return TermNode(
             term,
             False,
@@ -158,13 +171,19 @@ class TreeToExpr(Transformer):
         )
 
     def prefixed_string(self, s):
+        """Transform a prefixed search term"""
         text = str(s[0])  # e.g., 'rc"pattern"'
-        prefix = text.split('"', 1)[0].lower()
-        content = text.split('"', 1)[1][:-1]
+
+        quote_index = text.index('"')
+        prefix = text[:quote_index].lower()
+        quoted = text[quote_index:]
+
+        is_regex = 'r' in prefix
+        content = decode_expr_string(quoted, is_regex)
 
         return TermNode(
             content,
-            regex='r' in prefix,
+            regex=is_regex,
             whole_word='w' in prefix,
             case_sensitive='c' in prefix,
             fuzzy='f' in prefix,
@@ -187,6 +206,9 @@ def parse_query_expression(config) -> ExprNode:
     If expr is False, treat the whole query as a single term.
     """
 
+    if config.query is None:
+        return None
+
     if not config.expr:
         return TermNode(
             config.query,
@@ -352,6 +374,9 @@ def evaluate_with_matches(
 def find_matches(expr: ExprNode, text: str, num: int = 0) -> list[tuple[int, int]]:
     """Find spans that contribute to a successful expression"""
 
+    if expr is None:
+        return []
+
     matched, matches = evaluate_with_matches(expr, text, num)
     # Remove duplicate ranges
     return list(dict.fromkeys(matches)) if matched else []

{pseek-3.4.0 → pseek-3.4.2}/pseek/searcher.py

@@ -61,7 +61,7 @@ def search_file_and_dir(config, matches: dict, pattern, p: Path,
         None
     )
 
-    if match_type and pattern.evaluate(p.name):
+    if match_type and (pattern is None or pattern.evaluate(p.name)):
         # Find matched query in the name
         name_matches = find_matches(
             pattern,
@@ -102,7 +102,7 @@ def search_file_and_dir(config, matches: dict, pattern, p: Path,
                 None
             )
             
-            if arc_match_type and pattern.evaluate(name.name):
+            if arc_match_type and (pattern is None or pattern.evaluate(name.name)):
                 name_matches = find_matches(
                     pattern,
                     name.name,
@@ -231,7 +231,7 @@ def search_content(config, matches: dict, pattern, binary_pattern,
 
             collector = ContextCollector(config.context)
             for num, line in enumerate(decoded_content.splitlines(), 1):
-                matched = pattern.evaluate(line)
+                matched = pattern is None or pattern.evaluate(line)
 
                 if config.paths_only and matched:
                     add_result(
@@ -285,7 +285,7 @@ def search_content(config, matches: dict, pattern, binary_pattern,
                 # Skip lines that can't be decoded
                 continue
 
-            matched = pattern.evaluate(line_decoded)
+            matched = pattern is None or pattern.evaluate(line_decoded)
 
             # Avoid searching through the entire file content if the paths-only flag is True
             if config.paths_only and matched:

{pseek-3.4.0 → pseek-3.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "pseek"
-version = "3.4.0"
+version = "3.4.2"
 description = "Pseek is a Python CLI toolkit to search files, folders, and text"
 readme = "README.md"
 license = "MIT"