Interface difference test - diffy tool

One 、Diffy working principle

Testing tools | An open source Diffy Automated testing framework ： Super detailed practical tutorial explanation _ Crazy teacher vs The blog of -CSDN Blog https://blog.csdn.net/jinjiangongzuoshi/article/details/106799081/

Two 、Diffy Use

1. Clone Source ：

   git clone https://github.com/twitter/diffy.git

   

2. structure diffy-server.jar, Execute the following two commands in turn

   cd diffy
   
   ./sbt assembly

3. start-up diffy service

   1. http Interface startup diffy command

      java -jar diffy-server.jar -candidate=localhost:8080 -master.primary=localhost:8081 -master.secondary=localhost:8082 -service.protocol=http
      -serviceName=My-Service -proxy.port=:8880 -admin.port=:8881 -http.port=:8888 -rootUrl='localhost:8888'

   2. https Interface startup diffy command （ Close test available , It's been a long time ）

      java -jar diffy-server.jar -candidate=www.baidu.test -master.primary=www.baidu.com -master.secondary=www.baidu.com -service.protocol=https -serviceName=My-Service -proxy.port=:9990 -admin.port=:9991 -http.port=:8888 -rootUrl='localhost:8888' -summary.email='[email protected]' -summary.delay="5" -allowHttpSideEffects=true -excludeHttpHeadersComparison='true'

   3. Parameter description

      Parameters	explain
      -candidate=www.baidu.test	The version to be launched ip Or domain name . If Baidu test environment host by www.baidu.test
      -master.primary=www.baidu.com	Online version ip1 Or domain name 1
      -master.secondary=www.baidu.com	Online version ip2 Or domain name 2
      -service.protocol=https	http Agreement or https agreement
      -serviceName=My-Service	The service name . Write at will
      -proxy.port=:9990	The proxy port . All requests should be accessed from this port . Such as :curl localhost:9990/search/1
      -admin.port=:9991
      -http.port=:8888	diffy Report port .localhost:8888
      -rootUrl='localhost:8888'	ditto
      -summary.email='[email protected]'	Report the email address
      -summary.delay="5"
      -allowHttpSideEffects=true	diffy Considering the safety ,post、put、delete Request is ignored by default . Set to true These types of requests can still be sent normally
      -excludeHttpHeadersComparison='true'	Whether to exclude header The difference of . Generally set as true. Different services header There's a difference , Negligible

   4. Pit description ！！！

      1. responseMode=primary： Some articles write that parameters include responseMode, But the execution will report an error ：. The error message indicates that there is no such parameter , If this item is removed, no error will be reported .
      2. excludeHttpHeadersComparison=false： An error occurs when this parameter is executed ：. resolvent ： to false Put double quotes , namely excludeHttpHeadersComparison="false"

4. diffy The report

   1. localhost:8888, The browser accesses the address , You can view it diffy The report .
   2. Example report