Chapter 8: Packages

Introduksyon

Ayaw ibutang tanan sa usa ka file. Di ta animal. Ang packages kay pamaagi sa Go para i-organize ug i-reuse imong code. Sama rag nag-hipos ka sa imong kwarto — ang underwear sa drawer, ang laptop sa lamesa. Kung pataka rag butang, maglisod kag pangita. Same sa imong Go files.

Maintainable

Kung imong code kay isa lang ka higanteng file, maglisod kag pangita sa imong gipangita. Ang packages kay parehas rag nag-organize ka sa imong fridge — ang meat sa usa ka drawer, ang veggies sa lain. Kung gutomon ka, di nang magkalot2:

Reusable

Nagsulat kag maayong code? Gamita nasad sa lain project. Ang packages pwede i-import ug i-reuse — way limit. Ang Go standard library mismo kay daghan ug packages para sa common tasks, para di ka mag-imbento ug ligid kada adlaw:

Modular

Ang Go modules (Go 1.11+) kay ang nag-asikaso sa imong mga dependency — versioning, reproducible builds, ug uban pa. Mura nag MVC sa imong project — sa katapusan, naay mag-manage sa imong mess:

What Is a Package?

Ang package kay directory sa .go files na parehas ug package declaration. Nagprovide ug encapsulation — ang naka-uppercase lang (exported) ang makita sa gawas. Ang lowercase kay private — murag diary mo nga di dapat basahon ni mama:

Package Structure

myapp/
  go.mod
  main.go              // package main
  calculator/
    calc.go            // package calculator
  utils/
    strings.go         // package utils

Package Naming

Ang package names kay short, lowercase, ug descriptive. Isa ka word lang kung kaya. Dili nang super_duper_mega_utils_v2:

Simple ra. Parehas sa nickname — "Rian" dili "Rian Miguel Antonio Santos III":

Package Declarations

// File: logger/logger.go
package logger

func Info(msg string) {
    fmt.Println("[INFO]", msg)
}

// File: main.go
package main
import "myapp/logger"

func main() {
    logger.Info("starting app")
}

Exported and Unexported Code

Capital letter = exported (makita sa gawas). Lowercase = unexported (para lang sa inyo — package lang). Mura rag GCash transaction — kung sayop ang spelling, imo rang problema:

package account

var balance float64  // unexported

func Deposit(amount float64) { balance += amount }    // exported
func GetBalance() float64 { return balance }          // exported

GOROOT ug GOPATH

GOROOT — kung asa naka-install ang Go (standard library). GOPATH — workspace para sa imong Go code. Pero sa modern Go (1.16+), modules na ang uso. Ang GOPATH kay murag VCD — naa pa pero wala nay naggamit:

Package Alias

import (
    "fmt"
    myfmt "mylib/fmt"
)
myfmt.Println("custom")

Main Package

Ang main package kay special — nagdefine ug standalone executable. Kung wala kay func main(), wala sad kay program. Mura rag sine na walay showing:

Exercise 8.01: Area Package

// File: shape/area.go
package shape
import "math"
func Circle(r float64) float64 { return math.Pi * r * r }
func Rectangle(w, h float64) float64 { return w * h }

// File: main.go
package main
import ("fmt"; "myapp/shape")
func main() {
    fmt.Println(shape.Circle(5))
    fmt.Println(shape.Rectangle(4, 6))
}

The init() Function

Ang init() kay automatic nag-run kung ma-import ang package — before pa sa main(). Mura rag alarm clock sa buntag — di nang hangyo, automatic jud na:

package config
var AppName string
func init() { AppName = "MyApp" }

Exercise 8.02: Budget Categories

package budget
var Categories map[string]float64

func init() {
    Categories = map[string]float64{
        "rent": 1200, "food": 500, "utilities": 200,
    }
}

func GetLimit(cat string) float64 { return Categories[cat] }

Multiple init() Functions

Pwede daghang init() sa parehas na file — mag-run sila in order. Ang init() sa imported packages kay before sa nag-import. Mura rag pila sa 7-Eleven — first come, first served:

Exercise 8.03: Payees to Categories

package budget

var PayeeCategory map[string]string

func init() {
    PayeeCategory = map[string]string{
        "Landlord Inc": "rent", "Supermarket Co": "food",
    }
}

func GetCategory(payee string) string { return PayeeCategory[payee] }

Activity 8.01: Payroll Package

// File: payroll/payroll.go
package payroll

func CalculatePay(hours, rate float64) float64 { return hours * rate }
func GenerateReview(name string) string {
    return name + ": Performance review pending"
}

// File: main.go
package main
import ("fmt"; "myapp/payroll")
func main() {
    pay := payroll.CalculatePay(40, 25)
    fmt.Println("Pay:", pay)
    fmt.Println(payroll.GenerateReview("Alice"))
}

Summary