Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2025-05-25 12:27
📄 .editorconfig # top-most EditorConfig file root = true # Unix-style newlines with a newline ending every file [] end_of_line = lf insert_final_newline = true indent_style = space indent_size = 2 trim_trailing_whitespace = true # Set default charset [.{js,py,go,scala,rb,java,html,css,less,sass,md}] charset = utf-8 # Tab indentation (no size specified) [.go] indent_style = tab [.md] trim_trailing_whitespace = false # Matches the exact files either package.json or .travis.yml [{package.json,.travis.yml}] indent_style = space indent_size = 2	539 B	2025-05-25 12:27
📁 .github	-	2025-05-25 12:27
📄 .gitignore secrets.yml coverage.out profile.cov profile.out	49 B	2025-05-25 12:27
📄 .golangci.yml linters-settings: govet: check-shadowing: true golint: min-confidence: 0 gocyclo: min-complexity: 45 maligned: suggest-new: true dupl: threshold: 200 goconst: min-len: 2 min-occurrences: 3 linters: enable-all: true disable: - maligned - unparam - lll - gochecknoinits - gochecknoglobals - funlen - godox - gocognit - whitespace - wsl - wrapcheck - testpackage - nlreturn - gomnd - exhaustivestruct - goerr113 - errorlint - nestif - godot - gofumpt - paralleltest - tparallel - thelper - ifshort - exhaustruct - varnamelen - gci - depguard - errchkjson - inamedparam - nonamedreturns - musttag - ireturn - forcetypeassert - cyclop # deprecated linters - deadcode - interfacer - scopelint - varcheck - structcheck - golint - nosnakecase	952 B	2025-05-25 12:27
📄 .travis.yml after_success: - bash <(curl -s https://codecov.io/bash) go: - 1.16.x - 1.x install: - go get gotest.tools/gotestsum language: go arch: - amd64 - ppc64le jobs: include: # include linting job, but only for latest go version and amd64 arch - go: 1.x arch: amd64 install: go get github.com/golangci/golangci-lint/cmd/golangci-lint script: - golangci-lint run --new-from-rev master notifications: slack: secure: OxkPwVp35qBTUilgWC8xykSj+sGMcj0h8IIOKD+Rflx2schZVlFfdYdyVBM+s9OqeOfvtuvnR9v1Ye2rPKAvcjWdC4LpRGUsgmItZaI6Um8Aj6+K9udCw5qrtZVfOVmRu8LieH//XznWWKdOultUuniW0MLqw5+II87Gd00RWbCGi0hk0PykHe7uK+PDA2BEbqyZ2WKKYCvfB3j+0nrFOHScXqnh0V05l2E83J4+Sgy1fsPy+1WdX58ZlNBG333ibaC1FS79XvKSmTgKRkx3+YBo97u6ZtUmJa5WZjf2OdLG3KIckGWAv6R5xgxeU31N0Ng8L332w/Edpp2O/M2bZwdnKJ8hJQikXIAQbICbr+lTDzsoNzMdEIYcHpJ5hjPbiUl3Bmd+Jnsjf5McgAZDiWIfpCKZ29tPCEkVwRsOCqkyPRMNMzHHmoja495P5jR+ODS7+J8RFg5xgcnOgpP9D4Wlhztlf5WyZMpkLxTUD+bZq2SRf50HfHFXTkfq22zPl3d1eq0yrLwh/Z/fWKkfb6SyysROL8y6s8u3dpFX1YHSg0BR6i913h4aoZw9B2BG27cafLLTwKYsp2dFo1PWl4O6u9giFJIeqwloZHLKKrwh0cBFhB7RH0I58asxkZpCH6uWjJierahmHe7iS+E6i+9oCHkOZ59hmCYNimIs3hM= script: - gotestsum -f short-verbose -- -race -timeout=20m -coverprofile=coverage.txt -covermode=atomic ./...	1.21 KB	2025-05-25 12:27
📄 CODE_OF_CONDUCT.md # Contributor Covenant Code of Conduct ## Our Pledge In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. ## Our Standards Examples of behavior that contributes to creating a positive environment include: * Using welcoming and inclusive language * Being respectful of differing viewpoints and experiences * Gracefully accepting constructive criticism * Focusing on what is best for the community * Showing empathy towards other community members Examples of unacceptable behavior by participants include: * The use of sexualized language or imagery and unwelcome sexual attention or advances * Trolling, insulting/derogatory comments, and personal or political attacks * Public or private harassment * Publishing others' private information, such as a physical or electronic address, without explicit permission * Other conduct which could reasonably be considered inappropriate in a professional setting ## Our Responsibilities Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. ## Scope This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at ivan+abuse@flanders.co.nz. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] [homepage]: http://contributor-covenant.org [version]: http://contributor-covenant.org/version/1/4/	3.16 KB	2025-05-25 12:27
📄 LICENSE Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.	11.09 KB	2025-05-25 12:27
📄 README.md # Loads OAI specs [![Build Status](https://github.com/go-openapi/loads/actions/workflows/go-test.yml/badge.svg)](https://github.com/go-openapi/loads/actions?query=workflow%3A"go+test") [![codecov](https://codecov.io/gh/go-openapi/loads/branch/master/graph/badge.svg)](https://codecov.io/gh/go-openapi/loads) [![license](http://img.shields.io/badge/license-Apache%20v2-orange.svg)](https://raw.githubusercontent.com/go-openapi/loads/master/LICENSE) [![GoDoc](https://godoc.org/github.com/go-openapi/loads?status.svg)](http://godoc.org/github.com/go-openapi/loads) [![Go Report Card](https://goreportcard.com/badge/github.com/go-openapi/loads)](https://goreportcard.com/report/github.com/go-openapi/loads) Loading of OAI specification documents from local or remote locations. Supports JSON and YAML documents.	811 B	2025-05-25 12:27
📄 doc.go // Copyright 2015 go-swagger maintainers // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package loads provides document loading methods for swagger (OAI) specifications. // // It is used by other go-openapi packages to load and run analysis on local or remote spec documents. package loads	804 B	2025-05-25 12:27
📄 doc_test.go package loads_test import ( "encoding/json" "fmt" "os" "path/filepath" "github.com/go-openapi/loads" "github.com/go-openapi/swag" ) func ExampleSpec() { // Example with default loaders defined at the package level path := "fixtures/yaml/swagger/spec.yml" doc, err := loads.Spec(path) if err != nil { fmt.Println("Could not load this spec") return } fmt.Printf("Spec loaded: %q\n", doc.Host()) // Output: Spec loaded: "api.example.com" } func ExampleLoaderOption() { // Example with custom loaders passed as options path := "fixtures/yaml/swagger/spec.yml" // a simpler version of loads.JSONDoc jsonLoader := loads.NewDocLoaderWithMatch( func(pth string) (json.RawMessage, error) { buf, err := os.ReadFile(pth) return json.RawMessage(buf), err }, func(pth string) bool { return filepath.Ext(pth) == ".json" }, ) // equivalent to the default loader at the package level, which does: // // loads.AddLoader(swag.YAMLMatcher, swag.YAMLDoc) yamlLoader := loads.NewDocLoaderWithMatch( swag.YAMLDoc, func(pth string) bool { return filepath.Ext(pth) == ".yml" }, ) doc, err := loads.Spec(path, loads.WithDocLoaderMatches(jsonLoader, yamlLoader)) if err != nil { fmt.Println("Could not load this spec") return } fmt.Printf("Spec loaded: %q\n", doc.Host()) // Output: Spec loaded: "api.example.com" }	1.33 KB	2025-05-25 12:27
📄 example_test.go package loads	14 B	2025-05-25 12:27
📁 fixtures	-	2025-05-25 12:27
📁 fmts	-	2025-05-25 12:27
📄 go.mod module github.com/go-openapi/loads require ( github.com/go-openapi/analysis v0.23.0 github.com/go-openapi/spec v0.21.0 github.com/go-openapi/swag v0.23.0 github.com/stretchr/testify v1.9.0 gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 // indirect github.com/davecgh/go-spew v1.1.1 // indirect github.com/go-openapi/errors v0.22.0 // indirect github.com/go-openapi/jsonpointer v0.21.0 // indirect github.com/go-openapi/jsonreference v0.21.0 // indirect github.com/go-openapi/strfmt v0.23.0 // indirect github.com/google/uuid v1.6.0 // indirect github.com/josharian/intern v1.0.0 // indirect github.com/mailru/easyjson v0.7.7 // indirect github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/oklog/ulid v1.3.1 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect go.mongodb.org/mongo-driver v1.14.0 // indirect ) go 1.20	917 B	2025-05-25 12:27
📄 go.sum github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 h1:DklsrG3dyBCFEj5IhUbnKptjxatkF07cF2ak3yi77so= github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2/go.mod h1:WaHUgvxTVq04UNunO+XhnAqY/wQc+bxr74GqbsZ/Jqw= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/go-openapi/analysis v0.23.0 h1:aGday7OWupfMs+LbmLZG4k0MYXIANxcuBTYUC03zFCU= github.com/go-openapi/analysis v0.23.0/go.mod h1:9mz9ZWaSlV8TvjQHLl2mUW2PbZtemkE8yA5v22ohupo= github.com/go-openapi/errors v0.22.0 h1:c4xY/OLxUBSTiepAg3j/MHuAv5mJhnf53LLMWFB+u/w= github.com/go-openapi/errors v0.22.0/go.mod h1:J3DmZScxCDufmIMsdOuDHxJbdOGC0xtUynjIx092vXE= github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ= github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY= github.com/go-openapi/jsonreference v0.21.0 h1:Rs+Y7hSXT83Jacb7kFyjn4ijOuVGSvOdF2+tg1TRrwQ= github.com/go-openapi/jsonreference v0.21.0/go.mod h1:LmZmgsrTkVg9LG4EaHeY8cBDslNPMo06cago5JNLkm4= github.com/go-openapi/spec v0.21.0 h1:LTVzPc3p/RzRnkQqLRndbAzjY0d0BCL72A6j3CdL9ZY= github.com/go-openapi/spec v0.21.0/go.mod h1:78u6VdPw81XU44qEWGhtr982gJ5BWg2c0I5XwVMotYk= github.com/go-openapi/strfmt v0.23.0 h1:nlUS6BCqcnAk0pyhi9Y+kdDVZdZMHfEKQiS4HaMgO/c= github.com/go-openapi/strfmt v0.23.0/go.mod h1:NrtIpfKtWIygRkKVsxh7XQMDQW5HKQl6S5ik2elW+K4= github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE= github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ= github.com/google/go-cmp v0.5.2 h1:X2ev0eStA3AbceY54o37/0PQ/UWqKEiiO2dKL5OPaFM= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY= github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/mailru/easyjson v0.7.7 h1:UGYAvKxe3sBsEDzO8ZeWOSlIQfWFlxbzLZe7hwFURr0= github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= github.com/oklog/ulid v1.3.1 h1:EGfNDEx6MqHz8B3uNV6QAib1UR2Lm97sHi3ocA6ESJ4= github.com/oklog/ulid v1.3.1/go.mod h1:CirwcVhetQ6Lv90oh/F+FBtV6XMibvdAFo93nm5qn4U= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M= github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg= github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= go.mongodb.org/mongo-driver v1.14.0 h1:P98w8egYRjYe3XDjxhYJagTokP/H6HzlsnojRgZRd80= go.mongodb.org/mongo-driver v1.14.0/go.mod h1:Vzb0Mk/pa7e6cWw85R4F/endUC3u0U9jGcNU603k65c= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=	3.64 KB	2025-05-25 12:27
📄 json_test.go // Copyright 2015 go-swagger maintainers // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package loads import ( "net/http" "net/http/httptest" "testing" "github.com/stretchr/testify/require" ) func TestLoadJSON(t testing.T) { serv := httptest.NewServer(http.HandlerFunc(jsonPestoreServer)) defer serv.Close() s, err := JSONSpec(serv.URL) require.NoError(t, err) require.NotNil(t, s) ts2 := httptest.NewServer(http.HandlerFunc(func(rw http.ResponseWriter, _ http.Request) { rw.WriteHeader(http.StatusNotFound) _, _ = rw.Write([]byte("{}")) })) defer ts2.Close() _, err = JSONSpec(ts2.URL) require.Error(t, err) } var jsonPestoreServer = func(rw http.ResponseWriter, _ *http.Request) { rw.WriteHeader(http.StatusOK) _, _ = rw.Write([]byte(petstoreJSON)) } const petstoreJSON = `{ "swagger": "2.0", "info": { "version": "1.0.0", "title": "Swagger Petstore", "contact": { "name": "Wordnik API Team", "url": "http://developer.wordnik.com" }, "license": { "name": "Creative Commons 4.0 International", "url": "http://creativecommons.org/licenses/by/4.0/" } }, "host": "petstore.swagger.wordnik.com", "basePath": "/api", "schemes": [ "http" ], "paths": { "/pets": { "get": { "security": [ { "oauth2": ["read"] } ], "tags": [ "Pet Operations" ], "operationId": "getAllPets", "parameters": [ { "name": "status", "in": "query", "description": "The status to filter by", "type": "string" } ], "summary": "Finds all pets in the system", "responses": { "200": { "description": "Pet response", "schema": { "type": "array", "items": { "$ref": "#/definitions/Pet" } } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "post": { "security": [ { "oauth2": ["write"] } ], "tags": [ "Pet Operations" ], "operationId": "createPet", "summary": "Creates a new pet", "parameters": [ { "name": "pet", "in": "body", "description": "The Pet to create", "required": true, "schema": { "$ref": "#/definitions/newPet" } } ], "responses": { "200": { "description": "Created Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } } }, "/pets/{id}": { "delete": { "security": [ { "oauth2": ["write"] } ], "description": "Deletes the Pet by id", "operationId": "deletePet", "parameters": [ { "name": "id", "in": "path", "description": "ID of pet to delete", "required": true, "type": "integer", "format": "int64" } ], "responses": { "204": { "description": "pet deleted" }, "default": { "description": "unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "get": { "security": [ { "oauth2": ["read"] } ], "tags": [ "Pet Operations" ], "operationId": "getPetById", "summary": "Finds the pet by id", "responses": { "200": { "description": "Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "parameters": [ { "name": "id", "in": "path", "description": "ID of pet", "required": true, "type": "integer", "format": "int64" } ] } }, "definitions": { "Category": { "id": "Category", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Pet": { "id": "Pet", "properties": { "category": { "$ref": "#/definitions/Category" }, "id": { "description": "unique identifier for the pet", "format": "int64", "maximum": 100.0, "minimum": 0.0, "type": "integer" }, "name": { "type": "string" }, "photoUrls": { "items": { "type": "string" }, "type": "array" }, "status": { "description": "pet status in the store", "enum": [ "available", "pending", "sold" ], "type": "string" }, "tags": { "items": { "$ref": "#/definitions/Tag" }, "type": "array" } }, "required": [ "id", "name" ] }, "newPet": { "allOf": [ { "$ref": "#/definitions/Pet" } ], "required": [ "name" ] }, "Tag": { "id": "Tag", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Error": { "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } } }, "produces": [ "application/json", "application/xml", "text/plain", "text/html" ], "securityDefinitions": { "oauth2": { "type": "oauth2", "scopes": { "read": "Read access.", "write": "Write access" }, "flow": "accessCode", "authorizationUrl": "http://petstore.swagger.wordnik.com/oauth/authorize", "tokenUrl": "http://petstore.swagger.wordnik.com/oauth/token" } } }`	7.11 KB	2025-05-25 12:27
📄 loaders.go package loads import ( "encoding/json" "errors" "net/url" "github.com/go-openapi/spec" "github.com/go-openapi/swag" ) var ( // Default chain of loaders, defined at the package level. // // By default this matches json and yaml documents. // // May be altered with AddLoader(). loaders loader ) func init() { jsonLoader := &loader{ DocLoaderWithMatch: DocLoaderWithMatch{ Match: func(_ string) bool { return true }, Fn: JSONDoc, }, } loaders = jsonLoader.WithHead(&loader{ DocLoaderWithMatch: DocLoaderWithMatch{ Match: swag.YAMLMatcher, Fn: swag.YAMLDoc, }, }) // sets the global default loader for go-openapi/spec spec.PathLoader = loaders.Load } // DocLoader represents a doc loader type type DocLoader func(string) (json.RawMessage, error) // DocMatcher represents a predicate to check if a loader matches type DocMatcher func(string) bool // DocLoaderWithMatch describes a loading function for a given extension match. type DocLoaderWithMatch struct { Fn DocLoader Match DocMatcher } // NewDocLoaderWithMatch builds a DocLoaderWithMatch to be used in load options func NewDocLoaderWithMatch(fn DocLoader, matcher DocMatcher) DocLoaderWithMatch { return DocLoaderWithMatch{ Fn: fn, Match: matcher, } } type loader struct { DocLoaderWithMatch Next loader } // WithHead adds a loader at the head of the current stack func (l loader) WithHead(head loader) loader { if head == nil { return l } head.Next = l return head } // WithNext adds a loader at the trail of the current stack func (l loader) WithNext(next loader) loader { l.Next = next return next } // Load the raw document from path func (l *loader) Load(path string) (json.RawMessage, error) { _, erp := url.Parse(path) if erp != nil { return nil, erp } lastErr := errors.New("no loader matched") // default error if no match was found for ldr := l; ldr != nil; ldr = ldr.Next { if ldr.Match != nil && !ldr.Match(path) { continue } // try then move to next one if there is an error b, err := ldr.Fn(path) if err == nil { return b, nil } lastErr = err } return nil, lastErr } // JSONDoc loads a json document from either a file or a remote url func JSONDoc(path string) (json.RawMessage, error) { data, err := swag.LoadFromFileOrHTTP(path) if err != nil { return nil, err } return json.RawMessage(data), nil } // AddLoader for a document, executed before other previously set loaders. // // This sets the configuration at the package level. // // NOTE: // - this updates the default loader used by github.com/go-openapi/spec // - since this sets package level globals, you shouln't call this concurrently func AddLoader(predicate DocMatcher, load DocLoader) { loaders = loaders.WithHead(&loader{ DocLoaderWithMatch: DocLoaderWithMatch{ Match: predicate, Fn: load, }, }) // sets the global default loader for go-openapi/spec spec.PathLoader = loaders.Load }	2.9 KB	2025-05-25 12:27
📄 loaders_test.go package loads import ( "testing" "github.com/stretchr/testify/require" ) func TestLoader_EdgeCases(t *testing.T) { ldr := &loader{} ldr.Fn = JSONDoc // chaining with nil is a no op next := ldr.WithHead(nil) require.Equal(t, ldr, next) _, err := ldr.Load(`d\::invalid uri\`) require.Error(t, err) }	312 B	2025-05-25 12:27
📄 options.go package loads type options struct { loader loader } func defaultOptions() options { return &options{ loader: loaders, } } func loaderFromOptions(options []LoaderOption) loader { opts := defaultOptions() for _, apply := range options { apply(opts) } return opts.loader } // LoaderOption allows to fine-tune the spec loader behavior type LoaderOption func(options) // WithDocLoader sets a custom loader for loading specs func WithDocLoader(l DocLoader) LoaderOption { return func(opt options) { if l == nil { return } opt.loader = &loader{ DocLoaderWithMatch: DocLoaderWithMatch{ Fn: l, }, } } } // WithDocLoaderMatches sets a chain of custom loaders for loading specs // for different extension matches. // // Loaders are executed in the order of provided DocLoaderWithMatch'es. func WithDocLoaderMatches(l ...DocLoaderWithMatch) LoaderOption { return func(opt options) { var final, prev *loader for _, ldr := range l { if ldr.Fn == nil { continue } if prev == nil { final = &loader{DocLoaderWithMatch: ldr} prev = final continue } prev = prev.WithNext(&loader{DocLoaderWithMatch: ldr}) } opt.loader = final } }	1.17 KB	2025-05-25 12:27
📄 options_test.go package loads import ( "encoding/json" "errors" "os" "path/filepath" "testing" "github.com/go-openapi/swag" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" ) const optionFixture = "fixtures/json/resources/pathLoaderIssue.json" func TestOptionsWithDocLoader(t testing.T) { document, err := Spec(optionFixture, WithDocLoader(func(pth string) (json.RawMessage, error) { buf, err := os.ReadFile(pth) return json.RawMessage(buf), err })) require.NoError(t, err) require.NotNil(t, document) require.NotNil(t, document.pathLoader) b, err := document.pathLoader.Load(optionFixture) require.NoError(t, err) trimmed, err := trimData(b) require.NoError(t, err) assert.EqualValues(t, trimmed, document.Raw()) // a nil loader is a no op _, err = Spec(optionFixture, WithDocLoader(nil)) require.NoError(t, err) } func TestOptionsLoaderFromOptions(t testing.T) { var called int // not chaining here, just replacing with the last one l := loaderFromOptions([]LoaderOption{ WithDocLoader(func(pth string) (json.RawMessage, error) { called = 1 buf, err := os.ReadFile(pth) return json.RawMessage(buf), err }), WithDocLoader(func(pth string) (json.RawMessage, error) { called = 2 buf, err := os.ReadFile(pth) return json.RawMessage(buf), err }), }) require.NotNil(t, l) b, err := l.Load(optionFixture) require.NoError(t, err) require.NotNil(t, b) require.Equal(t, 2, called) } func TestOptionsWithDocLoaderMatches(t *testing.T) { jsonLoader := NewDocLoaderWithMatch( func(pth string) (json.RawMessage, error) { buf, err := os.ReadFile(pth) return json.RawMessage(buf), err }, func(pth string) bool { return filepath.Ext(pth) == ".json" }, ) document, err := Spec(optionFixture, WithDocLoaderMatches(jsonLoader)) require.NoError(t, err) require.NotNil(t, document) require.NotNil(t, document.pathLoader) yamlLoader := NewDocLoaderWithMatch( swag.YAMLDoc, func(pth string) bool { return filepath.Ext(pth) == ".yaml" }, ) document, err = Spec(optionFixture, WithDocLoaderMatches(yamlLoader)) require.Error(t, err) require.Nil(t, document) // chained loaders, with different ordering document, err = Spec(optionFixture, WithDocLoaderMatches(yamlLoader, jsonLoader)) require.NoError(t, err) require.NotNil(t, document) document, err = Spec(optionFixture, WithDocLoaderMatches(jsonLoader, yamlLoader)) require.NoError(t, err) require.NotNil(t, document) // the nil loader is a no op nilLoader := NewDocLoaderWithMatch(nil, nil) document, err = Spec(optionFixture, WithDocLoaderMatches(nilLoader, jsonLoader, yamlLoader)) require.NoError(t, err) require.NotNil(t, document) // the nil matcher always matches nilMatcher := NewDocLoaderWithMatch(func(_ string) (json.RawMessage, error) { return nil, errors.New("test") }, nil) _, err = Spec(optionFixture, WithDocLoaderMatches(nilMatcher)) require.Error(t, err) require.Equal(t, "test", err.Error()) // when a matcher returns an errors, the next one is tried document, err = Spec(optionFixture, WithDocLoaderMatches(nilMatcher, jsonLoader, yamlLoader)) require.NoError(t, err) require.NotNil(t, document) }	3.13 KB	2025-05-25 12:27
📄 spec.go // Copyright 2015 go-swagger maintainers // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package loads import ( "bytes" "encoding/gob" "encoding/json" "fmt" "github.com/go-openapi/analysis" "github.com/go-openapi/spec" "github.com/go-openapi/swag" ) func init() { gob.Register(map[string]interface{}{}) gob.Register([]interface{}{}) } // Document represents a swagger spec document type Document struct { // specAnalyzer Analyzer analysis.Spec spec spec.Swagger specFilePath string origSpec spec.Swagger schema spec.Schema pathLoader loader raw json.RawMessage } // JSONSpec loads a spec from a json document func JSONSpec(path string, options ...LoaderOption) (Document, error) { data, err := JSONDoc(path) if err != nil { return nil, err } // convert to json doc, err := Analyzed(data, "", options...) if err != nil { return nil, err } doc.specFilePath = path return doc, nil } // Embedded returns a Document based on embedded specs. No analysis is required func Embedded(orig, flat json.RawMessage, options ...LoaderOption) (Document, error) { var origSpec, flatSpec spec.Swagger if err := json.Unmarshal(orig, &origSpec); err != nil { return nil, err } if err := json.Unmarshal(flat, &flatSpec); err != nil { return nil, err } return &Document{ raw: orig, origSpec: &origSpec, spec: &flatSpec, pathLoader: loaderFromOptions(options), }, nil } // Spec loads a new spec document from a local or remote path func Spec(path string, options ...LoaderOption) (Document, error) { ldr := loaderFromOptions(options) b, err := ldr.Load(path) if err != nil { return nil, err } document, err := Analyzed(b, "", options...) if err != nil { return nil, err } document.specFilePath = path document.pathLoader = ldr return document, nil } // Analyzed creates a new analyzed spec document for a root json.RawMessage. func Analyzed(data json.RawMessage, version string, options ...LoaderOption) (Document, error) { if version == "" { version = "2.0" } if version != "2.0" { return nil, fmt.Errorf("spec version %q is not supported", version) } raw, err := trimData(data) // trim blanks, then convert yaml docs into json if err != nil { return nil, err } swspec := new(spec.Swagger) if err = json.Unmarshal(raw, swspec); err != nil { return nil, err } origsqspec, err := cloneSpec(swspec) if err != nil { return nil, err } d := &Document{ Analyzer: analysis.New(swspec), // NOTE: at this moment, analysis does not follow $refs to documents outside the root doc schema: spec.MustLoadSwagger20Schema(), spec: swspec, raw: raw, origSpec: origsqspec, pathLoader: loaderFromOptions(options), } return d, nil } func trimData(in json.RawMessage) (json.RawMessage, error) { trimmed := bytes.TrimSpace(in) if len(trimmed) == 0 { return in, nil } if trimmed[0] == '{' \|\| trimmed[0] == '[' { return trimmed, nil } // assume yaml doc: convert it to json yml, err := swag.BytesToYAMLDoc(trimmed) if err != nil { return nil, fmt.Errorf("analyzed: %v", err) } d, err := swag.YAMLToJSON(yml) if err != nil { return nil, fmt.Errorf("analyzed: %v", err) } return d, nil } // Expanded expands the $ref fields in the spec document and returns a new spec document func (d Document) Expanded(options ...spec.ExpandOptions) (Document, error) { swspec := new(spec.Swagger) if err := json.Unmarshal(d.raw, swspec); err != nil { return nil, err } var expandOptions spec.ExpandOptions if len(options) > 0 { expandOptions = options[0] if expandOptions.RelativeBase == "" { expandOptions.RelativeBase = d.specFilePath } } else { expandOptions = &spec.ExpandOptions{ RelativeBase: d.specFilePath, } } if expandOptions.PathLoader == nil { if d.pathLoader != nil { // use loader from Document options expandOptions.PathLoader = d.pathLoader.Load } else { // use package level loader expandOptions.PathLoader = loaders.Load } } if err := spec.ExpandSpec(swspec, expandOptions); err != nil { return nil, err } dd := &Document{ Analyzer: analysis.New(swspec), spec: swspec, specFilePath: d.specFilePath, schema: spec.MustLoadSwagger20Schema(), raw: d.raw, origSpec: d.origSpec, } return dd, nil } // BasePath the base path for the API specified by this spec func (d Document) BasePath() string { return d.spec.BasePath } // Version returns the version of this spec func (d Document) Version() string { return d.spec.Swagger } // Schema returns the swagger 2.0 schema func (d Document) Schema() spec.Schema { return d.schema } // Spec returns the swagger spec object model func (d Document) Spec() spec.Swagger { return d.spec } // Host returns the host for the API func (d Document) Host() string { return d.spec.Host } // Raw returns the raw swagger spec as json bytes func (d Document) Raw() json.RawMessage { return d.raw } // OrigSpec yields the original spec func (d Document) OrigSpec() spec.Swagger { return d.origSpec } // ResetDefinitions gives a shallow copy with the models reset to the original spec func (d Document) ResetDefinitions() Document { defs := make(map[string]spec.Schema, len(d.origSpec.Definitions)) for k, v := range d.origSpec.Definitions { defs[k] = v } d.spec.Definitions = defs return d } // Pristine creates a new pristine document instance based on the input data func (d Document) Pristine() Document { raw, _ := json.Marshal(d.Spec()) dd, _ := Analyzed(raw, d.Version()) dd.pathLoader = d.pathLoader dd.specFilePath = d.specFilePath return dd } // SpecFilePath returns the file path of the spec if one is defined func (d Document) SpecFilePath() string { return d.specFilePath } func cloneSpec(src spec.Swagger) (spec.Swagger, error) { var b bytes.Buffer if err := gob.NewEncoder(&b).Encode(src); err != nil { return nil, err } var dst spec.Swagger if err := gob.NewDecoder(&b).Decode(&dst); err != nil { return nil, err } return &dst, nil }	6.47 KB	2025-05-25 12:27
📄 spec_test.go // Copyright 2015 go-swagger maintainers // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package loads import ( "encoding/json" "path/filepath" "regexp" "strconv" "strings" "testing" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" ) func TestUnknownSpecVersion(t testing.T) { _, err := Analyzed([]byte{}, "0.9") require.Error(t, err) } func TestDefaultsTo20(t testing.T) { d, err := Analyzed(PetStoreJSONMessage, "") require.NoError(t, err) require.NotNil(t, d) assert.Equal(t, "2.0", d.Version()) // assert.Equal(t, "2.0", d.data["swagger"].(string)) assert.Equal(t, "/api", d.BasePath()) } func TestLoadsYAMLContent(t testing.T) { d, err := Analyzed(json.RawMessage([]byte(YAMLSpec)), "") require.NoError(t, err) require.NotNil(t, d) sw := d.Spec() assert.Equal(t, "1.0.0", sw.Info.Version) } // for issue 11 func TestRegressionExpand(t testing.T) { swaggerFile := "fixtures/yaml/swagger/1/2/3/4/swagger.yaml" document, err := Spec(swaggerFile) require.NoError(t, err) require.NotNil(t, document) d, err := document.Expanded() require.NoError(t, err) require.NotNil(t, d) b, _ := d.Spec().MarshalJSON() assert.JSONEq(t, expectedExpanded, string(b)) } func TestCascadingRefExpand(t testing.T) { swaggerFile := "fixtures/yaml/swagger/spec.yml" document, err := Spec(swaggerFile) require.NoError(t, err) require.NotNil(t, document) d, err := document.Expanded() require.NoError(t, err) require.NotNil(t, d) b, _ := d.Spec().MarshalJSON() assert.JSONEq(t, cascadeRefExpanded, string(b)) } func TestFailsInvalidJSON(t testing.T) { _, err := Analyzed(json.RawMessage([]byte("{]")), "") require.Error(t, err) } // issue go-swagger/go-swagger#1816 (regression when cloning original spec) func TestIssue1846(t testing.T) { swaggerFile := "fixtures/bugs/1816/fixture-1816.yaml" document, err := Spec(swaggerFile) require.NoError(t, err) require.NotNil(t, document) sp, err := cloneSpec(document.Spec()) require.NoError(t, err) jazon, _ := json.MarshalIndent(sp, "", " ") rex := regexp.MustCompile(`"\$ref":\s"(.+)"`) m := rex.FindAllStringSubmatch(string(jazon), -1) require.NotNil(t, m) for _, matched := range m { subMatch := matched[1] require.Truef(t, strings.HasPrefix(subMatch, "#/definitions") \|\| strings.HasPrefix(subMatch, "#/responses"), "expected $ref to point either to definitions or responses section, got: %s", matched[0]) } } func TestEmbedded(t testing.T) { swaggerFile := "fixtures/yaml/swagger/spec.yml" document, err := Spec(swaggerFile) require.NoError(t, err) require.NotNil(t, document) raw, err := json.Marshal(document.Raw()) require.NoError(t, err) spc, err := json.Marshal(document.Spec()) require.NoError(t, err) d, err := Embedded(raw, spc) require.NoError(t, err) require.NotNil(t, d) rawEmbedded, err := json.Marshal(d.Raw()) require.NoError(t, err) spcEmbedded, err := json.Marshal(d.Spec()) require.NoError(t, err) assert.JSONEq(t, string(raw), string(rawEmbedded)) assert.JSONEq(t, string(spc), string(spcEmbedded)) } func TestDocument(t testing.T) { document, err := Embedded(PetStoreJSONMessage, PetStoreJSONMessage) require.NoError(t, err) require.Equal(t, "petstore.swagger.wordnik.com", document.Host()) orig, err := json.Marshal(document.OrigSpec()) require.NoError(t, err) require.JSONEq(t, string(PetStoreJSONMessage), string(orig)) cloned, err := json.Marshal(document.Pristine().Spec()) require.NoError(t, err) require.JSONEq(t, string(PetStoreJSONMessage), string(cloned)) spc := document.Spec() spc.Definitions = nil before := document.Spec() require.Empty(t, before.Definitions) reset := document.ResetDefinitions() afterReset, err := json.Marshal(reset.Spec()) require.NoError(t, err) require.JSONEq(t, string(PetStoreJSONMessage), string(afterReset)) } func BenchmarkAnalyzed(b testing.B) { d := []byte(`{ "swagger": "2.0", "info": { "version": "1.0.0", "title": "Swagger Petstore", "contact": { "name": "Wordnik API Team", "url": "http://developer.wordnik.com" }, "license": { "name": "Creative Commons 4.0 International", "url": "http://creativecommons.org/licenses/by/4.0/" } }, "host": "petstore.swagger.wordnik.com", "basePath": "/api", "schemes": [ "http" ], "paths": { "/pets": { "get": { "security": [ { "basic": [] } ], "tags": [ "Pet Operations" ], "operationId": "getAllPets", "parameters": [ { "name": "status", "in": "query", "description": "The status to filter by", "type": "string" }, { "name": "limit", "in": "query", "description": "The maximum number of results to return", "type": "integer", "format": "int64" } ], "summary": "Finds all pets in the system", "responses": { "200": { "description": "Pet response", "schema": { "type": "array", "items": { "$ref": "#/definitions/Pet" } } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "post": { "security": [ { "basic": [] } ], "tags": [ "Pet Operations" ], "operationId": "createPet", "summary": "Creates a new pet", "consumes": ["application/x-yaml"], "produces": ["application/x-yaml"], "parameters": [ { "name": "pet", "in": "body", "description": "The Pet to create", "required": true, "schema": { "$ref": "#/definitions/newPet" } } ], "responses": { "200": { "description": "Created Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } } }`) for i := 0; i < 1000; i++ { d = append(d, []byte(`, "/pets/`)...) d = strconv.AppendInt(d, int64(i), 10) d = append(d, []byte(`": { "delete": { "security": [ { "apiKey": [] } ], "description": "Deletes the Pet by id", "operationId": "deletePet", "parameters": [ { "name": "id", "in": "path", "description": "ID of pet to delete", "required": true, "type": "integer", "format": "int64" } ], "responses": { "204": { "description": "pet deleted" }, "default": { "description": "unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "get": { "tags": [ "Pet Operations" ], "operationId": "getPetById", "summary": "Finds the pet by id", "responses": { "200": { "description": "Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "parameters": [ { "name": "id", "in": "path", "description": "ID of pet", "required": true, "type": "integer", "format": "int64" } ] }`)...) } d = append(d, []byte(` }, "definitions": { "Category": { "id": "Category", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Pet": { "id": "Pet", "properties": { "category": { "$ref": "#/definitions/Category" }, "id": { "description": "unique identifier for the pet", "format": "int64", "maximum": 100.0, "minimum": 0.0, "type": "integer" }, "name": { "type": "string" }, "photoUrls": { "items": { "type": "string" }, "type": "array" }, "status": { "description": "pet status in the store", "enum": [ "available", "pending", "sold" ], "type": "string" }, "tags": { "items": { "$ref": "#/definitions/Tag" }, "type": "array" } }, "required": [ "id", "name" ] }, "newPet": { "anyOf": [ { "$ref": "#/definitions/Pet" }, { "required": [ "name" ] } ] }, "Tag": { "id": "Tag", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Error": { "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } } }, "consumes": [ "application/json", "application/xml" ], "produces": [ "application/json", "application/xml", "text/plain", "text/html" ], "securityDefinitions": { "basic": { "type": "basic" }, "apiKey": { "type": "apiKey", "in": "header", "name": "X-API-KEY" } } } `)...) rm := json.RawMessage(d) b.ResetTimer() for i := 0; i < b.N; i++ { _, err := Analyzed(rm, "") if err != nil { b.Fatal(err) } } } const YAMLSpec = `swagger: '2.0' info: version: "1.0.0" title: Simple Search API description: \| A very simple api description that makes a x-www-form-urlencoded only API to submit searches. produces: - application/json consumes: - application/json paths: /search: post: operationId: search summary: searches tasks description: searches the task titles and descriptions for a match consumes: - application/x-www-form-urlencoded parameters: - name: q in: formData type: string description: the search string required: true /tasks: get: operationId: getTasks summary: Gets Task objects. description: \| Optional query param of size* determines size of returned array tags: - tasks parameters: - name: size in: query description: Size of task list type: integer format: int32 default: 20 - name: completed in: query description: when true shows completed tasks type: boolean responses: default: description: Generic Error 200: description: Successful response headers: X-Rate-Limit: type: integer format: int32 X-Rate-Limit-Remaining: type: integer format: int32 default: 42 X-Rate-Limit-Reset: type: integer format: int32 default: "1449875311" X-Rate-Limit-Reset-Human: type: string default: 3 days X-Rate-Limit-Reset-Human-Number: type: string default: 3 Access-Control-Allow-Origin: type: string default: "" schema: type: array items: $ref: "#/definitions/Task" post: operationId: createTask summary: Creates a 'Task' object. description: \| Validates the content property for length etc. parameters: - name: body in: body schema: $ref: "#/definitions/Task" tags: - tasks responses: default: description: Generic Error 201: description: Task Created /tasks/{id}: parameters: - name: id in: path type: integer format: int32 description: The id of the task required: true minimum: 1 put: operationId: updateTask summary: updates a task. description: \| Validates the content property for length etc. tags: - tasks parameters: - name: body in: body description: the updated task schema: $ref: "#/definitions/Task" responses: default: description: Generic Error 200: description: Task updated schema: $ref: "#/definitions/Task" delete: operationId: deleteTask summary: deletes a task description: \| Deleting a task is irrevocable. tags: - tasks responses: default: description: Generic Error 204: description: Task Deleted definitions: Task: title: A Task object description: \| This describes a task. Tasks require a content property to be set. required: - content type: object properties: id: title: the unique id of the task description: \| This id property is autogenerated when a task is created. type: integer format: int64 readOnly: true content: title: The content of the task description: \| Task content can contain [GFM](https://help.github.com/articles/github-flavored-markdown/). type: string minLength: 5 completed: title: when true this task is completed type: boolean creditcard: title: the credit card format usage type: string format: creditcard createdAt: title: task creation time type: string format: date-time readOnly: true ` // PetStoreJSONMessage json raw message for Petstore20 var PetStoreJSONMessage = json.RawMessage([]byte(PetStore20)) // PetStore20 json doc for swagger 2.0 pet store const PetStore20 = `{ "swagger": "2.0", "info": { "version": "1.0.0", "title": "Swagger Petstore", "contact": { "name": "Wordnik API Team", "url": "http://developer.wordnik.com" }, "license": { "name": "Creative Commons 4.0 International", "url": "http://creativecommons.org/licenses/by/4.0/" } }, "host": "petstore.swagger.wordnik.com", "basePath": "/api", "schemes": [ "http" ], "paths": { "/pets": { "get": { "security": [ { "basic": [] } ], "tags": [ "Pet Operations" ], "operationId": "getAllPets", "parameters": [ { "name": "status", "in": "query", "description": "The status to filter by", "type": "string" }, { "name": "limit", "in": "query", "description": "The maximum number of results to return", "type": "integer", "format": "int64" } ], "summary": "Finds all pets in the system", "responses": { "200": { "description": "Pet response", "schema": { "type": "array", "items": { "$ref": "#/definitions/Pet" } } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "post": { "security": [ { "basic": [] } ], "tags": [ "Pet Operations" ], "operationId": "createPet", "summary": "Creates a new pet", "consumes": ["application/x-yaml"], "produces": ["application/x-yaml"], "parameters": [ { "name": "pet", "in": "body", "description": "The Pet to create", "required": true, "schema": { "$ref": "#/definitions/newPet" } } ], "responses": { "200": { "description": "Created Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } } }, "/pets/{id}": { "delete": { "security": [ { "apiKey": [] } ], "description": "Deletes the Pet by id", "operationId": "deletePet", "parameters": [ { "name": "id", "in": "path", "description": "ID of pet to delete", "required": true, "type": "integer", "format": "int64" } ], "responses": { "204": { "description": "pet deleted" }, "default": { "description": "unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "get": { "tags": [ "Pet Operations" ], "operationId": "getPetById", "summary": "Finds the pet by id", "responses": { "200": { "description": "Pet response", "schema": { "$ref": "#/definitions/Pet" } }, "default": { "description": "Unexpected error", "schema": { "$ref": "#/definitions/Error" } } } }, "parameters": [ { "name": "id", "in": "path", "description": "ID of pet", "required": true, "type": "integer", "format": "int64" } ] } }, "definitions": { "Category": { "id": "Category", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Pet": { "id": "Pet", "properties": { "category": { "$ref": "#/definitions/Category" }, "id": { "description": "unique identifier for the pet", "format": "int64", "maximum": 100.0, "minimum": 0.0, "type": "integer" }, "name": { "type": "string" }, "photoUrls": { "items": { "type": "string" }, "type": "array" }, "status": { "description": "pet status in the store", "enum": [ "available", "pending", "sold" ], "type": "string" }, "tags": { "items": { "$ref": "#/definitions/Tag" }, "type": "array" } }, "required": [ "id", "name" ] }, "newPet": { "anyOf": [ { "$ref": "#/definitions/Pet" }, { "required": [ "name" ] } ] }, "Tag": { "id": "Tag", "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } } }, "Error": { "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } } }, "consumes": [ "application/json", "application/xml" ], "produces": [ "application/json", "application/xml", "text/plain", "text/html" ], "securityDefinitions": { "basic": { "type": "basic" }, "apiKey": { "type": "apiKey", "in": "header", "name": "X-API-KEY" } } } ` const expectedExpanded = ` { "produces":[ "application/json", "plain/text" ], "schemes":[ "https", "http" ], "swagger":"2.0", "info":{ "description":"Something", "title":"Something", "contact":{ "name":"Somebody", "url":"https://url.com", "email":"email@url.com" }, "version":"v1" }, "host":"security.sonusnet.com", "basePath":"/api", "paths":{ "/whatnot":{ "get":{ "description":"Get something", "responses":{ "200":{ "description":"The something", "schema":{ "description":"A collection of service events", "type":"object", "properties":{ "page":{ "description":"A description of a paged result", "type":"object", "properties":{ "page":{ "description":"the page that was requested", "type":"integer" }, "page_items":{ "description":"the number of items per page requested", "type":"integer" }, "pages":{ "description":"the total number of pages available", "type":"integer" }, "total_items":{ "description":"the total number of items available", "type":"integer", "format":"int64" } } }, "something":{ "description":"Something", "type":"object", "properties":{ "p1":{ "description":"A string", "type":"string" }, "p2":{ "description":"An integer", "type":"integer" } } } } } }, "500":{ "description":"Oops" } } } } }, "definitions":{ "Something":{ "description":"A collection of service events", "type":"object", "properties":{ "page":{ "description":"A description of a paged result", "type":"object", "properties":{ "page":{ "description":"the page that was requested", "type":"integer" }, "page_items":{ "description":"the number of items per page requested", "type":"integer" }, "pages":{ "description":"the total number of pages available", "type":"integer" }, "total_items":{ "description":"the total number of items available", "type":"integer", "format":"int64" } } }, "something":{ "description":"Something", "type":"object", "properties":{ "p1":{ "description":"A string", "type":"string" }, "p2":{ "description":"An integer", "type":"integer" } } } } } } } ` const cascadeRefExpanded = ` { "swagger": "2.0", "consumes":[ "application/json" ], "produces":[ "application/json" ], "schemes":[ "http" ], "host": "api.example.com", "info":{ "description":"recursively following JSON references", "title":"test 1", "contact":{ "name":"Fred" }, "version":"0.1.1" }, "paths":{ "/getAll":{ "get":{ "operationId":"getAll", "parameters":[ { "description":"max number of results", "name":"a", "in":"body", "schema":{ "type":"string" } } ], "responses":{ "200":{ "description":"Success", "schema":{ "type":"array", "items":{ "type":"string" } } } } } } }, "definitions":{ "a":{ "type":"string" }, "b":{ "type":"array", "items":{ "type":"string" } } } } ` func TestSpecCircular(t testing.T) { swaggerFile := "fixtures/json/resources/pathLoaderIssue.json" document, err := Spec(swaggerFile) require.NoError(t, err) require.NotNil(t, document) } func TestIssueSpec145(t testing.T) { t.Run("with remote $ref", func(t testing.T) { docPath := filepath.Join("fixtures", "bugs", "145", "Program Files (x86)", "AppName", "todos.json") t.Run("with Spec loader", func(t testing.T) { document, err := Spec(docPath) require.NoError(t, err) require.NotNil(t, document) _, err = document.Expanded() require.NoError(t, err) }) t.Run("with JSONSpec loader", func(t testing.T) { document, err := JSONSpec(docPath) require.NoError(t, err) require.NotNil(t, document) _, err = document.Expanded() require.NoError(t, err) }) }) t.Run("with self-contained root", func(t testing.T) { docPath := filepath.Join("fixtures", "bugs", "145", "Program Files (x86)", "AppName", "todos-expanded.json") t.Run("with Spec loader", func(t testing.T) { document, err := Spec(docPath) require.NoError(t, err) require.NotNil(t, document) require.Equal(t, docPath, document.SpecFilePath()) expanded, err := document.Expanded() require.NoError(t, err) require.Equal(t, docPath, expanded.SpecFilePath()) }) t.Run("with JSONSpec loader", func(t testing.T) { document, err := JSONSpec(docPath) require.NoError(t, err) require.NotNil(t, document) _, err = document.Expanded() require.NoError(t, err) t.Run("with Pristine", func(t testing.T) { pristine := document.Pristine() require.Equal(t, document.SpecFilePath(), pristine.SpecFilePath()) }) }) }) }	27.81 KB	2025-05-25 12:27

Edit File:

Terminal