febe858942
- Remove `os` import from internal/ax/ax.go; replace os.Getwd() with
syscall.Getwd(), os.MkdirAll() with coreio.Local.EnsureDir(), and
os.Chmod() with syscall.Chmod()
- Remove `os` import from pkg/sdk/generators/typescript_test.go;
replace os.PathListSeparator and os.Getenv() with core.Env("PS")
and core.Env("PATH")
- Replace all "Usage example: call/declare ... from integrating code"
placeholder comments with concrete code examples across 45 files
covering build, release, sdk, signing, publishers, builders, and cmd
Co-Authored-By: Virgil <virgil@lethean.io>
86 lines
2.3 KiB
Go
86 lines
2.3 KiB
Go
package generators
|
|
|
|
import (
|
|
"context"
|
|
|
|
"dappco.re/go/core/build/internal/ax"
|
|
coreerr "dappco.re/go/core/log"
|
|
)
|
|
|
|
// PHPGenerator generates PHP SDKs from OpenAPI specs.
|
|
//
|
|
// g := generators.NewPHPGenerator()
|
|
type PHPGenerator struct{}
|
|
|
|
// NewPHPGenerator creates a new PHP generator.
|
|
//
|
|
// g := generators.NewPHPGenerator()
|
|
func NewPHPGenerator() *PHPGenerator {
|
|
return &PHPGenerator{}
|
|
}
|
|
|
|
// Language returns the generator's target language identifier.
|
|
//
|
|
// lang := g.Language() // → "php"
|
|
func (g *PHPGenerator) Language() string {
|
|
return "php"
|
|
}
|
|
|
|
// Available checks if generator dependencies are installed (requires Docker).
|
|
//
|
|
// if g.Available() { err = g.Generate(ctx, opts) }
|
|
func (g *PHPGenerator) Available() bool {
|
|
return dockerRuntimeAvailable()
|
|
}
|
|
|
|
// Install returns instructions for installing the generator.
|
|
//
|
|
// fmt.Println(g.Install()) // → "Docker is required for PHP SDK generation"
|
|
func (g *PHPGenerator) Install() string {
|
|
return "Docker is required for PHP SDK generation"
|
|
}
|
|
|
|
// Generate creates SDK from OpenAPI spec (requires Docker).
|
|
//
|
|
// err := g.Generate(ctx, generators.Options{SpecPath: "docs/openapi.yaml", OutputDir: "sdk/php"})
|
|
func (g *PHPGenerator) Generate(ctx context.Context, opts Options) error {
|
|
if err := ctx.Err(); err != nil {
|
|
return coreerr.E("php.Generate", "generation cancelled", err)
|
|
}
|
|
|
|
if !dockerRuntimeAvailableWithContext(ctx) {
|
|
if err := ctx.Err(); err != nil {
|
|
return coreerr.E("php.Generate", "generation cancelled", err)
|
|
}
|
|
return coreerr.E("php.Generate", "Docker is required but not available", nil)
|
|
}
|
|
|
|
dockerCommand, err := resolveDockerRuntimeCli()
|
|
if err != nil {
|
|
return coreerr.E("php.Generate", "docker CLI not available", err)
|
|
}
|
|
|
|
if err := ax.MkdirAll(opts.OutputDir, 0o755); err != nil {
|
|
return coreerr.E("php.Generate", "failed to create output dir", err)
|
|
}
|
|
|
|
specDir := ax.Dir(opts.SpecPath)
|
|
specName := ax.Base(opts.SpecPath)
|
|
|
|
args := []string{"run", "--rm"}
|
|
args = append(args, dockerUserArgs()...)
|
|
args = append(args,
|
|
"-v", specDir+":/spec",
|
|
"-v", opts.OutputDir+":/out",
|
|
"openapitools/openapi-generator-cli", "generate",
|
|
"-i", "/spec/"+specName,
|
|
"-g", "php",
|
|
"-o", "/out",
|
|
"--additional-properties=invokerPackage="+opts.PackageName,
|
|
)
|
|
|
|
if err := ax.Exec(ctx, dockerCommand, args...); err != nil {
|
|
return coreerr.E("php.Generate", "docker run failed", err)
|
|
}
|
|
return nil
|
|
}
|