cli ¤

Command to list the backlog of issues.

Attributes:

• backlog_namespaces (list[str]) –

  Namespaces to fetch issues from.

• github_beneficiaries (dict[str, list[str]]) –

  Beneficiaries of GitHub sponsors.

• github_token (str) –

  A GitHub token. Recommended scopes: read:user.

• issue_labels (dict[str, str]) –

  Issue labels to keep in issues metadata, and how they are represented.

• limit (int) –

  Limit the number of issues to display.

• polar_beneficiaries (dict[str, list[str]]) –

  Beneficiaries of Polar sponsors.

• polar_token (str) –

  A Polar token. Recommended scopes: user:read, issues:read, subscriptions:read.

• public (bool) –

  Only use public sponsorships.

• sort (list[Callable]) –

  Sort strategy.

backlog_namespaces: list[str]

github_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

github_token: str = ''

issue_labels: dict[str, str] = field(default_factory=dict)

limit: int = 0

polar_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

polar_token: str = ''

public: bool = False

sort: list[Callable] = field(default_factory=list)

Command to manage the local index.

Attributes:

• subcommand (CommandIndexList | CommandIndexAdd | CommandIndexRemove | CommandIndexUpdate | CommandIndexStart | CommandIndexStatus | CommandIndexStop | CommandIndexLogs) –

  The selected subcommand.

subcommand: (
    CommandIndexList
    | CommandIndexAdd
    | CommandIndexRemove
    | CommandIndexUpdate
    | CommandIndexStart
    | CommandIndexStatus
    | CommandIndexStop
    | CommandIndexLogs
)

Command to add a repository to the watched repositories.

Attributes:

• distributions_directory (Path) –

  Directory where the distributions are stored.

• repositories (list[str]) –

  List of repositories (GitHub namespace/project or Git URL git@host:repo).

• sources_directory (Path) –

  Directory where the sources are stored.

• url (str) –

  URL of the index to upload packages to.

distributions_directory: Path = DEFAULT_DIST_DIR

repositories: list[str]

sources_directory: Path = DEFAULT_REPO_DIR

url: str = DEFAULT_INDEX_URL

Command to list the watched repositories.

Attributes:

• distributions_directory (Path) –

  Directory where the distributions are stored.

• dists (bool) –

  List distributions.

• projects (bool) –

  List projects.

• sources_directory (Path) –

  Directory where the sources are stored.

distributions_directory: Path = DEFAULT_DIST_DIR

dists: bool = False

projects: bool = False

sources_directory: Path = DEFAULT_REPO_DIR

Command to show the server logs.

Command to remove a repository and its distributions (if served locally).

Attributes:

• distributions_directory (Path) –

  Directory where the distributions are stored.

• repositories (list[str]) –

  List of repository names.

• sources_directory (Path) –

  Directory where the sources are stored.

distributions_directory: Path = DEFAULT_DIST_DIR

repositories: list[str]

sources_directory: Path = DEFAULT_REPO_DIR

Command to start the server.

Attributes:

• background (bool) –

  Run the server in the background.

• distributions_directory (Path) –

  Directory where the distributions are stored.

• log_path (str | None) –

  Where to write index server logs.

• sources_directory (Path) –

  Directory where the sources are stored.

• url (str) –

  URL to serve the index at.

background: bool = False

distributions_directory: Path = DEFAULT_DIST_DIR

log_path: str | None = None

sources_directory: Path = DEFAULT_REPO_DIR

url: str = DEFAULT_INDEX_URL

Command to show the server status.

Command to stop the server.

Command to update watched projects.

Attributes:

• distributions_directory (Path) –

  Directory where the distributions are stored.

• repositories (list[str]) –

  List of repository names.

• sources_directory (Path) –

  Directory where the sources are stored.

• url (str) –

  URL of the index to upload packages to.

distributions_directory: Path = DEFAULT_DIST_DIR

