# send_email
`send_email` یک کتابخانه Python است که برای ارسال ایمیلها از طریق API سایت [api-free.ir](https://api-free.ir) طراحی شده است. این کتابخانه به شما امکان میدهد که به راحتی و به سرعت ایمیلهای خود را ارسال کنید.
## نصب
برای نصب این کتابخانه، میتوانید از `pip` استفاده کنید. دستور زیر را در ترمینال خود اجرا کنید:
```bash
pip install git+https://github.com/Mahditerorist/send_email.git
```
**استفاده**
در زیر یک مثال ساده برای استفاده از این کتابخانه آورده شده است:
```python
Copy code
from send_email import Email
# تنظیمات ایمیل
setup = Email(
To='mahdiahmadi.1208@gmail.com',
text='hi',
Title='Codern',
Token=None,
Input='iran'
)
# ارسال ایمیل
result = setup.Send()
print(result)
```
مثال عملی
```python
Copy code
from send_email import Email
# تنظیمات ایمیل
to_email = 'recipient@example.com'
text_content = 'این یک ایمیل تستی است.'
email_title = 'سلام!'
api_token = 'your_api_token_here'
input_type = 'info'
# ساخت نمونهای از کلاس Email
email = Email(
To=to_email,
text=text_content,
Title=email_title,
Token=api_token,
Input=input_type
)
# ارسال ایمیل
result = email.Send()
if result:
print('ایمیل با موفقیت ارسال شد!')
else:
print('خطا در ارسال ایمیل')
```
# پارامترها
1. To: آدرس ایمیل گیرنده.
2. text: متن ایمیل.
3. Title: عنوان ایمیل.
4. Token: توکن احراز هویت برای استفاده از API. برای دریافت توکن، باید در سایت api-free.ir ثبتنام کنید و توکن مخصوص خود را دریافت کنید.
5. Input: نوع ورودی که میتواند یکی از مقادیر 'info', 'app', 'Login', 'support' باشد.
راهنمای کامل
1. ثبتنام در سایت api-free.ir
ابتدا به آیدی rubika.ir/bot_token بروید آنجا میتوانید توکن API خود را دریافت کنید.
2. نصب کتابخانه
با استفاده از دستور pip کتابخانه را نصب کنید:
```bash
Copy code
pip install git+https://github.com/Mahditerorist/send_email.git
```
3. استفاده از کتابخانه
یک فایل Python جدید ایجاد کنید و کد زیر را در آن قرار دهید:
```python
Copy code
from send_email import Email
# تنظیمات ایمیل
setup = Email(
To='mahdiahmadi.1208@gmail.com',
text='hi',
Title='Codern',
Token=None,
Input='iran'
)
# ارسال ایمیل
result = setup.Send()
print(result)
```
4. اجرای کد
فایل Python خود را اجرا کنید تا ایمیل ارسال شود:
```bash
Copy code
python your_file_name.py
```
مشکلات متداول
1. خطای اتصال به API
اگر با خطای اتصال به API مواجه شدید، مطمئن شوید که به اینترنت متصل هستید و آدرس API به درستی وارد شده است.
2. خطای احراز هویت
اگر با خطای احراز هویت مواجه شدید، مطمئن شوید که توکن API را به درستی وارد کردهاید و توکن معتبر است.
مشارکت
اگر مایل به مشارکت در توسعه این کتابخانه هستید، میتوانید مخزن را فورک کرده و تغییرات خود را از طریق Pull Request ارسال کنید. هر گونه کمک و پیشنهاد استقبال میشود.
مجوز
این پروژه تحت مجوز MIT منتشر شده است. برای اطلاعات بیشتر فایل LICENSE را مشاهده کنید.
برای هر گونه سوال یا مشکل، میتوانید از طریق api-free.ir با ما در تماس باشید.
Raw data
{
"_id": null,
"home_page": "https://github.com/Mahditerorist/send_email",
"name": "free-send",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Your Name",
"author_email": "your-email@example.com",
"download_url": null,
"platform": null,
"description": "# send_email\r\n\r\n`send_email` \u06cc\u06a9 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 Python \u0627\u0633\u062a \u06a9\u0647 \u0628\u0631\u0627\u06cc \u0627\u0631\u0633\u0627\u0644 \u0627\u06cc\u0645\u06cc\u0644\u200c\u0647\u0627 \u0627\u0632 \u0637\u0631\u06cc\u0642 API \u0633\u0627\u06cc\u062a [api-free.ir](https://api-free.ir) \u0637\u0631\u0627\u062d\u06cc \u0634\u062f\u0647 \u0627\u0633\u062a. \u0627\u06cc\u0646 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 \u0628\u0647 \u0634\u0645\u0627 \u0627\u0645\u06a9\u0627\u0646 \u0645\u06cc\u200c\u062f\u0647\u062f \u06a9\u0647 \u0628\u0647 \u0631\u0627\u062d\u062a\u06cc \u0648 \u0628\u0647 \u0633\u0631\u0639\u062a \u0627\u06cc\u0645\u06cc\u0644\u200c\u0647\u0627\u06cc \u062e\u0648\u062f \u0631\u0627 \u0627\u0631\u0633\u0627\u0644 \u06a9\u0646\u06cc\u062f.\r\n\r\n## \u0646\u0635\u0628\r\n\r\n\u0628\u0631\u0627\u06cc \u0646\u0635\u0628 \u0627\u06cc\u0646 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647\u060c \u0645\u06cc\u200c\u062a\u0648\u0627\u0646\u06cc\u062f \u0627\u0632 `pip` \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u06a9\u0646\u06cc\u062f. \u062f\u0633\u062a\u0648\u0631 \u0632\u06cc\u0631 \u0631\u0627 \u062f\u0631 \u062a\u0631\u0645\u06cc\u0646\u0627\u0644 \u062e\u0648\u062f \u0627\u062c\u0631\u0627 \u06a9\u0646\u06cc\u062f:\r\n\r\n```bash\r\npip install git+https://github.com/Mahditerorist/send_email.git\r\n```\r\n**\u0627\u0633\u062a\u0641\u0627\u062f\u0647**\r\n\u062f\u0631 \u0632\u06cc\u0631 \u06cc\u06a9 \u0645\u062b\u0627\u0644 \u0633\u0627\u062f\u0647 \u0628\u0631\u0627\u06cc \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u0627\u06cc\u0646 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 \u0622\u0648\u0631\u062f\u0647 \u0634\u062f\u0647 \u0627\u0633\u062a:\r\n\r\n```python\r\nCopy code\r\nfrom send_email import Email\r\n\r\n# \u062a\u0646\u0638\u06cc\u0645\u0627\u062a \u0627\u06cc\u0645\u06cc\u0644\r\nsetup = Email(\r\n To='mahdiahmadi.1208@gmail.com',\r\n text='hi',\r\n Title='Codern',\r\n Token=None,\r\n Input='iran'\r\n)\r\n\r\n# \u0627\u0631\u0633\u0627\u0644 \u0627\u06cc\u0645\u06cc\u0644\r\nresult = setup.Send()\r\nprint(result)\r\n```\r\n\u0645\u062b\u0627\u0644 \u0639\u0645\u0644\u06cc\r\n```python\r\nCopy code\r\nfrom send_email import Email\r\n\r\n# \u062a\u0646\u0638\u06cc\u0645\u0627\u062a \u0627\u06cc\u0645\u06cc\u0644\r\nto_email = 'recipient@example.com'\r\ntext_content = '\u0627\u06cc\u0646 \u06cc\u06a9 \u0627\u06cc\u0645\u06cc\u0644 \u062a\u0633\u062a\u06cc \u0627\u0633\u062a.'\r\nemail_title = '\u0633\u0644\u0627\u0645!'\r\napi_token = 'your_api_token_here'\r\ninput_type = 'info'\r\n\r\n# \u0633\u0627\u062e\u062a \u0646\u0645\u0648\u0646\u0647\u200c\u0627\u06cc \u0627\u0632 \u06a9\u0644\u0627\u0633 Email\r\nemail = Email(\r\n To=to_email,\r\n text=text_content,\r\n Title=email_title,\r\n Token=api_token,\r\n Input=input_type\r\n)\r\n\r\n# \u0627\u0631\u0633\u0627\u0644 \u0627\u06cc\u0645\u06cc\u0644\r\nresult = email.Send()\r\nif result:\r\n print('\u0627\u06cc\u0645\u06cc\u0644 \u0628\u0627 \u0645\u0648\u0641\u0642\u06cc\u062a \u0627\u0631\u0633\u0627\u0644 \u0634\u062f!')\r\nelse:\r\n print('\u062e\u0637\u0627 \u062f\u0631 \u0627\u0631\u0633\u0627\u0644 \u0627\u06cc\u0645\u06cc\u0644')\r\n\r\n```\r\n# \u067e\u0627\u0631\u0627\u0645\u062a\u0631\u0647\u0627\r\n1. To: \u0622\u062f\u0631\u0633 \u0627\u06cc\u0645\u06cc\u0644 \u06af\u06cc\u0631\u0646\u062f\u0647.\r\n2. text: \u0645\u062a\u0646 \u0627\u06cc\u0645\u06cc\u0644.\r\n3. Title: \u0639\u0646\u0648\u0627\u0646 \u0627\u06cc\u0645\u06cc\u0644.\r\n4. Token: \u062a\u0648\u06a9\u0646 \u0627\u062d\u0631\u0627\u0632 \u0647\u0648\u06cc\u062a \u0628\u0631\u0627\u06cc \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 API. \u0628\u0631\u0627\u06cc \u062f\u0631\u06cc\u0627\u0641\u062a \u062a\u0648\u06a9\u0646\u060c \u0628\u0627\u06cc\u062f \u062f\u0631 \u0633\u0627\u06cc\u062a api-free.ir \u062b\u0628\u062a\u200c\u0646\u0627\u0645 \u06a9\u0646\u06cc\u062f \u0648 \u062a\u0648\u06a9\u0646 \u0645\u062e\u0635\u0648\u0635 \u062e\u0648\u062f \u0631\u0627 \u062f\u0631\u06cc\u0627\u0641\u062a \u06a9\u0646\u06cc\u062f.\r\n5. Input: \u0646\u0648\u0639 \u0648\u0631\u0648\u062f\u06cc \u06a9\u0647 \u0645\u06cc\u200c\u062a\u0648\u0627\u0646\u062f \u06cc\u06a9\u06cc \u0627\u0632 \u0645\u0642\u0627\u062f\u06cc\u0631 'info', 'app', 'Login', 'support' \u0628\u0627\u0634\u062f.\r\n\u0631\u0627\u0647\u0646\u0645\u0627\u06cc \u06a9\u0627\u0645\u0644\r\n1. \u062b\u0628\u062a\u200c\u0646\u0627\u0645 \u062f\u0631 \u0633\u0627\u06cc\u062a api-free.ir\r\n\u0627\u0628\u062a\u062f\u0627 \u0628\u0647 \u0622\u06cc\u062f\u06cc rubika.ir/bot_token \u0628\u0631\u0648\u06cc\u062f \u0622\u0646\u062c\u0627 \u0645\u06cc\u200c\u062a\u0648\u0627\u0646\u06cc\u062f \u062a\u0648\u06a9\u0646 API \u062e\u0648\u062f \u0631\u0627 \u062f\u0631\u06cc\u0627\u0641\u062a \u06a9\u0646\u06cc\u062f.\r\n\r\n2. \u0646\u0635\u0628 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647\r\n\u0628\u0627 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u062f\u0633\u062a\u0648\u0631 pip \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 \u0631\u0627 \u0646\u0635\u0628 \u06a9\u0646\u06cc\u062f:\r\n\r\n```bash\r\nCopy code\r\npip install git+https://github.com/Mahditerorist/send_email.git\r\n```\r\n3. \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647\r\n\u06cc\u06a9 \u0641\u0627\u06cc\u0644 Python \u062c\u062f\u06cc\u062f \u0627\u06cc\u062c\u0627\u062f \u06a9\u0646\u06cc\u062f \u0648 \u06a9\u062f \u0632\u06cc\u0631 \u0631\u0627 \u062f\u0631 \u0622\u0646 \u0642\u0631\u0627\u0631 \u062f\u0647\u06cc\u062f:\r\n\r\n```python\r\nCopy code\r\nfrom send_email import Email\r\n\r\n# \u062a\u0646\u0638\u06cc\u0645\u0627\u062a \u0627\u06cc\u0645\u06cc\u0644\r\nsetup = Email(\r\n To='mahdiahmadi.1208@gmail.com',\r\n text='hi',\r\n Title='Codern',\r\n Token=None,\r\n Input='iran'\r\n)\r\n\r\n# \u0627\u0631\u0633\u0627\u0644 \u0627\u06cc\u0645\u06cc\u0644\r\nresult = setup.Send()\r\nprint(result)\r\n```\r\n4. \u0627\u062c\u0631\u0627\u06cc \u06a9\u062f\r\n\u0641\u0627\u06cc\u0644 Python \u062e\u0648\u062f \u0631\u0627 \u0627\u062c\u0631\u0627 \u06a9\u0646\u06cc\u062f \u062a\u0627 \u0627\u06cc\u0645\u06cc\u0644 \u0627\u0631\u0633\u0627\u0644 \u0634\u0648\u062f:\r\n\r\n```bash\r\nCopy code\r\npython your_file_name.py\r\n```\r\n\u0645\u0634\u06a9\u0644\u0627\u062a \u0645\u062a\u062f\u0627\u0648\u0644\r\n1. \u062e\u0637\u0627\u06cc \u0627\u062a\u0635\u0627\u0644 \u0628\u0647 API\r\n\u0627\u06af\u0631 \u0628\u0627 \u062e\u0637\u0627\u06cc \u0627\u062a\u0635\u0627\u0644 \u0628\u0647 API \u0645\u0648\u0627\u062c\u0647 \u0634\u062f\u06cc\u062f\u060c \u0645\u0637\u0645\u0626\u0646 \u0634\u0648\u06cc\u062f \u06a9\u0647 \u0628\u0647 \u0627\u06cc\u0646\u062a\u0631\u0646\u062a \u0645\u062a\u0635\u0644 \u0647\u0633\u062a\u06cc\u062f \u0648 \u0622\u062f\u0631\u0633 API \u0628\u0647 \u062f\u0631\u0633\u062a\u06cc \u0648\u0627\u0631\u062f \u0634\u062f\u0647 \u0627\u0633\u062a.\r\n\r\n2. \u062e\u0637\u0627\u06cc \u0627\u062d\u0631\u0627\u0632 \u0647\u0648\u06cc\u062a\r\n\u0627\u06af\u0631 \u0628\u0627 \u062e\u0637\u0627\u06cc \u0627\u062d\u0631\u0627\u0632 \u0647\u0648\u06cc\u062a \u0645\u0648\u0627\u062c\u0647 \u0634\u062f\u06cc\u062f\u060c \u0645\u0637\u0645\u0626\u0646 \u0634\u0648\u06cc\u062f \u06a9\u0647 \u062a\u0648\u06a9\u0646 API \u0631\u0627 \u0628\u0647 \u062f\u0631\u0633\u062a\u06cc \u0648\u0627\u0631\u062f \u06a9\u0631\u062f\u0647\u200c\u0627\u06cc\u062f \u0648 \u062a\u0648\u06a9\u0646 \u0645\u0639\u062a\u0628\u0631 \u0627\u0633\u062a.\r\n\r\n\u0645\u0634\u0627\u0631\u06a9\u062a\r\n\u0627\u06af\u0631 \u0645\u0627\u06cc\u0644 \u0628\u0647 \u0645\u0634\u0627\u0631\u06a9\u062a \u062f\u0631 \u062a\u0648\u0633\u0639\u0647 \u0627\u06cc\u0646 \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 \u0647\u0633\u062a\u06cc\u062f\u060c \u0645\u06cc\u200c\u062a\u0648\u0627\u0646\u06cc\u062f \u0645\u062e\u0632\u0646 \u0631\u0627 \u0641\u0648\u0631\u06a9 \u06a9\u0631\u062f\u0647 \u0648 \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u062e\u0648\u062f \u0631\u0627 \u0627\u0632 \u0637\u0631\u06cc\u0642 Pull Request \u0627\u0631\u0633\u0627\u0644 \u06a9\u0646\u06cc\u062f. \u0647\u0631 \u06af\u0648\u0646\u0647 \u06a9\u0645\u06a9 \u0648 \u067e\u06cc\u0634\u0646\u0647\u0627\u062f \u0627\u0633\u062a\u0642\u0628\u0627\u0644 \u0645\u06cc\u200c\u0634\u0648\u062f.\r\n\r\n\u0645\u062c\u0648\u0632\r\n\u0627\u06cc\u0646 \u067e\u0631\u0648\u0698\u0647 \u062a\u062d\u062a \u0645\u062c\u0648\u0632 MIT \u0645\u0646\u062a\u0634\u0631 \u0634\u062f\u0647 \u0627\u0633\u062a. \u0628\u0631\u0627\u06cc \u0627\u0637\u0644\u0627\u0639\u0627\u062a \u0628\u06cc\u0634\u062a\u0631 \u0641\u0627\u06cc\u0644 LICENSE \u0631\u0627 \u0645\u0634\u0627\u0647\u062f\u0647 \u06a9\u0646\u06cc\u062f.\r\n\r\n\u0628\u0631\u0627\u06cc \u0647\u0631 \u06af\u0648\u0646\u0647 \u0633\u0648\u0627\u0644 \u06cc\u0627 \u0645\u0634\u06a9\u0644\u060c \u0645\u06cc\u200c\u062a\u0648\u0627\u0646\u06cc\u062f \u0627\u0632 \u0637\u0631\u06cc\u0642 api-free.ir \u0628\u0627 \u0645\u0627 \u062f\u0631 \u062a\u0645\u0627\u0633 \u0628\u0627\u0634\u06cc\u062f.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A simple library to send emails using API from api-free.ir",
"version": "0.2",
"project_urls": {
"Homepage": "https://github.com/Mahditerorist/send_email"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "75fa9323f9b6b341a17da59662cc5585907dd64056cdf5d02b52dd05bd848188",
"md5": "21af4a4f1f1ed367b10c9f90ae814169",
"sha256": "606f442988c5006caf9ba0dfeda94674e9d9d90118f5bcd63575b31907b7b09e"
},
"downloads": -1,
"filename": "free_send-0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "21af4a4f1f1ed367b10c9f90ae814169",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 2638,
"upload_time": "2024-07-14T07:46:01",
"upload_time_iso_8601": "2024-07-14T07:46:01.887649Z",
"url": "https://files.pythonhosted.org/packages/75/fa/9323f9b6b341a17da59662cc5585907dd64056cdf5d02b52dd05bd848188/free_send-0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-14 07:46:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Mahditerorist",
"github_project": "send_email",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "free-send"
}