gofasta g method

Adds a method to an existing service — patches both the interface at app/services/interfaces/<snake>_service.go (adding the signature) and the impl at app/services/<snake>.service.go (adding a stub body). Idempotent: re-running with the same method name returns METHOD_ALREADY_EXISTS rather than silently duplicating.

Uses dst for AST patching, so doc comments, blank lines, and import grouping are preserved through the parse → modify → print round-trip.

Usage


gofasta g method <Resource> <Method> [param:type ...] [flags]

The resource must already exist (see gofasta g scaffold). Additional positional args are parameters in name:type form — the same shorthand g scaffold uses for fields.

Flags

Flag	Default	Description
`--dry-run`	`false`	Preview the patches without writing. Honors `--json` for a structured `{patch: [...]}` plan.

Examples

Add an Archive method with no parameters:


gofasta g method Order Archive

Result — app/services/interfaces/order_service.go gains:


type OrderServiceInterface interface {
    // ... existing methods preserved ...
    Archive(ctx context.Context) error
}

And app/services/order.service.go gains:


// Archive is a generated stub. Replace with the real implementation.
func (s *orderService) Archive(ctx context.Context) error {
    return fmt.Errorf("OrderServiceInterface.Archive: not implemented")
}

Add a method with parameters:


gofasta g method Order Cancel reason:string force:bool
# →  Cancel(ctx context.Context, reason string, force bool) error

Preview without writing:


gofasta g method Order Archive --dry-run

Plan output (JSON):


gofasta g method Order Archive --dry-run --json


{
  "actions": [
    {"kind": "patch", "path": "app/services/interfaces/order_service.go", "detail": "add Archive to OrderServiceInterface"},
    {"kind": "patch", "path": "app/services/order.service.go", "detail": "add Archive impl stub to orderService"}
  ]
}

What it patches

File	Change
`app/services/interfaces/<snake>_service.go`	Appends the method signature to `<Resource>ServiceInterface`. Adds `context` import if not present.
`app/services/<snake>.service.go`	Appends a stub method to the impl struct. The stub returns a `fmt.Errorf("...: not implemented")` so the build stays green and existing tests don’t break.

Naming conventions (overridable via MethodData fields if invoking the API directly):

Interface name: <Resource>ServiceInterface (matches scaffold)
Impl struct: <lowerResource>Service (matches scaffold)
Receiver name: s

Argument convention

Every generated method takes ctx context.Context as the first parameter and returns error. User-supplied args follow ctx:


gofasta g method Order Cancel reason:string force:bool
# →  Cancel(ctx context.Context, reason string, force bool) error

This matches the gofasta scaffold convention so all methods on a service have the same shape — predictable for callers and consistent with the auth/timeout middleware that hangs off the context.

Error codes

Code	When
`RESOURCE_NOT_FOUND`	The interface or impl file is missing. Run `gofasta g scaffold <Resource>` first.
`METHOD_ALREADY_EXISTS`	The interface already declares a method by that name. Idempotency hit.
`AST_PARSE_FAILED`	One of the target files has a syntax error. Fix the file and re-run.
`AST_PATCH_FAILED`	dst couldn’t render the modified AST (rare — usually a malformed parameter type that doesn’t parse).

gofasta g scaffold
Generate a complete CRUD resource with all layers including model, repository, service, controller, routes, DTOs, migration, and DI provider.
gofasta g model
Generate a GORM database model with typed fields and a corresponding migration pair.
gofasta g repository
Generate a model, migration, repository interface, and repository implementation for database access.
gofasta g service
Generate a service interface and implementation containing business logic, plus every prerequisite layer (model, migration, repository, DTOs, Wire provider).
gofasta g controller
Generate a REST controller (with CRUD handlers) plus every prerequisite layer — model, migration, repository, service, DTOs, Wire provider, and routes.
gofasta g dto
Generate request and response Data Transfer Objects (DTOs) for a resource.
gofasta g migration
Generate a `.up.sql` / `.down.sql` migration pair under `db/migrations/` for a database table — with per-driver SQL flavor (postgres,...
gofasta g route
Generate a per-resource chi routes file under `app/rest/routes/` — the registration function (`<Resource>Routes(r chi.Router)`) that the index router mounts.
gofasta g resolver
Patch the GraphQL resolver root to add a service dependency for an existing resource — appends the service field, regenerates Wire...
gofasta g provider
Generate a Google Wire dependency-injection provider set for a resource — the small `wire.NewSet(...)` glue that ties the service,...
gofasta g repo-method
Add a method to an existing repository — the repository-layer twin of `g method`.
gofasta g field
Add a column to an existing resource.
gofasta g endpoint
Add a single REST endpoint to an existing resource — patches the controller (handler stub), routes file (chi registration), and...
gofasta g middleware
Wrap an existing chi route's handler with a middleware.
gofasta g relation
Add a GORM association between two resources — belongs_to, has_many, or has_one.
gofasta g rename
Cross-file rename of a field on a resource — model, DTOs, service, tests, repository, plus a rename migration.
gofasta g job
Generate a scheduled background job that implements the scheduler.Job interface.
gofasta g task
Generate an asynq-backed async task — emits a `Task<Name>` constant, a `<Name>Payload` struct, a `Handle<Name>` handler, and an `Enqueue<Name>` helper.
gofasta g email-template
Generate an HTML email template with a matching Go template file under app/emails/templates/ and a registration entry so the pkg/mailer renderer can find it by name.
gofasta g mock
Generate a testify/mock implementation that satisfies a Go interface.