mcserver-cli 4.0.0.dev0__tar.gz → 4.3.0__tar.gz

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.3.0}/CHANGELOG.md

@@ -5,16 +5,38 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [4.3.0] - 2026-11-02
 
 ### Added
 
+- `whitelist remove` to remove players based on UUIDs or names
+
+## [4.2.0] - 2026-11-02
+
+### Changed
+
+- Reorder the `search` error message between 0 result and page is smaller than asked
+
+## [4.1.0] - 2026-11-02
+
+### Fixed
+
+- `search` now say "No environment"
+- `search` correctly use the appropiate project type for the homepage
+
+## [4.0.0] - 2026-10-31
+
+### Added
+
+- Working `show` command
+- Working `search` command
 - New `--game-version` and `--loader` options to the `search` command
 - New `--search-sort` and `--search-limit` options to the `init` command
-- 
 
 ### Changed
 
+- Moved `slug_index.json` to global `.mcserver` cache
+- More information that the `show` command output
 - Better `search` info message
 - slug_index.json is now a global cache
 
@@ -212,7 +234,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Better mod conflict error
 - Faster mod resolving
 
-[unreleased]: https://github.com/Othecat35/MCServer/compare/v3.0.0...HEAD
+[unreleased]: https://github.com/Othecat35/MCServer/compare/v4.3.0...HEAD
+[4.3.0]: https://github.com/Othecat35/MCServer/compare/v4.2.0...v4.3.0
+[4.2.0]: https://github.com/Othecat35/MCServer/compare/v4.1.0...v4.2.0
+[4.1.0]: https://github.com/Othecat35/MCServer/compare/v4.0.0...v4.1.0
+[4.0.0]: https://github.com/Othecat35/MCServer/compare/v3.0.0...v4.0.0
 [3.0.0]: https://github.com/Othecat35/MCServer/compare/v2.0.0...v3.0.0
 [2.0.0]: https://github.com/Othecat35/MCServer/compare/v1.13.16...v2.0.0
 [1.13.16]: https://github.com/Othecat35/MCServer/compare/v1.13.15...v1.13.16

mcserver_cli-4.3.0/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+# License
+
+By submitting a pull request, you agree that your contribution is licensed under the MIT License.
+
+# Development
+
+- Python >= 3.12 (3.14 is recommended)
+- Install with `pip install -e .`
+- Use `ruff format` to reformat code
+
+# Release
+
+1. Bump version in `src/mcserver/__init__.py`
+2. `python zip_app.py`
+3. Tag: `git tag vX.Y.Z && git push --tags`
+4. Create GitHub release, attach `dist/mcserver`

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.3.0}/NOTES.txt

@@ -1,3 +1,6 @@
+Pls don't feed my creation to AI ;>
+
+
 A file where I dumped ideas for this project.
 
 CLI Commands:
@@ -183,7 +186,9 @@ check_dependency_conflicts: no
 resolve_dependencies: ok... what are dependencies of mod b?
 (some dialogue later)
 resolve_dependencies: ok, there's no more dependency. here you go "return the list of dependencies"
-user: why are there 29 mods including dependencies 0_0
+user: why are there 29 mods including dependencies 0_0 (basucally the resolver works)
+
+on second thought, the caller is the one that handle conflict.
 
 thx chatgpt but I can't prove it yet
 
@@ -199,7 +204,15 @@ thx chatgpt but I can't prove it yet
 - Review codes, especially TypedDict, because why not
 - Avoid making myself suffer in this project, potentially abandoning this cool project
 - I hate CurseForge personally.
+
+
+
 - And yet I still have no friend (to talk about my weird hobby of computer, including this)
+
+- Oh hi Finjer! idk if you are reading this, cool. so uh... idk I added stuff I guess, or remove stuff.
+
+
+
 - Add command such as 'whitelist add/remove/list', 'ban/unban/ban-list', and probably 'op/deop <player> <level>'
 
 MCServer™ Naming Convention: (the Trademark is just a joke)
@@ -340,3 +353,41 @@ make a visualize command to visualize installed projects that output to graphviz
 we should merge the metadata.json and relationships.json back into one file :o
 
 look at myterious.py, idk why yiu thought it would be a good idea to make it more fun, and dynamic even.
