package exiftool import ( "context" "errors" "fmt" "log/slog" "os" "os/exec" "reflect" "strings" "syscall" "github.com/barasher/go-exiftool" "go.opentelemetry.io/otel/codes" "go.opentelemetry.io/otel/trace" "github.com/gotenberg/gotenberg/v8/pkg/gotenberg" ) func init() { gotenberg.MustRegisterModule(new(ExifTool)) } // ExifTool abstracts the CLI tool ExifTool and implements the // [gotenberg.PdfEngine] interface. type ExifTool struct { binPath string } // Descriptor returns [ExifTool]'s module descriptor. func (engine *ExifTool) Descriptor() gotenberg.ModuleDescriptor { return gotenberg.ModuleDescriptor{ ID: "exiftool", New: func() gotenberg.Module { return new(ExifTool) }, } } // Provision sets the module properties. func (engine *ExifTool) Provision(ctx *gotenberg.Context) error { binPath, ok := os.LookupEnv("EXIFTOOL_BIN_PATH") if !ok { return errors.New("EXIFTOOL_BIN_PATH environment variable is not set") } engine.binPath = binPath return nil } // Validate validates the module properties. func (engine *ExifTool) Validate() error { _, err := os.Stat(engine.binPath) if os.IsNotExist(err) { return fmt.Errorf("ExifTool binary path does not exist: %w", err) } return nil } // Debug returns additional debug data. func (engine *ExifTool) Debug() map[string]any { debug := make(map[string]any) cmd := exec.Command(engine.binPath, "-ver") //nolint:gosec cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true} output, err := cmd.Output() if err != nil { debug["version"] = err.Error() return debug } debug["version"] = strings.TrimSpace(string(output)) return debug } // Merge is not available in this implementation. func (engine *ExifTool) Merge(ctx context.Context, logger *slog.Logger, inputPaths []string, outputPath string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.Merge", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("merge PDFs with ExifTool: %w", gotenberg.ErrPdfEngineMethodNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return err } // Split is not available in this implementation. func (engine *ExifTool) Split(ctx context.Context, logger *slog.Logger, mode gotenberg.SplitMode, inputPath, outputDirPath string) ([]string, error) { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.Split", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("split PDF with ExifTool: %w", gotenberg.ErrPdfEngineMethodNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return nil, err } // Flatten is not available in this implementation. func (engine *ExifTool) Flatten(ctx context.Context, logger *slog.Logger, inputPath string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.Flatten", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("flatten PDF with ExifTool: %w", gotenberg.ErrPdfEngineMethodNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return err } // Convert is not available in this implementation. func (engine *ExifTool) Convert(ctx context.Context, logger *slog.Logger, formats gotenberg.PdfFormats, inputPath, outputPath string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.Convert", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("convert PDF to '%+v' with ExifTool: %w", formats, gotenberg.ErrPdfEngineMethodNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return err } // ReadMetadata extracts the metadata of a given PDF file. func (engine *ExifTool) ReadMetadata(ctx context.Context, logger *slog.Logger, inputPath string) (map[string]any, error) { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.ReadMetadata", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() exifTool, err := exiftool.NewExiftool(exiftool.SetExiftoolBinaryPath(engine.binPath)) if err != nil { err = fmt.Errorf("new ExifTool: %w", err) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return nil, err } defer func(exifTool *exiftool.Exiftool) { err := exifTool.Close() if err != nil { logger.ErrorContext(ctx, fmt.Sprintf("close ExifTool: %v", err)) } }(exifTool) fileMetadata := exifTool.ExtractMetadata(inputPath) if fileMetadata[0].Err != nil { err = fmt.Errorf("read metadata with ExitfTool: %w", fileMetadata[0].Err) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return nil, err } return fileMetadata[0].Fields, nil } // WriteMetadata writes the metadata into a given PDF file. func (engine *ExifTool) WriteMetadata(ctx context.Context, logger *slog.Logger, metadata map[string]any, inputPath string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.WriteMetadata", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() exifTool, err := exiftool.NewExiftool(exiftool.SetExiftoolBinaryPath(engine.binPath)) if err != nil { err = fmt.Errorf("new ExifTool: %w", err) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return err } defer func(exifTool *exiftool.Exiftool) { err := exifTool.Close() if err != nil { logger.ErrorContext(ctx, fmt.Sprintf("close ExifTool: %v", err)) } }(exifTool) fileMetadata := exifTool.ExtractMetadata(inputPath) if fileMetadata[0].Err != nil { err = fmt.Errorf("read metadata with ExitfTool: %w", fileMetadata[0].Err) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return err } // Define a list of derived, system, or computed tags that ExifTool // extracts but should never be written back. Writing these can break PDF/A // compliance (e.g., PageCount -> prism:pageCount) or cause side effects // (e.g., FileModifyDate). derivedTags := []string{ "PageCount", // Causes prism:pageCount injection "Linearized", // Computed status; writing it may invalidate structure "PDFVersion", // Header version; should not be manually forced via metadata "MIMEType", // Read-only derived "FileType", // Read-only derived "FileTypeExtension", // Read-only derived "FileSize", // System attribute "FileModifyDate", // System attribute "FileAccessDate", // System attribute "FileInodeChangeDate", // System attribute "FilePermissions", // System attribute "FileName", // Writing this triggers a file rename in ExifTool "Directory", // System attribute "ExifToolVersion", // Tool metadata "Error", // Extraction error messages "Warning", // Extraction warning messages } for _, tag := range derivedTags { delete(fileMetadata[0].Fields, tag) } for key, value := range metadata { switch val := value.(type) { case string: fileMetadata[0].SetString(key, val) case []string: fileMetadata[0].SetStrings(key, val) case []any: // See https://github.com/gotenberg/gotenberg/issues/1048. strs := make([]string, len(val)) for i, entry := range val { if str, ok := entry.(string); ok { strs[i] = str continue } err = fmt.Errorf("write PDF metadata with ExifTool: %s %+v %s %w", key, val, reflect.TypeFor[[]any](), gotenberg.ErrPdfEngineMetadataValueNotSupported) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return err } fileMetadata[0].SetStrings(key, strs) case bool: fileMetadata[0].SetString(key, fmt.Sprintf("%t", val)) case int: fileMetadata[0].SetInt(key, int64(val)) case int64: fileMetadata[0].SetInt(key, val) case float32: fileMetadata[0].SetFloat(key, float64(val)) case float64: fileMetadata[0].SetFloat(key, val) // TODO: support more complex cases, e.g., arrays and nested objects // (limitations in underlying library). default: err = fmt.Errorf("write PDF metadata with ExifTool: %s %+v %s %w", key, val, reflect.TypeOf(val), gotenberg.ErrPdfEngineMetadataValueNotSupported) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return err } } exifTool.WriteMetadata(fileMetadata) if fileMetadata[0].Err != nil { err = fmt.Errorf("write PDF metadata with ExifTool: %w", fileMetadata[0].Err) span.RecordError(err) span.SetStatus(codes.Error, err.Error()) return err } return nil } // Encrypt is not available in this implementation. func (engine *ExifTool) Encrypt(ctx context.Context, logger *slog.Logger, inputPath, userPassword, ownerPassword string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.Encrypt", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("encrypt PDF using ExifTool: %w", gotenberg.ErrPdfEncryptionNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return err } // AddAttachments is not available in this implementation. func (engine *ExifTool) AddAttachments(ctx context.Context, logger *slog.Logger, filePaths []string, inputPath string) error { _, span := gotenberg.Tracer().Start(ctx, "ExifTool.AddAttachments", trace.WithSpanKind(trace.SpanKindInternal)) defer span.End() err := fmt.Errorf("add attachments with ExifTool: %w", gotenberg.ErrPdfEngineMethodNotSupported) if err != nil { span.RecordError(err) span.SetStatus(codes.Error, err.Error()) } return err } // Interface guards. var ( _ gotenberg.Module = (*ExifTool)(nil) _ gotenberg.Provisioner = (*ExifTool)(nil) _ gotenberg.Validator = (*ExifTool)(nil) _ gotenberg.Debuggable = (*ExifTool)(nil) _ gotenberg.PdfEngine = (*ExifTool)(nil) )