准备做一个每周自动的巡检报告,数据来源于zabbix,通过python读取zabbix数据库获取数据并制作成excel表格, 本来打算直接邮件发送到指定邮箱,但是都被SMTP过滤掉了,试过126和QQ的,其他的不知道. 操作系统:Cenos 6.7 python版本: python3.5 以下代码是亲测并生产环境使用的: #!/usr/local/python/bin/python3.5 import pymysql import time, datetime import smtplib im…
近来前端组小盆友开发的类库越来越多,很多情况下彼此不知道写了些什么方法,为了更好的合作提高工作效率,找了个比较好的api文档生成方法.使用jsdoc-toolkit来自动生成js api文档. 一. 环境搭建 1) 首先要安装java环境,如果不太了解的参看:http://jingyan.baidu.com/article/e75aca85b29c3b142edac6a8.html 2) 安装jsdoc-toolkit 下载地址:http://code.google.com/p/jsdoc-to…
关于Swaggo 或许你使用过Swagger, 而 swaggo就是代替了你手动编写yaml的部分.只要通过一个命令就可以将注释转换成文档,这让我们可以更加专注于代码. 目前swaggo主要实现了swagger 2.0 的以下部分功能: 基本结构(Basic Structure) API 地址与基本路径(API Host and Base Path) 路径与操作 (Paths and Operations) 参数描述(Describing Parameters) 请求参数描述(Describin…
#关于Swaggo 相信很多程序猿和我一样不喜欢写API文档.写代码多舒服,写文档不仅要花费大量的时间,有时候还不能做到面面具全.但API文档是必不可少的,相信其重要性就不用我说了,一份含糊的文档甚至能让前后端人员打起来. 而今天这篇博客介绍的swaggo就是让你只需要专注于代码就可以生成完美API文档的工具.废话说的有点多,我们直接看文章. 或许你使用过Swagger, 而 swaggo就是代替了你手动编写yaml的部分.只要通过一个命令就可以将注释转换成文档,这让我们可以更加专注于代码. 目…
1.添加Swagger2依赖 在pom.xml中加入Swagger2的依赖 <!--swagger2--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.6.1</version> </dependency> <dependency>…
暂时没学会正规的转载style临时记录一下 NET中的规范标准注释(一) -- XML注释标签讲解 http://www.cnblogs.com/mq0036/p/3544264.html NET中的规范标准注释(二) -- 创建帮助文档入门篇 http://www.cnblogs.com/mq0036/p/3544268.html 简言之: 1. 设置build参数,使XML可以生成在独立于代码的xml文件中. 2. 代码开发过程中养成添加备注的好习惯.VisualStudio中方法或类前输入…
上一篇博客中,讲到了将WebApi Host到控制台和IIS,本篇总结一下如何将WebApi的Service以插件的形式进行动态部署,并设置Hoster的首页显示Api帮助文档,当然,也包括动态部署进来的插件的Api帮助. 话不多说,上酸菜,啊不, 上干货. 源码地址 建立Host 新建 Asp.Net Web Application, 解决方案名称填写WeiApiPluginDemo,项目名称填写IISHost,确定 选择 Empty, 确定 菜单中点选 Tools -> NuGet Pack…
Swagger 号称:世界最流行的API框架,官网:http://swagger.io/,Swagger 是一个规范和完整的框架,用于生成.描述.调用和可视化 RESTful 风格的 Web 服务.总体目标是使客户端和文件系统作为服务器以同样的速度来更新.文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步.Swagger 让部署管理和使用功能强大的API从未如此简单. 使用工具:eclipse,jdk7,maven,spring 使用方法: 首先你得有自己的一个能访问的ap…
今天照着孙鑫老师的VC++教程学习文件的操作,VS2010,单文档应用程序,项目文件命名为File,也就有了自动生成的CFileDoc.CFileView等类,一进去就编译运行(就是最初自动生成的项目),编译通过,可运行时直接弹出错误框,有点小懵,,,啥都没做就给我看这个: 图一   错误提示框 后来搜索一查,网上好多类似的错误以及解决方案,几乎都试了个遍,有: 方法(1)—重新生成解决方案,或者将项目文件目录下Debug文件夹删了,重新生成Release版: 方法(2)—可以先声明一个临时的C…
最近在做新项目,感觉写完一个接口 还要去再写一遍api文档 挺浪费时间的,所以借用ShowDoc的api开放功能 自动生成api文档. 首先 去 https://www.showdoc.cc/ 注册一个账户,新建一个项目, 建立新项目后,选择该项目,打开,进入项目界面 然后点击项目,下拉选择项目设置, 可以看到开放API,下面还有Api文档,数据字典文档 Windows系统安装步骤: 自动化生成API文档,首先需要下载Git ,推荐下载地址: https://npm.taobao.org/mir…