{"id":30777838,"url":"https://github.com/fulcrumgenomics/fqgrep","last_synced_at":"2025-09-05T05:08:46.555Z","repository":{"id":50595241,"uuid":"416465549","full_name":"fulcrumgenomics/fqgrep","owner":"fulcrumgenomics","description":"Grep for FASTQ files","archived":false,"fork":false,"pushed_at":"2025-04-11T17:20:34.000Z","size":234,"stargazers_count":99,"open_issues_count":10,"forks_count":4,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-08-18T14:54:41.887Z","etag":null,"topics":["bioinformatics","fastq","genomics","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fulcrumgenomics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-10-12T19:09:41.000Z","updated_at":"2025-07-21T15:08:20.000Z","dependencies_parsed_at":"2024-12-04T18:30:12.647Z","dependency_job_id":"6092142b-ceae-4870-b872-f05c9f2f3017","html_url":"https://github.com/fulcrumgenomics/fqgrep","commit_stats":{"total_commits":20,"total_committers":4,"mean_commits":5.0,"dds":0.65,"last_synced_commit":"806ce2e73cf39d15dfe5ae9f13a4d2e3c815f7e2"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/fulcrumgenomics/fqgrep","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fulcrumgenomics%2Ffqgrep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fulcrumgenomics%2Ffqgrep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fulcrumgenomics%2Ffqgrep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fulcrumgenomics%2Ffqgrep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fulcrumgenomics","download_url":"https://codeload.github.com/fulcrumgenomics/fqgrep/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fulcrumgenomics%2Ffqgrep/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273713621,"owners_count":25154614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","fastq","genomics","rust"],"created_at":"2025-09-05T05:08:43.548Z","updated_at":"2025-09-05T05:08:46.542Z","avatar_url":"https://github.com/fulcrumgenomics.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fqgrep\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/fulcrumgenomics/fqgrep/actions?query=workflow%3ACheck\"\u003e\u003cimg src=\"https://github.com/fulcrumgenomics/fqgrep/workflows/Check/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/crates/l/fqgrep.svg\" alt=\"license\"\u003e\n  \u003ca href=\"https://crates.io/crates/fqgrep\"\u003e\u003cimg src=\"https://img.shields.io/crates/v/fqgrep.svg?colorB=319e8c\" alt=\"Version info\"\u003e\u003c/a\u003e\n  \u003ca href=\"http://bioconda.github.io/recipes/fqgrep/README.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat\" alt=\"Install with bioconda\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://doi.org/10.5281/zenodo.14985002\"\u003e\u003cimg src=\"https://zenodo.org/badge/416465549.svg\" alt=\"zenodo\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  Grep for FASTQ files.\n\u003c/p\u003e\n\nSearch a pair of fastq files for reads that match a given ref or alt sequence.\n\n\u003cp\u003e\n\u003ca href=\"https://fulcrumgenomics.com\"\u003e\u003cimg src=\".github/logos/fulcrumgenomics.svg\" alt=\"Fulcrum Genomics\" height=\"100\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n[Visit us at Fulcrum Genomics](https://www.fulcrumgenomics.com) to learn more about how we can power your Bioinformatics with fqgrep and beyond.\n\n\u003ca href=\"mailto:contact@fulcrumgenomics.com?subject=[GitHub inquiry]\"\u003e\u003cimg src=\"https://img.shields.io/badge/Email_us-brightgreen.svg?\u0026style=for-the-badge\u0026logo=gmail\u0026logoColor=white\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://www.fulcrumgenomics.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Visit_Us-blue.svg?\u0026style=for-the-badge\u0026logo=wordpress\u0026logoColor=white\"/\u003e\u003c/a\u003e\n\n## Install\n\n### From bioconda\n\n```console\nconda install -c bioconda fqgrep\n```\n\n### From Source\n\n```console \ngit clone ... \u0026\u0026 cd fqgrep\ncargo install --path .\n```\n\n## Usage\n\nTo match a single pattern in a single FASTQ:\n\n```console\nfqgrep 'GACGAGATTA' /data/test.fastq.gz\n```\n\nTo match two patterns across two FASTQs treating them as paired end:\n\n```console\nfqgrep  --paired --threads 10 --regexp 'GACGAGATTA' --regexp 'GACGTGATTA' /data/testR1.fastq.gz /data/testR2.fastq.gz\n```\n\n## Help\n\nSee the following for usage:\n\n\u003c!-- start usage --\u003e\n```console\n\nOVERVIEW\n\nThe fqgrep utility searches any given input FASTQ files, selecting records whose bases match one or more patterns.  By default, a pattern matches the bases in a FASTQ record if the regular expression (RE) in the pattern matches the bases.  An empty expression matches every line.  Each FASTQ record that matches at least one of the patterns is written to the standard output.\n\nINPUT COMPRESSION\n\nBy default, the input files are assumed to be uncompressed with the following exceptions: (1) If the input files are real files and end with .gz or .bgz, they are assumed to be GZIP compressed, or (2) if they end with .fastq or .fq, they are assumed to be uncompressed, or (3) if the -Z/--decompress option is specified then any unrecongized inputs (including standard input) are assumed to be GZIP compressed.\n\nTHREADS\n\nThe --threads option controls the number of threads used to search the reads. Independently, for single end reads or interleaved paired end reads, a single thread will be used to read each input FASTQ.  For paired end reads across pairs of FASTQs, two threads will be used to read the FASTQs for each end of a pair.  Finally, a single thread will be created for the writer.\n\nEXIT STATUS\n\nThe fqgrep utility exits with one of the following values: 0 if one or more lines were selected, 1 if no lines were selected, and \u003e1 if an error occurred.\n\nUsage: fqgrep [OPTIONS] [ARGS]...\n\nArguments:\n  [ARGS]...\n          The first argument is the pattern to match, with the remaining arguments containing the files to match.  If -e is given, then all the arguments are files to match. Use standard input if either no files are given or - is given\n\nOptions:\n  -t, --threads \u003cTHREADS\u003e\n          The number of threads to use for matching reads against pattern.  See the full usage for threads specific to reading and writing\n          \n          [default: 10]\n\n      --color \u003cCOLOR\u003e\n          Mark up the matching text.  The possible values of when are “never”, “always” and “auto”\n          \n          [default: never]\n          [possible values: never, always, auto]\n\n  -c, --count\n          Only a count of selected lines is written to standard output\n\n  -e, --regexp \u003cREGEXP\u003e\n          Specify a pattern used during the search of the input: an input line is selected if it matches any of the specified patterns.  This option is most useful when multiple -e options are used to specify multiple patterns\n\n  -F, --fixed-strings\n          Interpret pattern as a set of fixed strings\n\n  -f, --file \u003cFILE\u003e\n          Read one or more newline separated patterns from file.  Empty pattern lines match every input line.  Newlines are not considered part of a pattern.  If file is empty, nothing is matched\n\n  -v\n          Selected lines are those not matching any of the specified patterns\n\n  -Z, --decompress\n          Assume all unrecognized inputs are GZIP compressed\n\n      --paired\n          Treat the input files as paired.  The number of input files must be a multiple of two, with the first file being R1, second R2, third R1, fourth R2, and so on.  If the pattern matches either R1 or R2, then both R1 and R2 will be output (interleaved).  If the input is standard input, then treat the input as interlaved paired end reads\n\n      --reverse-complement\n          Search the reverse complement for matches\n\n      --progress\n          Write progress information\n\n  -h, --help\n          Print help (see a summary with '-h')\n\n  -V, --version\n          Print version\n```\n\u003c!-- end usage --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffulcrumgenomics%2Ffqgrep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffulcrumgenomics%2Ffqgrep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffulcrumgenomics%2Ffqgrep/lists"}