mcmanager 0.1.2__tar.gz → 0.1.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcmanager
-Version: 0.1.2
+Version: 0.1.4
 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.4}/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.4/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.4/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.4/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.4/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.4/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.4/mcmanager/console/management/commands/format_code.py

@@ -0,0 +1,43 @@
+import subprocess
+from django.core.management.base import BaseCommand
+
+
+class Command(BaseCommand):
+    """
+    Formatar o código do projeto
+    """
+    help = 'Formatar o código do projeto'
+
+    def handle(self, *args, **kwargs):
+        # Executa o comando de formatação para *.py
+        result1 = subprocess.getstatusoutput(
+            "autopep8 --recursive --in-place --exclude venv,.git,node_modules ./")
+        if result1[0] == 0:
+            self.stdout.write(self.style.SUCCESS(
+                'Código Python formatado com sucesso!'))
+            if kwargs.get('verbosity', 1) > 1:
+                self.stdout.write(self.style.SUCCESS(result1[1]))
+        else:
+            self.stdout.write(self.style.ERROR(
+                'Erro ao formatar o código Python!'))
+            if kwargs.get('verbosity', 1) > 1:
+                self.stdout.write(self.style.ERROR(result1[1]))
+        # Executa o comando de formatação para *.html, *.css e *.js
+        result2 = subprocess.getstatusoutput(
+            """find . -type d \\( -name 'venv' -o -name 'node_modules' -o -name '.git' \\) -prune -false -o -type d -name 'templates' | while read -r dir; do
+    echo "Formating $dir"
+    djlint "$dir" --reformat --format-css --format-js --use-gitignore
+done""")
+        if result2[0] == 0:
+            self.stdout.write(self.style.SUCCESS(
+                'Não foi necessário formatar o código HTML, CSS e JavaScript!'))
+            if kwargs.get('verbosity', 1) > 1:
+                self.stdout.write(self.style.SUCCESS(result2[1]))
+        else:
+            if kwargs.get('verbosity', 1) > 1:
+                self.stdout.write(self.style.WARNING(
+                    'Foram realizadas alterações no código HTML, CSS e JavaScript!'))
+                self.stdout.write(self.style.WARNING(result2[1]))
+            else:
+                self.stdout.write(self.style.WARNING(
+                    'Foram realizadas alterações no código HTML, CSS e JavaScript!\nUse "python manage.py format_code --verbosity 2" para mais detalhes.'))

mcmanager-0.1.4/mcmanager/console/management/commands/generate_secret_key.py

@@ -0,0 +1,23 @@
+from django.core.management.base import BaseCommand
+from django.core.management.utils import get_random_secret_key
+from django.conf import settings
+
+
+class Command(BaseCommand):
+    """
+    Gerar uma nova SECRET_KEY e atualizá-la no arquivo .secret_key do diretório de dados
+    """
+    help = 'Gerar uma nova SECRET_KEY e atualizá-la no arquivo .secret_key do diretório de dados'
+
+    def handle(self, *args, **kwargs):
+        secret_key = get_random_secret_key()
+        user_data_dir = getattr(settings, 'USER_DATA_DIR', settings.BASE_DIR)
+        secret_key_file = user_data_dir / '.secret_key'
+        
+        user_data_dir.mkdir(parents=True, exist_ok=True)
+        secret_key_file.write_text(secret_key, encoding='utf-8')
+        
+        self.stdout.write(self.style.SUCCESS(
+            f'Nova SECRET_KEY gerada e salva com sucesso em: {secret_key_file}'
+        ))
+

mcmanager-0.1.4/mcmanager/console/migrations/0001_initial.py

@@ -0,0 +1,45 @@
+# Generated by Django 4.0.5 on 2024-07-09 23:19
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Type',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True,
+                 primary_key=True, serialize=False, verbose_name='ID')),
+                ('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)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Server',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True,
+                 primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100)),
+                ('jar_template', models.CharField(choices=[('custom.jar', 'custom.jar'), (
+                    'minecraft_server.1.7.10.jar', 'minecraft_server.1.7.10.jar')], max_length=100)),
+                ('jar', models.CharField(blank=True, max_length=100, null=True)),
+                ('ip', models.GenericIPAddressField()),
+                ('port', models.IntegerField()),
+                ('memory_limit', models.IntegerField(
+                    default=1024, verbose_name='Memory Limit (MB)')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('type', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE,
+                 related_name='servers', to='console.type')),
+            ],
+        ),
+    ]

mcmanager-0.1.4/mcmanager/console/migrations/0002_alter_server_ip_alter_server_port.py

@@ -0,0 +1,23 @@
+# Generated by Django 4.0.5 on 2024-07-09 23:49
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('console', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='server',
+            name='ip',
+            field=models.GenericIPAddressField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name='server',
+            name='port',
+            field=models.IntegerField(default=25565),
+        ),
+    ]

mcmanager-0.1.4/mcmanager/console/migrations/0003_remove_server_ip_server_status.py

@@ -0,0 +1,22 @@
+# Generated by Django 4.0.5 on 2024-07-10 00:44
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('console', '0002_alter_server_ip_alter_server_port'),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name='server',
+            name='ip',
+        ),
+        migrations.AddField(
+            model_name='server',
+            name='status',
+            field=models.BooleanField(default=False),
+        ),
+    ]

mcmanager-0.1.4/mcmanager/console/migrations/0004_server_server_properties.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.0.5 on 2024-07-10 20:29
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('console', '0003_remove_server_ip_server_status'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='server',
+            name='server_properties',
+            field=models.TextField(blank=True, default='#Minecraft server properties\n#Wed Jul 10 19:30:06 UTC 2024\ngenerator-settings=\nop-permission-level=4\nallow-nether=true\nlevel-name=world\nenable-query=false\nallow-flight=true\nannounce-player-achievements=true\nserver-port=25566\nlevel-type=DEFAULT\nenable-rcon=false\nforce-gamemode=false\nlevel-seed=\nserver-ip=\nmax-build-height=256\nspawn-npcs=true\nwhite-list=false\nspawn-animals=true\nhardcore=false\nsnooper-enabled=true\nonline-mode=false\nresource-pack=\npvp=true\ndifficulty=1\nenable-command-block=false\ngamemode=0\nplayer-idle-timeout=0\nmax-players=5\nspawn-monsters=true\ngenerate-structures=true\nview-distance=10\nmotd=A Minecraft Server\n', null=True),
+        ),
+    ]

mcmanager-0.1.4/mcmanager/console/migrations/0005_alter_server_jar_template_and_more.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.1.15 on 2026-07-17 13:23
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('console', '0004_server_server_properties'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='server',
+            name='jar_template',
+            field=models.CharField(max_length=100),
+        ),
+        migrations.AlterField(
+            model_name='server',
+            name='server_properties',
+            field=models.TextField(blank=True, null=True),
+        ),
+    ]