معرفی شرکت ها
disease.py-1.2.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
An asynchronous wrapper for the Open Disease API written in Python.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | disease.py-1.2.0 |
| نام | disease.py |
| نسخه کتابخانه | 1.2.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Rob Wainwright |
| ایمیل نویسنده | apex@taka.moe |
| آدرس صفحه اصلی | https://github.com/apex2504/disease.py |
| آدرس اینترنتی | https://pypi.org/project/disease.py/ |
| مجوز | MIT |
# disease.py
The official Python wrapper for the [Open Disease API](https://github.com/disease-sh/API). Formerly `corona-api`.
# Requirements
- Python 3.5 or above
- aiohttp (`python3 -m pip install -U aiohttp`)
# Installation
### Using pip (recommended)
- `python3 -m pip install -U disease.py`
Importing is then as easy as `import diseaseapi`.
# Support
Get support for this on Discord, either on our [official server](https://takagisan.xyz/support) or the [Disease.sh server](https://discord.gg/cEDxzfW).
# Basic usage
```py
import diseaseapi
import asyncio
client = diseaseapi.Client()
covid = client.covid19
# for influenza, use: influenza = client.influenza
async def main():
data = await covid.all()
print(
data.cases,
data.today.cases,
data.deaths,
data.today.deaths
)
await client.request_client.close()
asyncio.get_event_loop().run_until_complete(main())
```
# Optional parameters in Covid methods
| Parameter | Supported methods | Accepted values |
|---------------- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `yesterday` | - `all()`<br>- `country()`<br>- `all_countries()`<br>- `all_states()`<br>- `state()`<br>- `all_continents()`<br>- `continent()` | - `True`<br>- `False` |
| `two_days_ago` | - `all()`<br>- `country()`<br>- `all_countries()`<br>- `continent()`<br>- `all_continents()` | - `True`<br>- `False` |
| `sort` | - `all_countries()`<br>- `all_states()`<br>- `all_continents()` |Depends on the endpoint used. Consult the API documentation to see which endpoints support which parameters. |
| `allow_none` | - `all()`<br>- `country()`<br>- `all_countries()`<br>- `all_continents()`<br>- `continent()`<br>- `state()`<br>- `all_states()`<br>- `gov()` | - `True`<br>- `False` |
| `last_days` | - `country_history()`<br>- `province_history()`<br>- `county_history()`<br>- `vaccine_coverage()`<br>- `vaccine_countries()`<br>- `vaccine_country()` | - `'all'`<br>- Any int value |
# Examples
The following examples cover the basic usage of the library and its various features.
Note; many methods also support `yesterday=True`, `sort='sort method'` and `allow_none=True` kwargs to get data from the previous day or sorted by various parameters. Refer to the table above to find out which ones do and do not.
## Discord bot
There is an example cog for your Discord bot [here](https://github.com/apex2504/disease.py/blob/master/examples/discord_cog.py).
## Basic data
### Global data
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_all():
data = await client.all() #get global data
print(data.cases, data.deaths) #print the number of global cases and deaths
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_all())
```
### Data for a specific country
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_country():
data = await client.country('UK') #get data for the UK today,
print(data.cases, data.deaths) #print the number of cases and deaths for the UK
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_country())
```
### Data for more than one country
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_countries():
data = await client.country('UK', 'USA', 'China') #get data for specified countries
#to get data for every country supported, use: all_countries()
print(data) #prints a list of Country
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_countries())
```
## US States
### Data for a specific state
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_state():
data = await client.state('Ohio') #get data for Ohio today,
print(data.cases, data.deaths) #print the number of cases and deaths for Ohio
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_state())
```
### Data for more than one state
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_states():
data = await client.state('Ohio', 'California', 'Texas') #get data for specified states
#to get data for every state supported, use: all_states()
print(data) #prints a list of State
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_states())
```
## Historical statistics
### Historical data globally
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_history():
data = await client.country_history('all', 'all') #get all the historical data for the world
print(data.name, data.history.cases[0].date, data.history.cases[0].value) #print name (in this case 'Global'), the date of the first entry, and the number of cases for that date
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_history())
```
### Historical data for a country
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_history():
data = await client.country_history('UK', 7) #get the past week of historical data for the UK
print(data.name, data.history.cases[0].date, data.history.cases[0].value) #print name, the date of the first entry, and the number of cases for that date
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_history())
```
### Historical data for a province
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_history_province():
data = await client.province_history('UK', 'Gibraltar', 7) #get the past week of historical data for Gibraltar, UK
print(data.province, data.history.cases[0].date, data.history.deaths[0].value) #print province name, the date of the first entry, and the number of cases for that date
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_history_province())
```
### Historical data for a county within a US state
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_county():
data = await client.county_history('Ohio', 'Adams') #get all historical data for Adams, Ohio, USA
print(data.name, data.province, data.history.cases[0].date, data.history.cases[0].value) #print state and county name, the date of the first entry, and the number of cases for that date
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_county())
```
## John Hopkins University CSSE
### All data from the JHU CSSE
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_jhu():
data = await client.jhucsse() #get data for every province and country JHU supports
print(data) #print a long list of JhuCsse
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_jhu())
```
### Data for a county within a US state
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_jhu_county():
data = await client.jhu_county('Ohio', 'Adams') #get data for Adams, Ohio
print(data.province_name, data.county_name, data.confirmed_cases) #print the state, county and case number
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_jhu_county())
```
### Data for every county in the USA
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_jhu_counties():
data = await client.jhu_all_counties()
print(data) #print a long list of JhuCsse
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_jhu_counties())
```
## Continental data
### Data for every continent
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_conts():
data = await client.all_continents()
first = data[0]
print(first.name, first.cases, first.deaths) #print some info for the first continent in the list
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_conts())
```
### Data for a single continent
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_one_cont():
data = await client.continent('Europe')
print(data.name, data.cases, data.deaths) #print some info for the specified continent
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_one_cont())
```
## New York Times
### USA data from NY Times
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_nyt_us():
data = await client.nyt()
first = data[0]
print(first.date, first.cases, first.deaths) #print first piece of data
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_nyt_us())
```
### All USA state data from NY Times
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_nyt_states():
data = await client.nyt_states()
first = data[0]
print(first.state, first.date, first.cases) #print some data from the frst element
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_nyt_states())
```
### Data for a single state from NY Times
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_nyt_state():
data = await client.nyt_state('Ohio')
first = date[0]
print(first.date, first.cases, first.deaths) #print the first date, and case/death number
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_nyt_state())
```
### Every county from NY Times
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_counts():
data = await client.nyt_counties()
first = data[0]
print(first.date, first.cases, first.deaths) #print part of the first piece of data
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_counts())
```
### Counties from NYT filtered by name
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_one_county():
data = await client.nyt_county('Adams')
first = data[0]
print(first.date, first.cases, first.deaths) #print part of the first piece of data
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_one_county())
```
## Apple Mobility
### Every country supported by Apple Mobility Data
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def all_apples():
data = await client.apple_countries()
print(data) #print all supported countries
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(apples())
```
### Every subregion within a country for Apple Mobility
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_subregions():
data = await client.apple_subregions('UK')
print(data.subregions) #print all supported subregions within the country
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_subregions())
```
### Apple's Mobility data for a subregion
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_one_sub():
data = await client.apple_mobility_data('UK', 'London')
first = data.statistics[0]
print(first.date, first.name, first.driving) #print some data about the first result
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_one_sub())
```
## Governmental data
### All countries supported by the API for government data
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_gov_countries():
data = await client.gov_countries()
print(data) #print the supported countries
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_gov_countries())
```
### Get the data from a country's government site
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def get_country_gov():
data = await client.gov('UK')
print(data) #probably will return a large amount of dict data.
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(get_country_gov())
```
### Get the vaccine data globally
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def vax_cov():
data = await client.vaccine_coverage(30)
print(data[0].date.day, data[0].value) #global vaccine data 30 days ago
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(vax_cov())
```
### Get the vaccine data for all countries
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def vax_all():
data = await client.vaccine_countries(30)
d = data[0]
print(d.country, d.timeline[0].date, d.timeline[0].value)
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(vax_all())
```
### Get the vaccine data for a specific country
```python
import diseaseapi
import asyncio
client = diseaseapi.Client().covid19
async def vax_ctry():
data = await client.vaccine_country('UK', 30)
print(d.country, d.timeline[0].date, d.timeline[0].value)
await client.request_client.close() #close the ClientSession
asyncio.get_event_loop().run_until_complete(vac_ctry())
```
# Note
Due to the fact that each country's governmental/official statistics website is different (layouts, tables etc.), it is not feasible to create a standardised class for the data. However, the data returned will be in standard JSON format so it should be relatively simple to work with.
نحوه نصب
نصب پکیج whl disease.py-1.2.0:
pip install disease.py-1.2.0.whl
نصب پکیج tar.gz disease.py-1.2.0:
pip install disease.py-1.2.0.tar.gz