seek_lines

Reads a set of files, filters lines based on a regular expression pattern,
and constructs a tidy tibble of the results.

internal

Provides a simple interface to recursively list files from a
directory, filter them using a regular expression, read their
contents, and extract lines that match a user-defined pattern. The
package returns a dataframe containing the matched lines, their
line numbers, file paths, and the corresponding matched substrings.
Designed for quick code base exploration, log inspection, or any use
case involving pattern-based file and line filtering.

Sacha Martingay

seekr

Extract Matching Lines from Matching Files

seek_lines function

<dl><dt>files</dt>
<dd>A character vector of files to search (only for <code>seek_in()</code>).</dd>
<dt>pattern</dt>
<dd>A regular expression pattern used to match lines.</dd>
<dt>...</dt>
<dd>Additional arguments passed to <code><a href="https://readr.tidyverse.org/reference/read_lines.html">readr::read_lines()</a></code>, such as
<code>skip</code>, <code>n_max</code>, or <code>locale</code>.</dd>
<dt>path</dt>
<dd>A character vector of one or more directories where files should be
discovered (only for <code><a href="/link/seek()?package=seekr&version=0.1.3" data-mini-rdoc="seekr::seek()">seek()</a></code>).</dd>
<dt>relative_path</dt>
<dd>Logical. If TRUE, file paths are made relative to the
path argument. If multiple root paths are provided, relative_path is
automatically ignored and absolute paths are kept to avoid ambiguity.</dd>
<dt>matches</dt>
<dd>Logical. If <code>TRUE</code>, all matches per line are also returned in a
<code>matches</code> list-column.</dd></dl>

Arguments

Read and Prepare Matching Lines — seek_lines

<dl>

<dt>files</dt>
<dd>A character vector of files to search (only for <code>seek_in()</code>).</dd>


<dt>pattern</dt>
<dd>A regular expression pattern used to match lines.</dd>


<dt>...</dt>
<dd>Additional arguments passed to <code><a href='https://readr.tidyverse.org/reference/read_lines.html'>readr::read_lines()</a></code>, such as
<code>skip</code>, <code>n_max</code>, or <code>locale</code>.</dd>


<dt>path</dt>
<dd>A character vector of one or more directories where files should be
discovered (only for <code><a href='https://rdrr.io/r/base/seek.html'>seek()</a></code>).</dd>


<dt>relative_path</dt>
<dd>Logical. If TRUE, file paths are made relative to the
path argument. If multiple root paths are provided, relative_path is
automatically ignored and absolute paths are kept to avoid ambiguity.</dd>


<dt>matches</dt>
<dd>Logical. If <code>TRUE</code>, all matches per line are also returned in a
<code>matches</code> list-column.</dd>

</dl>

seek_lines: Read and Prepare Matching Lines

Description

Usage

Value

Arguments