{"id":22077187,"url":"https://github.com/dusch4593/nyt_bestsellers_cli","last_synced_at":"2026-07-03T14:01:53.087Z","repository":{"id":103751944,"uuid":"249073147","full_name":"Dusch4593/nyt_bestsellers_cli","owner":"Dusch4593","description":"Browse the New York Times Best Seller list with a given date and category.","archived":false,"fork":false,"pushed_at":"2022-09-08T12:25:02.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-23T20:27:36.465Z","etag":null,"topics":["api","cli","newyorktimes","nyt-bestsellers","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/Dusch4593.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2020-03-21T22:38:48.000Z","updated_at":"2022-09-08T12:20:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"e573015e-8724-4ff4-be30-bc7598ad44e6","html_url":"https://github.com/Dusch4593/nyt_bestsellers_cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dusch4593/nyt_bestsellers_cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dusch4593%2Fnyt_bestsellers_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dusch4593%2Fnyt_bestsellers_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dusch4593%2Fnyt_bestsellers_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dusch4593%2Fnyt_bestsellers_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dusch4593","download_url":"https://codeload.github.com/Dusch4593/nyt_bestsellers_cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dusch4593%2Fnyt_bestsellers_cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35088478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"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":["api","cli","newyorktimes","nyt-bestsellers","ruby"],"created_at":"2024-11-30T22:37:01.728Z","updated_at":"2026-07-03T14:01:53.068Z","avatar_url":"https://github.com/Dusch4593.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# New York Times Best Seller CLI\n\nThis is my command line interface (CLI) project is written in Ruby.\n\nYou can access book information from the New York Times Best Seller\nlist based on a given date and category*.\n\n\\* _From the Weekly Best Seller lists, not the Monthly_\n\n## Installation\n\nFork and clone this repository to your local machine. Save it somewhere it'll be easy to find. Then, `cd` into `nyt_bestsellers_cli`.\n\n### Getting an API Key\n\nThis project uses the New York Times Books API. As far as I know, you'll have to [sign up for an account](https://developer.nytimes.com/accounts/create) on the New York Times Developer Network in order to be able to generate an API key. You'll need this key to be able to fetch the Book and Category data.\n\n### Working with `dotenv`\n\nFor security reasons, it's generally a good idea to take measures to ensure sensitive information isn't exposed to hackers. One of the ways I found was storing the API key as an *environment variable* that can only be seen on your local machine; the actual key isn't seen on the frontend at all.\n\nBe sure to change the name of `example.env` to `.env` and assign to the `NYT_API_KEY`:\n\n```\nNYT_API_KEY = \"your-api-key-here-between-the-quotes\"\n```\n\n## Usage\n\nChange into the directory of this repo and run the following command\nin your terminal:\n\n```\n$ ruby bin/nyt_bestsellers_cli\n```\n\nYou'll be welcomed to the program and asked to provide a valid date in one of the following formats:\n\n- `YYYY-MM-DD`\n- `MM-DD-YYYY`\n- `M-D-YYYY`\n- `M-DD-YYYY` / `MM-D-YYYY`\n\n```\nWelcome to the New York Times Best Seller list, CLI Edition!\n------------------------------------------------------------\nThis project uses data from the NYT Books API (https://developer.nytimes.com)\nThe NYT Best Seller list has featured some\nof America's most successful and widely read books!\nCome search for Best Sellers!\nUnfortunately, the NYT Books API seems to only fetch\nlist data from as far back as June 6th, 2008.\nPlease enter a valid date:\n```\n\nYou'll then be presented with a list of categories; you must select one by\nentering its corresponding number.\n\nChoose a category, and you will then be shown the NYT Best Seller list based\non the date you gave.\n\nSelect a book to get more information.\n\nAt the end of the program, you'll be asked if you'd like to\nhelp support local book stores near you. If you type `y` your Internet browser will direct you to\n[www.indiebound.org](https://www.indiebound.org/) where you can buy the selected book from a local store.\n\nPlease enjoy and feel free to let me know if you have any issues with\nsetup or usage! \n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/Dusch4593/nyt_bestsellers_cli. This project is intended to be a safe, welcoming space for collaboration.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## Code of Conduct\n\nEveryone interacting in the NytBestsellersCli project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/Dusch4593/nyt_bestsellers_cli/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdusch4593%2Fnyt_bestsellers_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdusch4593%2Fnyt_bestsellers_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdusch4593%2Fnyt_bestsellers_cli/lists"}