bsm-cli 1.6.0b3__tar.gz

bsm_cli-1.6.0b3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Danny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bsm_cli-1.6.0b3/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: bsm-cli
+Version: 1.6.0b3
+Summary: A CLI for managing Bedrock servers via BSM API
+Author-email: DMedina559 <dmedina559-github@outlook.com>
+Project-URL: Homepage, https://github.com/DMedina559/bsm-api-client
+Keywords: minecraft,bedrock,server,manager,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<8.5,>=8.2.0
+Requires-Dist: questionary<2.2,>=2.1.0
+Requires-Dist: bsm-api-client
+Provides-Extra: dev
+Requires-Dist: pytest<9.2,>=8.4.0; extra == "dev"
+Requires-Dist: pytest-mock<3.16,>=3.14.0; extra == "dev"
+Requires-Dist: pytest-asyncio<1.5,>=1.1.0; extra == "dev"
+Requires-Dist: black<26.6,>=25.1.0; extra == "dev"
+Requires-Dist: flake8<7.4,>=7.3.0; extra == "dev"
+Requires-Dist: isort<8.1,>=5.13.0; extra == "dev"
+Requires-Dist: mypy<2.2,>=1.10.0; extra == "dev"
+Requires-Dist: bedrock-server-manager<3.11.0,>=3.10.0b3; extra == "dev"
+Requires-Dist: pre-commit<4.7,>=4.6.0; extra == "dev"
+Dynamic: license-file
+
+<div style="text-align: center;">
+    <img src="https://raw.githubusercontent.com/DMedina559/bsm-frontend/main/frontend/public/image/icon/favicon.svg" alt="BSM Logo" width="150">
+</div>
+
+# bsm-cli
+
+<p align="center">
+  <a href="https://github.com/DMedina559/bsm-api-client/releases">
+    <img alt="Stable" src="https://img.shields.io/github/v/release/DMedina559/bsm-api-client?label=Stable&color=blue">
+  </a>
+  <a href="https://github.com/DMedina559/bsm-api-client/releases">
+    <img alt="Pre-Release" src="https://img.shields.io/github/v/release/DMedina559/bsm-api-client?include_prereleases&label=Pre-Release&color=red">
+  </a>
+  <a href="https://github.com/DMedina559/bsm-api-client/actions">
+    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/DMedina559/bsm-api-client/build-test.yml?label=Tests&event=push">
+  </a>
+</p>
+
+## Introduction
+
+`bsm-cli` is a command-line interface tool for managing Minecraft Bedrock Dedicated Servers via the Bedrock Server Manager API.
+
+## Features
+
+*   Full CLI interface using `click` and `questionary`.
+*   Interactive menus for server management.
+*   Realtime server state updates via WebSocket.
+*   Seamlessly manages configuration for server and backups.
+
+## Installation
+
+Install the library using pip:
+
+```bash
+pip install bsm-cli
+```
+
+## Quick Start
+
+You can invoke the CLI using:
+
+```bash
+bsm-cli
+```
+
+Which will trigger the interactive menu allowing you to manage and configure your Bedrock Dedicated Servers.

bsm_cli-1.6.0b3/README.md

@@ -0,0 +1,46 @@
+<div style="text-align: center;">
+    <img src="https://raw.githubusercontent.com/DMedina559/bsm-frontend/main/frontend/public/image/icon/favicon.svg" alt="BSM Logo" width="150">
+</div>
+
+# bsm-cli
+
+<p align="center">
+  <a href="https://github.com/DMedina559/bsm-api-client/releases">
+    <img alt="Stable" src="https://img.shields.io/github/v/release/DMedina559/bsm-api-client?label=Stable&color=blue">
+  </a>
+  <a href="https://github.com/DMedina559/bsm-api-client/releases">
+    <img alt="Pre-Release" src="https://img.shields.io/github/v/release/DMedina559/bsm-api-client?include_prereleases&label=Pre-Release&color=red">
+  </a>
+  <a href="https://github.com/DMedina559/bsm-api-client/actions">
+    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/DMedina559/bsm-api-client/build-test.yml?label=Tests&event=push">
+  </a>
+</p>
+
+## Introduction
+
+`bsm-cli` is a command-line interface tool for managing Minecraft Bedrock Dedicated Servers via the Bedrock Server Manager API.
+
+## Features
+
+*   Full CLI interface using `click` and `questionary`.
+*   Interactive menus for server management.
+*   Realtime server state updates via WebSocket.
+*   Seamlessly manages configuration for server and backups.
+
+## Installation
+
+Install the library using pip:
+
+```bash
+pip install bsm-cli
+```
+
+## Quick Start
+
+You can invoke the CLI using:
+
+```bash
+bsm-cli
+```
+
+Which will trigger the interactive menu allowing you to manage and configure your Bedrock Dedicated Servers.

