mcmanager 0.1.2__tar.gz → 0.1.3__tar.gz

{mcmanager-0.1.2 → mcmanager-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcmanager
-Version: 0.1.2
+Version: 0.1.3
 Summary: A Django-based web interface to manage Minecraft servers on a VPS
 License: MIT
 Classifier: Programming Language :: Python :: 3
@@ -8,11 +8,14 @@ Classifier: Framework :: Django
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Topic :: Games/Entertainment
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: Django<5.2.0,>=4.2.0
 Requires-Dist: psutil>=5.8.0
 Requires-Dist: whitenoise>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-django>=4.7.0; extra == "dev"
 
 # mcmanager (BETA)
 

{mcmanager-0.1.2 → mcmanager-0.1.3}/mcmanager/cli.py

@@ -1,115 +1,135 @@
-import os
-import sys
-import argparse
-import shutil
-from pathlib import Path
-
-def get_data_dir():
-    """Determina o diretório de dados com base na variável de ambiente ou home"""
-    if os.environ.get("MCMANAGER_DATA_DIR"):
-        return Path(os.environ["MCMANAGER_DATA_DIR"]).resolve()
-    
-    debug_mode = os.environ.get("MCMANAGER_DEBUG", "False").lower() in ("true", "1", "yes")
-    if debug_mode:
-        # Se estiver em modo debug local, usa a pasta do próprio projeto
-        return Path(__file__).resolve().parent.parent
-    else:
-        return Path.home() / ".mcmanager"
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="mcmanager - Painel de Controle de Servidores Minecraft"
-    )
-    subparsers = parser.add_subparsers(dest="command", required=True, help="Subcomando a executar")
-
-    # Comando init
-    init_parser = subparsers.add_parser("init", help="Inicializa o diretório de dados, banco e arquivos padrões")
-
-    # Comando run
-    run_parser = subparsers.add_parser("run", help="Inicia o servidor web do painel")
-    run_parser.add_argument("--host", default="0.0.0.0", help="Endereço IP para escutar (padrão: 0.0.0.0)")
-    run_parser.add_argument("--port", type=int, default=8000, help="Porta para escutar (padrão: 8000)")
-
-    # Comando createsuperuser
-    createsuperuser_parser = subparsers.add_parser(
-        "createsuperuser", help="Cria um usuário administrador para o painel"
-    )
-
-    # Comando shell
-    shell_parser = subparsers.add_parser("shell", help="Inicia o console interativo do Django")
-
-    args = parser.parse_args()
-
-    # 1. Obter e criar estrutura de dados do usuário
-    data_dir = get_data_dir()
-    data_dir.mkdir(parents=True, exist_ok=True)
-    (data_dir / "servers").mkdir(exist_ok=True)
-    (data_dir / "jar").mkdir(exist_ok=True)
-    (data_dir / "configs").mkdir(exist_ok=True)
-
-    # 2. Copiar server.properties padrão se não existir
-    properties_dest = data_dir / "configs" / "server.properties"
-    if not properties_dest.exists():
-        # Tenta carregar usando importlib.resources (PEP 517)
-        copied = False
-        try:
-            from importlib import resources
-            # Python 3.9+
-            source_path = resources.files("mcmanager").joinpath("configs/server.properties")
-            with source_path.open("rb") as fsrc:
-                with open(properties_dest, "wb") as fdst:
-                    shutil.copyfileobj(fsrc, fdst)
-            copied = True
-        except Exception:
-            pass
-
-        if not copied:
-            # Fallback para caminho relativo
-            source_path = Path(__file__).resolve().parent / "configs" / "server.properties"
-            if source_path.exists():
-                shutil.copy(source_path, properties_dest)
-                copied = True
-
-        if copied:
-            print(f"[*] Arquivo server.properties padrão copiado para: {properties_dest}")
-        else:
-            print("[!] Aviso: Não foi possível copiar o arquivo server.properties padrão.")
-
-    # 3. Configurar variáveis de ambiente do Django
-    os.environ.setdefault("MCMANAGER_DATA_DIR", str(data_dir))
-    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "mcmanager.settings")
-
-    # 4. Inicializar Django
-    import django
-    django.setup()
-
-    from django.core.management import call_command
-
-    # 5. Executar os subcomandos
-    if args.command == "init":
-        print("[*] Executando migrações do banco de dados...")
-        call_command("migrate", interactive=False)
-        print("[*] Coletando arquivos estáticos...")
-        call_command("collectstatic", "--noinput", "--clear")
-        print("\n[+] Inicialização concluída com sucesso!")
-        print(f"[+] Seus dados estão em: {data_dir}")
-        print("[+] Agora você pode rodar: mcmanager createsuperuser")
-
-    elif args.command == "run":
-        bind_address = f"{args.host}:{args.port}"
-        print(f"[*] Iniciando servidor mcmanager em http://{bind_address}/")
-        print("[*] Pressione CTRL+C para encerrar.")
-        # Em produção, rodamos sem autoreload
-        call_command("runserver", "--noreload", "--nostatic", bind_address)
-
-    elif args.command == "createsuperuser":
-        try:
-            call_command("createsuperuser")
-        except KeyboardInterrupt:
-            print("\n[!] Operação cancelada.")
-
-    elif args.command == "shell":
-        call_command("shell")
-
-if __name__ == "__main__":
-    main()
+import os
+import sys
+import argparse
+import shutil
+from pathlib import Path
+
+def get_data_dir():
+    """Determina o diretório de dados com base na variável de ambiente ou home"""
+    if os.environ.get("MCMANAGER_DATA_DIR"):
+        return Path(os.environ["MCMANAGER_DATA_DIR"]).resolve()
+    
+    debug_mode = os.environ.get("MCMANAGER_DEBUG", "False").lower() in ("true", "1", "yes")
+    if debug_mode:
+        # Se estiver em modo debug local, usa a pasta do próprio projeto
+        return Path(__file__).resolve().parent.parent
+    else:
+        return Path.home() / ".mcmanager"
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="mcmanager - Painel de Controle de Servidores Minecraft"
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True, help="Subcomando a executar")
+
+    # Comando init
+    subparsers.add_parser("init", help="Inicializa o diretório de dados, banco e arquivos padrões")
+
+    # Comando run
+    run_parser = subparsers.add_parser("run", help="Inicia o servidor web do painel")
+    run_parser.add_argument("--host", default="0.0.0.0", help="Endereço IP para escutar (padrão: 0.0.0.0)")
+    run_parser.add_argument("--port", type=int, default=8000, help="Porta para escutar (padrão: 8000)")
+
+    # Comando createsuperuser
+    subparsers.add_parser(
+        "createsuperuser", help="Cria um usuário administrador para o painel"
+    )
+
+    # Comando shell
+    subparsers.add_parser("shell", help="Inicia o console interativo do Django")
+
+    # Comando doctor
+    subparsers.add_parser(
+        "doctor", help="Diagnostica o ambiente (Java, diretórios, banco de dados)"
+    )
+
+    args = parser.parse_args()
+
+    # 1. Obter e criar estrutura de dados do usuário
+    data_dir = get_data_dir()
+    data_dir.mkdir(parents=True, exist_ok=True)
+    (data_dir / "servers").mkdir(exist_ok=True)
+    (data_dir / "jar").mkdir(exist_ok=True)
+    (data_dir / "configs").mkdir(exist_ok=True)
+    (data_dir / "run").mkdir(exist_ok=True)
+    (data_dir / "backups").mkdir(exist_ok=True)
+
+    # 2. Copiar server.properties padrão se não existir
+    properties_dest = data_dir / "configs" / "server.properties"
+    if not properties_dest.exists():
+        # Tenta carregar usando importlib.resources (PEP 517)
+        copied = False
+        try:
+            from importlib import resources
+            # Python 3.9+
+            source_path = resources.files("mcmanager").joinpath("configs/server.properties")
+            with source_path.open("rb") as fsrc:
+                with open(properties_dest, "wb") as fdst:
+                    shutil.copyfileobj(fsrc, fdst)
+            copied = True
+        except Exception:
+            pass
+
+        if not copied:
+            # Fallback para caminho relativo
+            source_path = Path(__file__).resolve().parent / "configs" / "server.properties"
+            if source_path.exists():
+                shutil.copy(source_path, properties_dest)
+                copied = True
+
+        if copied:
+            print(f"[*] Arquivo server.properties padrão copiado para: {properties_dest}")
+        else:
+            print("[!] Aviso: Não foi possível copiar o arquivo server.properties padrão.")
+
+    # 3. Configurar variáveis de ambiente do Django
+    os.environ.setdefault("MCMANAGER_DATA_DIR", str(data_dir))
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "mcmanager.settings")
+
+    # 4. Inicializar Django
+    import django
+    django.setup()
+
+    from django.core.management import call_command
+
+    # 5. Executar os subcomandos
+    if args.command == "init":
+        print("[*] Executando migrações do banco de dados...")
+        call_command("migrate", interactive=False)
+        print("[*] Coletando arquivos estáticos...")
+        call_command("collectstatic", "--noinput", "--clear")
+        print("\n[+] Inicialização concluída com sucesso!")
+        print(f"[+] Seus dados estão em: {data_dir}")
+        print("[+] Agora você pode rodar: mcmanager createsuperuser")
+
+    elif args.command == "run":
+        from mcmanager.console.services import supervisor
+        supervisor.start()
+        bind_address = f"{args.host}:{args.port}"
+        print(f"[*] Iniciando servidor mcmanager em http://{bind_address}/")
+        print("[*] Pressione CTRL+C para encerrar.")
+        # Em produção, rodamos sem autoreload
+        call_command("runserver", "--noreload", "--nostatic", bind_address)
+
+    elif args.command == "createsuperuser":
+        try:
+            call_command("createsuperuser")
+        except KeyboardInterrupt:
+            print("\n[!] Operação cancelada.")
+
+    elif args.command == "shell":
+        call_command("shell")
+
+    elif args.command == "doctor":
+        from mcmanager.console.services import doctor
+        results = doctor.run_checks()
+        all_passed = True
+        for result in results:
+            symbol = "OK" if result['passed'] else "FAIL"
+            print(f"[{symbol}] {result['name']}: {result['message']}")
+            if not result['passed']:
+                all_passed = False
+        sys.exit(0 if all_passed else 1)
+
+if __name__ == "__main__":
+    main()

