cognos2powerbi 0.1.0__tar.gz

cognos2powerbi-0.1.0/.env.example

@@ -0,0 +1,10 @@
+# AI provider selection: claude | copilot | codex | none
+COGNOS2PBI_AI_PROVIDER=claude
+
+# Path to the provider CLI executable (leave blank to use PATH default)
+COGNOS2PBI_CLAUDE_CLI=claude
+COGNOS2PBI_COPILOT_CLI=copilot
+COGNOS2PBI_CODEX_CLI=codex
+
+# Timeout in seconds for a single AI refinement call
+COGNOS2PBI_AI_TIMEOUT=120

cognos2powerbi-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# Funding configuration. Replace placeholders with real accounts before publishing.
+# github: [your-github-sponsors-username]
+# open_collective: cognos-to-powerbi

cognos2powerbi-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,49 @@
+name: Bug report
+description: Report a problem with a Cognos to Power BI migration
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for filing a bug. Please remove or anonymize any sensitive identifiers from sample
+        input before attaching it.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: A clear description of the bug and what you expected instead.
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Include the exact command you ran.
+      placeholder: |
+        1. cognos2pbi migrate ./report.xml --out ./out/Report
+        2. ...
+    validations:
+      required: true
+  - type: textarea
+    id: sample
+    attributes:
+      label: Sample Cognos input
+      description: Minimal, anonymized report specification or model that reproduces the issue.
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Output of `cognos2pbi --version`.
+    validations:
+      required: true
+  - type: dropdown
+    id: ai-provider
+    attributes:
+      label: AI provider
+      options:
+        - none
+        - claude
+        - copilot
+        - codex
+    validations:
+      required: true

cognos2powerbi-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions and discussion
+    url: https://github.com/navintkr/cognos-to-powerbi/discussions
+    about: Ask questions and discuss migration scenarios with the community.

cognos2powerbi-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,22 @@
+name: Feature request
+description: Suggest a capability or supported conversion
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What migration scenario is not supported or is painful today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the Cognos source and the desired Power BI output.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered

cognos2powerbi-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Summary
+
+Describe the change and the migration scenario it improves.
+
+Closes #
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New parser or generator capability
+- [ ] Expression translation
+- [ ] Documentation
+- [ ] Other
+
+## Checklist
+
+- [ ] `ruff check .` passes
+- [ ] `ruff format --check .` passes
+- [ ] `mypy src` passes
+- [ ] `pytest` passes
+- [ ] Added or updated tests
+- [ ] Updated documentation and CHANGELOG where relevant
+- [ ] No emojis added to code, docs, or commit messages

cognos2powerbi-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Lint, type-check, and test
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev,api]"
+
+      - name: Ruff lint
+        run: ruff check .
+
+      - name: Ruff format check
+        run: ruff format --check .
+
+      - name: Type check
+        run: mypy src
+
+      - name: Run tests
+        run: pytest --cov=cognos2powerbi --cov-report=term-missing

cognos2powerbi-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+name: Publish to PyPI
+
+# Publishes the package to PyPI when a GitHub Release is published.
+# Uses PyPI Trusted Publishing (OIDC) - no API token or secret is stored in the repository.
+# Configure the trusted publisher on PyPI before the first release:
+#   PyPI project: cognos2powerbi
+#   Owner: navintkr
+#   Repository: cognos-to-powerbi
+#   Workflow filename: publish.yml
+#   Environment: pypi
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: python -m pip install --upgrade build
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/cognos2powerbi/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cognos2powerbi-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+env/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Tooling
+.env
+.env.local
+
+# Editors
+.vscode/
+.idea/
+*.swp
+.DS_Store
+
+# Project output
+out/
+*.pbip.bak

