bb2gh 0.2.1__tar.gz

bb2gh-0.2.1/.gitignore

@@ -0,0 +1,191 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Hatch
+.hatch/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+*.sublime-project
+*.sublime-workspace
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Project specific
+*.log
+*.sqlite
+*.db
+
+# Migration output files (generated during bb2gh operations)
+inventory.json
+plan.json
+plan-*.json
+secrets-inventory.json
+validation-*.json
+user-mapping.csv
+users-*.csv
+
+# Git worktrees
+.worktrees/
+
+# Migration state files (local user data)
+.bb2gh/
+
+# Temporary files
+*.tmp
+*.temp
+.tmp/
+tmp/
+
+# Secrets and credentials - never commit
+.env.local
+.env.*.local
+.env.production
+.env.staging
+secrets.yaml
+secrets.yml
+secrets.json
+*.pem
+*.key
+*.p12
+*.pfx
+*.crt
+*.cer
+credentials.json
+credentials.yaml
+credentials.yml
+service-account.json
+serviceaccount.json
+*-service-account.json
+*.keystore
+*.jks
+
+# API tokens and keys
+.netrc
+.npmrc
+.pypirc
+token.txt
+tokens.json
+api_key.txt
+api_keys.json
+auth.json
+oauth.json
+
+# Cloud provider configs
+.aws/
+.azure/
+.gcloud/
+.config/gcloud/
+kubeconfig
+.kube/config
+
+# MCP configuration (may contain tokens)
+.mcp.json
+mcp.json
+
+# Claude/AI assistant configs (may contain API keys)
+.claude.json
+.anthropic.json
+.openai.json
+
+# GitHub CLI config
+.gh/
+
+# Infisical (secrets manager used by bb2gh)
+.infisical.json
+
+# Build artifacts
+*.whl
+
+# Documentation build
+docs/_build/
+site/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# profiling
+*.prof

bb2gh-0.2.1/LICENSE

@@ -0,0 +1,70 @@
+Business Source License 1.1
+
+Licensor:       N8 Group
+Licensed Work:  bb2gh
+                The Licensed Work is (c) 2026 N8 Group.
+Change Date:    Four years from the release date of each version.
+Change License: Apache License, Version 2.0
+
+Usage Grant:
+
+You may use the Licensed Work for any purpose, including commercial use,
+provided you do not offer a competing migration service using this software.
+
+Additional Use Grant:
+
+Internal business use and migrations are always permitted. You may:
+- Use this software to migrate your own organization's repositories
+- Use this software as part of your internal development workflow
+- Modify and create derivative works for internal use
+
+What is NOT permitted without a separate commercial license:
+- Offering repository migration as a service to third parties
+- Building a competing SaaS product that uses this software
+- Reselling or sublicensing the migration functionality
+
+For commercial licensing inquiries, contact: licensing@n8group.com
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