mcmanager-0.1.3/mcmanager/console/admin.py

@@ -0,0 +1,54 @@
+from typing import Any
+
+from django.contrib import admin
+
+from .forms import ServerForm
+from .models import Server, Type
+from .services import process, provisioning
+
+
+@admin.register(Server)
+class ServerAdmin(admin.ModelAdmin):
+    form = ServerForm
+    list_display = ('name', 'port', 'type', 'is_running')
+    exclude = ('jar', 'server_properties', 'desired_running', 'consecutive_restart_failures', 'last_scheduled_backup_date')
+    search_fields = ('name', 'port', 'type')
+    list_filter = ('type',)
+    readonly_fields = ()
+
+    def is_running(self, obj):
+        return process.is_running(obj)
+    is_running.boolean = True
+    is_running.short_description = 'Running'
+
+    def get_form(self, request, obj=..., change=..., **kwargs) -> Any:
+        internal_fields = ('desired_running', 'consecutive_restart_failures', 'last_scheduled_backup_date')
+        if obj is None:
+            self.exclude = ('jar', 'server_properties') + internal_fields
+            self.readonly_fields = ()
+        else:
+            self.exclude = internal_fields
+            self.readonly_fields = ('jar',)
+        return super().get_form(request, obj, change, **kwargs)
+
+    def save_model(self, request, obj, form, change):
+        super().save_model(request, obj, form, change)
+        if not obj.jar:
+            provisioning.create_server_files(obj)
+        else:
+            provisioning.sync_server_properties_file(obj)
+
+    def delete_model(self, request, obj):
+        provisioning.delete_server_files(obj)
+        super().delete_model(request, obj)
+
+    def delete_queryset(self, request, queryset):
+        for obj in queryset:
+            provisioning.delete_server_files(obj)
+        super().delete_queryset(request, queryset)
+
+
+@admin.register(Type)
+class TypeAdmin(admin.ModelAdmin):
+    list_display = ('name',)
+    search_fields = ('name',)

mcmanager-0.1.3/mcmanager/console/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+
+class ConsoleConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'mcmanager.console'
+
+    def ready(self):
+        from .compat import patch_context_copy_for_python314
+        patch_context_copy_for_python314()

mcmanager-0.1.3/mcmanager/console/compat.py

@@ -0,0 +1,31 @@
+"""Runtime compatibility shims for this project's supported environments."""
+from django.template.context import BaseContext
+
+
+def patch_context_copy_for_python314():
+    """Python 3.14 changed copy.copy()'s handling of `super` proxy objects,
+    breaking Django 5.1's BaseContext.__copy__ (which does
+    `duplicate = copy(super())` to get a shallow copy of self while bypassing
+    dict's own __copy__ -- BaseContext isn't a dict subclass, but relies on
+    this idiom to allocate a bare instance). This now raises
+    `AttributeError: 'super' object has no attribute 'dicts' and no __dict__
+    for setting new attributes` any time Django copies a template Context --
+    which happens on every Django admin change-list page render (via the
+    `{% change_list_object_tools %}` templatetag), and more generally
+    whenever `Context.new()` is called. Reproduced independently of Django
+    with a minimal `copy(super())` snippet, so this is an upstream Python
+    3.14 regression, not an application bug. Django 5.1.15 (latest 5.1.x as
+    of writing) does not include a fix.
+
+    TODO: remove once either (a) Django ships a fix for the copy(super())
+    idiom under Python 3.14+, or (b) this project's supported Python floor
+    is raised past whatever version fixes it -- check `python --version`
+    and retest by removing this call before deleting it.
+    """
+    def _base_context_copy(self):
+        duplicate = object.__new__(self.__class__)
+        duplicate.__dict__.update(self.__dict__)
+        duplicate.dicts = self.dicts[:]
+        return duplicate
+
+    BaseContext.__copy__ = _base_context_copy

mcmanager-0.1.3/mcmanager/console/forms.py

@@ -0,0 +1,15 @@
+from django import forms
+
+from .models import Server, get_jar_files
+
+
+class ServerForm(forms.ModelForm):
+    jar_template = forms.ChoiceField(choices=[])
+
+    class Meta:
+        model = Server
+        fields = '__all__'
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['jar_template'].choices = get_jar_files()

mcmanager-0.1.3/mcmanager/console/json_utils.py

@@ -0,0 +1,8 @@
+"""Shared JSON error-response helper. Success responses keep their existing,
+per-view flat shape unchanged — only error responses use this, so they get a
+real HTTP status code instead of always returning 200."""
+from django.http import JsonResponse
+
+
+def json_error(message, status=400):
+    return JsonResponse({'status': 'error', 'message': message}, status=status)

mcmanager-0.1.3/mcmanager/console/models.py

@@ -0,0 +1,118 @@
+import os
+
+from django.conf import settings
+from django.core.exceptions import ValidationError
+from django.db import models
+from django.db.models import Q
+
+
+def get_jar_files():
+    jar_dir = getattr(settings, 'JAR_DIR', os.path.join(settings.BASE_DIR, 'jar'))
+    if not os.path.exists(jar_dir):
+        os.makedirs(jar_dir)
+    return [(x, x) for x in os.listdir(jar_dir) if x.endswith('.jar')]
+
+
+def get_default_server_prop():
+    configs_dir = getattr(settings, 'CONFIGS_DIR', os.path.join(settings.BASE_DIR, 'configs'))
+    with open(os.path.join(configs_dir, 'server.properties'), 'r', encoding='utf-8') as arq:
+        text = arq.read()
+    return text
+
+
+class Type(models.Model):
+    name = models.CharField(max_length=100)
+    dependencies = models.JSONField(blank=True, null=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return self.name
+
+
+MAX_GAME_PORT = 55535  # port + 10000 (the RCON port) must not exceed 65535
+
+
+class Server(models.Model):
+    name = models.CharField(max_length=100)
+    jar_template = models.CharField(max_length=100)
+    jar = models.CharField(max_length=100, blank=True, null=True)
+    port = models.IntegerField(default=25565)
+    memory_limit = models.IntegerField("Memory Limit (MB)", default=1024)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    type = models.ForeignKey(
+        Type, on_delete=models.CASCADE, related_name='servers')
+    server_properties = models.TextField(blank=True, null=True)
+    rcon_port = models.IntegerField(editable=False, default=0)
+    rcon_password = models.CharField(max_length=32, editable=False, default='', blank=True)
+    auto_restart_enabled = models.BooleanField(default=False)
+    desired_running = models.BooleanField(default=False, editable=False)
+    consecutive_restart_failures = models.IntegerField(default=0, editable=False)
+    scheduled_backup_time = models.TimeField(null=True, blank=True)
+    last_scheduled_backup_date = models.DateField(null=True, blank=True, editable=False)
+
+    def __str__(self):
+        return self.name
+
+    def clean(self):
+        super().clean()
+        if self.port is None:
+            return
+        if self.port > MAX_GAME_PORT:
+            raise ValidationError({
+                'port': 'Port must leave room for the RCON port (port + 10000 must not exceed 65535).',
+            })
+
+        implied_rcon_port = self.port + 10000
+        conflict = Server.objects.exclude(pk=self.pk).filter(
+            Q(port=implied_rcon_port)
+            | Q(rcon_port=implied_rcon_port)
+            | Q(rcon_port=self.port)
+        ).first()
+        if conflict is not None:
+            raise ValidationError({
+                'port': (
+                    f'This port implies RCON port {implied_rcon_port}, which conflicts with '
+                    f'server "{conflict.name}" (port={conflict.port}, rcon_port={conflict.rcon_port}).'
+                ),
+            })
+
+
+class JarDownload(models.Model):
+    STATUS_CHOICES = [
+        ('pending', 'Pending'),
+        ('downloading', 'Downloading'),
+        ('done', 'Done'),
+        ('error', 'Error'),
+    ]
+
+    provider = models.CharField(max_length=20)
+    version = models.CharField(max_length=50)
+    filename = models.CharField(max_length=255, blank=True)
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending')
+    error_message = models.TextField(blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return f'{self.provider} {self.version} ({self.status})'
+
+
+class Backup(models.Model):
+    STATUS_CHOICES = [
+        ('pending', 'Pending'),
+        ('running', 'Running'),
+        ('done', 'Done'),
+        ('error', 'Error'),
+    ]
+
+    server = models.ForeignKey(Server, on_delete=models.CASCADE, related_name='backups')
+    filename = models.CharField(max_length=255, blank=True)
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending')
+    error_message = models.TextField(blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return f'{self.server.name} backup {self.filename or "(pending)"} ({self.status})'