[Full Changelog](go-swagger/go-swagger@v0.20.1...v0.21.0)

**Implemented enhancements:**

- Add warning messages for inconsistent parameter types and validations [\go-swagger#2069](go-swagger#2069)

**Fixed bugs:**

- JSON tags are not honored in case of allOf. [\go-swagger#2071](go-swagger#2071)

**Closed issues:**

- How to register a handler for the server? [\go-swagger#2083](go-swagger#2083)
- Flatten before serve [\go-swagger#2078](go-swagger#2078)
- Additional keys in response model [\go-swagger#2073](go-swagger#2073)
- Go v0.20.0: checksum mismatch when using GOPROXY=direct [\go-swagger#2065](go-swagger#2065)
- Code generation fails when swagger is built with go1.13 [\go-swagger#2058](go-swagger#2058)
- feature: support custom swagger type [\go-swagger#1183](go-swagger#1183)

**Merged pull requests:**

- Add OpenAPI Terraform provider to 'Who is using this project?' section [\go-swagger#2084](go-swagger#2084) ([dikhan](https://github.com/dikhan))
- Add flag to allow overwriting protected templates [\go-swagger#2082](go-swagger#2082) ([dominikznidar](https://github.com/dominikznidar))
- Feat\(serve\) : Add flatten flag to serve command [\go-swagger#2079](go-swagger#2079) ([seblegall](https://github.com/seblegall))
- added contrib to the docker image [\go-swagger#2076](go-swagger#2076) ([ronnie-stratoscale](https://github.com/ronnie-stratoscale))
- Keep spec orders for mixin command [\go-swagger#2074](go-swagger#2074) ([BupycHuk](https://github.com/BupycHuk))
- fixes undue propagation of x-go-name to tags in AllOf serializer [\go-swagger#2072](go-swagger#2072) ([fredbi](https://github.com/fredbi))
- Provide example for configure command-line flags [\go-swagger#2068](go-swagger#2068) ([antonok](https://github.com/antonok))
- Add default flag support  `import "flags"` [\go-swagger#2067](go-swagger#2067) ([hisunwei](https://github.com/hisunwei))
- Added installation instructions through docker for windows users [\go-swagger#2061](go-swagger#2061) ([EliCDavis](https://github.com/EliCDavis))
- update go-openapi libraries for go 1.13 fix [\go-swagger#2059](go-swagger#2059) ([casualjim](https://github.com/casualjim))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

release v0.20.1

release v0.20.0

Merge pull request go-swagger#1907 from e-nikolov/master

Generate properties with x-order above ones without

[Full Changelog](go-swagger/go-swagger@v0.17.2...v0.18.0)

**Implemented enhancements:**

- Client cannot unmarshal struct [\go-swagger#1729](go-swagger#1729)
- swagger generation with --with-context result in compiles error [\go-swagger#1684](go-swagger#1684)
- Can't have server code in subdirectory [\go-swagger#1624](go-swagger#1624)
- Proposal: x-omitempty for general types [\go-swagger#1623](go-swagger#1623)
- When generating validations struct pkg references needs to be preserved [\go-swagger#578](go-swagger#578)

**Fixed bugs:**

- Duplicated parentheses [\go-swagger#1839](go-swagger#1839)
- Regression with gob encoder optimization [\go-swagger#1824](go-swagger#1824)
- generated embedded\_spec.go removing refs [\go-swagger#1816](go-swagger#1816)
- Duplicated imports in configure.go [\go-swagger#1808](go-swagger#1808)
- Recursive model errors during flattening stage of generate server [\go-swagger#1796](go-swagger#1796)
- Invalid paths in go generate directive [\go-swagger#1789](go-swagger#1789)
- race in handleShutdown [\go-swagger#1781](go-swagger#1781)
- non-compiling code if an API method contains a parameter named 'result' [\go-swagger#1778](go-swagger#1778)
- Are external references supported? [\go-swagger#1774](go-swagger#1774)
- One spec in multiple files \(data types logic override\) - error of generating [\go-swagger#1767](go-swagger#1767)
- go-swagger generate server: minItems \(maxItems\) on array fails during validation.  [\go-swagger#1755](go-swagger#1755)
- Client wont compile with a route tagged "test"  [\go-swagger#1683](go-swagger#1683)
- Generate client does not handle "-" dashes in --client-package consistently [\go-swagger#1157](go-swagger#1157)

**Closed issues:**

- body parameter of type string results in code that doesn't compile [\go-swagger#1832](go-swagger#1832)
- Add an option for placing the docs/docs.go file [\go-swagger#1811](go-swagger#1811)
- Deb version 0.17.2 doesn't contain the binary on bintray [\go-swagger#1793](go-swagger#1793)
- Parameters in swagger:route produce validation warnings [\go-swagger#1785](go-swagger#1785)
- Do not escape '&' character in json response [\go-swagger#1763](go-swagger#1763)
- Deb installation is broken with the new version with the "v" prefix [\go-swagger#1760](go-swagger#1760)
- Validate returns different output in console and logs [\go-swagger#1722](go-swagger#1722)

**Merged pull requests:**

- Prepare for v0.18.0 release [\go-swagger#1843](go-swagger#1843) ([casualjim](https://github.com/casualjim))
- FAQ update [\go-swagger#1842](go-swagger#1842) ([fredbi](https://github.com/fredbi))
- Models: avoids redundant "\(\)" on .ValueExpression [\go-swagger#1840](go-swagger#1840) ([fredbi](https://github.com/fredbi))
- route: add support description response tag at path [\go-swagger#1829](go-swagger#1829) ([d7561985](https://github.com/d7561985))
- Fix \go-swagger#1824 [\go-swagger#1827](go-swagger#1827) ([fredbi](https://github.com/fredbi))
- Add HandlerAPI\(\) function to stratoscale template [\go-swagger#1821](go-swagger#1821) ([maxatome](https://github.com/maxatome))
- Remove x net context from generated code [\go-swagger#1819](go-swagger#1819) ([fredbi](https://github.com/fredbi))
- Acknowledge fix \go-swagger#1816 with go-openapi updates [\go-swagger#1818](go-swagger#1818) ([fredbi](https://github.com/fredbi))
- Fixed go generate paths in configure\_xxx.go [\go-swagger#1810](go-swagger#1810) ([fredbi](https://github.com/fredbi))
- Fixed regression on Windows introduced by \go-swagger#1804 [\go-swagger#1809](go-swagger#1809) ([fredbi](https://github.com/fredbi))
- Handle array examples; document Example usage [\go-swagger#1807](go-swagger#1807) ([leon-barrett](https://github.com/leon-barrett))
- Deprecates `--with-context` option [\go-swagger#1806](go-swagger#1806) ([fredbi](https://github.com/fredbi))
- Fixes race condition in generated server [\go-swagger#1805](go-swagger#1805) ([fredbi](https://github.com/fredbi))
- More mangling for generated package names and path [\go-swagger#1804](go-swagger#1804) ([fredbi](https://github.com/fredbi))
- Fix slice validations in body param [\go-swagger#1803](go-swagger#1803) ([fredbi](https://github.com/fredbi))
- chore: update vendor for performance [\go-swagger#1802](go-swagger#1802) ([orisano](https://github.com/orisano))
- Use JSON for examples of type object [\go-swagger#1801](go-swagger#1801) ([leon-barrett](https://github.com/leon-barrett))
- Fix go vet 11 issue with debugAsJSON func [\go-swagger#1800](go-swagger#1800) ([fredbi](https://github.com/fredbi))
- Fix flattening spec with remote circular $ref [\go-swagger#1799](go-swagger#1799) ([fredbi](https://github.com/fredbi))
- Allow '?' character in route path [\go-swagger#1792](go-swagger#1792) ([andrewmilson](https://github.com/andrewmilson))
- There is a panic when invalid schema of route/operation is used in spec generation. It should prevent it [\go-swagger#1791](go-swagger#1791) ([marsianin](https://github.com/marsianin))
- fix client cannot unmarshal struct which contains null [\go-swagger#1788](go-swagger#1788) ([AlexInGitHub](https://github.com/AlexInGitHub))
- Absorbing api names across multiple lines [\go-swagger#1783](go-swagger#1783) ([liyuankui](https://github.com/liyuankui))
- fixes \go-swagger#1778. Allow 'result' name for API parameter [\go-swagger#1780](go-swagger#1780) ([mtfelian](https://github.com/mtfelian))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

[Full Changelog](go-swagger/go-swagger@v0.17.1...v0.17.2)

**Closed issues:**

- invalid client code generated for spec [\go-swagger#1770](go-swagger#1770)

**Merged pull requests:**

- Fix a typo in tutorial [\go-swagger#1764](go-swagger#1764) ([ladrift](https://github.com/ladrift))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

[Full Changelog](go-swagger/go-swagger@v0.17.0...v0.17.1)

**Implemented enhancements:**

- un-graceful shutdown after 15 seconds on generated restapi/server.go\#handleShutdown [\go-swagger#1714](go-swagger#1714)
- Better Email Validation [\go-swagger#1519](go-swagger#1519)

**Fixed bugs:**

- skipping -A/--name option in generate server generates corrupt code [\go-swagger#1746](go-swagger#1746)

**Closed issues:**

- testing server: the required flags `--tls-certificate` and `--tls-key` were not specified [\go-swagger#1745](go-swagger#1745)
- Go-swagger vendoring problem [\go-swagger#1743](go-swagger#1743)

**Merged pull requests:**

- fix typo in docs [\go-swagger#1756](go-swagger#1756) ([jharshman](https://github.com/jharshman))
- feature: x-omitempty extension for general types [\go-swagger#1751](go-swagger#1751) ([zhuangqh](https://github.com/zhuangqh))
- verifies swagger:operation can deal with $ref [\go-swagger#1750](go-swagger#1750) ([casualjim](https://github.com/casualjim))
- Updated contributing guidelines [\go-swagger#1749](go-swagger#1749) ([fredbi](https://github.com/fredbi))
- Fix go generate command when --name is absent [\go-swagger#1748](go-swagger#1748) ([fredbi](https://github.com/fredbi))
- Handle relative path when using Go modules [\go-swagger#1744](go-swagger#1744) ([mikkeloscar](https://github.com/mikkeloscar))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

[Full Changelog](go-swagger/go-swagger@0.16.0...v0.17.0)

**Implemented enhancements:**

- Unused variable in restapi/server.go [\go-swagger#1692](go-swagger#1692)
- Generate spec in yml format [\go-swagger#1686](go-swagger#1686)
- Could not get payload or file content from request [\go-swagger#1666](go-swagger#1666)

**Closed issues:**

- --socket-path is being ignored [\go-swagger#1740](go-swagger#1740)
- Request context does not flow down handler pipeline \(handler registered i globalmiddleware\) is lost. [\go-swagger#1733](go-swagger#1733)
- Cannot install go-swagger [\go-swagger#1728](go-swagger#1728)
- -m, --scan-models missing when compiled using go 1.11 with module support [\go-swagger#1718](go-swagger#1718)
- Models rendered to file even if imported from external package using x-go-type [\go-swagger#1710](go-swagger#1710)
- Bug in external type import using x-go-type [\go-swagger#1703](go-swagger#1703)
- How to receive the shutdown signal from generated server? [\go-swagger#1695](go-swagger#1695)
- errcheck failed on generated restapi/server.go\#handleInterrupt [\go-swagger#1689](go-swagger#1689)
- Move to go modules ? [\go-swagger#1677](go-swagger#1677)
- Move from x/net/context to just context [\go-swagger#1676](go-swagger#1676)
- tuple unmarshaller fails [\go-swagger#1673](go-swagger#1673)
- Path parameter with request body [\go-swagger#1523](go-swagger#1523)

**Merged pull requests:**

- Fix graceful-timeout variable [\go-swagger#1732](go-swagger#1732) ([gregorhollmig](https://github.com/gregorhollmig))
- Enhance Server to have configurable graceful timeout [\go-swagger#1730](go-swagger#1730) ([gregorhollmig](https://github.com/gregorhollmig))
- use different bindata binary [\go-swagger#1723](go-swagger#1723) ([casualjim](https://github.com/casualjim))
- Fix do not generate models with x-go-type extension [\go-swagger#1717](go-swagger#1717) ([moskal91](https://github.com/moskal91))
- Fix missing error check on s.Shutdown\(\) [\go-swagger#1715](go-swagger#1715) ([MrLuje](https://github.com/MrLuje))
- Allow to include/exclude routes by their tags [\go-swagger#1709](go-swagger#1709) ([scf2k](https://github.com/scf2k))
- Support dot in the tag names [\go-swagger#1706](go-swagger#1706) ([scf2k](https://github.com/scf2k))
- Fix x-go-type imports missing [\go-swagger#1705](go-swagger#1705) ([moskal91](https://github.com/moskal91))
- Remove unused variable [\go-swagger#1701](go-swagger#1701) ([jackwilsdon](https://github.com/jackwilsdon))
- Enhance spec  [\go-swagger#1700](go-swagger#1700) ([chenziliang](https://github.com/chenziliang))
- Add include/exclude parameters to spec generator [\go-swagger#1698](go-swagger#1698) ([scf2k](https://github.com/scf2k))
- Make extension generation optional [\go-swagger#1697](go-swagger#1697) ([chenziliang](https://github.com/chenziliang))
- fix minor typo "you" to "your" [\go-swagger#1694](go-swagger#1694) ([stmuk](https://github.com/stmuk))
- Add yaml format spec support [\go-swagger#1693](go-swagger#1693) ([chenziliang](https://github.com/chenziliang))
- remove telling user they need to install context package [\go-swagger#1691](go-swagger#1691) ([etsangsplk](https://github.com/etsangsplk))
- Gave up with parallel testing [\go-swagger#1669](go-swagger#1669) ([fredbi](https://github.com/fredbi))
- Spelling mistake 🍝 [\go-swagger#1667](go-swagger#1667) ([frg](https://github.com/frg))
- Fix race condition in unit test [\go-swagger#1664](go-swagger#1664) ([fredbi](https://github.com/fredbi))
- Improve go.mod support in generator [\go-swagger#1661](go-swagger#1661) ([mikkeloscar](https://github.com/mikkeloscar))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

add v0.16.0 release notes

[Full Changelog](go-swagger/go-swagger@0.14.0...0.15.0)

**Implemented enhancements:**

- Fail to generate model: unhandled type to resolve JSON pointer [\go-swagger#1602](go-swagger#1602)
- Suggestion: Implement golangci on go-swagger? [\go-swagger#1576](go-swagger#1576)
- Improve spec preprocessing : flatten vs expand [\go-swagger#1572](go-swagger#1572)
- Produces application/pdf ignored [\go-swagger#1284](go-swagger#1284)
- swagger json, title and possibly other constants in a separate package [\go-swagger#1169](go-swagger#1169)
- Debug prints regorganization [\go-swagger#634](go-swagger#634)

**Fixed bugs:**

- Tuple unmarshaller fails on nil fields [\go-swagger#1571](go-swagger#1571)
- Deadlock issue in shutdown function under restapi [\go-swagger#1565](go-swagger#1565)
- Models: Invalid pointer redirect [\go-swagger#1562](go-swagger#1562)
- Broken code is generated with --skip-flatten [\go-swagger#1559](go-swagger#1559)
- Rendering and validation of maps in body [\go-swagger#1556](go-swagger#1556)
- Base64 validation wrongly performed after decoding the string field [\go-swagger#1548](go-swagger#1548)
- Model definition not included when response definition has an external $ref containing a schema $ref [\go-swagger#1429](go-swagger#1429)
- Client Generator hangs on swagger with circular dependencies. [\go-swagger#957](go-swagger#957)
- repeated resolve of remote ref fails [\go-swagger#908](go-swagger#908)
- Override struct type in json struct tag? [\go-swagger#543](go-swagger#543)

**Closed issues:**

- Stack overflow error in swagger validate [\go-swagger#1614](go-swagger#1614)
- server execution on linux does not appear to call server.ConfigureFlags\(\) in main.go [\go-swagger#1584](go-swagger#1584)
- Question: Accessing parsed command-line arguments in configureAPI method [\go-swagger#1581](go-swagger#1581)
- Error "Cannot find file" on transpile todo example yml to Go server code on windows. [\go-swagger#1554](go-swagger#1554)
- Json Generation Issues [\go-swagger#1553](go-swagger#1553)
- Security & Nullable fields [\go-swagger#1546](go-swagger#1546)
- swagger:parameters won't generate in spec when inside a function [\go-swagger#1545](go-swagger#1545)
- Polymorphism does not support --skip-flatten [\go-swagger#1516](go-swagger#1516)
- Bug in oauth2 example [\go-swagger#1496](go-swagger#1496)
- contributing guidelines lack development instructions [\go-swagger#1484](go-swagger#1484)
- Missing strfmt import [\go-swagger#1480](go-swagger#1480)
- The commit number of command `swagger version` is wrong v0.12.0 [\go-swagger#1297](go-swagger#1297)
- Fail to include import "github.com/go-openapi/validate" in first go generate [\go-swagger#824](go-swagger#824)
- it appears that vendoring breaks client generation assumption [\go-swagger#785](go-swagger#785)

**Merged pull requests:**

- Fixes \go-swagger#1614 [\go-swagger#1615](go-swagger#1615) ([fredbi](https://github.com/fredbi))
- Feature/x-order [\go-swagger#1612](go-swagger#1612) ([liber-takano](https://github.com/liber-takano))
- Update vendor 20180710 [\go-swagger#1608](go-swagger#1608) ([fredbi](https://github.com/fredbi))
- Document contribution guidelines [\go-swagger#1607](go-swagger#1607) ([fredbi](https://github.com/fredbi))
- Review doc site [\go-swagger#1604](go-swagger#1604) ([fredbi](https://github.com/fredbi))
- regen examples [\go-swagger#1600](go-swagger#1600) ([fredbi](https://github.com/fredbi))
- Update vendor - keep up to date with go-openapi repo [\go-swagger#1599](go-swagger#1599) ([fredbi](https://github.com/fredbi))
- Refactor debug code [\go-swagger#1598](go-swagger#1598) ([fredbi](https://github.com/fredbi))
- Fix some linting and mispelling issues [\go-swagger#1597](go-swagger#1597) ([fredbi](https://github.com/fredbi))
- Validation of string with format "byte" [\go-swagger#1593](go-swagger#1593) ([fredbi](https://github.com/fredbi))
- Tuple serializer [\go-swagger#1592](go-swagger#1592) ([fredbi](https://github.com/fredbi))
- Add go report card and golangci badges [\go-swagger#1590](go-swagger#1590) ([fredbi](https://github.com/fredbi))
- Doc for new flatten [\go-swagger#1589](go-swagger#1589) ([fredbi](https://github.com/fredbi))
- Minimal flatten [\go-swagger#1588](go-swagger#1588) ([fredbi](https://github.com/fredbi))
- Add license scan report and status [\go-swagger#1586](go-swagger#1586) ([fossabot](https://github.com/fossabot))
- Update vendor 20180630 [\go-swagger#1585](go-swagger#1585) ([fredbi](https://github.com/fredbi))
- Create .golangci.yml [\go-swagger#1578](go-swagger#1578) ([JonKohler](https://github.com/JonKohler))
- Update README.md to add Nutanix to the list [\go-swagger#1577](go-swagger#1577) ([JonKohler](https://github.com/JonKohler))
- Replace tylerb/graceful with inbuilt methods Go 1.8 onwards - new request [\go-swagger#1574](go-swagger#1574) ([tortuoise](https://github.com/tortuoise))
- fix: Shutdown method didn't shutdown all the schemes [\go-swagger#1569](go-swagger#1569) ([dreamlover](https://github.com/dreamlover))
- Anonymous body parameters and responses [\go-swagger#1568](go-swagger#1568) ([fredbi](https://github.com/fredbi))
- swagger:type Documentation [\go-swagger#1567](go-swagger#1567) ([nathanwilk7](https://github.com/nathanwilk7))
- Render and validate maps in body parameters [\go-swagger#1566](go-swagger#1566) ([fredbi](https://github.com/fredbi))
- Fix typo in clone command [\go-swagger#1564](go-swagger#1564) ([dbmalkovsky](https://github.com/dbmalkovsky))
- Generate consumer/producer handlers that are not whitelisted [\go-swagger#1557](go-swagger#1557) ([Xzya](https://github.com/Xzya))
- Doc dependencies requirement [\go-swagger#1555](go-swagger#1555) ([fredbi](https://github.com/fredbi))
- Allow parameter code generation when struct is inside a function. [\go-swagger#1550](go-swagger#1550) ([josephspurrier](https://github.com/josephspurrier))

\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*