bb2gh-0.2.1/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: bb2gh
+Version: 0.2.1
+Summary: CLI tool for migrating Bitbucket repositories to GitHub Enterprise
+Project-URL: Documentation, https://n8-group.gitbook.io/bb2gh/
+Project-URL: Homepage, https://bb2gh.dev
+Project-URL: Issues, https://github.com/n8group-oss/bb2gh/issues
+Project-URL: Repository, https://github.com/n8group-oss/bb2gh
+Author-email: N8 Group <oss@n8group.com>
+License: Business Source License 1.1
+        
+        Licensor:       N8 Group
+        Licensed Work:  bb2gh
+                        The Licensed Work is (c) 2026 N8 Group.
+        Change Date:    Four years from the release date of each version.
+        Change License: Apache License, Version 2.0
+        
+        Usage Grant:
+        
+        You may use the Licensed Work for any purpose, including commercial use,
+        provided you do not offer a competing migration service using this software.
+        
+        Additional Use Grant:
+        
+        Internal business use and migrations are always permitted. You may:
+        - Use this software to migrate your own organization's repositories
+        - Use this software as part of your internal development workflow
+        - Modify and create derivative works for internal use
+        
+        What is NOT permitted without a separate commercial license:
+        - Offering repository migration as a service to third parties
+        - Building a competing SaaS product that uses this software
+        - Reselling or sublicensing the migration functionality
+        
+        For commercial licensing inquiries, contact: licensing@n8group.com
+        
+        ---
+        
+        Terms
+        
+        The Licensor hereby grants you the right to copy, modify, create derivative
+        works, redistribute, and make non-production use of the Licensed Work. The
+        Licensor may make an Additional Use Grant, above, permitting limited
+        production use.
+        
+        Effective on the Change Date, or the fourth anniversary of the first publicly
+        available distribution of a specific version of the Licensed Work under this
+        License, whichever comes first, the Licensor hereby grants you rights under
+        the terms of the Change License, and the rights granted in the paragraph
+        above terminate.
+        
+        If your use of the Licensed Work does not comply with the requirements
+        currently in effect as described in this License, you must purchase a
+        commercial license from the Licensor, its affiliated entities, or authorized
+        resellers, or you must refrain from using the Licensed Work.
+        
+        All copies of the original and modified Licensed Work, and derivative works
+        of the Licensed Work, are subject to this License. This License applies
+        separately for each version of the Licensed Work and the Change Date may vary
+        for each version of the Licensed Work released by Licensor.
+        
+        You must conspicuously display this License on each original or modified copy
+        of the Licensed Work. If you receive the Licensed Work in original or
+        modified form from a third party, the terms and conditions set forth in this
+        License apply to your use of that work.
+        
+        Any use of the Licensed Work in violation of this License will automatically
+        terminate your rights under this License for the current and all other
+        versions of the Licensed Work.
+        
+        This License does not grant you any right in any trademark or logo of
+        Licensor or its affiliates (provided that you may use a trademark or logo of
+        Licensor as expressly required by this License).
+        
+        TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+        AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+        EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+        TITLE.
+License-File: LICENSE
+Keywords: bitbucket,cli,devops,github,migration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: posthog>=7.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: structlog>=24.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: enterprise
+Requires-Dist: redis>=5.0.0; extra == 'enterprise'
+Requires-Dist: rq>=1.16.0; extra == 'enterprise'
+Provides-Extra: secure
+Requires-Dist: keyring>=25.0.0; extra == 'secure'
+Description-Content-Type: text/markdown
+
+# bb2gh
+
+[![CI](https://github.com/n8group-oss/bb2gh/actions/workflows/ci.yml/badge.svg)](https://github.com/n8group-oss/bb2gh/actions/workflows/ci.yml)
+[![Security](https://github.com/n8group-oss/bb2gh/actions/workflows/security.yml/badge.svg)](https://github.com/n8group-oss/bb2gh/actions/workflows/security.yml)
+[![Documentation](https://img.shields.io/badge/docs-GitBook-blue.svg)](https://n8-group.gitbook.io/bb2gh/)
+[![License: BSL-1.1](https://img.shields.io/badge/License-BSL--1.1-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**Bitbucket to GitHub migration tool** - Migrate repositories with full metadata preservation including Pull Requests, comments, user attribution, and secrets.
+
+## Features
+
+- **Terraform-inspired workflow**: `discover` → `plan` → `migrate` → `validate`
+- **Full metadata preservation**: Git history, branches, tags, PRs, comments, user attribution
+- **LFS support**: Automatic detection and migration of LFS objects
+- **Secrets migration**: Assisted secrets migration via Infisical integration
+- **Enterprise ready**: Supports GitHub Enterprise Cloud, Data Residency, and Enterprise Server
+- **Resilient**: Checkpoint/resume capability, rollback options
+
+## Requirements
+
+- Python >= 3.11
+- Git and git-lfs available in PATH
+
+## Installation
+
+```bash
+# Using pip
+pip install bb2gh
+
+# Using pipx (recommended for CLI tools)
+pipx install bb2gh
+```
+
+## Setup
+
+### Option 1: Interactive login (recommended)
+
+The fastest way to get started. Stores secrets securely in your OS keychain:
+
+```bash
+# Install with keyring support
+pip install bb2gh[secure]
+
+# Run interactive setup — prompts for Bitbucket and GitHub credentials
+bb2gh auth login
+```
+
+The login flow will:
+1. Ask for your Bitbucket username and API token (or OAuth2 credentials)
+2. Ask for your GitHub personal access token (or GitHub App details)
+3. Validate credentials against the APIs
+4. Store secrets in your OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+5. Save non-secret config to `~/.bb2gh/config.yaml`
+
+Verify your setup:
+
+```bash
+bb2gh auth status
+```
+
+### Option 2: Environment variables (CI/CD)
+
+For headless environments, pipelines, or Docker:
+
+```bash
+# Bitbucket — create an API token at:
+# https://id.atlassian.com/manage-profile/security/api-tokens
+export BB_USERNAME=your-username
+export BB_API_TOKEN=your-api-token
+
+# GitHub — create a fine-grained PAT at:
+# https://github.com/settings/personal-access-tokens/new
+export GH_TOKEN=ghp_your-token
+```
+
+> **Note**: Bitbucket App Passwords are deprecated and will stop working in June 2026. Use API tokens instead — they work the same way (HTTP Basic auth) with the same username. See the [Authentication Guide](https://n8-group.gitbook.io/bb2gh/getting-started/authentication) for details.
+
+### Required permissions
+
+**Bitbucket API token scopes**: `repository:read`, `pullrequest:read`
+
+**GitHub PAT permissions**: Contents (write), Pull requests (write), Administration (write), Metadata (read)
+
+## Quick Start
+
+```bash
+# 1. Discover your Bitbucket workspace
+bb2gh discover --workspace my-company --output inventory.json
+
+# 2. Generate a migration plan
+bb2gh plan --inventory inventory.json --target-org my-gh-org --output plan.json
+
+# 3. Execute the migration
+bb2gh migrate --plan plan.json
+
+# 4. Validate the migration
+bb2gh validate --migration mig_xxx
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/n8group-oss/bb2gh.git
+cd bb2gh
+
+# Install Hatch (build system / environment manager)
+pip install hatch
+
+# Create the development environment (installs Python 3.11+ and all dependencies)
+hatch env create
+
+# Install pre-commit hooks
+hatch run pre-commit install
+
+# Run tests
+hatch run test
+
+# Run tests with coverage
+hatch run test-cov
+
+# Run linting
+hatch run lint
+
+# Run type checking
+hatch run type-check
+
+# Run all checks (lint + format-check + type-check + tests)
+hatch run all
+```
+
+## Documentation
+
+Full documentation is available at **[n8-group.gitbook.io/bb2gh](https://n8-group.gitbook.io/bb2gh/)**
+
+- [Getting Started Guide](https://n8-group.gitbook.io/bb2gh/getting-started/installation)
+- [Command Reference](https://n8-group.gitbook.io/bb2gh/commands)
+- [Configuration Reference](https://n8-group.gitbook.io/bb2gh/getting-started/configuration)
+- [User Mapping Guide](https://n8-group.gitbook.io/bb2gh/guides/user-mapping)
+- [Enterprise Features](https://n8-group.gitbook.io/bb2gh/guides/enterprise)
+
+## License
+
+Business Source License 1.1 - see [LICENSE](LICENSE) for details.
+
+The license allows free use for any purpose except offering a competing migration service. After 4 years from each release, that version converts to Apache 2.0.
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a PR.

bb2gh-0.2.1/README.md

@@ -0,0 +1,151 @@
+# bb2gh
+
+[![CI](https://github.com/n8group-oss/bb2gh/actions/workflows/ci.yml/badge.svg)](https://github.com/n8group-oss/bb2gh/actions/workflows/ci.yml)
+[![Security](https://github.com/n8group-oss/bb2gh/actions/workflows/security.yml/badge.svg)](https://github.com/n8group-oss/bb2gh/actions/workflows/security.yml)
+[![Documentation](https://img.shields.io/badge/docs-GitBook-blue.svg)](https://n8-group.gitbook.io/bb2gh/)
+[![License: BSL-1.1](https://img.shields.io/badge/License-BSL--1.1-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**Bitbucket to GitHub migration tool** - Migrate repositories with full metadata preservation including Pull Requests, comments, user attribution, and secrets.
+
+## Features
+
+- **Terraform-inspired workflow**: `discover` → `plan` → `migrate` → `validate`
+- **Full metadata preservation**: Git history, branches, tags, PRs, comments, user attribution
+- **LFS support**: Automatic detection and migration of LFS objects
+- **Secrets migration**: Assisted secrets migration via Infisical integration
+- **Enterprise ready**: Supports GitHub Enterprise Cloud, Data Residency, and Enterprise Server
+- **Resilient**: Checkpoint/resume capability, rollback options
+
+## Requirements
+
+- Python >= 3.11
+- Git and git-lfs available in PATH
+
+## Installation
+
+```bash
+# Using pip
+pip install bb2gh
+
+# Using pipx (recommended for CLI tools)
+pipx install bb2gh
+```
+
+## Setup
+
+### Option 1: Interactive login (recommended)
+
+The fastest way to get started. Stores secrets securely in your OS keychain:
+
+```bash
+# Install with keyring support
+pip install bb2gh[secure]
+
+# Run interactive setup — prompts for Bitbucket and GitHub credentials
+bb2gh auth login
+```
+
+The login flow will:
+1. Ask for your Bitbucket username and API token (or OAuth2 credentials)
+2. Ask for your GitHub personal access token (or GitHub App details)
+3. Validate credentials against the APIs
+4. Store secrets in your OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+5. Save non-secret config to `~/.bb2gh/config.yaml`
+
+Verify your setup:
+
+```bash
+bb2gh auth status
+```
+
+### Option 2: Environment variables (CI/CD)
+
+For headless environments, pipelines, or Docker:
+
+```bash
+# Bitbucket — create an API token at:
+# https://id.atlassian.com/manage-profile/security/api-tokens
+export BB_USERNAME=your-username
+export BB_API_TOKEN=your-api-token
+
+# GitHub — create a fine-grained PAT at:
+# https://github.com/settings/personal-access-tokens/new
+export GH_TOKEN=ghp_your-token
+```
+
+> **Note**: Bitbucket App Passwords are deprecated and will stop working in June 2026. Use API tokens instead — they work the same way (HTTP Basic auth) with the same username. See the [Authentication Guide](https://n8-group.gitbook.io/bb2gh/getting-started/authentication) for details.
+
+### Required permissions
+
+**Bitbucket API token scopes**: `repository:read`, `pullrequest:read`
+
+**GitHub PAT permissions**: Contents (write), Pull requests (write), Administration (write), Metadata (read)
+
+## Quick Start
+
+```bash
+# 1. Discover your Bitbucket workspace
+bb2gh discover --workspace my-company --output inventory.json
+
+# 2. Generate a migration plan
+bb2gh plan --inventory inventory.json --target-org my-gh-org --output plan.json
+
+# 3. Execute the migration
+bb2gh migrate --plan plan.json
+
+# 4. Validate the migration
+bb2gh validate --migration mig_xxx
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/n8group-oss/bb2gh.git
+cd bb2gh
+
+# Install Hatch (build system / environment manager)
+pip install hatch
+
+# Create the development environment (installs Python 3.11+ and all dependencies)
+hatch env create
+
+# Install pre-commit hooks
+hatch run pre-commit install
+
+# Run tests
+hatch run test
+
+# Run tests with coverage
+hatch run test-cov
+
+# Run linting
+hatch run lint
+
+# Run type checking
+hatch run type-check
+
+# Run all checks (lint + format-check + type-check + tests)
+hatch run all
+```
+
+## Documentation
+
+Full documentation is available at **[n8-group.gitbook.io/bb2gh](https://n8-group.gitbook.io/bb2gh/)**
+
+- [Getting Started Guide](https://n8-group.gitbook.io/bb2gh/getting-started/installation)
+- [Command Reference](https://n8-group.gitbook.io/bb2gh/commands)
+- [Configuration Reference](https://n8-group.gitbook.io/bb2gh/getting-started/configuration)
+- [User Mapping Guide](https://n8-group.gitbook.io/bb2gh/guides/user-mapping)
+- [Enterprise Features](https://n8-group.gitbook.io/bb2gh/guides/enterprise)
+
+## License
+
+Business Source License 1.1 - see [LICENSE](LICENSE) for details.
+
+The license allows free use for any purpose except offering a competing migration service. After 4 years from each release, that version converts to Apache 2.0.
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a PR.