cognos2powerbi-0.1.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial project scaffold.
+- Cognos report specification parser (beta).
+- Cognos Framework Manager model parser with the `migrate-model` command, producing TMDL tables
+  and relationships.
+- Deterministic Cognos-to-DAX expression translation library (references, arithmetic with
+  aggregates, if/then/else, case, common string and date functions).
+- Parameterized SQL Server data-source wiring: generated models include `Server` and `Database`
+  parameters and `Sql.Database` partitions so the PBIP is refreshable. Configure with
+  `--source-type`, `--server`, `--database`, and `--schema`.
+- Single-page web frontend served by the FastAPI backend for upload, analyze, and download.
+- Vendor-neutral intermediate representation (IR).
+- PBIP generator producing TMDL semantic models and PBIR reports.
+- Provider-agnostic AI adapter for Claude, GitHub Copilot, and Codex CLIs.
+- Command-line interface (`cognos2pbi`).
+- FastAPI backend for the SaaS surface.
+- PyPI publishing workflow using Trusted Publishing (OIDC).
+
+## [0.1.0] - 2026-06-29
+
+- First public preview.

cognos2powerbi-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,52 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a
+harassment-free experience for everyone, regardless of age, body size, visible or invisible
+disability, ethnicity, sex characteristics, gender identity and expression, level of experience,
+education, socio-economic status, nationality, personal appearance, race, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive,
+and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness toward other people.
+- Being respectful of differing opinions, viewpoints, and experiences.
+- Giving and gracefully accepting constructive feedback.
+- Accepting responsibility and apologizing to those affected by our mistakes.
+- Focusing on what is best for the overall community.
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind.
+- Trolling, insulting or derogatory comments, and personal or political attacks.
+- Public or private harassment.
+- Publishing others' private information without explicit permission.
+- Other conduct which could reasonably be considered inappropriate in a professional setting.
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards and will take
+appropriate and fair corrective action in response to any behavior that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces and when an individual is officially
+representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the
+community leaders responsible for enforcement at the contact address listed in
+[SECURITY.md](SECURITY.md). All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1.

cognos2powerbi-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing to Cognos to Power BI
+
+Thank you for helping build the most reliable open-source Cognos to Power BI migration tool. This
+guide explains how to set up your environment, the conventions we follow, and how to submit changes.
+
+## Ways to contribute
+
+- Improve Cognos parsers (report specifications, Framework Manager, data modules).
+- Improve PBIP generators (TMDL semantic models, PBIR reports).
+- Add expression translations (Cognos expression -> DAX).
+- Write tests, sample inputs, and documentation.
+- Triage issues and review pull requests.
+
+Look for issues labeled `good first issue` and `help wanted`.
+
+## Development setup
+
+```bash
+git clone https://github.com/navintkr/cognos-to-powerbi.git
+cd cognos-to-powerbi
+python -m venv .venv
+# Windows: .venv\Scripts\activate    macOS/Linux: source .venv/bin/activate
+pip install -e ".[dev,api]"
+```
+
+Run the checks before opening a pull request:
+
+```bash
+ruff check .
+ruff format --check .
+mypy src
+pytest
+```
+
+## Architecture overview
+
+The pipeline is parser -> intermediate representation (IR) -> generator -> optional AI refinement.
+Keep parsers and generators decoupled through the IR. New Cognos inputs and new Power BI outputs
+should never depend on each other directly. See [docs/architecture.md](docs/architecture.md).
+
+## Coding conventions
+
+- Format and lint with `ruff`.
+- Type-check with `mypy`; add type hints to all public functions.
+- Prefer small, pure functions in `core/`. Side effects belong in the CLI and API layers.
+- Add or update tests for every behavior change.
+- Do not add emojis to code, docs, or commit messages.
+
+## Commit and pull request guidelines
+
+- Use clear, imperative commit messages (for example, `Add crosstab parser for list reports`).
+- Reference the issue number in the pull request description.
+- Keep pull requests focused. Split unrelated changes.
+- Ensure CI passes. Pull requests that fail CI will not be merged.
+
+## Reporting bugs and requesting features
+
+Open an issue using the provided templates. Include sample Cognos input (with sensitive data
+removed) whenever possible so maintainers can reproduce the problem.
+
+## Code of Conduct
+
+Participation in this project is governed by our [Code of Conduct](CODE_OF_CONDUCT.md).

