[bugfix] Fix Swagger spec and add test script (#2698)

* Add Swagger spec test script

* Fix Swagger spec errors not related to statuses with polls

* Add API tests that post a status with a poll

* Fix creating a status with a poll from form params

* Fix Swagger spec errors related to statuses with polls (this is the last error)

* Fix Swagger spec warnings not related to unused definitions

* Suppress a duplicate list update params definition that was somehow causing wrong param names

* Add Swagger test to CI

- updates Drone config
- vendorizes go-swagger
- fixes a file extension issue that caused the test script to generate JSON instead of YAML with the vendorized version

* Put `Sample: ` on its own line everywhere

* Remove unused id param from emojiCategoriesGet

* Add 5 more pairs of profile fields to account update API Swagger

* Remove Swagger prefix from dummy fields

It makes the generated code look weird

* Manually annotate params for statusCreate operation

* Fix all remaining Swagger spec warnings

- Change some models into operation parameters
- Ignore models that already correspond to manually documented operation parameters but can't be trivially changed (those with file fields)

* Documented that creating a status with scheduled_at isn't implemented yet

* sign drone.yml

* Fix filter API Swagger errors

* fixup! Fix filter API Swagger errors

---------

Co-authored-by: tobi <tobi.smethurst@protonmail.com>

1 files changed, 6 insertions, 6 deletions

diff --git a/internal/api/model/report.go b/internal/api/model/report.go
index b9b8c77d2..175875204 100644
--- a/internal/api/model/report.go
+++ b/internal/api/model/report.go
@@ -65,31 +65,31 @@ type Report struct {
 // swagger:parameters reportCreate
 type ReportCreateRequest struct {
 	// ID of the account to report.
-	// example: 01GPE75FXSH2EGFBF85NXPH3KP
+	// Sample: 01GPE75FXSH2EGFBF85NXPH3KP
 	// in: formData
 	// required: true
 	AccountID string `form:"account_id" json:"account_id" xml:"account_id"`
 	// IDs of statuses to attach to the report to provide additional context.
-	// example: ["01GPE76N4SBVRZ8K24TW51ZZQ4","01GPE76WN9JZE62EPT3Q9FRRD4"]
+	// Sample: ["01GPE76N4SBVRZ8K24TW51ZZQ4","01GPE76WN9JZE62EPT3Q9FRRD4"]
 	// in: formData
 	StatusIDs []string `form:"status_ids[]" json:"status_ids" xml:"status_ids"`
 	// The reason for the report. Default maximum of 1000 characters.
-	// example: Anti-Blackness, transphobia.
+	// Sample: Anti-Blackness, transphobia.
 	// in: formData
 	Comment string `form:"comment" json:"comment" xml:"comment"`
 	// If the account is remote, should the report be forwarded to the remote admin?
-	// example: true
+	// Sample: true
 	// default: false
 	// in: formData
 	Forward bool `form:"forward" json:"forward" xml:"forward"`
 	// Specify if the report is due to spam, violation of enumerated instance rules, or some other reason.
 	// Currently only 'other' is supported.
-	// example: other
+	// Sample: other
 	// default: other
 	// in: formData
 	Category string `form:"category" json:"category" xml:"category"`
 	// IDs of rules on this instance which have been broken according to the reporter.
-	// example: ["01GPBN5YDY6JKBWE44H7YQBDCQ","01GPBN65PDWSBPWVDD0SQCFFY3"]
+	// Sample: ["01GPBN5YDY6JKBWE44H7YQBDCQ","01GPBN65PDWSBPWVDD0SQCFFY3"]
 	// in: formData
 	RuleIDs []string `form:"rule_ids[]" json:"rule_ids" xml:"rule_ids"`
 }