Metadata-Version: 2.1
Name: ms-requests-session
Version: 0.0.1
Summary: Provides a requests session logged in to your Microsoft account
Home-page: https://github.com/zmarffy/ms_requests_session
License: MIT
Author: Zeke Marffy
Author-email: zmarffy@yahoo.com
Requires-Python: >=3.8.1,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: beautifulsoup4 (>=4.12.3,<5.0.0)
Requires-Dist: poetry (>=1.8.3,<2.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Project-URL: Repository, https://github.com/zmarffy/ms_requests_session
Description-Content-Type: text/markdown

# `ms-requests-session`

`ms-requests-session` is a tiny Python library that provides a way to login to your Microsoft account programatically in a `requests` `Session`. It is unknown why you would ever want to use this, but that's for you to determine. I just make the library.

## Usage

The usage is incredibly simple and straightforward. Just create a new `MSRequestsSession` object and pass it your creds and a user agent.

```python
from ms_requests_session import MSRequestsSession

session = MSRequestsSession("someone@example.com", "password", "some user agent")
```

The returned object is a subclass of `requests.Session` and has you logged in to your Microsoft account.

## Known issues

- Rarely (it seems to occur for Microsoft accounts that have not been accessed for a very long time), a required key may be missing from an API response that is required to be passed to the next. This will prevent you from logging in using `ms-requests-session`. There may be a way further traverse the chain of requests needed to login, but I have found that logging in to that account manually once seems to get it back in shape to be used with `ms-requests-session`. If you figure anything out about combatting this, feel free to submit a PR
- Accounts protected by two-factor auth are not supported, and I have no plans to do so ever

## Special thanks

A huge thank you to [@Terrance](https://github.com/Terrance) and his [SkPy](https://github.com/Terrance/SkPy) library. He and his library were able to point me in the correct direction for understanding how tricky values such as `t` work.

The Chromium Dev Tools are your best friend when it comes to reversing services. Do not sleep on them.