+mcserver export --client-setup seems nice
+mcserver add thdilos-fox-origin -y is better
+mcserver add jade --include-optional make sense, but for specifically requested mod that is client_only_server_optional, include them. otherwise, put them into "suggested" mods.
+
+yo the get_project_informations() is broken because moderator_message can be null
+as for every API interface/client, we can instead return parsed (for those who we already know the structure), and then another, extra (just a dict[str, Any]). call the new typeddict, *Data.
+
+About lazy loading imports... what if I make it so that imports that are required regardless, just
+import it on the module instead? because if you do import it, you must have a reason to do so. Like,
+you don't import a module and not use it at all, right? so just move the imports outside the function.
+init.py:
+import argparse
+
+def init(args: argparse.Namespace):
+    import logging
+    ...
+
+
+init.py:
+import argparse
+import logging
+
+def init(args: argparse.Namespace):
+    ...
+
+so, if you import init, you of course want to run init() right? so lazy-laoding it is not just useless,
+it also make the code a bit more unreadable.
+When do we lazy-loading stuff? imports that aren't always needed. Like command invocation in cli.py
+with match case, because you don't need any to print the help message (except the help command itself),
+or if you did, like init, you don't neccesearily need to import the stop command right? and also other
+case is in init.py and start.pt. it import the appropriate loader and not other.
+
+hmmm yes, global .mcserver config, just like cache.
+it can be the default config of all your new Minecraft server derived from
+and yea
+
+
+2026-11-01, let's start not using AI?

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcserver-cli
-Version: 4.0.0.dev0
+Version: 4.3.0
 Summary: A CLI tool to manage Minecraft: Java Edition servers.
 Project-URL: Homepage, https://github.com/Othecat35/MCServer
 Project-URL: Repository, https://github.com/Othecat35/MCServer.git
@@ -44,14 +44,15 @@ Supported platforms:
 ## Usage
 - Initialize a server: `mcserver init [options]`
 - List operator players: `mcserver op list`
+- Show information about projects: `mcserver show <projects>`
 - Start the server: `mcserver start`
-- Stop the server: `mcserver stop`
+- Stop the server: `mcserver stop [--force-stop]`
 - List whitelisted players: `mcserver whitelist list`
 
 ### Example
-- Create a 1.20.1 Fabric (0.19.5) server on current directory
+- Create and start a Fabric 1.20.1 server on current directory
 ```bash
-mcserver init --mc-version=1.20.1 --loader=fabric --loader-version=0.19.5
+mcserver init --game-version=1.20.1 --loader=fabric
 mcserver start
 ```
 
@@ -60,11 +61,11 @@ mcserver start
 mcserver op list
 mcserver whitelist list
 ```
+
 - Stop (sigterm) a server on current directory
 ```bash
 mcserver stop
 ```
 
-
 ## Note
 This is a **Personal Project**, things may be unstable.

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.3.0}/README.md

@@ -31,14 +31,15 @@ Supported platforms:
 ## Usage
 - Initialize a server: `mcserver init [options]`
 - List operator players: `mcserver op list`
+- Show information about projects: `mcserver show <projects>`
 - Start the server: `mcserver start`
-- Stop the server: `mcserver stop`
+- Stop the server: `mcserver stop [--force-stop]`
 - List whitelisted players: `mcserver whitelist list`
 
 ### Example
-- Create a 1.20.1 Fabric (0.19.5) server on current directory
+- Create and start a Fabric 1.20.1 server on current directory
 ```bash
-mcserver init --mc-version=1.20.1 --loader=fabric --loader-version=0.19.5
+mcserver init --game-version=1.20.1 --loader=fabric
 mcserver start
 ```
 
@@ -47,11 +48,11 @@ mcserver start
 mcserver op list
 mcserver whitelist list
 ```
+
 - Stop (sigterm) a server on current directory
 ```bash
 mcserver stop
 ```
 
-
 ## Note
 This is a **Personal Project**, things may be unstable.

mcserver_cli-4.3.0/src/mcserver/__init__.py

@@ -0,0 +1 @@
+__version__ = "4.3.0"

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.3.0}/src/mcserver/cli.py

