Repository

Repository Manager

sierra.package_manager.repository

Repository management for Sierra Package Manager.

Handles adding, removing, and updating GitHub repository sources.

Classes

RepositorySource dataclass

Python

RepositorySource(
    name: str,
    url: str,
    branch: str = "main",
    enabled: bool = True,
    priority: int = 10,
)

Represents a package repository source.

Attributes

name instance-attribute

Python

name: str

url instance-attribute

Python

url: str

branch class-attribute instance-attribute

Python

branch: str = 'main'

enabled class-attribute instance-attribute

Python

enabled: bool = True

priority class-attribute instance-attribute

Python

priority: int = 10

Functions

to_dict

Python

to_dict() -> dict[str, typing.Any]

Convert to dictionary.

from_dict classmethod

Python

from_dict(data: dict) -> RepositorySource

Create from dictionary.

RepositoryManager

Python

RepositoryManager(
    config_dir: Path, logger: UniversalLogger | None = None
)

Manages GitHub repository sources for package discovery.

Handles: - Adding/removing repository sources - Updating package registries
- Caching registry data - Validating repository structure

Initialize repository manager.

PARAMETER	DESCRIPTION
config_dir	Directory for storing configuration and cache TYPE: Path
logger	Logger instance for tracking operations TYPE: UniversalLogger DEFAULT: None

Attributes

logger instance-attribute

Python

logger = logger or UniversalLogger('RepositoryManager')

config_dir instance-attribute

Python

config_dir = Path(config_dir)

sources_file instance-attribute

Python

sources_file = self.config_dir / 'sources.json'

cache_dir instance-attribute

Python

cache_dir = self.config_dir / 'cache' / 'registry'

sources instance-attribute

Python

sources: list[RepositorySource] = []

Functions

load_sources

Python

load_sources() -> None

Load repository sources from disk.

save_sources

Python

save_sources() -> None

Save repository sources to disk.

add_source

Python

add_source(
    url: str,
    name: str | None = None,
    branch: str = "main",
    priority: int = 10,
) -> RepositorySource

Add a new repository source.

PARAMETER	DESCRIPTION
url	GitHub repository URL TYPE: str
name	Custom name for the source TYPE: str DEFAULT: None
branch	Git branch to use TYPE: str DEFAULT: 'main'
priority	Priority for package resolution (lower = higher priority) TYPE: int DEFAULT: 10

RETURNS	DESCRIPTION
RepositorySource	The created source

RAISES	DESCRIPTION
ValueError	If source already exists or URL is invalid

remove_source

Python

remove_source(name: str) -> bool

Remove a repository source.

PARAMETER	DESCRIPTION
name	Name of the source to remove TYPE: str

RETURNS	DESCRIPTION
bool	True if removed, False if not found

list_sources

Python

list_sources() -> list[RepositorySource]

Get all configured sources.

RETURNS	DESCRIPTION
list[RepositorySource]	List of repository sources sorted by priority

get_source

Python

get_source(name: str) -> RepositorySource | None

Get a specific source by name.

PARAMETER	DESCRIPTION
name	Source name TYPE: str

RETURNS	DESCRIPTION
RepositorySource | None	The source if found, None otherwise

update_registry

Python

update_registry(
    source_name: str | None = None,
) -> dict[str, int]

Update package registries from sources.

PARAMETER	DESCRIPTION
source_name	Update specific source, or all if None TYPE: str DEFAULT: None

RETURNS	DESCRIPTION
dict[str, int]	Map of source name to package count

get_cached_registry

Python

get_cached_registry(
    source_name: str,
) -> dict[str, typing.Any] | None

Get cached registry for a source.

PARAMETER	DESCRIPTION
source_name	Source name TYPE: str

RETURNS	DESCRIPTION
dict | None	Cached registry data or None if not cached