Skip routes w/ no Swagger Spec comment about play-swagger

[Javakky-pxv]

@nVitius
Perhaps the following features might be available.

How to hide an endpoint?

If you don't want an end point to be included, add ### NoDocs ### in front of it e.g.

### NoDocs ###
GET   /docs/swagger-ui/*file        controllers.Assets.at(path:String="/public/lib/swagger-ui", file:String)

Skip entire file

The entire file can be skipped by adding ### SkipFileForDocs ### at the beginning of the routes file.

Alternatively, the routes file can be split into multiple files, so that you can skip practically only a part of the file.

https://www.playframework.com/documentation/ja/2.4.x/SBTSubProjects

### SkipFileForDocs ###

GET      /api/hidden/a                 controllers.hiddenEndPointA()
GET      /api/hidden/b                 controllers.hiddenEndPointB()
GET      /api/hidden/c                 controllers.hiddenEndPointC()

It may also be possible to create a feature here to skip blank comments in the SwaggerSpecGenerator.

play-swagger/core/src/main/scala/com/iheart/playSwagger/SwaggerSpecGenerator.scala

Lines 416 to 430 in 5ea8f16

	private def endPointEntry(route: Route, prefix: String, tag: Option[String]): Option[(String, JsObject)] = {
	import SwaggerSpecGenerator.marker
	val comments = route.comments.map(_.comment).mkString("\n")
	if (s"$marker\\s*NoDocs\\s*$marker".r.findFirstIn(comments).isDefined) {
	None
	} else {
	val inRoutePath = route.path.parts.map {
	case DynamicPart(name, _, _) => s"{$name}"
	case StaticPart(value) => value
	}.mkString
	val method = route.verb.value.toLowerCase
	Some(fullPath(prefix, inRoutePath) -> Json.obj(method -> endPointSpec(route, tag)))
	}
	}

Sorry for the brief answer, but if you have any questions, please feel free to ask again.