@@ -1,114 +1,119 @@
-def main() -> int:
-    import argparse
-    import sys
-
-    from . import __version__
-    from .modrinth.shared import search_sort_index
-    from .shared import loader_list
-
-    def bound_int(min_integer: int, max_integer: int | None = None):
-        def parse(cli_string: str):
-            try:
-                integer = int(cli_string)
-            except TypeError:
-                raise argparse.ArgumentTypeError(f"{cli_string} is not an integer")
-
-            if integer <= min_integer:
-                raise argparse.ArgumentTypeError(
-                    f"{integer} must be higher than or equal to {min_integer}"
-                )
-            if max_integer is not None and integer >= max_integer:
-                raise argparse.ArgumentTypeError(
-                    f"{integer} must be between {min_integer} and {max_integer} (inclusive)"
-                )
-            return integer
-
-        return parse
-
-    def command_function(args: argparse.Namespace) -> int:
-        command_name: str = args.command_name
-
-        match command_name:
-            case "add":
-                from .commands import add_projects
-
-                return add_projects(args)
-            case "import":
-                from .commands import import_setup
-
-                return import_setup(args)
-            case "help":
-                from .commands import print_help
-
-                return print_help(args)
-            case "init":
-                from .commands import initialize_server
-
-                return initialize_server(args)
-            case "list":
-                from .commands import list_projects
-
-                return list_projects(args)
-            case "op_grant":
-                from .commands import op_grant
-
-                return op_grant(args)
-            case "op_list":
-                from .commands import op_list
-
-                return op_list(args)
-            case "op_revoke":
-                from .commands import op_revoke
-
-                return op_revoke(args)
-            case "remove":
-                from .commands import remove_projects
-
-                return remove_projects(args)
-            case "search":
-                from .commands import search_projects
-
-                return search_projects(args)
-            case "show":
-                from .commands import show_projects
-
-                return show_projects(args)
-            case "start":
-                from .commands import start_server
-
-                return start_server(args)
-            case "status":
-                from .commands import server_status
-
-                return server_status(args)
-            case "stop":
-                from .commands import stop_server
-
-                return stop_server(args)
-            case "update":
-                from .commands import update_projects
-
-                return update_projects(args)
-            case "whitelist_add":
-                from .commands import whitelist_add
-
-                return whitelist_add(args)
-            case "whitelist_list":
-                from .commands import whitelist_list
-
-                return whitelist_list(args)
-            case "whitelist_remove":
-                from .commands import whitelist_remove
-
-                return whitelist_remove(args)
-            case _:
-                import logging as log
-
-                log.error(f"Unknown command: {command_name}")
-                return 1
+import argparse
+import sys
+from types import FunctionType
 
-    # Parser Setup
+from . import __version__
+from .modrinth.shared import search_sort_index
+from .shared import loader_list
+
+
+def bound_int(min_integer: int, max_integer: int | None = None) -> FunctionType:
+    def parse(cli_string: str) -> int:
+        try:
+            integer = int(cli_string)
+        except ValueError:
+            raise argparse.ArgumentTypeError(f"{cli_string} is not an integer")
+
+        if integer < min_integer:
+            raise argparse.ArgumentTypeError(
+                f"{integer} must be higher than or equal to {min_integer}"
+            )
+        if max_integer is not None and integer > max_integer:
+            raise argparse.ArgumentTypeError(
+                f"{integer} must be between {min_integer} and {max_integer} (inclusive)"
+            )
+        return integer
+
+    return parse
+
+
+def command_function(args: argparse.Namespace) -> int:
+    command_name: str = args.command_name
+
+    match command_name:
+        case "add":
+            from .commands import add_projects
+
+            return add_projects(args)
+        case "import":
+            from .commands import import_setup
+
+            return import_setup(args)
+        case "help":
+            from .commands import print_help
+
+            return print_help(args)
+        case "init":
+            from .commands import initialize_server
+
+            return initialize_server(args)
+        case "list":
+            from .commands import list_projects
+
+            return list_projects(args)
+        case "op_grant":
+            from .commands import op_grant
+
+            return op_grant(args)
+        case "op_list":
+            from .commands import op_list
+
+            return op_list(args)
+        case "op_revoke":
+            from .commands import op_revoke
+
+            return op_revoke(args)
+        case "remove":
+            from .commands import remove_projects
+
+            return remove_projects(args)
+        case "search":
+            from .commands import search_projects
+
+            return search_projects(args)
+        case "show":
+            from .commands import show_projects
+
+            return show_projects(args)
+        case "start":
+            from .commands import start_server
+
+            return start_server(args)
+        case "status":
+            from .commands import server_status
+
+            return server_status(args)
+        case "stop":
+            from .commands import stop_server
+
+            return stop_server(args)
+        case "update":
+            from .commands import update_projects
+
+            return update_projects(args)
+        case "whitelist_add":
+            from .commands import whitelist_add
+
+            return whitelist_add(args)
+        case "whitelist_list":
+            from .commands import whitelist_list
+
+            return whitelist_list(args)
+        case "whitelist_remove":
+            from .commands import whitelist_remove
+
+            return whitelist_remove(args)
+        case _:
+            import logging
+
+            logger = logging.getLogger(__name__)
+
+            logger.error(f"Unknown command: {command_name}")
+            return 1
 
