Giter Club home page Giter Club logo

homebrew-go-swagger's Introduction

Swagger 2.0 Run CI codecovGo Report Card

GitHub version Docker Repository on Quay Docker Repository on Github GitHub commits since latest release

Slack Status license GoDoc

Open SSF Scorecard FOSSA Status


This project contains a golang implementation of Swagger 2.0 (aka OpenAPI 2.0). It provide tools to work with swagger specifications.

Swagger is a simple yet powerful representation of your RESTful API.

Documentation

https://goswagger.io

Features

go-swagger brings to the go community a complete suite of fully-featured, high-performance, API components to work with a Swagger API: server, client and data model.

  • Generates a server from a swagger specification
  • Generates a client from a swagger specification
  • Generates a CLI (command line tool) from a swagger specification (alpha stage)
  • Supports most features offered by jsonschema and swagger, including polymorphism
  • Generates a swagger specification from annotated go code
  • Additional tools to work with a swagger spec
  • Great customization features, with vendor extensions and customizable templates

Our focus with code generation is to produce idiomatic, fast go code, which plays nice with golint, go vet etc.

More details.

Project status

This project supports OpenAPI 2.0. At this moment it does not support OpenAPI 3.x.

go-swagger is now feature complete and has stabilized its API.

Most features and building blocks are now in a stable state, with a rich set of CI tests.

The go-openapi community actively continues bringing fixes and enhancements to this code base.

There is still much room for improvement: contributors and PR's are welcome. You may also get in touch with maintainers on our slack channel.

Installing

go install github.com/go-swagger/go-swagger/cmd/swagger@latest

go-swagger is also available as binary or docker releases as well as from source: more details.

Try it

Try go-swagger in a free online workspace using Gitpod:

Open in Gitpod

Licensing

The toolkit itself is licensed under an Apache Software License 2.0.

Just like swagger, this does not cover code generated by the toolkit. That code is entirely yours to license however you see fit.

Licence scan on dependencies

FOSSA Status

homebrew-go-swagger's People

Contributors

bir avatar casualjim avatar rafee avatar rcousineau-xandr avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

homebrew-go-swagger's Issues

Invalid homebrew url for version 0.7.4

https://github.com/go-swagger/homebrew-go-swagger/blob/master/go-swagger.rb#L4

The url points to old 0.7.3 release and therefore install fails with:

$ brew install go-swagger
==> Installing go-swagger from go-swagger/go-swagger
==> Downloading https://github.com/go-swagger/go-swagger/releases/download/0.7.3/swagger_darwin_amd64
==> Downloading from https://github-cloud.s3.amazonaws.com/releases/26726495/3013727a-96ba-11e6-95a2-caa786bbe5ec?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAISTNZFOVBIJMK
######################################################################## 100.0%
Error: SHA256 mismatch
Expected: 0a16f15fd4de30c9f538d32bb0b2d935314b02b9dc398008a7f02688c0501bcb
Actual: 3b35afac723bf81bec76bae8cd0f6a23c244623a2821dbdb3e680400f99568fc
Archive: /Users/jbub/Library/Caches/Homebrew/go-swagger-0.7.4
To retry an incomplete download, remove the file above.

Update: Seems this PR fixes it #1

Making it official

When I couldn't find go-swagger in brew search I was about to see what it takes to package it, and then discovered this repo after asking Google. Are there any obstacles that prevent the formula from getting into the main Homebrew repo?

Doesn't support linuxbrew

I tried to use this with linuxbrew. It downloads the Mac binary which doesn't work for obvious reasons.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.