fastcore 2.2.33__tar.gz → 2.2.34__tar.gz

{fastcore-2.2.33/fastcore.egg-info → fastcore-2.2.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.2.33
+Version: 2.2.34
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
 License-Expression: Apache-2.0

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/__init__.py

@@ -55,4 +55,4 @@ Modules:
 - `fastcore.xml`: Concise HTML generation and namespace-aware XML construction.
 - `fastcore.xtras`: Utility functions used in the fastai library"""
 
-__version__ = "2.2.33"
+__version__ = "2.2.34"

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/ansi.py

@@ -9,20 +9,21 @@ from html import escape
 __all__ = ["strip_ansi", "ansi2html", "ansi2latex"]
 
 _ANSI_RE = re.compile("\x1b\\[(.*?)([@-~])")
+_OSC_RE = re.compile(r'\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)')
 _ANSI_COLORS = ( "ansi-black", "ansi-red", "ansi-green", "ansi-yellow", "ansi-blue", "ansi-magenta", "ansi-cyan", "ansi-white", "ansi-black-intense",
     "ansi-red-intense", "ansi-green-intense", "ansi-yellow-intense", "ansi-blue-intense", "ansi-magenta-intense", "ansi-cyan-intense", "ansi-white-intense")
 
 def strip_terminal_queries(text):
-    # Remove OSC sequences (like background color queries)
-    text = re.sub('\x1b\\][^\x07]*\x07', '', text)
+    # Remove OSC sequences, such as hyperlinks and background color queries
+    text = _OSC_RE.sub('', text)
     # Remove DSR sequences (device status reports)
     return re.sub(r'\x1b\[[0-9]*n', '', text)
 
 
 def strip_ansi(source, term_queries:bool=False):
-    "Remove ANSI escape codes from text."
+    "Remove ANSI escape codes, including OSC sequences such as hyperlinks, from text."
     if term_queries: source = strip_terminal_queries(source)
-    return _ANSI_RE.sub("", source)
+    return _ANSI_RE.sub("", _OSC_RE.sub("", source))
 
 
 def _htmlconverter(fg, bg, bold, underline, inverse):

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/basics.py

@@ -1314,6 +1314,7 @@ class NotStr(GetAttr):
 class PrettyString(str):
     "Little hack to get strings to show properly in Jupyter."
     def __repr__(self): return self
+    full = True # Tools that truncate long strings show this whole
 
 # %% ../nbs/01_basics.ipynb #a5138103
 def even_mults(start, stop, n):

fastcore-2.2.34/fastcore/editskill.py

@@ -0,0 +1,62 @@
+"""Text, file, cell, and notebook editing from `fastcore.tools` and `fastcore.nbio`, plus the conventions the whole fastai editing toolkit follows. Read this before working with the editing tools in any package that shares them.
+
+`from fastcore.editskill import *` loads `fastcore.tools` and `fastcore.nbio`.
+
+## Targets and tools
+
+Targets: in-memory strings, file paths, notebook cell sources (`path, cell_id`), and held `Notebook`/`NbCell` objects.
+
+- `fastcore.tools`: text primitives, file tools, and `line_hash`/`lnhash`/`lnhash_at` address creation without exhash installed.
+- `fastcore.nbio`: notebook read/write/validate/repair, cell construction/editing, and `Notebook`/`NbCell` session objects with snapshot queries (`find_cells`, `summary_nb`).
+- `exhash.skill`: preferred hash-verified file/cell editing where installed; covers address forms and the verified edit loop.
+- `rgapi.skill`: preferred search where installed: `rg`/`fd`/`ls`/`nbrg` with lnhash output, `rgstr` for text already held.
+- `remold`: structural Python search/rewrite with declarative ast-grep rules, LibCST matcher transforms and symbol queries; the engine behind `ast_replace`.
+- `aidialog.dlgskill`, `dialoghelper`: preferred dialog layer where installed, including its own theory of dialogs and projections. A Solveit dialog is an `.ipynb` with notes, runnable code and prompt/reply pairs. Cell tools handle notebook structure regardless of origin; this layer reads/edits dialog messages.
+
+Open/save: `Notebook.open(path)`, `nb.save()`. Index by position or cell id (exact/unique prefix): `nb[k]` returns a cell, `nb[k] = src` sets its source, `del nb[k]` removes it. `nb.add(src, cell_type)`/`nb.md(src)` insert at `idx`, `after` or `before` a cell id; `nb.move(ids, after=, before=)` reorders cells.
+
+## Naming
+
+- File/notebook/cell/message operations: `verb_target` (`view_file`, `create_file`, `read_nb`, `write_nb`, `view_cell`, `validate_nb`, `view_msg`, `view_dlg`, `lnhashview_cell`). `find_msgs`, `add_msg`, `del_msgs`, `find_cells` need no extra dialog/notebook prefix. `msg` = dialog message; `cell` = notebook cell; `summary_nb` returns notebook-cell rows.
+- Text primitives (`insert_line`, `del_lines`, `replace_lines`, `str_replace`) gain `file_`/`cell_`/`msg_` prefixes (`file_del_lines`, `cell_del_lines`, `msg_del_lines`); address arguments precede the primitive's arguments. `str_replace` retains Anthropic's text editor name/argument order. `ast_replace` (AST patterns) and `exhash` (hash-verified line addresses) use these prefixes too: `file_ast_replace`, `msg_ast_replace`, `file_exhash`, `cell_exhash`.
+- Converters: `x2y` (`nb2dict`, `cell2xml`); methods: `to_y` (`nb.to_dict()`).
+- Plurals accept several items: `view_cell` one cell, `lnhashview_cells` several, `del_msgs` many.
+
+## Parameters: shared vocabulary
+
+- Order: address (`text`; `path`; `path, cell_id`; message `id`), new text, then keyword-only ambient context (message tools' dialog).
+- `start_line`/`end_line`: 1-based, inclusive; `None` = first/last line; negative `end_line` counts from the end. `del_lines` has no defaults: state the range.
+- `re_filter`/`invert_filter`: lines (not) matching a regex, like ex `g//`/`g!//`; combines with the range.
+- Search patterns default to regex; editors default to literal unless `use_regex=True`.
+- Views: `nums` line numbers; `lnhashs` `lineno|hash|` addresses; `maxlen` caps summary lines; `trunc_out`/`trunc_in` truncate dialog outputs/sources.
+- `fd`/`ls`/`rg`/`nbrg` share one include/exclude/ext/hidden/ignore block. `fd`/`rg`/`nbrg`: `pattern` first, `root='.'` second. `ls` is `fd` with listing defaults, but `root` first, like shell `ls DIR`.
+- Filters narrow with `only_*` (`only_err`, `only_exp`, `only_errors`), widen with `incl_*` (`incl_out`).
+- `context=` units: file lines (blocks in summary mode), notebook cells, dialog messages.
+- Editors return a diff: read it as verification rather than re-viewing. No change: fastcore editors and exhash return `none: No changes.`
+
+## Functions and methods
+
+Functions take a path, save and return a diff; methods change held objects, saved explicitly. Methods drop address arguments and the object's part of the name: `cell_str_replace(path, cell_id, ...)` -> `c.str_replace(...)` on `NbCell`; `find_cells(path, pat)` -> `nb.find_cells(pat)` on `Notebook`. Read functions return snapshot rows (addresses, source, metadata); read methods return objects. One style per file: save before switching to functions; reopen before returning to methods.
+
+## Navigation and addresses
+
+When unsure where to edit, start with summaries: rgapi's `rg(summary=True)`/`nbrg`, aidialog's `summary_dlg`, exhash's `open_doc` outlines. They give one addressed row per block/cell/message/section. `open_doc` outlines Markdown, code and notebooks; `doc(open_doc)` covers inputs, navigation and llms.txt. A section is a span of lines or a run of cells, edited through file/cell tools. Token `1.6.|12|Py|,45|HD|` combines section number and first/last-line lnhash range; the range is an exhash address.
+
+Edits take plain line numbers or lnhash addresses obtained while reading: `nums=True`/`lnhashs=True` views, `rg(lnhashs=True)`. Prefer lnhash addresses where exhash is installed; stale ones are rejected. Plain numbers are unverified and shift: re-view after each such edit; apply several bottom-to-top.
+
+Docs: https://fastcore.fast.ai/tools.html.md and https://fastcore.fast.ai/nbio.html.md
+"""
+
+from fastcore.tools import (insert_line, str_replace, strs_replace, replace_lines, del_lines, ast_replace,
+    file_insert_line, file_str_replace, file_strs_replace, file_replace_lines, file_del_lines, file_ast_replace,
+    view_file, create_file, line_hash, lnhash, lnhash_at)
+from fastcore.nbio import (read_nb, write_nb, new_nb, mk_cell, validate_nb, validate_cell, repair_nb, repair_cell,
+    view_cell, cell_insert_line, cell_str_replace, cell_strs_replace, cell_replace_lines, cell_del_lines, cell_ast_replace, Notebook, NbCell, find_cells, summary_nb)
+
+__all__ = ['insert_line', 'str_replace', 'strs_replace', 'replace_lines', 'del_lines', 'ast_replace',
+    'file_insert_line', 'file_str_replace', 'file_strs_replace', 'file_replace_lines', 'file_del_lines', 'file_ast_replace',
+    'view_file', 'create_file', 'line_hash', 'lnhash', 'lnhash_at',
+    'read_nb', 'write_nb', 'new_nb', 'mk_cell', 'validate_nb', 'validate_cell', 'repair_nb', 'repair_cell',
+    'view_cell', 'cell_insert_line', 'cell_str_replace', 'cell_strs_replace', 'cell_replace_lines', 'cell_del_lines', 'cell_ast_replace', 'Notebook', 'NbCell', 'find_cells', 'summary_nb']
+
+__pyskill_params__ = {'replace_params': ('start_line', 'end_line', 'n_matches', 're_filter', 'invert_filter', 'use_regex')}

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/funccall.py

@@ -219,10 +219,9 @@ def _nm_map(nms):
     return py2orig
 
 # %% ../nbs/14_funccall.ipynb #47b49644
-def call_func(fc_name, fc_inputs, ns, raise_on_err=True):
-    "Call the function `fc_name` with the given `fc_inputs` using namespace `ns`."
-    if not isinstance(ns, abc.Mapping): ns = mk_ns(ns)
-    func = resolve_nm(fc_name, ns)
+def call_func(fc_name, fc_inputs, ns=None, raise_on_err=True):
+    "Call `fc_name`, a function or its name in namespace `ns`, with the given `fc_inputs`."
+    func = resolve_nm(fc_name, mk_ns(ns)) if isinstance(fc_name, str) else fc_name
     inps = {_norm_nm(k):v for k,v in fc_inputs.items()}
     inps = coerce_inputs(func, inps)
     try: return func(**inps)
@@ -231,17 +230,12 @@ def call_func(fc_name, fc_inputs, ns, raise_on_err=True):
         else: return traceback.format_exc()
 
 # %% ../nbs/14_funccall.ipynb #73bca085
-async def call_func_async(fc_name, fc_inputs, ns, raise_on_err=True):
-    "Awaits the function `fc_name` with the given `fc_inputs` using namespace `ns`."
-    if not isinstance(ns, abc.Mapping): ns = mk_ns(ns)
-    func = resolve_nm(fc_name, ns)
-    try:
-        res = call_func(fc_name, fc_inputs, ns, raise_on_err=raise_on_err)
-        res = await maybe_await(res)
+async def call_func_async(fc_name, fc_inputs, ns=None, raise_on_err=True):
+    "Awaits `fc_name`, a function or its name in namespace `ns`, with the given `fc_inputs`."
+    try: return await maybe_await(call_func(fc_name, fc_inputs, ns, raise_on_err=raise_on_err))
     except Exception as e:
         if raise_on_err: raise e from None
         else: return traceback.format_exc()
-    return res
 
 # %% ../nbs/14_funccall.ipynb #5a2588d5
 type_map = dict(string=str, boolean=bool, integer=int, number=float, array=list, object=dict)

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/nbio.py

@@ -799,9 +799,10 @@ def to_dict(self:Notebook):
 class Found:
     "Mixin for find-result containers: `matched` ids, id-only indexing, and match/context kinds"
     _unit = 'item'
-    def __init__(self, items=None, matched=None):
+    def __init__(self, items=None, matched=None, maxlen=MAXLEN):
         super().__init__(items if items is not None else [])
         self.matched = set(matched) if matched is not None else {o.id for o in self}
+        self.maxlen = maxlen
     def kind(self, o): return 'match' if o.id in self.matched else 'context'
     def __getitem__(self, k):
         if not isinstance(k, str): raise TypeError(
@@ -814,7 +815,7 @@ class FoundCells(Found, list):
     "Find results: cells indexed by id (exact or unique prefix), shown as `CellRow` lines with context rows marked"
     _unit = 'cell'
     def __repr__(self):
-        rows = [c if isinstance(c, CellRow) else CellRow(c) for c in self]
+        rows = [c if isinstance(c, CellRow) else CellRow(c, self.maxlen) for c in self]
         for r in rows: r.kind = self.kind(r)
         return '\n'.join(repr(r) for r in rows)
 
@@ -825,6 +826,7 @@ def find_cells(self:Notebook,
     cell_type:str=None, # Optional limit by type ('code', 'markdown', or 'raw')
     ids='', # Optional limit by cell ids (comma-separated str, or list); exact or unique prefixes
     context:int=None, # Cells of context around matches (default 1)
+    maxlen:int=MAXLEN, # Maximum source characters per displayed cell
 ):
     "Find live cells matching all the given criteria, plus `context` neighbouring cells"
     if context is None: context = 1
@@ -832,7 +834,7 @@ def find_cells(self:Notebook,
     cs = self.cells
     idxs = [i for i,c in enumerate(cs) if (not pat or re.search(pat, c.source)) and (not cell_type or c.cell_type==cell_type) and (not ids or c.id in ids)]
     keep = sorted({j for i in idxs for j in range(max(0,i-context), min(len(cs),i+context+1))})
-    return FoundCells([cs[j] for j in keep], matched={cs[i].id for i in idxs})
+    return FoundCells([cs[j] for j in keep], matched={cs[i].id for i in idxs}, maxlen=maxlen)
 
 # %% ../nbs/13_nbio.ipynb #cb639e77
 def find_cells(
@@ -841,10 +843,11 @@ def find_cells(
     cell_type:str=None, # Optional limit by type ('code', 'markdown', or 'raw')
     ids='', # Optional limit by cell ids (comma-separated str, or list); exact or unique prefixes
     context:int=None, # Cells of context around matches (default 1)
+    maxlen:int=MAXLEN, # Maximum source characters per displayed cell
 ):
     "Snapshot `FoundCells` for matching cells in the notebook at `path`"
     fc = Notebook.open(path).find_cells(pat, cell_type, ids=ids, context=context)
-    return FoundCells([CellRow(c) for c in fc], matched=fc.matched)
+    return FoundCells([CellRow(c, maxlen) for c in fc], matched=fc.matched)
 
 # %% ../nbs/13_nbio.ipynb #202a29f1
 def deep_merge(

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/xml.py

@@ -158,6 +158,7 @@ def Html(*c, doctype=True, **kwargs)->FT:
 # %% ../nbs/09_xml.ipynb #116c886e
 class Safe(str):
     def __html__(self): return self
+    full = True # Tools that truncate long strings show this whole
 
 # %% ../nbs/09_xml.ipynb #254c8ff3
 def _escape(s):

{fastcore-2.2.33 → fastcore-2.2.34}/fastcore/xtras.py

@@ -258,7 +258,7 @@ def detect_mime(data):
     import mimetypes
     from fastcore import imghdr
     for (sig,pos),mime in _sigs.items():
-        if data[pos:pos+len(sig)]==sig: return mime(data) if callable(mime) else mime
+        if data[pos:pos+len(sig)]==sig and (res := mime(data) if callable(mime) else mime): return res
     return mimetypes.types_map.get(f'.{imghdr.what(None, h=data)}')
 
 # %% ../nbs/03_xtras.ipynb #f856746a

{fastcore-2.2.33 → fastcore-2.2.34/fastcore.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.2.33
+Version: 2.2.34
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
 License-Expression: Apache-2.0

fastcore-2.2.33/fastcore/editskill.py

@@ -1,64 +0,0 @@
-"""Text, file, cell, and notebook editing from `fastcore.tools` and `fastcore.nbio`, plus the conventions the whole fastai editing toolkit follows. Read this before working with the editing tools in any package that shares them.
-
-`from fastcore.editskill import *` loads `fastcore.tools` (text primitives, file tools) and `fastcore.nbio` (notebook I/O, cell editors). Where installed, prefer `exhash` for hash-verified editing, `rgapi` for search, and `aidialog`/`dialoghelper` for dialogs.
-
-## Places
-
-Targets: strings in memory, files (a path), notebook cells (`path, cell_id`; edits that cell's source), and in-memory `Notebook`/`NbCell`. A Solveit dialog is an `.ipynb` whose cells are notes, runnable code, and prompt/reply pairs; cell tools work with notebook structure whatever produced the file, while `aidialog.dlgskill`/`dialoghelper` read and edit dialog messages. exhash's `open_doc` outlines Markdown, code, and notebooks (`doc(open_doc)`: inputs, navigation, llms.txt workflow); a section is a span of lines or a run of cells, changed with the file and cell tools.
-
-Open a `Notebook` with `Notebook.open(path)` and save it with `nb.save()`. Index it by position or cell id (exact or unique prefix): `nb[k]` returns a cell, `nb[k] = src` sets its source, and `del nb[k]` removes it. `nb.add(src, cell_type)` and `nb.md(src)` insert a cell at `idx`, or `after` or `before` a cell id. `nb.move(ids, after=, before=)` reorders cells.
-
-## Naming
-
-- Operations on files, notebooks, cells, and messages: `verb_target` (`view_file`, `create_file`, `read_nb`, `write_nb`, `view_cell`, `validate_nb`, `view_msg`, `view_dlg`, `lnhashview_cell`). `find_msgs`, `add_msg`, `del_msgs`, `find_cells` need no extra dialog/notebook prefix. `msg` = dialog message; `cell` = notebook cell. `summary_nb` returns rows for notebook cells.
-- Text primitives (`insert_line`, `del_lines`, `replace_lines`, `str_replace`) get `file_`/`cell_`/`msg_` versions (`file_del_lines`, `cell_del_lines`, `msg_del_lines`) that take the primitive's arguments after their address arguments. `str_replace` keeps the name and argument order of Anthropic's text editor tool. `ast_replace` (AST patterns) and `exhash` (hash-verified line addresses) use the same prefixes: `file_ast_replace`, `msg_ast_replace`, `file_exhash`, `cell_exhash`.
-- Converters: `x2y` (`nb2dict`, `cell2xml`, aidialog's `dlg2md`); converter methods: `to_y` (`nb.to_dict()`).
-- Plural names take several items: `view_cell` one cell, `lnhashview_cells` several, `del_msgs` many.
-
-## Parameters (one vocabulary wherever it appears)
-
-- Order: the place's address (`text`; `path`; `path, cell_id`; a message `id`), then the new text, then ambient context as keyword-only (how message tools name their dialog).
-- `start_line`/`end_line`: 1-based, inclusive, `None` = first/last line; a negative `end_line` counts from the end. `del_lines` has no defaults: state the range.
-- `re_filter`/`invert_filter`: restrict an edit to lines (not) matching a regex, like ex `g//`/`g!//`; combines with the range.
-- Searches read patterns as regex by default; editors read them as literal text unless `use_regex=True`.
-- Views: `nums` (line numbers), `lnhashs` (`lineno|hash|` addresses); `maxlen` caps summary lines; `trunc_out`/`trunc_in` truncate outputs/sources in dialog views.
-- Search tools (`fd`, `ls`, `rg`, `nbrg`): `pattern` first, `root='.'`, one include/exclude/ext/hidden/ignore block; variants differ by defaults, not API (`ls` is `fd` with listing defaults).
-- Boolean filters narrow as `only_*` (`only_err`, `only_exp`, `only_errors`) and widen as `incl_*` (`incl_out`).
-- `context=` counts the place's units: lines (blocks in summary mode) for files, cells for notebooks, messages for dialogs.
-- Editors return a diff, which is the verification: read it rather than re-viewing. No change: fastcore editors and exhash return `none: No changes.`
-
-## Functions and methods
-
-Functions take a path, save, and return a diff; methods change an object in memory, saved explicitly. Methods drop the address arguments and the object's part of the name: `cell_str_replace(path, cell_id, ...)` -> `c.str_replace(...)` on an `NbCell`; `find_cells(path, pat)` -> `nb.find_cells(pat)` on a `Notebook`. Read functions return snapshot rows (addresses, source, metadata); read methods return the objects. One style per file at a time: save before switching to functions, reopen before returning to methods.
-
-## Addresses
-
-Edits take plain line numbers or lnhash addresses, got while reading: `nums=True`/`lnhashs=True` views, `rg(lnhashs=True)`. Prefer lnhash addresses where exhash is installed; stale ones are rejected. Plain line numbers are unverified and shift, so re-view after each such edit and apply several bottom-to-top. `exhash.skill` covers address forms and the verified edit loop.
-
-Not sure where to edit? Start with a summary: rgapi's `rg(summary=True)` and `nbrg`, aidialog's `summary_dlg`, and exhash's `open_doc` outlines give one addressed row per block, cell, message, or section. A section token such as `1.6.|12|Py|,45|HD|` is the section number plus the lnhash range of the section's first and last lines; that range works as an exhash address.
-
-## What's where
-
-- `fastcore.tools`: text primitives, file tools, and `line_hash`/`lnhash`/`lnhash_at` for creating addresses without exhash installed.
-- `fastcore.nbio`: notebook read/write/validate/repair, cell construction, cell editors, and the `Notebook`/`NbCell` session objects with their snapshot queries (`find_cells`, `summary_nb`).
-- `exhash.skill`: hash-verified editing for files and cells, plus `open_doc` section outlines for Markdown, code, and notebooks; prefer it for edits where installed.
-- `rgapi.skill`: `rg`/`fd`/`ls`/`nbrg` search with lnhash output, and `rgstr` to search text already in hand.
-- `remold`: structural search and rewrite for Python source (declarative ast-grep rules, LibCST matcher transforms, symbol queries); the engine behind `ast_replace`.
-- `aidialog.dlgskill`, `dialoghelper`: the dialog layer, including its own theory of dialogs and projections.
-
-Docs: https://fastcore.fast.ai/tools.html.md and https://fastcore.fast.ai/nbio.html.md
-"""
-
-from fastcore.tools import (insert_line, str_replace, strs_replace, replace_lines, del_lines, ast_replace,
-    file_insert_line, file_str_replace, file_strs_replace, file_replace_lines, file_del_lines, file_ast_replace,
-    view_file, create_file, line_hash, lnhash, lnhash_at)
-from fastcore.nbio import (read_nb, write_nb, new_nb, mk_cell, validate_nb, validate_cell, repair_nb, repair_cell,
-    view_cell, cell_insert_line, cell_str_replace, cell_strs_replace, cell_replace_lines, cell_del_lines, cell_ast_replace, Notebook, NbCell, find_cells, summary_nb)
-
-__all__ = ['insert_line', 'str_replace', 'strs_replace', 'replace_lines', 'del_lines', 'ast_replace',
-    'file_insert_line', 'file_str_replace', 'file_strs_replace', 'file_replace_lines', 'file_del_lines', 'file_ast_replace',
-    'view_file', 'create_file', 'line_hash', 'lnhash', 'lnhash_at',
-    'read_nb', 'write_nb', 'new_nb', 'mk_cell', 'validate_nb', 'validate_cell', 'repair_nb', 'repair_cell',
-    'view_cell', 'cell_insert_line', 'cell_str_replace', 'cell_strs_replace', 'cell_replace_lines', 'cell_del_lines', 'cell_ast_replace', 'Notebook', 'NbCell', 'find_cells', 'summary_nb']
-
-__pyskill_params__ = {'replace_params': ('start_line', 'end_line', 'n_matches', 're_filter', 'invert_filter', 'use_regex')}