{"id":19989205,"url":"https://github.com/clamytoe/animpy","last_synced_at":"2025-03-01T21:48:22.124Z","repository":{"id":53173372,"uuid":"119572915","full_name":"clamytoe/animpy","owner":"clamytoe","description":"Anime Python Research Tool (animpy)","archived":false,"fork":false,"pushed_at":"2021-05-17T16:43:29.000Z","size":309,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-12T11:50:06.641Z","etag":null,"topics":["anime","bch","cli","python39","reviews","travis-ci"],"latest_commit_sha":null,"homepage":"","language":"Python","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/clamytoe.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}},"created_at":"2018-01-30T17:55:03.000Z","updated_at":"2023-10-18T11:43:14.000Z","dependencies_parsed_at":"2022-09-14T09:41:56.337Z","dependency_job_id":null,"html_url":"https://github.com/clamytoe/animpy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fanimpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fanimpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fanimpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fanimpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clamytoe","download_url":"https://codeload.github.com/clamytoe/animpy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241430312,"owners_count":19961635,"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":["anime","bch","cli","python39","reviews","travis-ci"],"created_at":"2024-11-13T04:45:49.741Z","updated_at":"2025-03-01T21:48:22.098Z","avatar_url":"https://github.com/clamytoe.png","language":"Python","readme":"# Anime Python Research Tool (animpy)\n\n\u003e Just a little tool to make it easier for me to look up anime reviews.\n\n![Python version][python-version]\n![Latest version][latest-version]\n[![Build Status][travis-image]][travis-url]\n[![BCH compliance][bch-image]][bch-url]\n[![GitHub issues][issues-image]][issues-url]\n[![GitHub forks][fork-image]][fork-url]\n[![GitHub Stars][stars-image]][stars-url]\n[![License][license-image]][license-url]\n\nMy kids are big movie and anime buffs and are constantly asking me to look up shows to see if they are allowed to watch them. This of course takes time, more so when they bring you a list of them!\n\nI initially wrote [Parental Guide (pguide)](https://github.com/clamytoe/pguide.git) but IMDb isn't really the greatest place to find reviews for anime. That lead me to start from scratch, so I created this one that scrapes [MyAnimeList](https://myanimelist.net) instead.\n\n## Requirements\n\n1. Requires Python 3.6+\n2. Requires all the packages *you* need in order to install **animpy** into your preferred flavor of virtual environment (of the three mentioned in the steps below that is).\n\n## How To Set It All Up\n\nUse a virtual environment. A *requirements.txt* and an *environment.yml* file are included already. Perform the steps in the *Initial Setup* to clone the repo and then choose whichever set of *Setup* instructions for the virtual environment you prefer to work with.\n\n### Initial Setup: Cloning the Repo\n\n1. Create and then change into the directory you would like to install **animpy** into.\n   - `mkdir \u003cdirectory name\u003e`\n   - `cd \u003cdirectory name\u003e`\n   - `git clone https://github.com/clamytoe/animpy.git`\n   - `cd animpy`\n\n### Anaconda Setup\n\n1. `conda env create` (creates the virtual environment)\n2. `activate animpy` or `source activate animpy` (activates the virtual environment)\n3. `pip install -e .` (installs the animpy package)\n\n### Regular Python 3 Virtual Environment Setup\n\n1. `python3 -m venv \u003c/path/to/new/virtual/environment\u003e` (creates the virtual environment)\n2. `source \u003c/path/to/new/virtual/environment\u003e/bin/activate` (activates the virtual environment)\n3. `pip install -r requirements.txt` (installs all required dependencies)\n4. `pip install -e .` (installs the animpy package)\n\n## How To Use\n\nOnce you've installed **animpy** into your virtual environment, using the script is pretty straight forward. If you use the *--help* flag it will display the following usage statement:\n\n```bash\nUsage: animpy [OPTIONS]\n\n  Entry point for the script, requires the title of the Anime to look up.\n\n  If a title is not given from the command line, one will be asked for.\n  :param title: String, the title of the show :return: None\n\nOptions:\n  --show / --no-show   Toggles display search results on/off, defaults to off.\n  -c, --count INTEGER  Number of search results to display, default is 5.\n  -t, --title TEXT     Title of the Anime that you would like to look up, use\n                       double-quotes.\n  --help               Show this message and exit.\n  ```\n\n### Method #1\n\n```bash\nanimpy\n```\n\nYou will be prompted for the title.\n\n### Method #2\n\n```bash\nanimpy -t \"D.Grey-man\"\n\n# or\n\nanimpy --show --count 2 --title \"D.Gray-man\"\n```\n\n## Sample run\n\n\u003e Notice that even if there is a type-o in the search term, the correct show is still found.\n\n![sample run](img/start.png)\n\n![search](img/review.png)\n\nJust hitting the *ENTER* key will continue with the next screen. To exit enter an *n*.\n\n[python-version]:https://img.shields.io/badge/python-3.9-brightgreen.svg\n[latest-version]:https://img.shields.io/badge/version-0.5.0-blue.svg\n[travis-image]:https://travis-ci.org/clamytoe/animpy.svg?branch=master\n[travis-url]:https://travis-ci.org/clamytoe/animpy\n[bch-image]:https://bettercodehub.com/edge/badge/clamytoe/animpy?branch=master\n[bch-url]:https://bettercodehub.com/\n[issues-image]:https://img.shields.io/github/issues/clamytoe/animpy.svg\n[issues-url]:https://github.com/clamytoe/animpy/issues\n[fork-image]:https://img.shields.io/github/forks/clamytoe/animpy.svg\n[fork-url]:https://github.com/clamytoe/animpy/network\n[stars-image]:https://img.shields.io/github/stars/clamytoe/animpy.svg\n[stars-url]:https://github.com/clamytoe/animpy/stargazers\n[license-image]:https://img.shields.io/github/license/clamytoe/animpy.svg\n[license-url]:https://github.com/clamytoe/animpy/blob/master/LICENSE\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclamytoe%2Fanimpy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclamytoe%2Fanimpy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclamytoe%2Fanimpy/lists"}