repositories: list[str] = field(default_factory=list)

sources_directory: Path = DEFAULT_REPO_DIR

url: str = DEFAULT_INDEX_URL

Command to manage your Insiders projects.

Attributes:

• config (Config) –

  Path to the configuration file.

• debug_info (bool) –

  Print debug information.

• log_downgrade (tuple[str, ...]) –

  Downgrade INFO logs to DEBUG for logs originating from these modules/loggers. By default, all dependency logs are downgraded.

• log_exclude (tuple[str, ...]) –

  Exclude logs originating from these modules/loggers. Applied after inclusion. By default, nothing is excluded.

• log_include (tuple[str, ...]) –

  Include logs originating from these modules/loggers. By default, all logs are included.

• log_level (Literal['TRACE', 'DEBUG', 'INFO', 'SUCCESS', 'WARNING', 'ERROR', 'CRITICAL']) –

  Lowest log level to display. Levels below that will be hidden.

• log_path (str | None) –

  Write log messages to this file path.

• subcommand (CommandBacklog | CommandIndex | CommandProject | CommandSponsors) –

  The selected subcommand.

• version (bool) –

  Print the program version and exit.

config: Config = field(default_factory=_load_config)

debug_info: bool = False

log_downgrade: tuple[str, ...] = field(
    default_factory=tuple
)

log_exclude: tuple[str, ...] = field(default_factory=tuple)

log_include: tuple[str, ...] = field(default_factory=tuple)

log_level: Literal[
    "TRACE",
    "DEBUG",
    "INFO",
    "SUCCESS",
    "WARNING",
    "ERROR",
    "CRITICAL",
] = "INFO"

log_path: str | None = None

subcommand: (
    CommandBacklog
    | CommandIndex
    | CommandProject
    | CommandSponsors
)

version: bool = False

Command to manage projects on GitHub and locally.

Attributes:

• subcommand (CommandProjectCreate | CommandProjectCheck | CommandProjectPyPIRegister) –

  The selected subcommand.

subcommand: (
    CommandProjectCreate
    | CommandProjectCheck
    | CommandProjectPyPIRegister
)

Command to check GitHub projects.

Command to create public/insiders repositories.

Attributes:

• copier_template (str | None) –

  Copier template to generate new projects with.

• copier_template_answers (dict[str, str] | None) –

  Copier template answers to use when generating a project.

• description (str) –

  Shared description.

• github_username (str | None) –

  GitHub username.

• insiders_namespace (str | None) –

  Namespace of the insiders repository.

• insiders_project_directory (Path) –

  Directory in which to clone the insiders repository.

• insiders_repository (str | None) –

  Name of the insiders repository.

• namespace (str) –

  Namespace of the public repository.

• post_creation_command (list[str] | None) –

  Command to run after creating the public repository.

• project_directory (Path) –

  Directory in which to clone the public repository.

• pypi_username (str | None) –

  PyPI username to register the project with.

• register_on_pypi (bool) –

  Whether to register the project on PyPI after creating it.

• repository (str) –

  Name of the public repository.

copier_template: str | None = None

copier_template_answers: dict[str, str] | None = None

description: str

github_username: str | None = None

insiders_namespace: str | None = None

insiders_project_directory: Path

insiders_repository: str | None = None

namespace: str

post_creation_command: list[str] | None = None

project_directory: Path

pypi_username: str | None = None

register_on_pypi: bool = False

repository: str

Command to register a project name on PyPI.

Attributes:

• description (str) –

  Description of the project on PyPI.

• name (str) –

  Name to register.

• username (str) –

  Username on PyPI (your account).

description: str

name: str

username: str

Command to manage sponsors.

Attributes:

• subcommand (CommandSponsorsList | CommandSponsorsShow | CommandSponsorsTeamList | CommandSponsorsTeamSync) –

  The selected subcommand.

subcommand: (
    CommandSponsorsList
    | CommandSponsorsShow
    | CommandSponsorsTeamList
    | CommandSponsorsTeamSync
)

