gopptx 0.2.0a1

High-performance PPTX engine powered by Go

gopptx

PowerPoint (PPTX) engine written in Go — with a Python library and a stable JSON command bridge for cross-language use.

---

Overview

gopptx is a Go library for generating and manipulating PPTX files. It is designed for correctness and ease of use across languages. A stable JSON command bridge lets you drive it from Python, or any other language without rewriting logic.

Why gopptx?

gopptx combines the native performance of Go with cross-language accessibility, making it ideal for high-throughput presentation generation. Use it for automating business reports, creating dynamic slides from data sources, or integrating PPTX creation into your existing workflows without sacrificing speed or reliability.

Key Capabilities

Feature	Description
Rich Diagrams	Native Mermaid rendering (12+ types) and SmartArt
Deep Editing	Full control over shapes, images, charts, tables, and text
Themes & Layouts	Built-in themes, color schemes, font schemes, and layout helpers
Accessibility	Alt-text, sections, comments, and speaker notes
Export	PDF export (native, LibreOffice, or PowerPoint driver)
Cross-Language	Stable JSON command API for Python and other language interop

---

Prerequisites

• Go: 1.25.9 or later
• Python: 3.10 or later (required for Python bindings)
• Platforms: Windows, Linux, macOS

---

Installation

Go

go get github.com/djinn-soul/gopptx

Python

The Python package uses a high-performance Go shared library for PPTX processing. You need to build this library before installing the package.

1. Build the Go shared library:

   • Windows (PowerShell):

     .\scripts\build_python.ps1
     

   • Linux/macOS (Bash):

     ./scripts/build_python.sh
     

2. Install the Python package:

   pip install -e .
   

---

Quick Start

Python Setup

Build the native bridge and install the package locally:

# Windows
.\scripts\build_python.ps1
pip install -e .

# Linux/macOS
./scripts/build_python.sh
pip install -e .

Python

Create and save a new deck:

from gopptx import Presentation

with Presentation.new("Quarterly Update") as pres:
    pres.add_slide("Overview")
    pres.add_bullet_slide("Highlights", ["Growth +12%", "Retention +4%"])
    pres.save("output.pptx")

Open and edit an existing deck:

from gopptx import Presentation

with Presentation("input.pptx") as pres:
    pres.set_slide_title(0, "Updated Title")
    pres.add_slide("New Closing Slide")
    pres.save("edited.pptx")

Run many writes in one batch:

from gopptx import Presentation

with Presentation.new("Batch Demo") as pres:
    with pres.batch(stop_on_error=True) as batch:
        for i in range(100):
            batch.add_slide(f"Slide {i}")
    pres.save("batch.pptx")

Go

Install and run:

go get github.com/djinn-soul/gopptx
go run ./your-main.go

package main

import (
    "os"

    "github.com/djinn-soul/gopptx/pkg/pptx"
)

func main() {
    slides := []pptx.SlideContent{
        pptx.NewSlide("Hello from gopptx").AddBullet("Created with gopptx"),
    }

    data, err := pptx.CreateWithSlides("My Deck", slides)
    if err != nil {
        panic(err)
    }

    if err := os.WriteFile("output.pptx", data, 0o600); err != nil {
        panic(err)
    }
}

Next Docs

• Python API reference: docs/reference/python-presentation-api.md
• Go API reference: docs/reference/go-api.md
• Full quickstart page: docs/quickstart.md
• Runnable examples: examples/README.md

---

PDF Export

PDF export supports three drivers: native, libreoffice, and powerpoint. The default auto mode tries LibreOffice or PowerPoint first, and falls back to the native renderer.

Note: The native Go PDF renderer is experimental. It may differ from PowerPoint output for advanced SmartArt or layout-heavy decks. Use auto for production unless you specifically need the native renderer.

Example (Python):

from gopptx import Presentation

with Presentation("input.pptx") as pres:
    pres.export_pdf("output.pdf", driver="auto")

Driver requirements (Windows):

• powerpoint — requires Microsoft PowerPoint installed (COM automation) and PowerShell (powershell or pwsh).
• libreoffice — requires LibreOffice with soffice on PATH. If soffice is not recognized, add C:\Program Files\LibreOffice\program to your PATH.

---

Documentation

Resource	Description
Quickstart	Python and Go quickstart examples
Examples Index	90+ runnable examples covering all features
Python Guide	Full Python API reference and usage
Go API Reference	Go library reference
Bridge Operations	All 149 JSON bridge commands
Showcase	Real-world usage patterns (simple → complex)

---

Contributing

See CONTRIBUTING.md for setup instructions, code guidelines, and the PR checklist.

License

Apache License 2.0 — see LICENSE.