| Name | google-api-client-wrapper JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | None |
| Summary | A comprehensive Python wrapper for Google APIs, providing clean and intuitive access to Gmail, Google Drive, Google Calendar, and Google Tasks services. |
| upload_time | 2025-08-21 16:52:18 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License
Copyright (c) 2025 Dagmawi Molla
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
|
| keywords |
google-api
gmail
google-drive
google-calendar
google-tasks
api-wrapper
python-wrapper
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
google-api-python-client
google-auth-httplib2
google-auth-oauthlib
tzlocal
html2text
pydantic
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Google API Client
A comprehensive Python wrapper for Google APIs, providing clean and intuitive access to Gmail, Google Drive, Google Calendar, and Google Tasks services.
## Installiation
```bash
pip install google-api-client-wrapper
```
or install directly from the GitHub repository:
```bash
pip install git+https://github.com/dsmolla/google-api-client-wrapper.git
```
## Features
- **Gmail Service**: Send, receive, search, and manage emails
- **Google Drive Service**: Upload, download, and manage files and folders
- **Google Calendar Service**: Create, update, and manage calendar events
- **Google Tasks Service**: Manage tasks and task lists
- **OAuth2 Authentication**: Secure authentication flow
- **Query Builders**: Intuitive query building for each service
- **Multi-User Authentication**: Supports multiple users to be authenticated
- **Dataclass Models**: Uses Python dataclasses for clean, type-safe data structures (GmailMessage, EmailAddress, Task, Event, etc.)
## Installation
## Quick Start
```python
from google_client.user_client import UserClient
from datetime import datetime, timedelta
# Authenticate User
user_1 = UserClient.from_file("< user_1_token_path >", "< app_credentials_path >")
user_2, user_2_token = UserClient.from_credentials_info(
"< user_2_token_dict >": 1,
"< app_credentials_dict >": 2,
"< scopes_list >",
)
# List User 1's emails
user_1_emails = user_1.gmail.list_emails()
# Create a calendar event for User 2
user_2_event = user_2.calendar.create_event(datetime.now(), datetime.now() + timedelta(hours=1))
```
## Package Documentation
Each service has detailed documentation with examples and API reference:
- **[Gmail Service](google_client/services/gmail/README.md)** - Email management and operations
- **[Google Drive Service](google_client/services/drive/README.md)** - File and folder management
- **[Google Calendar Service](google_client/services/calendar/README.md)** - Calendar and event management
- **[Google Tasks Service](google_client/services/tasks/README.md)** - Task and task list management
## Links
- **[Google Auth & Tokens](https://developers.google.com/identity/protocols/oauth2/web-server#python)**
---
See individual package documentation for detailed usage examples and API references.
For more information look at the official Google API Documentation for each service
Raw data
{
"_id": null,
"home_page": null,
"name": "google-api-client-wrapper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "google-api, gmail, google-drive, google-calendar, google-tasks, api-wrapper, python-wrapper",
"author": null,
"author_email": "Dagmawi Molla <dagmawishewadeg@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/37/49/ea48761872155f1e31d6fd08a9092fafa9f544c3bac35014eb26e533b55a/google_api_client_wrapper-1.0.1.tar.gz",
"platform": null,
"description": "# Google API Client\r\n\r\nA comprehensive Python wrapper for Google APIs, providing clean and intuitive access to Gmail, Google Drive, Google Calendar, and Google Tasks services.\r\n\r\n## Installiation\r\n\r\n```bash\r\npip install google-api-client-wrapper\r\n```\r\n\r\nor install directly from the GitHub repository:\r\n\r\n```bash\r\npip install git+https://github.com/dsmolla/google-api-client-wrapper.git\r\n```\r\n\r\n\r\n## Features\r\n\r\n- **Gmail Service**: Send, receive, search, and manage emails\r\n- **Google Drive Service**: Upload, download, and manage files and folders\r\n- **Google Calendar Service**: Create, update, and manage calendar events\r\n- **Google Tasks Service**: Manage tasks and task lists\r\n- **OAuth2 Authentication**: Secure authentication flow\r\n- **Query Builders**: Intuitive query building for each service\r\n- **Multi-User Authentication**: Supports multiple users to be authenticated\r\n- **Dataclass Models**: Uses Python dataclasses for clean, type-safe data structures (GmailMessage, EmailAddress, Task, Event, etc.)\r\n\r\n## Installation\r\n\r\n\r\n## Quick Start\r\n\r\n```python\r\nfrom google_client.user_client import UserClient\r\nfrom datetime import datetime, timedelta\r\n\r\n# Authenticate User\r\nuser_1 = UserClient.from_file(\"< user_1_token_path >\", \"< app_credentials_path >\")\r\nuser_2, user_2_token = UserClient.from_credentials_info(\r\n \"< user_2_token_dict >\": 1,\r\n \"< app_credentials_dict >\": 2,\r\n \"< scopes_list >\",\r\n)\r\n\r\n# List User 1's emails\r\nuser_1_emails = user_1.gmail.list_emails()\r\n\r\n# Create a calendar event for User 2\r\nuser_2_event = user_2.calendar.create_event(datetime.now(), datetime.now() + timedelta(hours=1))\r\n```\r\n\r\n## Package Documentation\r\n\r\nEach service has detailed documentation with examples and API reference:\r\n\r\n- **[Gmail Service](google_client/services/gmail/README.md)** - Email management and operations\r\n- **[Google Drive Service](google_client/services/drive/README.md)** - File and folder management\r\n- **[Google Calendar Service](google_client/services/calendar/README.md)** - Calendar and event management\r\n- **[Google Tasks Service](google_client/services/tasks/README.md)** - Task and task list management\r\n\r\n## Links\r\n- **[Google Auth & Tokens](https://developers.google.com/identity/protocols/oauth2/web-server#python)**\r\n\r\n--- \r\nSee individual package documentation for detailed usage examples and API references.\r\n\r\nFor more information look at the official Google API Documentation for each service\r\n\r\n",
"bugtrack_url": null,
"license": "MIT License\r\n \r\n Copyright (c) 2025 Dagmawi Molla\r\n \r\n Permission is hereby granted, free of charge, to any person obtaining a copy\r\n of this software and associated documentation files (the \"Software\"), to deal\r\n in the Software without restriction, including without limitation the rights\r\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n copies of the Software, and to permit persons to whom the Software is\r\n furnished to do so, subject to the following conditions:\r\n \r\n The above copyright notice and this permission notice shall be included in all\r\n copies or substantial portions of the Software.\r\n \r\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n SOFTWARE.\r\n ",
"summary": "A comprehensive Python wrapper for Google APIs, providing clean and intuitive access to Gmail, Google Drive, Google Calendar, and Google Tasks services.",
"version": "1.0.1",
"project_urls": {
"Documentation": "https://github.com/dsmolla/google-api-wrapper/blob/main/README.md",
"Homepage": "https://github.com/dsmolla/google-api-client-wrapper",
"Repository": "https://github.com/dsmolla/google-api-client-wrapper"
},
"split_keywords": [
"google-api",
" gmail",
" google-drive",
" google-calendar",
" google-tasks",
" api-wrapper",
" python-wrapper"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f83edea006ab499dde20a81c442ad4d1bf596fe0373c6cae2b93404a7548a630",
"md5": "49952e17188d83866b1c104139be165d",
"sha256": "071f8c3d1bd84e9c451ca2e2a1fda881d18829b69044e2fc2e490f6f6f961e3a"
},
"downloads": -1,
"filename": "google_api_client_wrapper-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "49952e17188d83866b1c104139be165d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 64497,
"upload_time": "2025-08-21T16:52:16",
"upload_time_iso_8601": "2025-08-21T16:52:16.993222Z",
"url": "https://files.pythonhosted.org/packages/f8/3e/dea006ab499dde20a81c442ad4d1bf596fe0373c6cae2b93404a7548a630/google_api_client_wrapper-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3749ea48761872155f1e31d6fd08a9092fafa9f544c3bac35014eb26e533b55a",
"md5": "ed19bf2f8350437d9ce72ab73569531f",
"sha256": "687c6773460d9589d13ae00218cbb64cb5372811edf09260a45cc4096ee40c1b"
},
"downloads": -1,
"filename": "google_api_client_wrapper-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "ed19bf2f8350437d9ce72ab73569531f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 52118,
"upload_time": "2025-08-21T16:52:18",
"upload_time_iso_8601": "2025-08-21T16:52:18.042834Z",
"url": "https://files.pythonhosted.org/packages/37/49/ea48761872155f1e31d6fd08a9092fafa9f544c3bac35014eb26e533b55a/google_api_client_wrapper-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-21 16:52:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dsmolla",
"github_project": "google-api-wrapper",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "google-api-python-client",
"specs": [
[
"~=",
"2.163.0"
]
]
},
{
"name": "google-auth-httplib2",
"specs": []
},
{
"name": "google-auth-oauthlib",
"specs": [
[
"~=",
"1.2.1"
]
]
},
{
"name": "tzlocal",
"specs": [
[
"~=",
"5.3.1"
]
]
},
{
"name": "html2text",
"specs": [
[
"~=",
"2025.4.15"
]
]
},
{
"name": "pydantic",
"specs": [
[
"~=",
"2.11.7"
]
]
}
],
"lcname": "google-api-client-wrapper"
}
