Looker-PowerPoint Documentation

A command line interface for Looker PowerPoint integration that embeds YAML metadata in PowerPoint shape alternative text and replaces shapes with live Looker data.

Contents:

• Getting Started: Creating Your Presentation
  • Overview
  • Prerequisites
  • Step 1 — Open the Alt Text panel
  • Step 2 — Write your YAML configuration
  • Step 3 — Run the tool
  • Configuration Patterns
  • Troubleshooting
  • Next Steps
• Command Line Interface
  • Main CLI Class
  • Entry Point
  • Environment Variables
  • Additional optional environment variables:
• Data Models
  • LookerReference
• Text Cell Templating
  • Setup
  • Jinja Context
  • Syntax Examples
  • Custom Filters
• API Reference
  • Looker Client
  • Shape Discovery Tools

Quick Start

1. Install dependencies:

   pip install looker-powerpoint
   

   Or, if you are using uv to manage a project:

   uv add looker-powerpoint
   

2. Set up Looker SDK credentials:

   To authenticate with your Looker instance, you need to provide your Looker base URL, client ID, and client secret. You can either create a looker.ini file in the project root with the following content:

   [looker]
   base_url=https://your-looker.com
   client_id=your_client_id
   client_secret=your_secret
   

   Or add the environment variables in your shell before running the tool:

   export LOOKERSDK_BASE_URL=https://your-looker.com
   export LOOKERSDK_CLIENT_ID=your_client_id
   export LOOKERSDK_CLIENT_SECRET=your_secret
   

   Or put the environment variables in a .env file in the project root:

   LOOKERSDK_BASE_URL=https://your-looker.com
   LOOKERSDK_CLIENT_ID=your_client_id
   LOOKERSDK_CLIENT_SECRET=your_secret
   

3. Process a PowerPoint file:

   uv run lppt -f your_presentation.pptx
   

Entry Point

looker_powerpoint.cli.main()

Indices and tables

• Index

• Module Index

• Search Page