OXIESEC PANEL

Name	Size	Modified	Perms	Actions
📁 ..	-	12/05/2024 09:52:20 PM	rwxr-xr-x
📄 .editorconfig	539 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📁 .github	-	12/05/2024 09:52:20 PM	r-xr-xr-x
📄 .gitignore	6 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 .golangci.yml	952 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 CODE_OF_CONDUCT.md	3.16 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 LICENSE	11.09 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 README.md	1.99 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 auth_test.go	4.58 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 cache.go	2.51 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 cache_test.go	676 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 circular_test.go	9.75 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 contact_info.go	1.57 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 contact_info_test.go	1.44 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 debug.go	1.27 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 debug_test.go	1.28 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 embed.go	348 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 errors.go	902 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 expander.go	17.16 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 expander_test.go	42.55 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 external_docs.go	918 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 external_docs_test.go	1.04 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📁 fixtures	-	12/05/2024 09:52:20 PM	r-xr-xr-x
📄 go.mod	446 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 go.sum	1.97 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 header.go	4.94 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 header_test.go	4.36 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 helpers_spec_test.go	3.96 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 helpers_test.go	4.85 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 info.go	4.62 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 info_test.go	2.39 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 items.go	5.75 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 items_test.go	4.51 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 license.go	1.48 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 license_test.go	1.34 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 normalizer.go	6.24 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 normalizer_nonwindows.go	1.19 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 normalizer_test.go	17.95 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 normalizer_windows.go	5.15 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 operation.go	10.84 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 operation_test.go	9.47 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 parameter.go	10.38 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 parameters_test.go	4.76 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 path_item.go	2.6 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 path_item_test.go	2.45 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 paths.go	2.57 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 paths_test.go	1.2 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 properties.go	2.35 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 properties_test.go	2.05 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 ref.go	4.17 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 ref_test.go	1.15 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 resolver.go	3.75 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 resolver_test.go	12.75 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 response.go	4.17 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 response_test.go	2.85 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 responses.go	3.91 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 responses_test.go	3.18 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 schema.go	18.14 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 schema_loader.go	8.86 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 schema_loader_test.go	873 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 schema_test.go	6.64 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📁 schemas	-	12/05/2024 09:52:20 PM	r-xr-xr-x
📄 security_scheme.go	5.71 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 spec.go	2.16 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 spec_test.go	13.99 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 structs_test.go	3.88 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 swagger.go	11.8 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 swagger_test.go	11.12 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 tag.go	2.24 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 url_go19.go	158 bytes	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 validations.go	7.12 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 validations_test.go	2.95 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 xml_object.go	1.93 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete
📄 xml_object_test.go	1.93 KB	12/05/2024 09:52:20 PM	r--r--r--	Delete

Editing: operation.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 spec

import (
	"bytes"
	"encoding/gob"
	"encoding/json"
	"sort"

"github.com/go-openapi/jsonpointer"
	"github.com/go-openapi/swag"
)

func init() {
	gob.Register(map[string]interface{}{})
	gob.Register([]interface{}{})
}

// OperationProps describes an operation
//
// NOTES:
// - schemes, when present must be from [http, https, ws, wss]: see validate
// - Security is handled as a special case: see MarshalJSON function
type OperationProps struct {
	Description  string                 `json:"description,omitempty"`
	Consumes     []string               `json:"consumes,omitempty"`
	Produces     []string               `json:"produces,omitempty"`
	Schemes      []string               `json:"schemes,omitempty"`
	Tags         []string               `json:"tags,omitempty"`
	Summary      string                 `json:"summary,omitempty"`
	ExternalDocs *ExternalDocumentation `json:"externalDocs,omitempty"`
	ID           string                 `json:"operationId,omitempty"`
	Deprecated   bool                   `json:"deprecated,omitempty"`
	Security     []map[string][]string  `json:"security,omitempty"`
	Parameters   []Parameter            `json:"parameters,omitempty"`
	Responses    *Responses             `json:"responses,omitempty"`
}

// MarshalJSON takes care of serializing operation properties to JSON
//
// We use a custom marhaller here to handle a special cases related to
// the Security field. We need to preserve zero length slice
// while omitting the field when the value is nil/unset.
func (op OperationProps) MarshalJSON() ([]byte, error) {
	type Alias OperationProps
	if op.Security == nil {
		return json.Marshal(&struct {
			Security []map[string][]string `json:"security,omitempty"`
			*Alias
		}{
			Security: op.Security,
			Alias:    (*Alias)(&op),
		})
	}
	return json.Marshal(&struct {
		Security []map[string][]string `json:"security"`
		*Alias
	}{
		Security: op.Security,
		Alias:    (*Alias)(&op),
	})
}

