{"id":16739901,"url":"https://github.com/stahnma/noodles","last_synced_at":"2026-05-16T23:08:49.993Z","repository":{"id":234011942,"uuid":"788168637","full_name":"stahnma/noodles","owner":"stahnma","description":"Search GitHub for specific things in READMEs","archived":false,"fork":false,"pushed_at":"2024-04-17T23:14:44.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-17T23:46:40.206Z","etag":null,"topics":["api","github"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stahnma.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-17T22:54:14.000Z","updated_at":"2024-06-08T06:26:15.273Z","dependencies_parsed_at":null,"dependency_job_id":"e1fb02fd-f4fe-4606-b032-462de8e70585","html_url":"https://github.com/stahnma/noodles","commit_stats":null,"previous_names":["stahnma/noodles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stahnma%2Fnoodles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stahnma%2Fnoodles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stahnma%2Fnoodles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stahnma%2Fnoodles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stahnma","download_url":"https://codeload.github.com/stahnma/noodles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243803039,"owners_count":20350332,"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":["api","github"],"created_at":"2024-10-13T00:54:46.178Z","updated_at":"2026-05-16T23:08:49.982Z","avatar_url":"https://github.com/stahnma.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Noodles \n---\n\nWhy is this named noodles?  Because, I said I would noodle on it.\n\n# GitHub Repository Search Tool\n\nThis tool allows you to search GitHub repositories to find those that contain a specific string in their README files and meet a minimum star requirement.\n\n## Requirements\n\n- Go (1.16 or later)\n- A GitHub Personal Access Token\n- Make\n\nIf you want this to run in a lambda, then you you'll want:\n- AWSCLI2\n- jq (perhaps for debugging)\n\n\n## Installation\n\nFirst, clone the repository or download the source code. Then navigate to the directory containing the source code.\n\n## Configuration\n\nBefore running the script, you must set your GitHub Personal Access Token as an environment variable:\n\n    export GITHUB_TOKEN=\"your_github_token_here\"\n\nEnsure this token is set in your shell environment where you plan to run the script.\n\n## Building\n\n     flox activate\n     go mod tidy\n     go build .\n\n## Running as via serverless\n\nThe `Makefile` contains targets to set up or update the code for the lambda.\n\n:warning: You will still need something to trigger the lambda, such as an API\nGateway. Setting that up not covered in this README.\n\nTo update the lambda: `make aws`\n\nTo create the initial lambda `make aws-init`\n\n\n## Usage\n\nThe tool is executed from the command line, where you can specify the search string and the minimum number of stars:\n\n    ./noodles -stars=\u003cminimum_stars\u003e \"\u003csearch_string\u003e\"\n\n### Parameters\n\n- `\u003cminimum_stars\u003e`: The minimum number of stars a repository must have to be included in the search results. This is optional and defaults to 1000 if not specified.\n- `\u003csearch_string\u003e`: The string to search for in the README files of repositories.\n\n### Examples\n\nTo search for repositories that include \"nvm use\" in their README and have at least 1500 stars:\n\n    ./noodles -stars=1500 \"nvm use\"\n\nTo search for repositories with the default star setting (1000 stars) that include \"pip install\":\n\n    ./noodles \"pip install\"\n\n## Contributing\n\nContributions are welcome! Please feel free to submit pull requests or open issues to suggest improvements or add new features.\n\n# Demo stuff\n\nIf you want a demo using Flox to do some neat things, this is a good project for that. \n\nYou can:\n\n1. Build `noodles` and then set it up as a Lambda. If you've configured the lambda and API Gateway, you can then run the lambda from the API Gateway using `make aws` from the `noodles` directory.\n2. There is a front end in the `front` directory. It uses `flox services` to show off the services component and runs a web application and proxy to get around CORS restrictions from API gateway.\n\nTo run the front end\n\n    cd front\n    flox activate -s\n\n\n## License\n\nWTFPL\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstahnma%2Fnoodles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstahnma%2Fnoodles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstahnma%2Fnoodles/lists"}