Command to list sponsors.

Attributes:

• exclude_users (list[str]) –

  Users that should never be in the team.

• github_beneficiaries (dict[str, list[str]]) –

  Beneficiaries of GitHub sponsors.

• github_sponsored_account (str) –

  The sponsored account on GitHub Sponsors.

• github_token (str) –

  A GitHub token. Recommended scopes: admin:org and read:user.

• include_users (list[str]) –

  Users that should always be in the team.

• minimum_amount (int) –

  Minimum amount to be considered an insider.

• polar_beneficiaries (dict[str, list[str]]) –

  Beneficiaries of Polar sponsors.

• polar_sponsored_account (str) –

  The sponsored account on Polar.

• polar_token (str) –

  A Polar token. Recommended scopes: user:read, issues:read, subscriptions:read.

• public (bool) –

  Only use public sponsorships.

• sponsorships (bool) –

  List sponsorships rather than users/sponsors.

exclude_users: list[str] = field(default_factory=list)

github_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

github_sponsored_account: str = ''

github_token: str = ''

include_users: list[str] = field(default_factory=list)

minimum_amount: int = 0

polar_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

polar_sponsored_account: str = ''

polar_token: str = ''

public: bool = False

sponsorships: bool = False

Command to show details about a sponsor/user.

Attributes:

• dry_run (bool) –

  Display the changes that would be made, without making them.

• exclude_users (list[str]) –

  Users that should never be in the team.

• github_beneficiaries (dict[str, list[str]]) –

  A mapping of users belonging to sponsoring organizations.

• github_sponsored_account (str) –

  The sponsored account on GitHub Sponsors.

• github_token (str) –

  A GitHub token. Recommended scopes: admin:org and read:user.

• include_users (list[str]) –

  Users that should always be in the team.

• insiders_team (str) –

  The GitHub team to sync.

• minimum_amount (int) –

  Minimum amount to be considered an insider.

• polar_sponsored_account (str) –

  The sponsored account on Polar.

• polar_token (str) –

  A Polar token. Recommended scopes: user:read, issues:read, subscriptions:read.

dry_run: bool = False

exclude_users: list[str] = field(default_factory=list)

github_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

github_sponsored_account: str = ''

github_token: str = ''

include_users: list[str] = field(default_factory=list)

insiders_team: str

minimum_amount: int = 0

polar_sponsored_account: str = ''

polar_token: str = ''

Command to list team memberships.

Command to sync team memberships with current sponsors.

Attributes:

• dry_run (bool) –

  Display the changes that would be made, without making them.

• exclude_users (list[str]) –

  Users that should never be in the team.

• github_beneficiaries (dict[str, list[str]]) –

  A mapping of users belonging to sponsoring organizations.

• github_sponsored_account (str) –

  The sponsored account on GitHub Sponsors.

• github_token (str) –

  A GitHub token. Recommended scopes: admin:org and read:user.

• include_users (list[str]) –

  Users that should always be in the team.

• insiders_team (str) –

  The GitHub team to sync.

• minimum_amount (int) –

  Minimum amount to be considered an insider.

• polar_beneficiaries (dict[str, list[str]]) –

  Beneficiaries of Polar sponsors.

• polar_sponsored_account (str) –

  The sponsored account on Polar.

• polar_token (str) –

  A Polar token. Recommended scopes: user:read, issues:read, subscriptions:read.

dry_run: bool = False

exclude_users: list[str] = field(default_factory=list)

github_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

github_sponsored_account: str = ''

github_token: str = ''

include_users: list[str] = field(default_factory=list)

insiders_team: str

minimum_amount: int = 0

polar_beneficiaries: dict[str, list[str]] = field(
    default_factory=dict
)

polar_sponsored_account: str = ''

polar_token: str = ''

Bases: ValueFrom

Parameters:

• field (Unset | property) –