در گولنگ می‌توان به دو صورت تک خطی یا چند خطی, درون کد, کامنت (comment) گذاشت.

package main

// one line comment
func main() {
    /*
        multiline
        comment
    */
}

کامنت ها معمولا توضیحاتی در مورد کد هستند که برای برنامه نویس ها نوشته می‌شوند. در گولنگ یکسری دستورات خاص برای نوشتن کامنت وجود دارند که قابلیت هایی را درون خط فرمان Go فعال می‌کنند. یکی از این دستورات ‍go:generate است که با استفاده از آن میتوان یک دستور خط فرمان را درون کد به صورت کامنت نوشت و سپس با استفاده از دستور go generate اجرا کرد.

package main

import "log"

//go:generate echo "This is a message from go generate"
func main() {
    log.Println("Hello world!")
}

در کد بالا کامنت خود را با go:generate شروع کردیم و سپس یک دستور echo را قرار دادیم. در صورتی که دستور go generate را درون پوشه ای که فایل بالا قرار دارد اجرا کنیم متن This is a message from generate درون صفحه چاپ می‌شود.

به‌صورت کلی go:generate این امکان را فراهم می‌کند که مجموعه‌ای از دستورات موردنیاز برای خودکارسازی کارها مانند تولید کد، ساخت فایل‌های کمکی، اجرای ابزارهای جانبی را مستقیماً درون سورس‌کد تعریف کنیم. این دستورات به شکل کامنت‌های ویژه در کد قرار می‌گیرند و سپس با اجرای دستورgo generate در خط فرمان، همگی به‌صورت یکپارچه اجرا می‌شوند. 

به این ترتیب، فرآیندهایی که وابسته به کد هستند در کنار همان کد مستندسازی و نگهداری می‌شوند و وابستگی آن‌ها شفاف‌تر می‌شود. در واقع، کاری که go generate انجام می‌دهد ذاتاً متفاوت از ابزارهایی مانند Make یا Taskfile نیست و می‌توان همان عملیات را با آن‌ها نیز پیاده‌سازی کرد. اما مزیت مهم go generate این است که بخشی از ابزار رسمی زبان Go محسوب می‌شود؛ بنابراین در هر محیطی که Go نصب باشد، دستور go نیز در دسترس است و نیازی به نصب، تنظیمات یا وابستگی اضافی به ابزارهای جانبی نخواهیم داشت. این موضوع باعث می‌شود فرآیند تولید کد ساده‌تر، قابل‌حمل‌تر و هماهنگ‌تر با اکوسیستم Go باشد.

قابلیت go generate اولین بار در فوریه 2015 و همراه با انتشار Go 1.4 معرفی شد. از آن زمان تاکنون، این دستور به‌عنوان بخشی رسمی از ابزار خط فرمان go در تمام نسخه‌های بعدی وجود دارد و نیاز به نصب جداگانه‌ای ندارد.

در ادامه با استفاده از go:generate فایل های openapi رو برای کد گولنگی خودمون تولید میکنیم.

تولید فایل‌های openapi/swagger برای کد گولنگ

در اینجا به صورت خلاصه توضیح میدیم چطور go:generate به ما کمک میکنه تا مستندات openapi رو تولید کنیم و کدمون رو باهاش ادغام کنیم.

برای ادغام با openapi ابتدا ابزار swag را به صورت زیر نصب می‌کنیم:

go get -u -tool github.com/swaggo/swag/cmd/swag@latest