时间:2021-05-22
最近在写测试平台,需要实现一个节点服务器的api,正好在用django,准备使用djangorestframework插件实现。
需求
实现一个接口,在调用时,通过传递的参数,直接运行对应项目的自动化测试
环境
Python3.6 ,PyCharm,W7
项目结构
功能实现
流程
我们要做的就是实现以上流程
安装
pip install djangorestframework pip install markdown pip install django-filter # Filtering support配置
INSTALLED_APPS = ( ... 'rest_framework',)编写代码(本次代码不涉及数据库操作,只简单的写一个api)
①:打开AutoApi/Api/views.py 编写如下代码
from django.http import JsonResponse, HttpResponseNotAllowed, HttpResponsefrom django.views.decorators.csrf import csrf_exemptfrom rest_framework.parsers import JSONParserfrom rest_framework import status@csrf_exemptdef run_job(request): # 判断请求头是否为json if request.content_type != 'application/json': # 如果不是的话,返回405 return HttpResponse('only support json data', status=status.HTTP_415_UNSUPPORTED_MEDIA_TYPE) # 判断是否为post 请求 if request.method == 'POST': try: # 解析请求的json格式入参 data = JSONParser().parse(request) except Exception as why: print(why.args) else: content = {'msg': 'SUCCESS'} print(data) # 返回自定义请求内容content,200状态码 return JsonResponse(data=content, status=status.HTTP_200_OK) # 如果不是post 请求返回不支持的请求方法 return HttpResponseNotAllowed(permitted_methods=['POST'])②:打开AutoApi/Api/urls.py 编写如下代码
from django.conf.urls import urlfrom Api import viewsurlpatterns = [ url(r'^runJob/$',views.run_job),]③:打开AutoApi/AutoApi/urls.py 修改如下代码
ALLOWED_HOSTS = '*' # 修改为* 代码允许任意hostfrom django.conf.urls import url,includeurlpatterns = [ url(r'^admin/', admin.site.urls), url(r'^',include('Api.urls')),# 新增]④:启动服务
python manage.py runserver 0.0.0.0:8080⑤:我们请求试试看
以上就是简单的实现一个api ,其实开发说的接口就这么简单,没有那么神秘!
接下来把post 的数据env ,project,cases 解析出来传给对应的自动化测试入口函数,就可以实现通过接口请求,启动自动化测试的目的。
后续
实现接口调用自动化测试项目
实现异步接口
实现定时任务
这篇Django 自动生成api接口文档教程就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持。
声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。
介绍我们在实际的开发工作中需要将django框架与swagger进行集成,用于生成API文档。网上也有一些关于django集成swagger的例子,但由于每个项
参考链接:狂神的Swagger笔记号称世界上最流行的API框架RestfulApi文档在线自动生成器=>API文档与API定义同步更新直接运行,在线测试API支
apiDoc的安装npminstallapidoc-g点击官方文档生成api的终端命令:apidoc-i代码所在路径-o生成文件的路径接口文档的编写文件的简介p
前言本篇文章主要介绍的是SpringBoot整合Swagger(API文档生成框架)和SpringBoot整合Actuator(项目监控)使用教程。Spring
前后端分离的项目,接口文档的存在十分重要。与手动编写接口文档不同,swagger是一个自动生成接口文档的工具,在需求不断变更的环境下,手动编写文档的效率实在