Mock测试【免费下载链接】motoA library that allows you to easily mock out tests based on AWS infrastructure.项目地址https://gitcode.com/gh_mirrors/mo/moto点击查看免费下载Moto 是一个让你在测试中轻松模拟mockAWS 服务行为的 Python 库。本指南基于仓库根目录的 README.md 展开完整继承其中安装方式 mock_aws装饰器快速上手的核心脉络并结合setup.cfg、moto/core下的源码与docs/docs中的官方文档深入讲解安装依赖、三种激活 mock 的方式、pytest/unittest 集成、请求拦截原理、凭据安全注意事项以及服务覆盖范围的查询方法。读完本文你能够把依赖 S3、EC2 等 AWS 服务的业务代码放入可离线运行的单元测试中并理解 Moto 底层的拦截与状态管理机制。一、Moto 是什么Moto 的定位在 README.md 中被一句话概括Moto is a library that allows your tests to easily mock out AWS Services.也就是说当你的代码通过boto3访问 S3、EC2、SQS 等 AWS 服务时Moto 会拦截这些 HTTP 请求用内存中维护的虚拟 AWS 账户状态来应答使测试无需真实 AWS 凭据和网络即可运行。项目元数据见 setup.cfg包名为motoApache-2.0 协议python_requires 3.10即当前版本支持 Python 3.10 至 3.14见 setup.cfg 中的classifiers。当前开发版本号可在 moto/init.py 中确认__version__ 5.2.4.devmoto/__init__.py只导出了一个公共入口from moto.core.decorator import mock_aws as mock_aws这意味着在 Moto 5.x 中所有服务的 mock 统一通过mock_aws一个入口激活而不是旧版本中按服务拆分的mock_s3、mock_ec2等独立装饰器。二、安装README 给出的标准安装命令是按需选择要 mock 的服务用 pip extras 语法$ pip install moto[ec2,s3,all]这里的[ec2,s3,all]表示安装 Moto 本体以及这些服务所需的额外依赖。为什么不同服务要装不同依赖查看 setup.cfg 的[options.extras_require]可以看到每个服务对应一组依赖声明例如awslambda docker3.0.0—— 完整模拟 Lambda 需要 Docker 环境apigateway PyYAML, joserfc, openapi-spec-validator—— API Gateway 需要解析 OpenAPI 规范appsync graphql-core—— AppSync 需要 GraphQL 解析器。Moto 的核心运行依赖声明在install_requires中boto31.9.201、botocore排除 1.35.45/1.35.46 两个版本、cryptography、requests、xmltodict、werkzeug、responses。其中responses库是 HTTP 拦截的关键组件后文工作原理部分会展开。如果不想关心依赖数量或者需要 mock 大量服务可以直接安装all附加项它聚合了几乎所有服务所需依赖含docker、PyYAML、cfn-lint、py-partiql-parser等。此外还有两个运行形态相关的 extrasmoto[server]在all依赖之外额外安装flask与flask-cors用于独立服务模式stand-alone servermoto[proxy]用于代理模式proxy mode。从源码安装的方式对应docs/docs/getting_started.rst$ git clone git://github.com/getmoto/moto.git $ cd moto $ pip install .[all]三、快速上手用 mock_aws 装饰器测试 S3 代码README In a nutshell 一节给出的最小示例是理解 Moto 用法的核心。假设被测代码是import boto3 class MyModel: def __init__(self, name, value): self.name name self.value value def save(self): s3 boto3.client(s3, region_nameus-east-1) s3.put_object(Bucketmybucket, Keyself.name, Bodyself.value)save()会把对象写入 S3。若不用 mock每次测试都要真实访问 AWS。用 Moto 后测试可以写成import boto3 from moto import mock_aws from mymodule import MyModel mock_aws def test_my_model_save(): conn boto3.resource(s3, region_nameus-east-1) # We need to create the bucket since this is all in Motos virtual AWS account conn.create_bucket(Bucketmybucket) model_instance MyModel(steve, is awesome) model_instance.save() body conn.Object(mybucket, steve).get()[Body].read().decode(utf-8) assert body is awesome注意两个关键点装饰器内的所有 S3 调用自动被 mock。Moto 会跟踪 bucket 与 key 的状态——create_bucket创建后put_object写入、get读取都能拿到一致的数据必须先创建 bucket。因为整个操作发生在 Moto 的虚拟 AWS 账户里桶不会凭空存在。mock_aws的实现入口在 moto/core/decorator.pydef mock_aws( func: Callable[P, T] | None None, config: DefaultConfig | None None ) - MockAWS | Callable[P, T]: clss ( ServerModeMockAWS if settings.TEST_SERVER_MODE else (ProxyModeMockAWS if settings.is_test_proxy_mode() else MockAWS) ) if func is not None: return clss().__call__(funcfunc) else: return clss(config)可以推断当作为装饰器使用时传入函数它等价于先构造一个 mock 实例再__call__不带参数直接mock_aws()调用时返回的实例本身支持with语法。类名MockAWS的选择依赖TEST_SERVER_MODE/TEST_PROXY_MODE环境变量——这两个开关主要服务于 Moto 自身测试矩阵普通业务代码默认走MockAWS的装饰器模式。四、三种激活 mock 的方式README 展示了装饰器用法完整的 docs/docs/getting_started.rst 则给出了三种等价方式装饰器、上下文管理器、手动 start/stop。三者底层都调用 moto/core/models.py 中MockAWS类的同一套机制。4.1 上下文管理器def test_my_model_save(): with mock_aws(): conn boto3.resource(s3, region_nameus-east-1) conn.create_bucket(Bucketmybucket) model_instance MyModel(steve, is awesome) model_instance.save() body conn.Object(mybucket, steve).get()[Body].read().decode(utf-8) assert body is awesomewith语句块内的一切 AWS 调用被 mock离开块后自动恢复。4.2 手动 start / stopdef test_my_model_save(): mock mock_aws() mock.start() conn boto3.resource(s3, region_nameus-east-1) conn.create_bucket(Bucketmybucket) model_instance MyModel(steve, is awesome) model_instance.save() body conn.Object(mybucket, steve).get()[Body].read().decode(utf-8) assert body is awesome mock.stop()对应MockAWS类实现了AbstractContextManager__enter__/__exit__直接转调start()/stop()见 moto/core/models.py 第 72-77 行因此上下文管理器只是start/stop的语法糖。4.3 unittest 集成如果测试框架是unittest需要在setUp/tearDown中显式启停 mockimport unittest from moto import mock_aws import boto3 def func_to_test(bucket_name, key, content): s3 boto3.resource(s3) object s3.Object(bucket_name, key) object.put(Bodycontent) class MyTest(unittest.TestCase): bucket_name test-bucket def setUp(self): self.mock_aws mock_aws() self.mock_aws.start() s3 boto3.resource(s3) bucket s3.Bucket(self.bucket_name) bucket.create() def tearDown(self): self.mock_aws.stop() def test(self): content babc key /path/to/obj func_to_test(self.bucket_name, key, content) s3 boto3.resource(s3) object s3.Object(self.bucket_name, key) actual object.get()[Body].read() self.assertEqual(actual, content)4.4 类级装饰器mock_aws也可以直接装饰整个测试类。从源码看MockAWS.__call__中inspect.isclass(func)分支会走_decorate_class装饰器会遍历类的方法为setUp与每个test_*方法分别注入 mock 的启停逻辑。关键行为状态不会跨测试方法共享——每个测试方法开始前状态自动重置mock_aws class TestMockClassLevel(unittest.TestCase): def setUp(self): s3 boto3.client(s3, region_nameus-east-1) s3.create_bucket(Bucketmybucket) def test_creating_a_bucket(self): # mybucketsetUp 中创建在本测试中可访问 s3 boto3.client(s3, region_nameus-east-1) s3.create_bucket(Bucketbucket_inside) def test_accessing_a_bucket(self): # 本方法开始前状态已重置mybucket 由 setUp 重新创建 # 但上一个测试中创建的 bucket_inside 已不存在 pass这种每个方法自动 reset的语义也解释了为什么MockAWS.start(self, reset: bool True)默认参数是resetTrue而stop(self, remove_data: bool True)默认清除数据——mock 结束后所有虚拟 AWS 资源被销毁。五、pytest 集成fixture 模式对于 pytest 用户官方文档推荐使用 fixture 统一管理假凭据 mock 上下文。这是一个可以直接复制的模式pytest.fixture(scopefunction) def aws_credentials(): Mocked AWS Credentials for moto. os.environ[AWS_ACCESS_KEY_ID] testing os.environ[AWS_SECRET_ACCESS_KEY] testing os.environ[AWS_SECURITY_TOKEN] testing os.environ[AWS_SESSION_TOKEN] testing os.environ[AWS_DEFAULT_REGION] us-east-1 pytest.fixture(scopefunction) def s3(aws_credentials): Return a mocked S3 client with mock_aws(): yield boto3.client(s3, region_nameus-east-1) pytest.fixture(scopefunction) def mocked_aws(aws_credentials): Mock all AWS interactions. Requires you to create your own boto3 clients. with mock_aws(): yield def test_s3_bucket_creation(s3): s3.create_bucket(Bucketsomebucket) result s3.list_buckets() assert len(result[Buckets]) 1 def test_generic_aws_fixture(mocked_aws): s3_client boto3.client(s3) s3_client.create_bucket(Bucketsomebucket)这个模式有三个设计要点均可从 docs/docs/getting_started.rst 中确认aws_credentialsfixture 设置一组假环境变量确保 botocore 不会去读取任何真实凭据——所有 mock 相关 fixture 都应依赖它s3fixture 在mock_aws()上下文内 yield 客户端保证客户端创建发生在 mock 激活之后mock 结束时数据自动销毁状态不跨测试方法共享因此 fixture 可以组合使用而不互相污染。六、独立服务器模式与多语言支持README 与官方文档都提到Moto 附带一个独立服务器可以 mock 掉 AWS 的 HTTP 端点$ moto_server -p3000 * Running on http://127.0.0.1:3000/启动moto_server后把测试程序的 AWS endpoint 指向http://127.0.0.1:3000即可。其价值在于不依赖 Python任何语言Go、Java、Ruby、.NET、Terraform、CDK 等的 SDK 只要把 endpoint 指过来就能对虚拟 AWS 做集成测试。仓库中 other_langs/ 目录提供了各语言的测试示例包括 other_langs/tests_go/、other_langs/tests_java/、other_langs/tests_ruby/、other_langs/tests_cli/、other_langs/terraform/ 与 other_langs/tests_cdk/。服务器实现位于 moto/moto_server/默认端口可在 moto/settings.py 中确认moto_server_port()读取环境变量MOTO_PORT缺省为5000命令行-p3000可覆盖。七、工作原理请求如何被拦截从 moto/core/models.py 的MockAWS类可以梳理出 mock 激活时的核心动作注入假凭据__init__中构造了_fake_credsAWS_ACCESS_KEY_IDFOOBARKEY、AWS_SECRET_ACCESS_KEYFOOBARSECRETstart()时通过_mock_env_variables()覆盖进程环境变量避免 botocore 使用真实凭据stop()时还原重置默认会话start()会 patchboto3.DEFAULT_SESSION为None默认reset_boto3_sessionTrue时防止复用 mock 前创建的会话嵌套计数类变量_nested_count与_mocks_active保证嵌套with mock_aws():场景下patch 只在最外层启停一次最内层退出时才真正释放状态重置stop()调用_disable_patching(remove_data)清除后端状态因此每个测试方法开始时状态是干净的这一行为是框架级保证而非约定。至于 HTTP 层面的拦截机制docs/docs/getting_started.rst 给出了权威解释Moto 通过一个自定义事件处理器挂到 botocore 的事件系统上boto3在创建 client/resource 时会收集当时已注册的全部事件处理器并注入该 client之后注册的处理器对已创建的 client 无效。由此引出两条重要规则mock 必须先于 boto3 client 创建而生效见下文避坑若无法调整导入顺序可用moto.core提供的patch_client/patch_resource对已存在的 client/resource 手动补挂# The client can come from an import, an __init__-file, wherever.. outside_client boto3.client(s3) s3 boto3.resource(s3) mock_aws def test_mock_works_with_client_or_resource_created_outside(): from moto.core import patch_client, patch_resource patch_client(outside_client) patch_resource(s3) assert outside_client.list_buckets()[Buckets] [] assert list(s3.buckets.all()) []另一个常用技巧是把在模块顶层创建 client的模块延迟到测试函数内部再导入从而保证 mock 已先于 client 初始化def test_something(aws): from some.package.that.does.something.with.s3 import some_func # 局部导入 some_func() # 包级 S3 client 将走 mock不会真正访问 AWS后端数据则按服务、按区域组织在moto/下各服务包中如 moto/s3/、moto/ec2/统一注册表见 moto/backend_index.py。默认模拟账户 ID 在 moto/core/models.py 中定义为DEFAULT_ACCOUNT_ID 123456789012。八、推荐用法与避坑官方文档Recommended Usage一节列出了保护真实基础设施不被测试误伤的关键措施建议逐条落实确保 mock 真的生效前先设置假凭据环境变量export AWS_ACCESS_KEY_IDtesting export AWS_SECRET_ACCESS_KEYtesting export AWS_SECURITY_TOKENtesting export AWS_SESSION_TOKENtesting export AWS_DEFAULT_REGIONus-east-1不要在代码里硬编码凭据。这本身是坏实践且会让测试用假凭据无法配置非常重要确保 mock 在 boto3 client 建立之前生效。典型事故场景是 import 了某个在模块顶层实例化 boto3 client 的模块——该 client 不会携带 Moto 的事件处理器。解法见第六节的局部导入或patch_client。另外注意默认情况下 region 必须是 AWS 支持的区域MOTO_ALLOW_NONEXISTENT_REGIONtrue可放宽该限制见 moto/settings.py 中allow_unknown_region()。对于 CITox、GitHub Actions 等环境若 botocore 仍尝试读取凭据文件可以生成一个包含无效凭据的配置文件mkdir ~/.aws touch ~/.aws/credentials echo -e [default]\naws_access_key_id test\naws_secret_access_key test ~/.aws/credentials九、服务覆盖范围与配置项README 指出具体哪些服务和 API 已被 mock请查看 implementation coverage。仓库内对应文件为 IMPLEMENTATION_COVERAGE.md按服务、按 API 列出支持状态另有 CLOUDFORMATION_COVERAGE.md 单独统计 CloudFormation 资源类型的覆盖情况。在线文档站点与源码同步仓库 docs/docs/ 目录包含按服务拆分的 167 篇 rst 文档S3、EC2、IAM 等各有专页以及 docs/docs/server_mode.rst、docs/docs/proxy_mode.rst 等专题。Moto 还支持通过环境变量与配置字典精细控制行为。moto/settings.py 暴露了大量开关常见的包括环境变量默认值作用MOTO_PORT5000moto_server监听端口MOTO_ALLOW_NONEXISTENT_REGIONfalse允许使用 AWS 不存在的区域名MOTO_EC2_LOAD_DEFAULT_AMIStrue是否加载内置的默认 AMI 数据集MOTO_IAM_LOAD_MANAGED_POLICIES未设置加载 AWS 托管策略数据MOTO_ACM_VALIDATION_WAIT60ACM 证书验证通过的等待秒数MOTO_PRETTIFY_RESPONSESfalse响应是否格式化输出S3_UPLOAD_PART_MIN_SIZE5242880S3 分片上传最小分片大小MOTO_ENABLE_ISO_REGIONSfalse启用 ISO政府云等区域除环境变量外mock_aws(config...)还支持传入配置字典moto/core/config.py中的DefaultConfig按服务名分层覆盖例如{iam: {load_aws_managed_policies: True}}MockAWS.__init__会把它合并进default_user_config的 patch 中生效。十、小结从 README 到仓库的完整脉络回到 README.md 的主线一条pip install moto[ec2,s3,all]命令完成安装一个mock_aws装饰器让测试代码零改动地跑在内存里的虚拟 AWS 账户上mock 自动跟踪 bucket/key 等状态IMPLEMENTATION_COVERAGE.md回答哪些 API 被支持docs 站点源码即 docs/docs/提供更完整的按服务文档。仓库中 tests/ 目录按服务组织了两千余个测试文件如 tests/test_s3/、tests/test_ec2/既验证上述行为也示范了 fixture 与类级装饰器的真实用法可作为参考实现。关于安全漏洞上报README 说明应通过 Tidelift 安全联系渠道提交由其协调修复与披露项目财务由 OpenCollective 管理贡献者可通过仓库页的 Sponsor 入口赞助。适用前提与限制Moto mock 的是 API 层行为不执行真实 Lambda 代码路径、不运行真实 K8s/Docker 集群负载Lambda/Batch 的完整模拟依赖本地 Docker它保证的是API 请求-应答语义与内存状态一致性而非与真实 AWS 100% 逐位一致。版本 5.x 已统一为mock_aws单一入口旧版按服务拆分的装饰器mock_s3等应逐步迁移。赞分享Mock测试【免费下载链接】motoA library that allows you to easily mock out tests based on AWS infrastructure.项目地址https://gitcode.com/gh_mirrors/mo/moto点击查看免费下载相关推荐moto 中 connectcampaigns 服务的实现用 mock_aws 模拟 AWS Connect Contact Lens Campaign 的测试实践moto 中 connectcampaigns 服务的实现用 mock_aws 模拟 AWS Connect Contact Lens Campaign 的测Mock测试Moto IVS 服务模拟指南用 mock_aws 测试 Amazon Interactive Video Service 通道管理代码Moto IVS 服务模拟指南用 mock_aws 测试 Amazon Interactive Video Service 通道管理代码 本篇指南基于 motMock测试CANN/ge获取输入维度范围aclmdlGetInputDimsRangea nameZH CN_TOPIC_0000001992610306 /a 产品支持情况a name人工智能深度学习模型编译模型优化编译器Ascend上一篇Simple-Salesforce 高级功能详解登录助手与网络配置下一篇komorebi 浮动窗口管理toggle-float 与 toggle-float-override 命令深度解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考