A plugin-based server for running fake HTTP services (especially SOA service) .
_ (`-. _ .-') .-. .-')
( (OO ) ( \( -O ) \ ( OO )
_.` \ ,------.,------. .-'),-----. .-----. ,--. ,--.
(__...--''('-| _.---'| /`. '( OO' .-. ' ' .--./ | .' /
| / | |(OO|(_\ | / | |/ | | | | | |('-. | /,
| |_.' |/ | '--. | |_.' |\_) | |\| | /_) |OO )| ' _)
| .___.'\_)| .--' | . '.' \ | | | | || |`-'| | . \
| | \| |_) | |\ \ `' '-' '(_' '--'\ | |\ \
`--' `--' `--' '--' `-----' `-----' `--' '--'
python >=2.7
https://github.com/urbanairship/frock
- dev(develop branch): 0.2.7
- master(stable branch):0.2.7
https://github.com/knightliao/pfrock/blob/master/README-en.md
- 为微服务架构(SOA)而生。
- 可以mock微服务架构(SOA)中各式各样的服务接口请求
- 统一的代理服务入口。通过提供统一的router入口, 用户不必一个一个接口的去对接mock. 统一接入代理服务即可.
- 强大的功能
- 配置文件式设计,零开发成本
- 更改配置文件,无须重启,自动生效
- 集成静态参数规则计算引擎,通过参数规则配置,可以根据参数的不同将请求定位到不同的静态配置。
- 输入自定义匹配 url, method(GET/POST/PUT/DELETE/HEAD); 输出可为自定义 静态文件/静态目录/动态handler/header
- 开放式设计
- 插件式开发,即插即用, 为可扩展性提供良好支持。目前系统核心已经支持 静态/动态/自定义 的Mock服务能力
- 开放性,利用python动态能力,可以与各种中间件交互,登录redis/Q/db/hadoop
也就是说,
- 我们可以随心所欲的对任何URL, 任何method进行mock.
- 并且可以对不想mock的URL, 还是让他请求原来要请求的服务.
通过此种方式, 我们可以以最低的侵入性, 实现为系统的部分或者全部接口进行mock.
- pfrock-static-plugin :提供文件式或目录结构的静态数据mock服务插件,具有参数规则计算引擎功能
- pfrock-http-plugin : 提供动态http服务请求的mock服务插件
- pfrock-proxy-plugin: 提供远程服务的代理服务插件
pip install pfrock
(pypi: https://pypi.python.org/pypi/pfrock)
- demo
- mocks
- handler
- hello_world.py
- __init__.py
- static
- a.json
- b.json
- __init__.py
- __init__.py
- pfrockfile.json
{
"servers": [
{
"port": 8888,
"routes": [
{
"path": "/api1/(.*)",
"handler": "pfrock_static_plugin",
"options": {
"routes": [
{
"path": "json",
"file": "mocks/static/a.json"
},
{
"dir": "mocks/static"
}
]
}
},
{
"path": "/api",
"methods": [
"GET"
],
"handler": "pfrock_http_plugin",
"options": {
"handler": "mocks.handler.hello_world.HelloWorldHandler",
"query": "1!",
"pageno": 1
}
},
{
"path": ".*",
"methods": "any",
"handler": "pfrock_proxy_plugin",
"options": {
"url": "http://www.sov5.com"
}
}
]
}
]
}
➜ pfrock git:(master) ✗
➜ pfrock git:(master) ✗ cd demo
➜ demo git:(master) ✗ pfrockpy
_ (`-. _ .-') .-. .-')
( (OO ) ( \( -O ) \ ( OO )
_.` \ ,------.,------. .-'),-----. .-----. ,--. ,--.
(__...--''('-| _.---'| /`. '( OO' .-. ' ' .--./ | .' /
| / | |(OO|(_\ | / | |/ | | | | | |('-. | /,
| |_.' |/ | '--. | |_.' |\_) | |\| | /_) |OO )| ' _)
| .___.'\_)| .--' | . '.' \ | | | | || |`-'| | . \
| | \| |_) | |\ \ `' '-' '(_' '--'\ | |\ \
`--' `--' `--' '--' `-----' `-----' `--' '--'
pfrock version 0.2.2
[I 2016-03-04 14:07:05,231 pfrock.core MainThread __init__:19] started server 8888 with autoreload mod
➜ ~ curl http://localhost:8888/api1/json
{
"a": "bddd33e34"
}%
➜ ~ curl -X POST -d {} http://localhost:8888/api1/json
{
"a": "bddd33e34"
}%
➜ ~ curl http://localhost:8888/api1/b.json
{
"b": "bbb"
}%
➜ ~ curl 'http://localhost:8888/api'
Hello, world 1! 1% ➜ ~
那么, 除了上面这些URL之外, 没有被匹配的URL怎么办? 就用代理到默认的服务器上吧! 这在项目中经常会被用到.
➜ ~ curl 'http://localhost:8888/'
没有匹配到的URL 自动被 路由到 设定的 域名和端口上.
这里是被路由到 http://www.sov5.com
- Tutorial-0: 目录结构推荐
- Tutorial-1: 静态配置服务能力
- Tutorial-5: 具有参数规则引擎计算服务能力
- Tutorial-2: 动态mock服务能力
- Tutorial-3: 代理服务能力
- Tutorial-4: 统一的pfrock服务
- pfrock命令介绍
https://github.com/knightliao/pfrock-demos
建议按以下方式进行敏捷开发
- 服务间定好接口
- 使用pfrock来提供统一mock服务
- 通过mock接口,修改配置文件,无须重启pfrock,快速进行接口式开发
- 联调过程和测试过程,亦可通过pfrock来进行部分接口mock, 避免部分服务不稳定影响整体服务能力
- pfrock技术QQ群: 545511264
- 有态度无广告的搜索引擎: https://www.sov5.com
- 微读 - 高品质阅读: http://www.100weidu.com
- Python**社区: http://www.python88.com
- Disconf - 分布式配置管理平台: http://github.com/knightliao/disconf
- CanalX - 基于
Canal
的数据感知服务框架: http://github.com/knightliao/canalX - jutf - Java Unit Test Framework: https://github.com/knightliao/jutf
- pfrock - A plugin-based server for running fake HTTP services (especially SOA service): https://github.com/knightliao/pfrock
- pdbsync - configurable db sync tool using python: https://github.com/knightliao/pdbsync