# superweather
This Python package fetches air quality data for a specified city and provides various functionalities like displaying the data, speaking it aloud, and more.
## Installation
You can install the package using pip:
```bash
pip install superweather
```
## For use in terminal mode
+ By running this code, the terminal will be opened and you will find the city number from the list, and if the city name is not in the list, you can write the name of your city.
+ All cities in the world are supported
+ The next option says what information you want, temperature and humidity or all
+ will show you what you have chosen
```python
from superweather import terminal_mode
terminal_mode()
```
## The methods of this package for development and programming without a terminal
+ You must use this code for coding without a terminal
+ In this way, it is known that you give the name of the city and the next line you say it will not be displayed
```python
from superweather import AirQualityData
aq = AirQualityData("tehran")
print(aq.get_full_info())
```
+ This shows all the codes
+ + Output: json
```json
{
"city": "Tehran",
"aqi": 85, # Example AQI value
"temperature": 10, # Example temperature value in °C
"humidity": 40, # Example humidity value in %
"air_pollution_level": "Moderate (متوسط)"
}
```
+ Get AQI Info:
```python
print(aq.get_aqi_info())
```
```json
AQI: 85 (Moderate (متوسط))
```
+ As well as the rest of the methods
```python
print(aq.get_temperature_info())
print(aq.get_humidity_info())
```
+ And finally this method
+ + This method reads the weather report
```python
aq.speak_info()
```
### __good luck__
### ________________________________________________________________________________________________________________________________________________________________
### به زبان فارسی
# superweather
این بسته پایتون دادههای کیفیت هوا را برای یک شهر مشخص دریافت میکند و عملکردهای مختلفی مانند نمایش دادهها، صحبت کردن با صدای بلند و غیره را ارائه میکند.
## نصب
می توانید بسته را با استفاده از pip نصب کنید:
```bash
pip install superweather
```
## برای استفاده در حالت ترمینال
+ با اجرای این کد ترمینال باز می شود و شماره شهر را از لیست پیدا می کنید و اگر نام شهر در لیست نبود می توانید نام شهر خود را بنویسید.
+ تمام شهرهای جهان پشتیبانی می شوند
+ گزینه بعدی می گوید چه اطلاعاتی می خواهید، دما و رطوبت یا همه
+ آنچه را که انتخاب کرده اید به شما نشان می دهد
```python
from superweather import terminal_mode
terminal_mode()
```
## روش های این بسته برای توسعه و برنامه نویسی بدون ترمینال
+ برای کدنویسی بدون ترمینال باید از این کد استفاده کنید
+ همین جور معلوم است اسم شهر میدی و خط بعد نخوه نمایش میگی
```python
from superweather import AirQualityData
aq = AirQualityData("tehran")
print(aq.get_full_info())
```
+ این همه کدها را نشان می دهد
+ + خروجی: json
```json
{
"city": "Tehran",
"aqi": 85, # Example AQI value
"temperature": 10, # Example temperature value in °C
"humidity": 40, # Example humidity value in %
"air_pollution_level": "Moderate (متوسط)"
}
```
+ اطلاعات AQI را دریافت کنید:
```python
print(aq.get_aqi_info())
```
```json
AQI: 85 (Moderate (متوسط))
```
+ همینطور بقیه روش ها
```python
print(aq.get_temperature_info())
print(aq.get_humidity_info())
```
+ و در نهایت این روش
+ + این روش گزارش آب و هوا را می خواند
```python
aq.speak_info()
```
### __موفق یاشد__
Raw data
{
"_id": null,
"home_page": "https://github.com/mohammadlegend",
"name": "superweather",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "mohammad shabakhti",
"author_email": "smmshabakhti@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c2/7a/7f813077d6d9f609da0fbd591f8fc7cdc4395d644e637a418bd30920b85c/superweather-0.3.2.4.tar.gz",
"platform": null,
"description": "# superweather\r\n\r\nThis Python package fetches air quality data for a specified city and provides various functionalities like displaying the data, speaking it aloud, and more.\r\n\r\n## Installation\r\n\r\nYou can install the package using pip:\r\n\r\n```bash\r\npip install superweather\r\n```\r\n## For use in terminal mode \r\n+ By running this code, the terminal will be opened and you will find the city number from the list, and if the city name is not in the list, you can write the name of your city.\r\n+ All cities in the world are supported\r\n+ The next option says what information you want, temperature and humidity or all \r\n+ will show you what you have chosen\r\n\r\n```python\r\nfrom superweather import terminal_mode\r\n\r\nterminal_mode()\r\n```\r\n## The methods of this package for development and programming without a terminal\r\n\r\n+ You must use this code for coding without a terminal\r\n+ In this way, it is known that you give the name of the city and the next line you say it will not be displayed\r\n\r\n\r\n\r\n```python\r\nfrom superweather import AirQualityData\r\n\r\naq = AirQualityData(\"tehran\")\r\nprint(aq.get_full_info())\r\n\r\n```\r\n+ This shows all the codes\r\n+ + Output: json\r\n```json\r\n{\r\n \"city\": \"Tehran\",\r\n \"aqi\": 85, # Example AQI value\r\n \"temperature\": 10, # Example temperature value in \u00b0C\r\n \"humidity\": 40, # Example humidity value in %\r\n \"air_pollution_level\": \"Moderate (\u0645\u062a\u0648\u0633\u0637)\"\r\n}\r\n```\r\n+ Get AQI Info:\r\n```python\r\nprint(aq.get_aqi_info())\r\n```\r\n```json\r\nAQI: 85 (Moderate (\u0645\u062a\u0648\u0633\u0637))\r\n```\r\n+ As well as the rest of the methods\r\n```python\r\nprint(aq.get_temperature_info())\r\n\r\nprint(aq.get_humidity_info())\r\n\r\n```\r\n+ And finally this method\r\n+ + This method reads the weather report\r\n```python\r\naq.speak_info()\r\n\r\n```\r\n### __good luck__\r\n\r\n### ________________________________________________________________________________________________________________________________________________________________\r\n\r\n### \u0628\u0647 \u0632\u0628\u0627\u0646 \u0641\u0627\u0631\u0633\u06cc\r\n\r\n# superweather\r\n\r\n\u0627\u06cc\u0646 \u0628\u0633\u062a\u0647 \u067e\u0627\u06cc\u062a\u0648\u0646 \u062f\u0627\u062f\u0647\u200c\u0647\u0627\u06cc \u06a9\u06cc\u0641\u06cc\u062a \u0647\u0648\u0627 \u0631\u0627 \u0628\u0631\u0627\u06cc \u06cc\u06a9 \u0634\u0647\u0631 \u0645\u0634\u062e\u0635 \u062f\u0631\u06cc\u0627\u0641\u062a \u0645\u06cc\u200c\u06a9\u0646\u062f \u0648 \u0639\u0645\u0644\u06a9\u0631\u062f\u0647\u0627\u06cc \u0645\u062e\u062a\u0644\u0641\u06cc \u0645\u0627\u0646\u0646\u062f \u0646\u0645\u0627\u06cc\u0634 \u062f\u0627\u062f\u0647\u200c\u0647\u0627\u060c \u0635\u062d\u0628\u062a \u06a9\u0631\u062f\u0646 \u0628\u0627 \u0635\u062f\u0627\u06cc \u0628\u0644\u0646\u062f \u0648 \u063a\u06cc\u0631\u0647 \u0631\u0627 \u0627\u0631\u0627\u0626\u0647 \u0645\u06cc\u200c\u06a9\u0646\u062f.\r\n\r\n## \u0646\u0635\u0628\r\n\r\n\u0645\u06cc \u062a\u0648\u0627\u0646\u06cc\u062f \u0628\u0633\u062a\u0647 \u0631\u0627 \u0628\u0627 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 pip \u0646\u0635\u0628 \u06a9\u0646\u06cc\u062f:\r\n\r\n```bash\r\npip install superweather\r\n```\r\n## \u0628\u0631\u0627\u06cc \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u062f\u0631 \u062d\u0627\u0644\u062a \u062a\u0631\u0645\u06cc\u0646\u0627\u0644 \r\n+ \u0628\u0627 \u0627\u062c\u0631\u0627\u06cc \u0627\u06cc\u0646 \u06a9\u062f \u062a\u0631\u0645\u06cc\u0646\u0627\u0644 \u0628\u0627\u0632 \u0645\u06cc \u0634\u0648\u062f \u0648 \u0634\u0645\u0627\u0631\u0647 \u0634\u0647\u0631 \u0631\u0627 \u0627\u0632 \u0644\u06cc\u0633\u062a \u067e\u06cc\u062f\u0627 \u0645\u06cc \u06a9\u0646\u06cc\u062f \u0648 \u0627\u06af\u0631 \u0646\u0627\u0645 \u0634\u0647\u0631 \u062f\u0631 \u0644\u06cc\u0633\u062a \u0646\u0628\u0648\u062f \u0645\u06cc \u062a\u0648\u0627\u0646\u06cc\u062f \u0646\u0627\u0645 \u0634\u0647\u0631 \u062e\u0648\u062f \u0631\u0627 \u0628\u0646\u0648\u06cc\u0633\u06cc\u062f.\r\n+ \u062a\u0645\u0627\u0645 \u0634\u0647\u0631\u0647\u0627\u06cc \u062c\u0647\u0627\u0646 \u067e\u0634\u062a\u06cc\u0628\u0627\u0646\u06cc \u0645\u06cc \u0634\u0648\u0646\u062f\r\n+ \u06af\u0632\u06cc\u0646\u0647 \u0628\u0639\u062f\u06cc \u0645\u06cc \u06af\u0648\u06cc\u062f \u0686\u0647 \u0627\u0637\u0644\u0627\u0639\u0627\u062a\u06cc \u0645\u06cc \u062e\u0648\u0627\u0647\u06cc\u062f\u060c \u062f\u0645\u0627 \u0648 \u0631\u0637\u0648\u0628\u062a \u06cc\u0627 \u0647\u0645\u0647 \r\n+ \u0622\u0646\u0686\u0647 \u0631\u0627 \u06a9\u0647 \u0627\u0646\u062a\u062e\u0627\u0628 \u06a9\u0631\u062f\u0647 \u0627\u06cc\u062f \u0628\u0647 \u0634\u0645\u0627 \u0646\u0634\u0627\u0646 \u0645\u06cc \u062f\u0647\u062f\r\n\r\n```python\r\nfrom superweather import terminal_mode\r\n\r\nterminal_mode()\r\n```\r\n## \u0631\u0648\u0634 \u0647\u0627\u06cc \u0627\u06cc\u0646 \u0628\u0633\u062a\u0647 \u0628\u0631\u0627\u06cc \u062a\u0648\u0633\u0639\u0647 \u0648 \u0628\u0631\u0646\u0627\u0645\u0647 \u0646\u0648\u06cc\u0633\u06cc \u0628\u062f\u0648\u0646 \u062a\u0631\u0645\u06cc\u0646\u0627\u0644\r\n+ \u0628\u0631\u0627\u06cc \u06a9\u062f\u0646\u0648\u06cc\u0633\u06cc \u0628\u062f\u0648\u0646 \u062a\u0631\u0645\u06cc\u0646\u0627\u0644 \u0628\u0627\u06cc\u062f \u0627\u0632 \u0627\u06cc\u0646 \u06a9\u062f \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u06a9\u0646\u06cc\u062f\r\n+ \u0647\u0645\u06cc\u0646 \u062c\u0648\u0631 \u0645\u0639\u0644\u0648\u0645 \u0627\u0633\u062a \u0627\u0633\u0645 \u0634\u0647\u0631 \u0645\u06cc\u062f\u06cc \u0648 \u062e\u0637 \u0628\u0639\u062f \u0646\u062e\u0648\u0647 \u0646\u0645\u0627\u06cc\u0634 \u0645\u06cc\u06af\u06cc\r\n\r\n```python\r\nfrom superweather import AirQualityData\r\n\r\naq = AirQualityData(\"tehran\")\r\nprint(aq.get_full_info())\r\n\r\n```\r\n+ \u0627\u06cc\u0646 \u0647\u0645\u0647 \u06a9\u062f\u0647\u0627 \u0631\u0627 \u0646\u0634\u0627\u0646 \u0645\u06cc \u062f\u0647\u062f\r\n+ + \u062e\u0631\u0648\u062c\u06cc: json\r\n\r\n```json\r\n{\r\n \"city\": \"Tehran\",\r\n \"aqi\": 85, # Example AQI value\r\n \"temperature\": 10, # Example temperature value in \u00b0C\r\n \"humidity\": 40, # Example humidity value in %\r\n \"air_pollution_level\": \"Moderate (\u0645\u062a\u0648\u0633\u0637)\"\r\n}\r\n```\r\n+ \u0627\u0637\u0644\u0627\u0639\u0627\u062a AQI \u0631\u0627 \u062f\u0631\u06cc\u0627\u0641\u062a \u06a9\u0646\u06cc\u062f:\r\n\r\n```python\r\nprint(aq.get_aqi_info())\r\n```\r\n```json\r\nAQI: 85 (Moderate (\u0645\u062a\u0648\u0633\u0637))\r\n```\r\n+ \u0647\u0645\u06cc\u0646\u0637\u0648\u0631 \u0628\u0642\u06cc\u0647 \u0631\u0648\u0634 \u0647\u0627\r\n```python\r\nprint(aq.get_temperature_info())\r\n\r\nprint(aq.get_humidity_info())\r\n\r\n```\r\n+ \u0648 \u062f\u0631 \u0646\u0647\u0627\u06cc\u062a \u0627\u06cc\u0646 \u0631\u0648\u0634\r\n+ + \u0627\u06cc\u0646 \u0631\u0648\u0634 \u06af\u0632\u0627\u0631\u0634 \u0622\u0628 \u0648 \u0647\u0648\u0627 \u0631\u0627 \u0645\u06cc \u062e\u0648\u0627\u0646\u062f\r\n```python\r\naq.speak_info()\r\n\r\n```\r\n### __\u0645\u0648\u0641\u0642 \u06cc\u0627\u0634\u062f__\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A package to fetch and display air quality data.",
"version": "0.3.2.4",
"project_urls": {
"Homepage": "https://github.com/mohammadlegend"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "da2c8bda4267ac5b4372ce1935b0d3365907f15f12fb45c19f48d310a4b3187d",
"md5": "beaeeb17a35240b8304004302235c6eb",
"sha256": "08fb550526f556bf1e4bb04e8f2a0dffa47566eeedbd4dfdf4e48f944b8ca235"
},
"downloads": -1,
"filename": "superweather-0.3.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "beaeeb17a35240b8304004302235c6eb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6021,
"upload_time": "2025-02-10T08:48:57",
"upload_time_iso_8601": "2025-02-10T08:48:57.905178Z",
"url": "https://files.pythonhosted.org/packages/da/2c/8bda4267ac5b4372ce1935b0d3365907f15f12fb45c19f48d310a4b3187d/superweather-0.3.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c27a7f813077d6d9f609da0fbd591f8fc7cdc4395d644e637a418bd30920b85c",
"md5": "981ee63317912783aace49507b2e43ef",
"sha256": "c109d0ffb92c0e5383e908dc7e3eb7393535500efd4c00efe7b5d36dd8791e5a"
},
"downloads": -1,
"filename": "superweather-0.3.2.4.tar.gz",
"has_sig": false,
"md5_digest": "981ee63317912783aace49507b2e43ef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5746,
"upload_time": "2025-02-10T08:48:59",
"upload_time_iso_8601": "2025-02-10T08:48:59.977529Z",
"url": "https://files.pythonhosted.org/packages/c2/7a/7f813077d6d9f609da0fbd591f8fc7cdc4395d644e637a418bd30920b85c/superweather-0.3.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-10 08:48:59",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "superweather"
}