// Operation describes a single API operation on a path.
//
// For more information: http://goo.gl/8us55a#operationObject
type Operation struct {
	VendorExtensible
	OperationProps
}

// SuccessResponse gets a success response model
func (o *Operation) SuccessResponse() (*Response, int, bool) {
	if o.Responses == nil {
		return nil, 0, false
	}

responseCodes := make([]int, 0, len(o.Responses.StatusCodeResponses))
	for k := range o.Responses.StatusCodeResponses {
		if k >= 200 && k < 300 {
			responseCodes = append(responseCodes, k)
		}
	}
	if len(responseCodes) > 0 {
		sort.Ints(responseCodes)
		v := o.Responses.StatusCodeResponses[responseCodes[0]]
		return &v, responseCodes[0], true
	}

return o.Responses.Default, 0, false
}

// JSONLookup look up a value by the json property name
func (o Operation) JSONLookup(token string) (interface{}, error) {
	if ex, ok := o.Extensions[token]; ok {
		return &ex, nil
	}
	r, _, err := jsonpointer.GetForToken(o.OperationProps, token)
	return r, err
}

// UnmarshalJSON hydrates this items instance with the data from JSON
func (o *Operation) UnmarshalJSON(data []byte) error {
	if err := json.Unmarshal(data, &o.OperationProps); err != nil {
		return err
	}
	return json.Unmarshal(data, &o.VendorExtensible)
}

// MarshalJSON converts this items object to JSON
func (o Operation) MarshalJSON() ([]byte, error) {
	b1, err := json.Marshal(o.OperationProps)
	if err != nil {
		return nil, err
	}
	b2, err := json.Marshal(o.VendorExtensible)
	if err != nil {
		return nil, err
	}
	concated := swag.ConcatJSON(b1, b2)
	return concated, nil
}

// NewOperation creates a new operation instance.
// It expects an ID as parameter but not passing an ID is also valid.
func NewOperation(id string) *Operation {
	op := new(Operation)
	op.ID = id
	return op
}

// WithID sets the ID property on this operation, allows for chaining.
func (o *Operation) WithID(id string) *Operation {
	o.ID = id
	return o
}

// WithDescription sets the description on this operation, allows for chaining
func (o *Operation) WithDescription(description string) *Operation {
	o.Description = description
	return o
}

// WithSummary sets the summary on this operation, allows for chaining
func (o *Operation) WithSummary(summary string) *Operation {
	o.Summary = summary
	return o
}

// WithExternalDocs sets/removes the external docs for/from this operation.
// When you pass empty strings as params the external documents will be removed.
// When you pass non-empty string as one value then those values will be used on the external docs object.
// So when you pass a non-empty description, you should also pass the url and vice versa.
func (o *Operation) WithExternalDocs(description, url string) *Operation {
	if description == "" && url == "" {
		o.ExternalDocs = nil
		return o
	}

if o.ExternalDocs == nil {
		o.ExternalDocs = &ExternalDocumentation{}
	}
	o.ExternalDocs.Description = description
	o.ExternalDocs.URL = url
	return o
}

// Deprecate marks the operation as deprecated
func (o *Operation) Deprecate() *Operation {
	o.Deprecated = true
	return o
}

// Undeprecate marks the operation as not deprected
func (o *Operation) Undeprecate() *Operation {
	o.Deprecated = false
	return o
}

// WithConsumes adds media types for incoming body values
func (o *Operation) WithConsumes(mediaTypes ...string) *Operation {
	o.Consumes = append(o.Consumes, mediaTypes...)
	return o
}

// WithProduces adds media types for outgoing body values
func (o *Operation) WithProduces(mediaTypes ...string) *Operation {
	o.Produces = append(o.Produces, mediaTypes...)
	return o
}

// WithTags adds tags for this operation
func (o *Operation) WithTags(tags ...string) *Operation {
	o.Tags = append(o.Tags, tags...)
	return o
}

// AddParam adds a parameter to this operation, when a parameter for that location
// and with that name already exists it will be replaced
func (o *Operation) AddParam(param *Parameter) *Operation {
	if param == nil {
		return o
	}

for i, p := range o.Parameters {
		if p.Name == param.Name && p.In == param.In {
			params := make([]Parameter, 0, len(o.Parameters)+1)
			params = append(params, o.Parameters[:i]...)
			params = append(params, *param)
			params = append(params, o.Parameters[i+1:]...)
			o.Parameters = params

return o
		}
	}

o.Parameters = append(o.Parameters, *param)
	return o
}

