# Moto - Mock AWS Services
[](https://gitter.im/awsmoto/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://github.com/getmoto/moto/actions)
[](https://codecov.io/gh/getmoto/moto)
[](http://docs.getmoto.org)
[](https://pypi.org/project/moto/)
[](#)
[](https://pypistats.org/packages/moto)
[](https://github.com/psf/black)
## Install
```console
$ pip install moto-improved-cognitoidentity
```
## In a nutshell
Moto is a library that allows your tests to easily mock out AWS Services.
Imagine you have the following python code that you want to test:
```python
import boto3
class MyModel:
def __init__(self, name, value):
self.name = name
self.value = value
def save(self):
s3 = boto3.client("s3", region_name="us-east-1")
s3.put_object(Bucket="mybucket", Key=self.name, Body=self.value)
```
Take a minute to think how you would have tested that in the past.
Now see how you could test it with Moto:
```python
import boto3
from moto import mock_s3
from mymodule import MyModel
@mock_s3
def test_my_model_save():
conn = boto3.resource("s3", region_name="us-east-1")
# We need to create the bucket since this is all in Moto's 'virtual' AWS account
conn.create_bucket(Bucket="mybucket")
model_instance = MyModel("steve", "is awesome")
model_instance.save()
body = conn.Object("mybucket", "steve").get()["Body"].read().decode("utf-8")
assert body == "is awesome"
```
With the decorator wrapping the test, all the calls to s3 are automatically mocked out. The mock keeps the state of the buckets and keys.
For a full list of which services and features are covered, please see our [implementation coverage](https://github.com/getmoto/moto/blob/master/IMPLEMENTATION_COVERAGE.md).
### Documentation
The full documentation can be found here:
[http://docs.getmoto.org/en/latest/](http://docs.getmoto.org/en/latest/)
### Fork Feature
In the original Moto cognitoidentity's method get_id() creates new identifiers on the fly. Each time it's requested the library generates a
new one. In cases when identity_id is used to associate it with the user this behavior makes it impossible to test. This version of library generates identifiers based on user's data and provides the same value each time the user requests it.
Raw data
{
"_id": null,
"home_page": "https://github.com/emusiyenko/moto-cognitoidentity-improved",
"name": "moto-improved-cognitoidentity",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "aws ec2 s3 boto3 mock moto cognitoidentity get_id",
"author": "Steve Pulec, Eugene Musiienko",
"author_email": "spulec@gmail.com, evgeniy.musiyenko@icloud.com",
"download_url": "https://files.pythonhosted.org/packages/82/0f/0bd1640c36d53cbd0e1a62a98a946f8f98c0acc1646ed759c1b1dbdc1adc/moto-improved-cognitoidentity-1.3.tar.gz",
"platform": null,
"description": "# Moto - Mock AWS Services\n\n[](https://gitter.im/awsmoto/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n[](https://github.com/getmoto/moto/actions)\n[](https://codecov.io/gh/getmoto/moto)\n[](http://docs.getmoto.org)\n[](https://pypi.org/project/moto/)\n[](#)\n[](https://pypistats.org/packages/moto)\n[](https://github.com/psf/black)\n\n\n## Install\n\n```console\n$ pip install moto-improved-cognitoidentity\n```\n\n## In a nutshell\n\n\nMoto is a library that allows your tests to easily mock out AWS Services.\n\nImagine you have the following python code that you want to test:\n\n```python\nimport boto3\n\n\nclass MyModel:\n def __init__(self, name, value):\n self.name = name\n self.value = value\n\n def save(self):\n s3 = boto3.client(\"s3\", region_name=\"us-east-1\")\n s3.put_object(Bucket=\"mybucket\", Key=self.name, Body=self.value)\n```\n\nTake a minute to think how you would have tested that in the past.\n\nNow see how you could test it with Moto:\n\n```python\nimport boto3\nfrom moto import mock_s3\nfrom mymodule import MyModel\n\n\n@mock_s3\ndef test_my_model_save():\n conn = boto3.resource(\"s3\", region_name=\"us-east-1\")\n # We need to create the bucket since this is all in Moto's 'virtual' AWS account\n conn.create_bucket(Bucket=\"mybucket\")\n model_instance = MyModel(\"steve\", \"is awesome\")\n model_instance.save()\n body = conn.Object(\"mybucket\", \"steve\").get()[\"Body\"].read().decode(\"utf-8\")\n assert body == \"is awesome\"\n```\n\nWith the decorator wrapping the test, all the calls to s3 are automatically mocked out. The mock keeps the state of the buckets and keys.\n\nFor a full list of which services and features are covered, please see our [implementation coverage](https://github.com/getmoto/moto/blob/master/IMPLEMENTATION_COVERAGE.md).\n\n\n### Documentation\nThe full documentation can be found here:\n\n[http://docs.getmoto.org/en/latest/](http://docs.getmoto.org/en/latest/)\n\n\n### Fork Feature\nIn the original Moto cognitoidentity's method get_id() creates new identifiers on the fly. Each time it's requested the library generates a\nnew one. In cases when identity_id is used to associate it with the user this behavior makes it impossible to test. This version of library generates identifiers based on user's data and provides the same value each time the user requests it.",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "",
"version": "1.3",
"split_keywords": [
"aws",
"ec2",
"s3",
"boto3",
"mock",
"moto",
"cognitoidentity",
"get_id"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "820f0bd1640c36d53cbd0e1a62a98a946f8f98c0acc1646ed759c1b1dbdc1adc",
"md5": "1906ec3806174dae0dc5997a7a4f18ea",
"sha256": "a9d1e930623721ebc88922ab5a0a1d5dddc933d843731dfa1f127b22ea38c9e6"
},
"downloads": -1,
"filename": "moto-improved-cognitoidentity-1.3.tar.gz",
"has_sig": false,
"md5_digest": "1906ec3806174dae0dc5997a7a4f18ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 5274309,
"upload_time": "2023-03-24T11:20:54",
"upload_time_iso_8601": "2023-03-24T11:20:54.893282Z",
"url": "https://files.pythonhosted.org/packages/82/0f/0bd1640c36d53cbd0e1a62a98a946f8f98c0acc1646ed759c1b1dbdc1adc/moto-improved-cognitoidentity-1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-24 11:20:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "emusiyenko",
"github_project": "moto-cognitoidentity-improved",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "moto-improved-cognitoidentity"
}
JSON