+
+def main() -> int:
+    # Parser Setup
     parser = argparse.ArgumentParser(
         prog="mcserver",
         description="A CLI tool for managing Minecraft: Java Edition servers.",
@@ -134,28 +139,6 @@ def main() -> int:
 
     commands = parser.add_subparsers(title="Commands")
 
-    # 'add' command
-    add_command = commands.add_parser(
-        "add",
-        help="Add Modrinth projects to the server",
-        description="Add Modrinth mods/plugins to the server",
-    )
-
-    add_command.set_defaults(command_name="add")
-    add_command.add_argument(
-        "projects", nargs="+", type=str, help="Modrinth project slugs or IDs"
-    )
-
-    # 'import' command
-    import_command = commands.add_parser(
-        "import",
-        help="Import a Modrinth modpack",
-        description="Import a Modrinth modpack from a file.",
-    )
-
-    import_command.set_defaults(command_name="import")
-    import_command.add_argument("file", type=str, help="The Modrinth modpack file")
-
     # 'init' command
     init_command = commands.add_parser(
         "init",
@@ -193,15 +176,15 @@ def main() -> int:
     init_command.add_argument(
         "--min-ram",
         default=512,
-        type=bound_int(1024),
-        help="Minimum RAM for the server (in MebiBytes) (minimum value: 1024)",
+        type=bound_int(512),
+        help="Minimum RAM for the server (in MebiBytes) (minimum value: 512)",
         metavar="Size",
     )
 
     init_command.add_argument(
         "--max-ram",
-        default=bound_int(1024),
-        type=int,
+        default=1024,
+        type=bound_int(1024),
         help="Maximum RAM for the server (in MebiBytes) (minimum value: 1024)",
         metavar="Size",
     )
@@ -222,16 +205,9 @@ def main() -> int:
         choices=search_sort_index,
         help="Default search sort index",
         metavar="Index",
-        dest="search_limit",
-    )
-
-    # 'list' command
-    list_command = commands.add_parser(
-        "list", help="List all added projects", description="List all added projects."
+        dest="sort_index",
     )
 
-    list_command.set_defaults(command_name="list")
-
     # 'op' command
     op_command = commands.add_parser(
         "op", help="Manage operator players", description="Manage the operator status."
@@ -248,16 +224,6 @@ def main() -> int:
 
     op_list_command.set_defaults(command_name="op_list")
 
-    # 'remove' command
-    remove_command = commands.add_parser(
-        "remove", help="Remove projects", description="Remove projects"
-    )
-
-    remove_command.set_defaults(command_name="remove")
-    remove_command.add_argument(
-        "projects", nargs="+", type=str, help="Modrinth project slugs or IDs"
-    )
-
     # 'search' command
     search_command = commands.add_parser(
         "search",
@@ -272,7 +238,6 @@ def main() -> int:
 
     search_command.add_argument(
         "--limit",
-        default=20,
         type=bound_int(1, 100),
         help="Search projects per page (value between (inclusive): 1-100)",
         metavar="Number",
@@ -289,13 +254,11 @@ def main() -> int:
     )
 
     search_command.add_argument(
-        "--sort",
-        default="relevance",
+        "--sort-index",
         type=str,
         choices=search_sort_index,
         help="Sort by index",
         metavar="Index",
-        dest="sort_index",
     )
 
     search_command.add_argument(
@@ -348,6 +311,7 @@ def main() -> int:
 
     stop_command.set_defaults(command_name="stop")
 
+    # update is not going to be implemented in this version
     # 'whitelist' command
     whitelist_command = commands.add_parser(
         "whitelist",
@@ -368,5 +332,15 @@ def main() -> int:
 
     whitelist_list_command.set_defaults(command_name="whitelist_list")
 
+    # 'whitelist remove'
+    whitelist_remove_command = whitelist_subcommands.add_parser(
+        "remove",
+        help="Remove players from the whitelist",
+        description="List all whitelisted players.",
+    )
+
+    whitelist_remove_command.set_defaults(command_name="whitelist_remove")
+    whitelist_remove_command.add_argument("players", nargs="+", type=str, help="List of player names or UUIDs")
+
     args = parser.parse_args()
     return args.func(args)

mcserver_cli-4.3.0/src/mcserver/commands/__init__.py

@@ -0,0 +1,39 @@
+from .add_projects import run as add_projects
+from .import_setup import run as import_setup
+from .initialize_server import run as initialize_server
+from .list_projects import run as list_projects
+from .op_grant import run as op_grant
+from .op_list import run as op_list
+from .op_revoke import run as op_revoke
+from .print_help import run as print_help
+from .remove_projects import run as remove_projects
+from .search_projects import run as search_projects
+from .server_status import run as server_status
+from .show_projects import run as show_projects
+from .start_server import run as start_server
+from .stop_server import run as stop_server
+from .update_projects import run as update_projects
+from .whitelist_add import run as whitelist_add
+from .whitelist_list import run as whitelist_list
+from .whitelist_remove import run as whitelist_remove
+
+__all__ = [
+    "add_projects",
+    "import_setup",
+    "initialize_server",
+    "list_projects",
+    "op_grant",
+    "op_list",
+    "op_revoke",
+    "print_help",
+    "remove_projects",
+    "search_projects",
+    "server_status",
+    "show_projects",
+    "start_server",
+    "stop_server",
+    "update_projects",
+    "whitelist_add",
+    "whitelist_list",
+    "whitelist_remove",
+]