{"id":348,"date":"2024-09-21T09:34:55","date_gmt":"2024-09-21T02:34:55","guid":{"rendered":"https:\/\/gotutorial.org\/?page_id=348"},"modified":"2024-09-21T09:37:35","modified_gmt":"2024-09-21T02:37:35","slug":"go-live-reload-air","status":"publish","type":"page","link":"https:\/\/www.gotutorial.org\/go-tutorial\/go-live-reload-air\/","title":{"rendered":"How to Set up Live Reload for Go Programs using Air"},"content":{"rendered":"\n

Summary<\/strong>: this tutorial will teach you how to use the air utility to set up a live reload for Go programs to boost your productivity and streamline your development workflow<\/p>\n\n\n\n

Step 1<\/strong>. Open your terminal and create a new project directory:<\/p>\n\n\n

mkdir airdemo<\/code><\/span><\/pre>\n\n\n
Step 2<\/strong>. Navigate to the project directory:<\/p>\n\n\n
cd airdemo<\/code><\/span><\/pre>\n\n\n
Step 3<\/strong>. Create main.go file with the following code:<\/p>\n\n\n
package main\n\nimport<\/span> \"fmt\"<\/span>\n\nfunc main() {\n\tfmt.Println(\"Hello, World!\"<\/span>)\n}\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Step 4<\/strong>. Run the go init<\/code> command:<\/p>\n\n\n
go mod init airdemo<\/code><\/span><\/pre>\n\n\n
This will create a go.mod<\/code> file that stores the Go versions and the project’s dependencies.<\/p>\n\n\n\n
Step 5<\/strong>. Install the air utility by running this command from the terminal:<\/p>\n\n\n
go install github.com\/air-verse\/air@latest<\/code><\/span><\/pre>\n\n\n
Step 6<\/strong>. Create the air configuration file:<\/p>\n\n\n
air init<\/code><\/span><\/pre>\n\n\n
This command will create the .air.toml<\/code> file that stores the air configuration parameters. <\/p>\n\n\n\n
A sample .air.toml file on Windows<\/summary>
root = \".\"<\/span>\ntestdata_dir = \"testdata\"<\/span>\ntmp_dir = \"tmp\"<\/span>\n\n[build]\n  args_bin = []\n  bin = \"tmp\\\\main.exe\"<\/span>\n  cmd = \"go build -o .\/tmp\/main.exe .\"<\/span>\n  delay = 1000<\/span>\n  exclude_dir = [\"assets\"<\/span>, \"tmp\"<\/span>, \"vendor\"<\/span>, \"testdata\"<\/span>]\n  exclude_file = []\n  exclude_regex = [\"_test.go\"<\/span>]\n  exclude_unchanged = false<\/span>\n  follow_symlink = false<\/span>\n  full_bin = \"\"<\/span>\n  include_dir = []\n  include_ext = [\"go\"<\/span>, \"tpl\"<\/span>, \"tmpl\"<\/span>, \"html\"<\/span>]\n  include_file = []\n  kill_delay = \"0s\"<\/span>\n  log = \"build-errors.log\"<\/span>\n  poll = false<\/span>\n  poll_interval = 0<\/span>\n  post_cmd = []\n  pre_cmd = []\n  rerun = false<\/span>\n  rerun_delay = 500<\/span>\n  send_interrupt = false<\/span>\n  stop_on_error = false<\/span>\n\n[color]\n  app = \"\"<\/span>\n  build = \"yellow\"<\/span>\n  main = \"magenta\"<\/span>\n  runner = \"green\"<\/span>\n  watcher = \"cyan\"<\/span>\n\n[log]\n  main_only = false<\/span>\n  time = false<\/span>\n\n[misc]\n  clean_on_exit = false<\/span>\n\n[proxy]\n  app_port = 0<\/span>\n  enabled = false<\/span>\n  proxy_port = 0<\/span>\n\n[screen]\n  clear_on_rebuild = false<\/span>\n  keep_scroll = true<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre><\/details>\n\n\n\n
Step 7. Run the air command on your terminal:<\/p>\n\n\n
air<\/code><\/span><\/pre>\n\n\n
The output will look like this:<\/p>\n\n\n
  __    _   ___  \n \/ \/\\  | | | |_) \n\/_\/--\\ |_| |_| \\_ v1.52<\/span>.3<\/span>, built with Go go1.23<\/span>.0<\/span>\n\nwatching .\n!exclude tmp\nbuilding...\nrunning...\nHello, World!\nProcess Exit<\/span> with Code 0<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Step 8. Change the code in the main.go<\/code>, the Air will automatically detect the change and rebuild the program:<\/p>\n\n\n
package main\n\nimport<\/span> \"fmt\"<\/span>\n\nfunc main() {\n\tfmt.Println(\"Hi there!\"<\/span>)\n}\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Air will produce the following output:<\/p>\n\n\n
main.go has changed\nbuilding...\nrunning...\nHi there!\nProcess Exit with<\/span> Code 0<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
<\/p>\n
\n\t
Was this tutorial helpful?<\/div>\n\t
\n\t\t\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t\t Yes <\/span>\n\t\t<\/button>\n\n\t\t\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t\t No <\/span>\n\t\t<\/button>\n\t<\/div>\n\n\t
\n\t\t
\n\t\t\t
<\/div>\n\t\t\t