[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#972071: ITP: openapi-specification -- community-driven open specification within the OpenAPI Initiative



Package: wnpp
Owner: Andrius Merkys <merkys@debian.org>
Severity: wishlist

* Package name    : openapi-specification
  Version         : 3.0.3
  Upstream Author : OpenAPI Initiative TSC <tsc@openapis.org>
* URL             : https://www.openapis.org
* License         : Apache-2.0
  Programming Lang: none
  Description     : community-driven open specification within the
OpenAPI Initiative

The OpenAPI Specification (OAS) defines a standard, programming
language-agnostic interface description for REST APIs, which allows both
humans and computers to discover and understand the capabilities of a
service without requiring access to source code, additional
documentation, or inspection of network traffic. When properly defined
via OpenAPI, a consumer can understand and interact with the remote
service with a minimal amount of implementation logic. Similar to what
interface descriptions have done for lower-level programming, the
OpenAPI Specification removes guesswork in calling a service.

The OpenAPI Specification files are already present in the Debian
archive [1][2] as embedded copies inside other packages, but it would be
nice to exclude these convenience copies in favor of proper package.
Especially when upstream provides backwards-compatible infrastructure
containing all versions of the specification until the latest.

[1]
https://codesearch.debian.net/search?q=A+JSON+Schema+for+Swagger+2.0+API&literal=1
[2]
https://codesearch.debian.net/search?q=Validation+schema+for+OpenAPI+Specification+3.0.X.&literal=1

Remark: This package is to be maintained at
   https://salsa.debian.org/debian/openapi-specification


Reply to: