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

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

@@ -5,16 +5,32 @@ 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.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 +228,10 @@ 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.2.0...HEAD
+[4.2.0]: https://github.com/Othecat35/MCServer/compare/v4.0.0...v4.1.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.2.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.2.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.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcserver-cli
-Version: 4.0.0.dev0
+Version: 4.2.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.2.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.0.0.dev0 → mcserver_cli-4.2.0}/pyproject.toml

@@ -28,3 +28,8 @@ packages = ["src/mcserver"]
 
 [tool.hatch.version]
 path = "src/mcserver/__init__.py"
+
+[tool.ruff.lint]
+ignore = [
+  "LOG015"
+]

mcserver_cli-4.2.0/src/mcserver/__init__.py

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

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

@@ -1,23 +1,24 @@
 def main() -> int:
     import argparse
     import sys
+    from types import FunctionType
 
     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):
+    def bound_int(min_integer: int, max_integer: int | None = None) -> FunctionType:
+        def parse(cli_string: str) -> int:
             try:
                 integer = int(cli_string)
-            except TypeError:
+            except ValueError:
                 raise argparse.ArgumentTypeError(f"{cli_string} is not an integer")
 
-            if integer <= min_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:
+            if max_integer is not None and integer > max_integer:
                 raise argparse.ArgumentTypeError(
                     f"{integer} must be between {min_integer} and {max_integer} (inclusive)"
                 )
@@ -30,9 +31,9 @@ def main() -> int:
 
         match command_name:
             case "add":
-                from .commands import add_projects
+                from .commands import add
 
-                return add_projects(args)
+                return add(args)
             case "import":
                 from .commands import import_setup
 
@@ -42,9 +43,9 @@ def main() -> int:
 
                 return print_help(args)
             case "init":
-                from .commands import initialize_server
+                from .commands import init
 
-                return initialize_server(args)
+                return init(args)
             case "list":
                 from .commands import list_projects
 
@@ -66,25 +67,25 @@ def main() -> int:
 
                 return remove_projects(args)
             case "search":
-                from .commands import search_projects
+                from .commands import search
 
-                return search_projects(args)
+                return search(args)
             case "show":
-                from .commands import show_projects
+                from .commands import show
 
-                return show_projects(args)
+                return show(args)
             case "start":
-                from .commands import start_server
+                from .commands import start
 
-                return start_server(args)
+                return start(args)
             case "status":
                 from .commands import server_status
 
                 return server_status(args)
             case "stop":
-                from .commands import stop_server
+                from .commands import stop
 
-                return stop_server(args)
+                return stop(args)
             case "update":
                 from .commands import update_projects
 
@@ -134,28 +135,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 +172,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 +201,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 +220,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 +234,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 +250,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 +307,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",

{mcserver_cli-4.0.0.dev0 → mcserver_cli-4.2.0}/src/mcserver/commands/__init__.py

@@ -1,37 +1,37 @@
-from .add_projects import main as add_projects
+from .add import add
 from .import_setup import main as import_setup
-from .initialize_server import main as initialize_server
+from .init import init
 from .list_projects import main as list_projects
 from .op_grant import main as op_grant
 from .op_list import main as op_list
 from .op_revoke import main as op_revoke
 from .print_help import main as print_help
 from .remove_projects import main as remove_projects
-from .search_projects import main as search_projects
+from .search import search
 from .server_status import main as server_status
-from .show_projects import main as show_projects
-from .start_server import main as start_server
-from .stop_server import main as stop_server
+from .show import show
+from .start import start
+from .stop import stop
 from .update_projects import main as update_projects
 from .whitelist_add import main as whitelist_add
 from .whitelist_list import main as whitelist_list
 from .whitelist_remove import main as whitelist_remove
 
 __all__ = [
-    "add_projects",
+    "add",
     "import_setup",
-    "initialize_server",
+    "init",
     "list_projects",
     "op_grant",
     "op_list",
     "op_revoke",
     "print_help",
     "remove_projects",
-    "search_projects",
+    "search",
     "server_status",
-    "show_projects",
-    "start_server",
-    "stop_server",
+    "show",
+    "start",
+    "stop",
     "update_projects",
     "whitelist_add",
     "whitelist_list",