migration-core 0.1.0rc1

Shared library for the N8 Group migration product family

migration-core

Shared Python library for the N8 Group migration product family.

migration-core packages the GitHub-side adapters, shared target models, exception hierarchy, and identity helpers used by migration tools such as bb2gh and ado2gh.

What This Package Includes

• GitHub target adapter abstractions and implementations under migration_core.adapters
• Shared GitHub-facing data models under migration_core.models
• Shared exception types under migration_core.exceptions
• Enterprise identity helpers and clients under migration_core.identity
• Supporting architecture and specification docs in docs/ and .specify/

This repository is a library package. It does not currently ship a standalone CLI.

Installation

Install the base package from a package index:

python -m pip install migration-core

Install with GitHub App authentication support:

python -m pip install "migration-core[github-app]"

Install from source for local development and release verification:

python -m pip install -e ".[dev,github-app]"

Optional Extras

• github-app - adds pyjwt[crypto] for GitHub App JWT generation used by the multi-app adapter flow
• dev - adds local quality and packaging tools, including pytest, ruff, mypy, and build

Local Verification

After installing the development extras, run:

python -m build
python -m pytest -v
ruff check src tests
mypy src

Current Module Surface

Top-level package exports:

from migration_core import __version__
from migration_core.adapters import SourceAdapter, TargetAdapter
from migration_core.adapters.github import (
    GitHubAppConfig,
    GitHubBaseAdapter,
    GitHubCloudAdapter,
    GitHubCloudDRAdapter,
    GitHubServerAdapter,
    MultiAppGitHubAdapter,
)
from migration_core.exceptions import APIError, MigrationError
from migration_core.models import GitHubRulesetConfig, Repository, User

Additional identity clients are available as submodules:

from migration_core.identity.github_saml import GitHubSAMLClient
from migration_core.identity.github_scim import GitHubSCIMClient

Repository Layout

• src/migration_core/ - package source
• tests/ - unit and integration tests
• docs/architecture/ - architecture reference docs
• .specify/ - shared specification kit assets used by product repos

License

Licensed under the Business Source License 1.1. See LICENSE.