// RemoveParam removes a parameter from the operation
func (o *Operation) RemoveParam(name, in string) *Operation {
	for i, p := range o.Parameters {
		if p.Name == name && p.In == in {
			o.Parameters = append(o.Parameters[:i], o.Parameters[i+1:]...)
			return o
		}
	}
	return o
}

// SecuredWith adds a security scope to this operation.
func (o *Operation) SecuredWith(name string, scopes ...string) *Operation {
	o.Security = append(o.Security, map[string][]string{name: scopes})
	return o
}

// WithDefaultResponse adds a default response to the operation.
// Passing a nil value will remove the response
func (o *Operation) WithDefaultResponse(response *Response) *Operation {
	return o.RespondsWith(0, response)
}

// RespondsWith adds a status code response to the operation.
// When the code is 0 the value of the response will be used as default response value.
// When the value of the response is nil it will be removed from the operation
func (o *Operation) RespondsWith(code int, response *Response) *Operation {
	if o.Responses == nil {
		o.Responses = new(Responses)
	}
	if code == 0 {
		o.Responses.Default = response
		return o
	}
	if response == nil {
		delete(o.Responses.StatusCodeResponses, code)
		return o
	}
	if o.Responses.StatusCodeResponses == nil {
		o.Responses.StatusCodeResponses = make(map[int]Response)
	}
	o.Responses.StatusCodeResponses[code] = *response
	return o
}

type opsAlias OperationProps

type gobAlias struct {
	Security []map[string]struct {
		List []string
		Pad  bool
	}
	Alias           *opsAlias
	SecurityIsEmpty bool
}

// GobEncode provides a safe gob encoder for Operation, including empty security requirements
func (o Operation) GobEncode() ([]byte, error) {
	raw := struct {
		Ext   VendorExtensible
		Props OperationProps
	}{
		Ext:   o.VendorExtensible,
		Props: o.OperationProps,
	}
	var b bytes.Buffer
	err := gob.NewEncoder(&b).Encode(raw)
	return b.Bytes(), err
}

// GobDecode provides a safe gob decoder for Operation, including empty security requirements
func (o *Operation) GobDecode(b []byte) error {
	var raw struct {
		Ext   VendorExtensible
		Props OperationProps
	}

buf := bytes.NewBuffer(b)
	err := gob.NewDecoder(buf).Decode(&raw)
	if err != nil {
		return err
	}
	o.VendorExtensible = raw.Ext
	o.OperationProps = raw.Props
	return nil
}

// GobEncode provides a safe gob encoder for Operation, including empty security requirements
func (op OperationProps) GobEncode() ([]byte, error) {
	raw := gobAlias{
		Alias: (*opsAlias)(&op),
	}

var b bytes.Buffer
	if op.Security == nil {
		// nil security requirement
		err := gob.NewEncoder(&b).Encode(raw)
		return b.Bytes(), err
	}

if len(op.Security) == 0 {
		// empty, but non-nil security requirement
		raw.SecurityIsEmpty = true
		raw.Alias.Security = nil
		err := gob.NewEncoder(&b).Encode(raw)
		return b.Bytes(), err
	}

raw.Security = make([]map[string]struct {
		List []string
		Pad  bool
	}, 0, len(op.Security))
	for _, req := range op.Security {
		v := make(map[string]struct {
			List []string
			Pad  bool
		}, len(req))
		for k, val := range req {
			v[k] = struct {
				List []string
				Pad  bool
			}{
				List: val,
			}
		}
		raw.Security = append(raw.Security, v)
	}

err := gob.NewEncoder(&b).Encode(raw)
	return b.Bytes(), err
}

// GobDecode provides a safe gob decoder for Operation, including empty security requirements
func (op *OperationProps) GobDecode(b []byte) error {
	var raw gobAlias

buf := bytes.NewBuffer(b)
	err := gob.NewDecoder(buf).Decode(&raw)
	if err != nil {
		return err
	}
	if raw.Alias == nil {
		return nil
	}

switch {
	case raw.SecurityIsEmpty:
		// empty, but non-nil security requirement
		raw.Alias.Security = []map[string][]string{}
	case len(raw.Alias.Security) == 0:
		// nil security requirement
		raw.Alias.Security = nil
	default:
		raw.Alias.Security = make([]map[string][]string, 0, len(raw.Security))
		for _, req := range raw.Security {
			v := make(map[string][]string, len(req))
			for k, val := range req {
				v[k] = make([]string, 0, len(val.List))
				v[k] = append(v[k], val.List...)
			}
			raw.Alias.Security = append(raw.Alias.Security, v)
		}
	}

*op = *(*OperationProps)(raw.Alias)
	return nil
}