Commands

sereto.cli.commands

WorkingDir

Helper class for REPL implementing the cd command.

Attributes:

Name	Type	Description
old_cwd	Path	The previous working directory.

Source code in sereto/cli/commands.py

class WorkingDir(metaclass=Singleton):
    """Helper class for REPL implementing the `cd` command.

    Attributes:
        old_cwd: The previous working directory.
    """

    old_cwd: Path = Field(default_factory=Path.cwd)

    def change(self, dst: Path, /) -> None:
        """Change the current working directory to the new location.

        Also saves the previous location for future reference.

        Args:
            dst: The new working directory

        Raises:
            SeretoPathError: If the provided path is not an existing directory.
        """
        if not dst.is_dir():
            raise SeretoPathError(f"Directory '{dst}' does not exist.")

        cwd = Path.cwd()
        os.chdir(dst)
        self.old_cwd = cwd

    def go_back(self) -> None:
        """Change the current working directory to the previous location."""
        self.change(self.old_cwd)

change(dst)

Change the current working directory to the new location.

Also saves the previous location for future reference.

Parameters:

Name	Type	Description	Default
dst	Path	The new working directory	required

Raises:

Type	Description
SeretoPathError	If the provided path is not an existing directory.

Source code in sereto/cli/commands.py

def change(self, dst: Path, /) -> None:
    """Change the current working directory to the new location.

    Also saves the previous location for future reference.

    Args:
        dst: The new working directory

    Raises:
        SeretoPathError: If the provided path is not an existing directory.
    """
    if not dst.is_dir():
        raise SeretoPathError(f"Directory '{dst}' does not exist.")

    cwd = Path.cwd()
    os.chdir(dst)
    self.old_cwd = cwd

go_back()

Change the current working directory to the previous location.

Source code in sereto/cli/commands.py

def go_back(self) -> None:
    """Change the current working directory to the previous location."""
    self.change(self.old_cwd)

repl_cd(project_id)

Switch the active project in the REPL.

Parameters:

Name	Type	Description	Default
project_id	TypeProjectId | Literal['-']	The ID of the project to switch to. Use '-' to go back to the previous working directory.	required

Raises:

Type	Description
SeretoValueError	If the project ID is invalid.
SeretoPathError	If the project's path does not exist.

Source code in sereto/cli/commands.py

@click.command(name="cd")
@handle_exceptions
@click.argument("project_id", type=str)
@validate_call
def repl_cd(project_id: TypeProjectId | Literal["-"]) -> None:
    """Switch the active project in the REPL.

    Args:
        project_id: The ID of the project to switch to. Use '-' to go back to the previous working directory.

    Raises:
        SeretoValueError: If the project ID is invalid.
        SeretoPathError: If the project's path does not exist.
    """
    repl_cd_impl(project_id=project_id)

repl_exit()

Exit from the Read-Eval-Print Loop (REPL).

Source code in sereto/cli/commands.py

@click.command(name="exit")
def repl_exit() -> None:
    """Exit from the Read-Eval-Print Loop (REPL)."""
    click_repl_exit()

repl_log(log_level)

Set the logging level for current REPL session.

Source code in sereto/cli/commands.py

@click.command(name="log")
@click.argument("log_level", type=click.Choice([level.value for level in LogLevel], case_sensitive=False))
def repl_log(log_level: LogLevel) -> None:
    """Set the logging level for current REPL session."""
    setup_logging(log_level)

sereto_ls(settings)

List all projects in the user's projects directory.

Print a table with the details to the console.

Parameters:

Name	Type	Description	Default
settings	Settings	The Settings object.	required

Source code in sereto/cli/commands.py

@validate_call
def sereto_ls(settings: Settings) -> None:
    """List all projects in the user's projects directory.

    Print a table with the details to the console.

    Args:
        settings: The Settings object.
    """
    project_paths: list[Path] = [d for d in settings.projects_path.iterdir() if is_project_dir(d)]
    table = Table("ID", "Name", "Location", title="Projects", box=box.MINIMAL)

    for dir in project_paths:
        try:
            project_name = Project.load_from(dir).config.last_config.name
        except (RuntimeError, SeretoValueError):
            project_name = "n/a"

        table.add_row(dir.name, project_name, f"[link {dir.as_uri()}]{dir}")

    Console().print(table, justify="center")

sereto_repl(cli)

Start an interactive Read-Eval-Print Loop (REPL) session.

Parameters:

Name	Type	Description	Default
cli	Group	The main CLI group.	required

Source code in sereto/cli/commands.py

def sereto_repl(cli: Group) -> None:
    """Start an interactive Read-Eval-Print Loop (REPL) session.

    Args:
        cli: The main CLI group.
    """
    logger.info(
        r"""
  ____       ____     _____
 / ___|  ___|  _ \ __|_   _|__
 \___ \ / _ \ |_) / _ \| |/ _ \
  ___) |  __/  _ <  __/| | (_) |
 |____/ \___|_| \_\___||_|\___/

Welcome to [blue]SeReTo Interactive Mode[/blue]!
---------------------------------------------
Type 'exit' or press 'Ctrl+D' to quit.
Use 'cd <ID>' to change the active project.
Type '-h'/'--help' to see available commands.
    """,
        markup=True,
    )

    # Add REPL specific commands
    cli.add_command(repl_cd)
    cli.add_command(repl_exit)
    cli.add_command(repl_log)

    # Define the prompt style
    prompt_style = Style.from_dict(
        {
            "debug": "red",
            "sereto": "#02a0f0 bold",
            "bracket": "#8a8a8a",
            "project_id": "#00ff00",
            "gt": "#8a8a8a bold",
        }
    )

    current_context = get_current_context()

    group_ctx = current_context
    if current_context.parent is not None and not isinstance(current_context.command, Group):
        group_ctx = current_context.parent

    prompt_kwargs = {
        "message": _get_repl_prompt,
        "history": FileHistory(Path(get_app_dir(app_name="sereto")) / ".sereto_history"),
        "style": prompt_style,
        "completer": EscapedClickCompleter(cli, ctx=group_ctx),
    }

    current_context.meta["in_repl"] = True

    repl(current_context, prompt_kwargs=prompt_kwargs)