cognos2powerbi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cognos to Power BI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cognos2powerbi-0.1.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: cognos2powerbi
+Version: 0.1.0
+Summary: Open-source tool to migrate IBM Cognos reports and models to Microsoft Power BI (PBIP / TMDL / PBIR) with AI assistance.
+Project-URL: Homepage, https://github.com/navintkr/cognos-to-powerbi
+Project-URL: Documentation, https://github.com/navintkr/cognos-to-powerbi#readme
+Project-URL: Repository, https://github.com/navintkr/cognos-to-powerbi
+Project-URL: Issues, https://github.com/navintkr/cognos-to-powerbi/issues
+Project-URL: Changelog, https://github.com/navintkr/cognos-to-powerbi/blob/main/CHANGELOG.md
+Author: Cognos to Power BI contributors
+License: MIT
+License-File: LICENSE
+Keywords: business-intelligence,cognos,cognos-to-power-bi,data-migration,ibm-cognos,migration,pbip,pbir,power-bi,powerbi,report-conversion,tmdl
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: lxml>=5.1
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7
+Provides-Extra: api
+Requires-Dist: fastapi>=0.110; extra == 'api'
+Requires-Dist: python-multipart>=0.0.9; extra == 'api'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'api'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Cognos to Power BI Migration Tool
+
+**Migrate IBM Cognos reports and models to Microsoft Power BI automatically.** An open-source,
+AI-assisted migration engine that converts Cognos report specifications into Power BI Project
+(PBIP) format using TMDL semantic models and PBIR report definitions.
+
+[![CI](https://github.com/navintkr/cognos-to-powerbi/actions/workflows/ci.yml/badge.svg)](https://github.com/navintkr/cognos-to-powerbi/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+---
+
+## What this project does
+
+Organizations moving from **IBM Cognos Analytics** to **Microsoft Power BI** face a slow, manual,
+error-prone migration. This tool automates the heavy lifting:
+
+1. **Parse** Cognos report specification XML, Framework Manager models, and data modules.
+2. **Normalize** them into a vendor-neutral intermediate representation (IR).
+3. **Generate** Power BI Project (PBIP) output — TMDL semantic models and PBIR reports.
+4. **Refine** the output with an AI assistant (Claude, GitHub Copilot, or Codex) to translate
+   expressions, layouts, and visuals that have no direct mechanical mapping.
+
+The result is a Git-friendly Power BI project you can open in Power BI Desktop, review, and deploy
+to the Power BI / Microsoft Fabric service.
+
+## Why use it
+
+- **Faster migrations.** Convert hundreds of reports in a fraction of the manual time.
+- **Consistent output.** Deterministic, reviewable PBIP artifacts instead of hand-rebuilt reports.
+- **AI-assisted, not AI-dependent.** The mechanical conversion works without any AI key; AI only
+  refines what cannot be mapped deterministically.
+- **Provider-agnostic AI.** Use Claude Code CLI, GitHub Copilot CLI, or OpenAI Codex CLI.
+- **Open and extensible.** MIT-licensed, plugin-friendly parsers and generators.
+
+## Supported conversions
+
+| Cognos source | Power BI target | Status |
+| --- | --- | --- |
+| Report specification (Report Studio XML) | PBIR report + TMDL tables | Available (beta) |
+| Queries and data items | TMDL columns and measures | Available (beta) |
+| Framework Manager model (`.cpf` / FM XML) | TMDL semantic model | In progress |
+| Data Modules | TMDL semantic model | In progress |
+| Dashboards | PBIR report pages | Planned |
+
+See the [migration coverage matrix](docs/coverage.md) for detail on expressions, filters, and
+visual types.
+
+## Quick start
+
+```bash
+# Install
+pip install cognos2powerbi
+
+# Convert a single Cognos report specification to a Power BI project
+cognos2pbi migrate ./examples/sample_report.xml --out ./out/SalesReport
+
+# Point the generated model at your database (refreshable PBIP)
+cognos2pbi migrate ./examples/sample_report.xml --out ./out/SalesReport \
+  --server sql01.contoso.com --database Sales
+
+# Convert a Cognos Framework Manager model to a Power BI semantic model
+cognos2pbi migrate-model ./examples/sample_model.xml --out ./out/SalesModel
+
+# Open the generated project
+#   ./out/SalesReport/SalesReport.pbip   ->  open in Power BI Desktop
+```
+
+Run from source instead:
+
+```bash
+git clone https://github.com/navintkr/cognos-to-powerbi.git
+cd cognos-to-powerbi
+pip install -e ".[dev]"
+cognos2pbi migrate ./examples/sample_report.xml --out ./out/SalesReport
+```
+
+## AI-assisted refinement (optional)
+
+Enable an AI provider to translate complex Cognos expressions and layouts into Power BI DAX and
+PBIR visuals. The provider is selected by configuration and shells out to the corresponding CLI.
+
+```bash
+# Claude Code CLI (default)
+cognos2pbi migrate ./report.xml --out ./out/Report --ai claude
+
+# GitHub Copilot CLI
+cognos2pbi migrate ./report.xml --out ./out/Report --ai copilot
+
+# OpenAI Codex CLI
+cognos2pbi migrate ./report.xml --out ./out/Report --ai codex
+```
+
+If no AI provider is configured, the tool completes a deterministic conversion and flags items that
+need manual review. See [docs/ai-providers.md](docs/ai-providers.md).
+
+## How it works
+
+```mermaid
+flowchart LR
+    A[Cognos artifacts<br/>report XML, FM model, data module] --> B[Parsers]
+    B --> C[Intermediate Representation<br/>vendor-neutral IR]
+    C --> D[PBIP Generators<br/>TMDL + PBIR]
+    D --> E[AI Refinement<br/>Claude / Copilot / Codex]
+    E --> F[Power BI Project<br/>.pbip]
+```
+
+The intermediate representation decouples parsing from generation, so new Cognos inputs and new
+Power BI output formats can be added independently. See [docs/architecture.md](docs/architecture.md).
+
+## Project layout
+
+```
+cognos-to-powerbi/
+├── src/cognos2powerbi/
+│   ├── cli.py                 # Command-line interface
+│   ├── core/
+│   │   ├── ir/                # Vendor-neutral intermediate representation
+│   │   ├── parsers/           # Cognos report/model parsers
+│   │   ├── generators/        # PBIP (TMDL + PBIR) generators
+│   │   ├── translate/         # Deterministic Cognos-to-DAX translation
+│   │   ├── ai/                # Provider-agnostic AI adapter
+│   │   └── pipeline.py        # Orchestration
+│   └── api/                   # FastAPI backend (SaaS surface)
+├── web/                       # Single-page web frontend
+├── examples/                  # Sample Cognos inputs
+├── docs/                      # Documentation
+└── tests/                     # Test suite
+```
+
+## Run the SaaS API locally
+
+```bash
+pip install -e ".[api]"
+uvicorn cognos2powerbi.api.main:app --reload
+# Open the web UI at http://127.0.0.1:8000/
+# Or POST a Cognos report to http://127.0.0.1:8000/api/v1/migrate
+```
+
+## Roadmap
+
+- [x] Framework Manager model conversion to TMDL
+- [ ] Data Module conversion
+- [ ] Dashboard to PBIR page mapping
+- [ ] Expression translation library (Cognos -> DAX)
+- [ ] Hosted SaaS portal with upload, review, and download
+- [ ] Batch / folder migration with a coverage report
+
+Full roadmap: [docs/roadmap.md](docs/roadmap.md).
+
+## Contributing
+
+Contributions are welcome and wanted. Good first issues are labeled
+[`good first issue`](https://github.com/navintkr/cognos-to-powerbi/labels/good%20first%20issue).
+Read [CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md) to get started.
+
+## Security
+
+Report vulnerabilities privately per our [security policy](SECURITY.md). Do not open public issues
+for security reports.
+
+## License
+
+Licensed under the [MIT License](LICENSE).
+
+---
+
+### Keywords
+
+Cognos to Power BI, Cognos Power BI migration, IBM Cognos migration tool, convert Cognos reports to
+Power BI, Cognos report converter, Power BI PBIP TMDL PBIR generator, business intelligence
+migration, automated report migration.