aah project file - aah.project

aah.project file holds the application info, build configuration and hot-reload values.

Table of Contents

• build { … }
• log { … }
• hot_reload { … } Since v0.7

Section: build { … }

Build section is used during aah application compile and build process.

build.binary_name

Application binary name.

Default value is name attribute value from aah.conf.

binary_name = ""

build.version

Used as fallback if git commit sha or AAH_APP_VERSION environment value is not available.

version = "0.0.1"

build.dep_get

If application is missing any dependencies in build import path during a compile and build process, aah CLI executes go get <package>. If it’s false then build shows error with list of dependencies which are not available.

Default value is false.

dep_get = true

build.flags

Flag values is supplied to go build command.

Default value is ["-i"]

flags = ["-i"]

build.ldflags

Ldflags is supplied to go build command as -ldflags ....

Default value is empty string.

ldflags = ""

build.tags

Tags is supplied to go build command as -tags ....

Default value is empty string.

tags = ""

build.ast_excludes

AST excludes is used for aah.Context inspection and generating aah application main Go file. For valid exclude patterns refer here.

Default value is ["*_test.go", ".*", "*.bak", "*.tmp", "vendor"]

ast_excludes = ["*_test.go", ".*", "*.bak", "*.tmp", "vendor"]

build.excludes

Packing excludes is used to exclude file/directory during aah application build archive. For valid exclude patterns refer here.

Default value is ["*.go", "*_test.go", ".*", "*.bak", "*.tmp", "vendor", "app", "tests", "logs"]

excludes = ["*.go", "*_test.go", ".*", "*.bak", "*.tmp", "vendor", "app", "tests", "logs"]

Section: log { … }

Since v0.9 Logger settings for the aah CLI tool.

log.level

Log level is used for aah CLI tool logging.

Default value is info.

level = "info"

log.color

Log colored output setting.

Default value is true.

color = false

Section: hot_reload { … }

Hot-Reload is development purpose to help developer. Read more about implementation here.

Note: Do not use hot-reload feature for production purpose, it’s not recommended.

hot_reload.enable

To enable hot-reload for development purpose.

Default value is true.

enable = true

Section: hot_reload.watch { … }

Watch configuration - files/directories exclusion list.

hot_reload.watch.dir_excludes

To Exclude directory from watch list.

# Note: static directory not required to be monitored, since server delivers
# up-to-date file on environment profile `dev`.
dir_excludes = [".*"]

hot_reload.watch.file_excludes

To Exclude file from watch list.

file_excludes = [".*", "_test.go", "LICENSE", "README.md"]