| Name | msgraph-core JSON |
| Version |
1.3.8
JSON |
| download |
| home_page | None |
| Summary | Core component of the Microsoft Graph Python SDK |
| upload_time | 2025-09-11 22:46:57 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
msgraph
openapi
microsoft
graph
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
[](https://badge.fury.io/py/msgraph-core)
[](https://github.com/microsoftgraph/msgraph-sdk-python-core/actions/workflows/build.yml)
[](https://pepy.tech/project/msgraph-core)
## Microsoft Graph Core Python Client Library
The Microsoft Graph Core Python Client Library contains core classes used by [Microsoft Graph Python Client Library](https://github.com/microsoftgraph/msgraph-sdk-python) to send native HTTP requests to [Microsoft Graph API](https://graph.microsoft.com).
> NOTE:
> This is a new major version of the Python Core library for Microsoft Graph based on the [Kiota](https://microsoft.github.io/kiota/) project. We recommend to use this library with the [full Python SDK](https://github.com/microsoftgraph/msgraph-sdk-python).
> Upgrading to this version from the [previous version of the Python Core library](https://pypi.org/project/msgraph-core/0.2.2/) will introduce breaking changes into your application.
## Prerequisites
Python 3.9+
This library doesn't support [older](https://devguide.python.org/versions/) versions of Python.
## Getting started
### 1. Register your application
To call Microsoft Graph, your app must acquire an access token from the Microsoft identity platform. Learn more about this -
- [Authentication and authorization basics for Microsoft Graph](https://docs.microsoft.com/en-us/graph/auth/auth-concepts)
- [Register your app with the Microsoft identity platform](https://docs.microsoft.com/en-us/graph/auth-register-app-v2)
### 2. Install the required packages
msgraph-core is available on PyPI.
```cmd
pip3 install msgraph-core
pip3 install azure-identity
```
### 3. Configure an Authentication Provider Object
An instance of the `BaseGraphRequestAdapter` class handles building client. To create a new instance of this class, you need to provide an instance of `AuthenticationProvider`, which can authenticate requests to Microsoft Graph.
> **Note**: This client library offers an asynchronous API by default. Async is a concurrency model that is far more efficient than multi-threading, and can provide significant performance benefits and enable the use of long-lived network connections such as WebSockets. We support popular python async environments such as `asyncio`, `anyio` or `trio`. For authentication you need to use one of the async credential classes from `azure.identity`.
```py
# Using EnvironmentCredential for demonstration purposes.
# There are many other options for getting an access token. See the following for more information.
# https://pypi.org/project/azure-identity/#async-credentials
from azure.identity.aio import EnvironmentCredential
from msgraph_core.authentication import AzureIdentityAuthenticationProvider
credential=EnvironmentCredential()
auth_provider = AzureIdentityAuthenticationProvider(credential)
```
> **Note**: `AzureIdentityAuthenticationProvider` sets the default scopes and allowed hosts.
### 5. Pass the authentication provider object to the BaseGraphRequestAdapter constructor
```python
from msgraph_core import BaseGraphRequestAdapter
adapter = BaseGraphRequestAdapter(auth_provider)
```
### 6. Make a requests to the graph
After you have a `BaseGraphRequestAdapter` that is authenticated, you can begin making calls against the service.
```python
import asyncio
from kiota_abstractions.request_information import RequestInformation
request_info = RequestInformation()
request_info.url = 'https://graph.microsoft.com/v1.0/me'
# User is your own type that implements Parsable or comes from the service library
user = asyncio.run(adapter.send_async(request_info, User, {}))
print(user.display_name)
```
## Telemetry Metadata
This library captures metadata by default that provides insights into its usage and helps to improve the developer experience. This metadata includes the `SdkVersion`, `RuntimeEnvironment` and `HostOs` on which the client is running.
## Issues
View or log issues on the [Issues](https://github.com/microsoftgraph/msgraph-sdk-python-core/issues) tab in the repo.
## Contributing
Please see the [contributing guidelines](CONTRIBUTING.md).
## Copyright and license
Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT [license](LICENSE).
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
Raw data
{
"_id": null,
"home_page": null,
"name": "msgraph-core",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "msgraph, openAPI, Microsoft, Graph",
"author": null,
"author_email": "Microsoft <graphtooling+python@microsoft.com>",
"download_url": "https://files.pythonhosted.org/packages/68/4e/123f9530ec43b306c597bb830c62bedab830ffa76e0edf33ea88a26f756e/msgraph_core-1.3.8.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/py/msgraph-core)\n[](https://github.com/microsoftgraph/msgraph-sdk-python-core/actions/workflows/build.yml)\n[](https://pepy.tech/project/msgraph-core)\n\n## Microsoft Graph Core Python Client Library\n\nThe Microsoft Graph Core Python Client Library contains core classes used by [Microsoft Graph Python Client Library](https://github.com/microsoftgraph/msgraph-sdk-python) to send native HTTP requests to [Microsoft Graph API](https://graph.microsoft.com).\n\n> NOTE:\n> This is a new major version of the Python Core library for Microsoft Graph based on the [Kiota](https://microsoft.github.io/kiota/) project. We recommend to use this library with the [full Python SDK](https://github.com/microsoftgraph/msgraph-sdk-python).\n> Upgrading to this version from the [previous version of the Python Core library](https://pypi.org/project/msgraph-core/0.2.2/) will introduce breaking changes into your application.\n\n## Prerequisites\n\n Python 3.9+\n\nThis library doesn't support [older](https://devguide.python.org/versions/) versions of Python.\n\n## Getting started\n\n### 1. Register your application\n\nTo call Microsoft Graph, your app must acquire an access token from the Microsoft identity platform. Learn more about this -\n\n- [Authentication and authorization basics for Microsoft Graph](https://docs.microsoft.com/en-us/graph/auth/auth-concepts)\n- [Register your app with the Microsoft identity platform](https://docs.microsoft.com/en-us/graph/auth-register-app-v2)\n\n### 2. Install the required packages\n\nmsgraph-core is available on PyPI.\n\n```cmd\npip3 install msgraph-core\npip3 install azure-identity\n```\n\n### 3. Configure an Authentication Provider Object\n\nAn instance of the `BaseGraphRequestAdapter` class handles building client. To create a new instance of this class, you need to provide an instance of `AuthenticationProvider`, which can authenticate requests to Microsoft Graph.\n\n> **Note**: This client library offers an asynchronous API by default. Async is a concurrency model that is far more efficient than multi-threading, and can provide significant performance benefits and enable the use of long-lived network connections such as WebSockets. We support popular python async environments such as `asyncio`, `anyio` or `trio`. For authentication you need to use one of the async credential classes from `azure.identity`.\n\n```py\n# Using EnvironmentCredential for demonstration purposes.\n# There are many other options for getting an access token. See the following for more information.\n# https://pypi.org/project/azure-identity/#async-credentials\nfrom azure.identity.aio import EnvironmentCredential\nfrom msgraph_core.authentication import AzureIdentityAuthenticationProvider\n\ncredential=EnvironmentCredential()\nauth_provider = AzureIdentityAuthenticationProvider(credential)\n```\n\n> **Note**: `AzureIdentityAuthenticationProvider` sets the default scopes and allowed hosts.\n\n### 5. Pass the authentication provider object to the BaseGraphRequestAdapter constructor\n\n```python\nfrom msgraph_core import BaseGraphRequestAdapter\nadapter = BaseGraphRequestAdapter(auth_provider)\n```\n\n### 6. Make a requests to the graph\n\nAfter you have a `BaseGraphRequestAdapter` that is authenticated, you can begin making calls against the service.\n\n```python\nimport asyncio\nfrom kiota_abstractions.request_information import RequestInformation\n\nrequest_info = RequestInformation()\nrequest_info.url = 'https://graph.microsoft.com/v1.0/me'\n\n# User is your own type that implements Parsable or comes from the service library\nuser = asyncio.run(adapter.send_async(request_info, User, {}))\nprint(user.display_name)\n```\n\n## Telemetry Metadata\n\nThis library captures metadata by default that provides insights into its usage and helps to improve the developer experience. This metadata includes the `SdkVersion`, `RuntimeEnvironment` and `HostOs` on which the client is running.\n\n## Issues\n\nView or log issues on the [Issues](https://github.com/microsoftgraph/msgraph-sdk-python-core/issues) tab in the repo.\n\n## Contributing\n\nPlease see the [contributing guidelines](CONTRIBUTING.md).\n\n## Copyright and license\n\nCopyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT [license](LICENSE).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n",
"bugtrack_url": null,
"license": null,
"summary": "Core component of the Microsoft Graph Python SDK",
"version": "1.3.8",
"project_urls": {
"documentation": "https://github.com/microsoftgraph/msgraph-sdk-python-core/docs",
"homepage": "https://github.com/microsoftgraph/msgraph-sdk-python-core#readme",
"repository": "https://github.com/microsoftgraph/msgraph-sdk-python-core"
},
"split_keywords": [
"msgraph",
" openapi",
" microsoft",
" graph"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cf4d01432f60727ae452787014cad0d5bc9e035c6e11a670f12c23f7fc926d90",
"md5": "8f93a4ac5a06d75833d8f87eec0a0785",
"sha256": "86d83edcf62119946f201d13b7e857c947ef67addb088883940197081de85bea"
},
"downloads": -1,
"filename": "msgraph_core-1.3.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8f93a4ac5a06d75833d8f87eec0a0785",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 34473,
"upload_time": "2025-09-11T22:46:56",
"upload_time_iso_8601": "2025-09-11T22:46:56.026810Z",
"url": "https://files.pythonhosted.org/packages/cf/4d/01432f60727ae452787014cad0d5bc9e035c6e11a670f12c23f7fc926d90/msgraph_core-1.3.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "684e123f9530ec43b306c597bb830c62bedab830ffa76e0edf33ea88a26f756e",
"md5": "befb679891e94ef0a58e4a26f43199fa",
"sha256": "6e883f9d4c4ad57501234749e07b010478c1a5f19550ef4cf005bbcac4a63ae7"
},
"downloads": -1,
"filename": "msgraph_core-1.3.8.tar.gz",
"has_sig": false,
"md5_digest": "befb679891e94ef0a58e4a26f43199fa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 25506,
"upload_time": "2025-09-11T22:46:57",
"upload_time_iso_8601": "2025-09-11T22:46:57.267264Z",
"url": "https://files.pythonhosted.org/packages/68/4e/123f9530ec43b306c597bb830c62bedab830ffa76e0edf33ea88a26f756e/msgraph_core-1.3.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-11 22:46:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoftgraph",
"github_project": "msgraph-sdk-python-core",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "msgraph-core"
}
