{"id":16105624,"url":"https://github.com/charlesyuan02/waifu-list-api","last_synced_at":"2026-04-28T00:33:02.913Z","repository":{"id":41059493,"uuid":"503921294","full_name":"CharlesYuan02/waifu-list-api","owner":"CharlesYuan02","description":"I made my waifu list into a REST API.","archived":false,"fork":false,"pushed_at":"2022-10-06T02:19:27.000Z","size":50969,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-12T15:06:39.461Z","etag":null,"topics":["flask","flask-restful","flask-sqlalchemy","heroku","rest-api"],"latest_commit_sha":null,"homepage":"https://waifu-list-api.herokuapp.com/","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/CharlesYuan02.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":"2022-06-15T21:02:21.000Z","updated_at":"2022-06-28T16:05:22.000Z","dependencies_parsed_at":"2023-01-19T08:00:20.771Z","dependency_job_id":null,"html_url":"https://github.com/CharlesYuan02/waifu-list-api","commit_stats":null,"previous_names":["charlesyuan02/waifu-list-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CharlesYuan02/waifu-list-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesYuan02%2Fwaifu-list-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesYuan02%2Fwaifu-list-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesYuan02%2Fwaifu-list-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesYuan02%2Fwaifu-list-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CharlesYuan02","download_url":"https://codeload.github.com/CharlesYuan02/waifu-list-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesYuan02%2Fwaifu-list-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32361477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["flask","flask-restful","flask-sqlalchemy","heroku","rest-api"],"created_at":"2024-10-09T19:10:12.187Z","updated_at":"2026-04-28T00:33:02.899Z","avatar_url":"https://github.com/CharlesYuan02.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# waifu-list-api\n\n## Introduction\nI'm tired of continuously updating my waifu list Google Doc, so I've decided to make it into a REST API that can be accessed by others, along with an independent website for everyone to see. The API allows for the GET, POST, PUT, and DELETE methods, with the latter three requiring the appropriate password to be inputted as a parameter. For more details, see \u003ca href=\"https://github.com/Chubbyman2/waifu-list-api/blob/main/test.py\"\u003e```test.py```\u003c/a\u003e. That being said, may I present: My \u003ca href=\"https://waifu-list-api.herokuapp.com/\"\u003ewaifu-list-api\u003c/a\u003e!\n\n## Getting Started\nTo get started locally, clone the repo and make the following alterations:\n* app.py: Change BASE variable assignment to local host and app.config to the sqlite db. Also change pymysql to sqlite3 accordingly.\n* api.py: Change PASSWORD variable assignment to anything you want\n* demo.py: Change BASE and PASSWORD to what you set previously\n\n### Prerequisites\n```\naniso8601==8.0.0\ncertifi==2022.5.18.1\ncharset-normalizer==2.0.12\nclick==7.1.2\ncolorama==0.4.4\nFlask==1.1.2\nFlask-RESTful==0.3.8\nFlask-SQLAlchemy==2.4.3\ngreenlet==1.1.2\ngunicorn==20.1.0\nidna==3.3\nimportlib-metadata==4.11.4\nitsdangerous==1.1.0\nJinja2==2.11.2\nMarkupSafe==1.1.1\npsycopg2==2.9.3\nPyMySQL==1.0.2\npytz==2020.1\nrequests==2.28.0\nsix==1.15.0\nSQLAlchemy==1.3.18\nurllib3==1.26.9\nWerkzeug==1.0.1\nwincertstore==0.2\nzipp==3.8.0\n```\n\n### Deploying Locally\nSet to correct project directory:\n```cd waifu-list-api```\n\nWith virtual environment:\n```python app.py```\n\nThen, using a separate command terminal:\n```python demo.py```\n\n### Integrating with Local Scripts\n\u003ca href=\"https://github.com/Chubbyman2/waifu-list-api/blob/main/demo.py\"\u003e```demo.py```\u003c/a\u003e provides a bunch of helper functions for easily communicating with the REST API, without you having to learn requests or HTTP methods. Just make sure to know your API base path (BASE) and password (PASSWORD). \n\n## Built With\n### Flask-RESTful\nAn extension for Flask that adds support for quickly building REST APIs. Comes and is used in conjunction with Flask. \n\n### SQLAlchemy \nUsed for creating the mySQL database, as well as sending HTTP methods to the REST API. \n\n### SQLite3/PyMySQL\nSince you can't call an API inside of the API itself, I used SQLite3 to retrieve the waifu entries from the database to display on the front end. Since I'm storing the waifus using a remote database, I had to switch to PyMySQL for the deployed version.\n\n### Heroku\nTHIS TOOK WAY LONGER THAN EXPECTED. Deployment is so annoying, I swear... Anyways, the API endpoint and home page are hosted using Heroku, while the SQL database is hosted using Heroku's provided ClearDB MySQL. I had to fix this since FreeSQLDatabase.com only provides a trial period...\n\n## License\nThis project is licensed under the MIT License - see the \u003ca href=\"https://github.com/Chubbyman2/waifu-list-api/blob/main/LICENSE\"\u003eLICENSE\u003c/a\u003e file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlesyuan02%2Fwaifu-list-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharlesyuan02%2Fwaifu-list-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlesyuan02%2Fwaifu-list-api/lists"}