{"id":13457728,"url":"https://github.com/thecodrr/fdir","last_synced_at":"2025-05-12T13:23:18.076Z","repository":{"id":38791573,"uuid":"247080561","full_name":"thecodrr/fdir","owner":"thecodrr","description":"⚡ The fastest directory crawler \u0026 globbing library for NodeJS. Crawls 1m files in \u003c 1s","archived":false,"fork":false,"pushed_at":"2025-04-19T04:41:19.000Z","size":1825,"stargazers_count":1591,"open_issues_count":18,"forks_count":64,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-23T07:00:19.639Z","etag":null,"topics":["directory","directory-tree","fast","fast-glob","fdir","filesystem","fs","glob","hacktoberfest","javascript","nodejs","os","sys","walker"],"latest_commit_sha":null,"homepage":"https://thecodrr.github.io/fdir/","language":"TypeScript","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/thecodrr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"thecodrr","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/cupertino"]}},"created_at":"2020-03-13T13:42:49.000Z","updated_at":"2025-04-23T03:09:42.000Z","dependencies_parsed_at":"2022-07-09T19:16:25.722Z","dependency_job_id":"2b1b325a-0c14-434d-bbb9-822f38aaff84","html_url":"https://github.com/thecodrr/fdir","commit_stats":{"total_commits":246,"total_committers":13,"mean_commits":"18.923076923076923","dds":"0.20731707317073167","last_synced_commit":"d5c4aa581371344bad40169029dc0f12406e530c"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodrr%2Ffdir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodrr%2Ffdir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodrr%2Ffdir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodrr%2Ffdir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thecodrr","download_url":"https://codeload.github.com/thecodrr/fdir/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745415,"owners_count":21957364,"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","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":["directory","directory-tree","fast","fast-glob","fdir","filesystem","fs","glob","hacktoberfest","javascript","nodejs","os","sys","walker"],"created_at":"2024-07-31T09:00:34.712Z","updated_at":"2025-05-12T13:23:18.051Z","avatar_url":"https://github.com/thecodrr.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/thecodrr/fdir/raw/master/assets/fdir.gif\" width=\"75%\"/\u003e\n\n\u003ch1 align=\"center\"\u003eThe Fastest Directory Crawler \u0026 Globber for NodeJS\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/fdir\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/fdir\"\u003e\u003cimg src=\"https://img.shields.io/npm/dw/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://codeclimate.com/github/thecodrr/fdir/maintainability\"\u003e\u003cimg src=\"https://img.shields.io/codeclimate/maintainability-percentage/thecodrr/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://coveralls.io/github/thecodrr/fdir?branch=master\"\u003e\u003cimg src=\"https://img.shields.io/coveralls/github/thecodrr/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/fdir\"\u003e\u003cimg src=\"https://img.shields.io/bundlephobia/minzip/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.producthunt.com/posts/fdir-every-millisecond-matters\"\u003e\u003cimg src=\"https://img.shields.io/badge/ProductHunt-Upvote-red?style=for-the-badge\u0026logo=product-hunt\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://dev.to/thecodrr/how-i-wrote-the-fastest-directory-crawler-ever-3p9c\"\u003e\u003cimg src=\"https://img.shields.io/badge/dev.to-Read%20Blog-black?style=for-the-badge\u0026logo=dev.to\"/\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/thecodrr/fdir?style=for-the-badge\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003c/p\u003e\n\n⚡ **The Fastest:** Nothing similar (in the NodeJS world) beats `fdir` in speed. It can easily crawl a directory containing **1 million files in \u003c 1 second.**\n\n💡 **Stupidly Easy:** `fdir` uses expressive Builder pattern to build the crawler increasing code readability.\n\n🤖 **Zero Dependencies\\*:** `fdir` only uses NodeJS `fs` \u0026 `path` modules.\n\n🕺 **Astonishingly Small:** \u003c 2KB in size gzipped \u0026 minified.\n\n🖮 **Hackable:** Extending `fdir` is extremely simple now that the new Builder API is here. Feel free to experiment around.\n\n_\\* `picomatch` must be installed manually by the user to support globbing._\n\n## 🚄 Quickstart\n\n### Installation\n\nYou can install using `npm`:\n\n```sh\n$ npm i fdir\n```\n\nor Yarn:\n\n```sh\n$ yarn add fdir\n```\n\n### Usage\n\n```ts\nimport { fdir } from \"fdir\";\n\n// create the builder\nconst api = new fdir().withFullPaths().crawl(\"path/to/dir\");\n\n// get all files in a directory synchronously\nconst files = api.sync();\n\n// or asynchronously\napi.withPromise().then((files) =\u003e {\n  // do something with the result here.\n});\n```\n\n## Documentation:\n\nDocumentation for all methods is available [here](/documentation.md).\n\n## 📊 Benchmarks:\n\nPlease check the benchmark against the latest version [here](/BENCHMARKS.md).\n\n## 🙏Used by:\n\n`fdir` is downloaded over 200k+ times a week by projects around the world. Here's a list of some notable projects using `fdir` in production:\n\n\u003e Note: if you think your project should be here, feel free to open an issue. Notable is anything with a considerable amount of GitHub stars.\n\n1. [rollup/plugins](https://github.com/rollup/plugins)\n2. [SuperchupuDev/tinyglobby](https://github.com/SuperchupuDev/tinyglobby)\n3. [pulumi/pulumi](https://github.com/pulumi/pulumi)\n4. [dotenvx/dotenvx](https://github.com/dotenvx/dotenvx)\n5. [mdn/yari](https://github.com/mdn/yari)\n6. [streetwriters/notesnook](https://github.com/streetwriters/notesnook)\n7. [imba/imba](https://github.com/imba/imba)\n8. [moroshko/react-scanner](https://github.com/moroshko/react-scanner)\n9. [netlify/build](https://github.com/netlify/build)\n10. [yassinedoghri/astro-i18next](https://github.com/yassinedoghri/astro-i18next)\n11. [selfrefactor/rambda](https://github.com/selfrefactor/rambda)\n12. [whyboris/Video-Hub-App](https://github.com/whyboris/Video-Hub-App)\n\n## 🦮 LICENSE\n\nCopyright \u0026copy; 2024 Abdullah Atta under MIT. [Read full text here.](https://github.com/thecodrr/fdir/raw/master/LICENSE)\n","funding_links":["https://ko-fi.com/thecodrr","https://paypal.me/cupertino"],"categories":["TypeScript","Utilities","os","JavaScript"],"sub_categories":["File System"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodrr%2Ffdir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecodrr%2Ffdir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodrr%2Ffdir/lists"}