{"id":13412093,"url":"https://github.com/AlbertSuarez/covid19-bot","last_synced_at":"2025-03-14T17:31:36.161Z","repository":{"id":112052112,"uuid":"244583692","full_name":"AlbertSuarez/covid19-bot","owner":"AlbertSuarez","description":"🤖 Real-time Twitter bot notifying new confirmed Coronavirus cases","archived":false,"fork":false,"pushed_at":"2020-03-26T18:59:42.000Z","size":59,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-07-31T20:49:48.596Z","etag":null,"topics":["2019-ncov","bot","coronavirus","covid-19","python","twitter-bot"],"latest_commit_sha":null,"homepage":"https://twitter.com/coronavid19_bot","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/AlbertSuarez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"AlbertSuarez","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-03-03T08:40:28.000Z","updated_at":"2022-01-10T13:17:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"2abc2aa0-6e64-4ffe-98de-500b65f79ad9","html_url":"https://github.com/AlbertSuarez/covid19-bot","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fcovid19-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fcovid19-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fcovid19-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fcovid19-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlbertSuarez","download_url":"https://codeload.github.com/AlbertSuarez/covid19-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243618748,"owners_count":20320286,"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":["2019-ncov","bot","coronavirus","covid-19","python","twitter-bot"],"created_at":"2024-07-30T20:01:20.910Z","updated_at":"2025-03-14T17:31:31.150Z","avatar_url":"https://github.com/AlbertSuarez.png","language":"Python","funding_links":["https://github.com/sponsors/AlbertSuarez"],"categories":["Python","With other Languages/Frameworks"],"sub_categories":["Articles"],"readme":"# CoVid-19 bot\n\n[![HitCount](http://hits.dwyl.io/AlbertSuarez/covid19-bot.svg)](http://hits.dwyl.io/AlbertSuarez/covid19-bot)\n[![GitHub stars](https://img.shields.io/github/stars/AlbertSuarez/covid19-bot.svg)](https://GitHub.com/AlbertSuarez/covid19-bot/stargazers/)\n[![GitHub forks](https://img.shields.io/github/forks/AlbertSuarez/covid19-bot.svg)](https://GitHub.com/AlbertSuarez/covid19-bot/network/)\n[![GitHub repo size in bytes](https://img.shields.io/github/repo-size/AlbertSuarez/covid19-bot.svg)](https://github.com/AlbertSuarez/covid19-bot)\n[![GitHub contributors](https://img.shields.io/github/contributors/AlbertSuarez/covid19-bot.svg)](https://GitHub.com/AlbertSuarez/covid19-bot/graphs/contributors/)\n[![GitHub license](https://img.shields.io/github/license/AlbertSuarez/covid19-bot.svg)](https://github.com/AlbertSuarez/covid19-bot/blob/master/LICENSE)\n\n[Twitter account](https://twitter.com/coronavid19_bot) | [Devpost project](https://devpost.com/software/covid19-bot) | [Static repo website](https://asuarez.dev/covid19-bot/)\n\n🤖 Real time Twitter bot notifying new confirmed Corona virus (CoVid-19) cases, deaths and recovered people by location.\n\n## Data source\n\nReal time data is being retrieved from the [Worldometer website](https://www.worldometers.info/coronavirus/).\n\n## Python requirements\n\nThis project is using Python3.7. All these requirements have been specified in the `requirements.lock` file.\n\n1. [Requests](https://2.python-requests.org/en/master/): used for retrieving the HTML content of a website.\n2. [Dictdiffer](https://dictdiffer.readthedocs.io/en/latest/): used for checking data differences easier.\n3. [APScheduler](https://apscheduler.readthedocs.io/en/stable/): used for scheduling jobs in a certain time.\n4. [Twitter](https://python-twitter.readthedocs.io/en/latest/): used for posting tweets.\n5. [BeautifulSoup](https://pypi.org/project/beautifulsoup4/): used for scraping an HTML content.\n6. [Tor](https://2019.www.torproject.org/docs/debian.html.en): used for making requests anonymous using other IPs.\n7. [Fake User-Agent](https://pypi.org/project/fake-useragent/): used for using random User-Agent's for every request.\n\n## Recommendations\n\nUsage of [virtualenv](https://realpython.com/blog/python/python-virtual-environments-a-primer/) is recommended for package library / runtime isolation.\n\n## Usage\n\nTo run this script, please execute the following from the root directory:\n\n1. Setup virtual environment\n\n2. Install dependencies\n\n  ```bash\n  pip3 install -r requirements.lock\n  ```\n\n3. Set up [Twitter API](https://developer.twitter.com/) account creating the .env file. This file must have this structure (without the brackets):\n\n  ```\n  TWITTER_CONSUMER_KEY={TWITTER_CONSUMER_KEY}\n  TWITTER_CONSUMER_SECRET={TWITTER_CONSUMER_SECRET}\n  TWITTER_ACCESS_TOKEN_KEY={TWITTER_ACCESS_TOKEN_KEY}\n  TWITTER_ACCESS_TOKEN_SECRET={TWITTER_ACCESS_TOKEN_SECRET}\n  ```\n\n4. Run the script as a Docker container\n\n  ```bash\n  docker-compose up -d --build\n  ```\n\n## Authors\n\n- [Albert Suàrez](https://github.com/AlbertSuarez)\n\n## License\n\nMIT © CoVid-19 bot\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlbertSuarez%2Fcovid19-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlbertSuarez%2Fcovid19-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlbertSuarez%2Fcovid19-bot/lists"}