Add an option for placing the docs/docs.go file

[john8329]

Problem statement

When generating the documentation with swag init, there is no option to place the generated docs folder differently. I'm trying to separate the documentation generation code from the application code.

At the moment the folder is always placed in the directory specified with the d flag, which is the analysed one. I'm aiming to have a src/ folder with the program code and a docs/ folder with the documentation and swagger code.

Please tell me if more explanations are needed, thanks

Environment

swagger version: 1.4.0

[fredbi]

Could you please mention your full command line?

[john8329]

Sure, I use a script to try to decouple stuff from the source.

#!/usr/bin/env bash
SCRIPTPATH="$( cd "$(dirname "$0")" ; pwd -P )"

APIPATH="../../src/admin-api"
INITFILE="admin-api.go"

cd "$SCRIPTPATH"

cd admin-api
swag init -g "$APIPATH/$INITFILE"  -d "$APIPATH" -s swagger/ || exit 1
mv "$APIPATH/docs/docs.go" docs/docs.go
rmdir "$APIPATH/docs/"

go build -o bin/admin-api-docs || exit 1

[fredbi]

You are probably referring to the swaggo/swag CLI tool. In this case, this is not the right place to report errors.

[john8329]

I'm sorry, I'll delete this

[john8329]

(guess what, I can't delete this issue. Feel free to do it, thanks)