bsm_cli-1.6.0b3/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+requires = ["setuptools>=80.9", "setuptools_scm"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bsm-cli"
+dynamic = ["version"]
+authors = [
+    { name="DMedina559", email="dmedina559-github@outlook.com" },
+]
+description = "A CLI for managing Bedrock servers via BSM API"
+readme = "README.md"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+]
+dependencies = [
+    "click >=8.2.0,<8.5",
+    "questionary >=2.1.0,<2.2",
+    "bsm-api-client",
+]
+keywords = ["minecraft", "bedrock", "server", "manager", "cli"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest >=8.4.0,<9.2",
+    "pytest-mock >=3.14.0,<3.16",
+    "pytest-asyncio >= 1.1.0,< 1.5",
+    "black >=25.1.0,<26.6",
+    "flake8 >=7.3.0,<7.4",
+    "isort >=5.13.0,<8.1",
+    "mypy >=1.10.0,<2.2",
+    "bedrock-server-manager >=3.10.0b3,<3.11.0",
+    "pre-commit >=4.6.0,<4.7",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/DMedina559/bsm-api-client"
+
+[project.scripts]
+bsm-cli = "bsm_cli.__main__:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["bsm_cli*"]
+
+[tool.setuptools_scm]
+root = "../.."
+local_scheme = "no-local-version"
+
+[tool.black]
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

bsm_cli-1.6.0b3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bsm_cli-1.6.0b3/src/bsm_cli/__main__.py

@@ -0,0 +1,88 @@
+try:
+    import click
+
+except ImportError:
+    print(
+        "Please install the required dependencies with `pip install bsm-api-client[cli]`"
+    )
+    exit(1)
+
+
+from contextlib import asynccontextmanager
+
+from bsm_cli.account import account
+from bsm_cli.addon import addon
+from bsm_cli.allowlist import allowlist
+from bsm_cli.auth import auth
+from bsm_cli.backup import backup
+from bsm_cli.bans import bans
+from bsm_cli.config import Config
+from bsm_cli.content import content
+from bsm_cli.decorators import AsyncGroup
+from bsm_cli.main_menus import main_menu
+from bsm_cli.permissions import permissions
+from bsm_cli.player import player
+from bsm_cli.plugins import plugin
+from bsm_cli.properties import properties
+from bsm_cli.server import server
+from bsm_cli.system import system
+from bsm_cli.users import users
+from bsm_cli.world import world
+
+from bsm_api_client import BedrockServerManagerApi
+
+
+@click.group(cls=AsyncGroup, invoke_without_command=True)
+@click.pass_context
+def cli(ctx):
+    """A CLI for managing Bedrock servers."""
+    ctx.obj["cli"] = cli
+    if ctx.invoked_subcommand is None:
+        return main_menu(ctx)
+
+
+@cli.context
+@asynccontextmanager
+async def cli_context(ctx):
+    config = Config()
+    ctx.obj["config"] = config
+
+    try:
+        client = BedrockServerManagerApi(
+            base_url=config.base_url,
+            jwt_token=config.jwt_token,
+            verify_ssl=config.verify_ssl,
+        )
+    except ValueError as e:
+        # Ignore AuthError when logging out or auth group is called
+        if ctx.invoked_subcommand == auth or ctx.invoked_subcommand is None:
+            client = None
+        else:
+            raise e
+    ctx.obj["client"] = client
+
+    try:
+        yield
+    finally:
+        if ctx.obj.get("client"):
+            await ctx.obj["client"].close()
+
+
+cli.add_command(auth)
+cli.add_command(server)
+cli.add_command(addon)
+cli.add_command(backup)
+cli.add_command(player)
+cli.add_command(plugin)
+cli.add_command(allowlist)
+cli.add_command(bans)
+cli.add_command(permissions)
+cli.add_command(properties)
+cli.add_command(system)
+cli.add_command(world)
+cli.add_command(account)
+cli.add_command(content)
+cli.add_command(users)
+
+if __name__ == "__main__":
+    cli()

bsm_cli-1.6.0b3/src/bsm_cli/account.py

@@ -0,0 +1,75 @@
+# src/bsm_cli/account.py
+"""CLI commands for account management."""
+
+import click
+from bsm_cli.decorators import pass_async_context
+
+
+@click.group()
+def account():
+    """Commands for managing your account."""
+    pass
+
+
+@account.command()
+@pass_async_context
+async def details(ctx):
+    """Get your account details."""
+    client = ctx.obj["client"]
+    details = await client.async_get_account_details()
+    click.echo(details.model_dump_json(indent=2))
+
+
+@account.command()
+@click.option("--theme", prompt="Theme name", help="The name of the theme to set.")
+@pass_async_context
+async def update_theme(ctx, theme):
+    """Update your theme."""
+    from bsm_api_client.models import ThemeUpdatePayload
+
+    client = ctx.obj["client"]
+    payload = ThemeUpdatePayload(theme=theme)
+    response = await client.async_update_theme(payload)
+    click.echo(response.model_dump_json(indent=2))
+
+
+@account.command()
+@click.option("--full-name", prompt="Full Name", help="Your full name.")
+@click.option("--email", prompt="Email", help="Your email address.")
+@pass_async_context
+async def update_profile(ctx, full_name, email):
+    """Update your profile."""
+    from bsm_api_client.models import ProfileUpdatePayload
+
+    client = ctx.obj["client"]
+    payload = ProfileUpdatePayload(full_name=full_name, email=email)
+    response = await client.async_update_profile(payload)
+    click.echo(response.model_dump_json(indent=2))
+
+
+@account.command()
+@click.option(
+    "--current-password",
+    prompt=True,
+    hide_input=True,
+    confirmation_prompt=False,
+    help="Your current password.",
+)
+@click.option(
+    "--new-password",
+    prompt=True,
+    hide_input=True,
+    confirmation_prompt=True,
+    help="Your new password.",
+)
+@pass_async_context
+async def change_password(ctx, current_password, new_password):
+    """Change your password."""
+    from bsm_api_client.models import ChangePasswordPayload
+
+    client = ctx.obj["client"]
+    payload = ChangePasswordPayload(
+        current_password=current_password, new_password=new_password
+    )
+    response = await client.async_change_password(payload)
+    click.echo(response.model_dump_json(indent=2))