python aternos

[Non tenu] Python aternos

Une API Aternos non officielle écrite en Python.
Il utilise l'API privée et l'analyse HTML d'Aternos.

Avertissement

Cette bibliothèque n'est plus maintenue, car:

1. Aternos a commencé à détecter toutes les demandes automatisées (et, par conséquent, les violations de TOS) via le code JS dans AJAX_TOKEN qui est exécuté incorrectement dans JS2PY et nécessite une bibliothèque NodeJS Dom (au moins) ou un moteur de navigateur. Pour plus de détails, voir # 85.
2. Aternos Frontend est protégé par CloudFlare, de sorte que cette bibliothèque ne parvient pas à analyser les pages dans le cas, par exemple, d'adresse IP bloquée ou suspecte (par exemple, l'hébergement Web). CF montre la page IUAM, souvent avec captcha. Nous avons besoin d'un moteur de navigateur comme un chromédriver non détecté et une IA ou un homme résolvant les captchas.
3. La dernière mise à jour de l'API Aternos a rompu presque tout.
4. Je n'ai plus de motivation et pas assez de temps pour travailler là-dessus, ni besoin d'utiliser Aternos.

Je suis vraiment désolé. Si vous voulez continuer le développement de Python-Atenos, contactez-moi, mais je pense qu'il vaut mieux écrire à partir de zéro.

Python Aternos prend en charge:

• Connexion pour comptabiliser avec le mot de passe (simple ou haché) ou une valeur de cookie ATERNOS_SESSION
• Enregistrer la session dans le fichier et restaurer
• Modification du nom d'utilisateur, de l'e-mail et du mot de passe
• Liste des serveurs minecraft d'analyse
• Analyse des informations sur le serveur par son identifiant
• Démarrage / arrêt du serveur, redémarrage, confirmation / annulation du lancement
• Mise à jour des informations sur le serveur en temps réel (voir API WebSocket)
• Modification du sous-domaine du serveur et MOTD (message du jour)
• Gérer les fichiers, les paramètres, les joueurs (liste blanche, opérateurs, etc.)

Installer

Commun

$ pip install python-aternos

Remarque pour les utilisateurs de Windows

Installez le package lxml à partir d'ici si vous avez des problèmes avec lui, puis exécutez:
pip install --no-deps python-aternos

Développement

$ git clone https://github.com/DarkCat09/python-aternos.git
$ cd python-aternos
$ pip install -e .[dev]

Usage

Pour utiliser l'API Aternos dans votre script Python, importez-le et connectez-vous avec votre nom d'utilisateur et votre mot de passe ou son hachage MD5.

Demandez ensuite à la liste des serveurs à l'aide de list_servers() .
Vous pouvez démarrer / arrêter votre serveur Aternos, appeler start() ou stop() .

Voici un exemple comment utiliser l'API:

 # Import
from python_aternos import Client

# Create object
atclient = Client ()

# Log in
# with username and password
atclient . login ( 'example' , 'test123' )
# ----OR----
# with username and MD5 hashed password
atclient . login_hashed ( 'example' , 'cc03e747a6afbbcbf8be7668acfebee5' )
# ----OR----
# with session cookie
atclient . login_with_session ( 'ATERNOS_SESSION cookie value' )

# Get AternosAccount object
aternos = atclient . account

# Get servers list
servs = aternos . list_servers ()

# Get the first server
myserv = servs [ 0 ]

# Start
myserv . start ()
# Stop
myserv . stop ()

# You can also find server by IP
testserv = None
for serv in servs :
    if serv . address == 'test.aternos.org' :
        testserv = serv

if testserv is not None :
    # Prints the server software and its version
    # (for example, "Vanilla 1.12.2")
    print ( testserv . software , testserv . version )
    # Starts server
    testserv . start ()

Plus d'exemples

Documentation

Guide comment

Changelog

Version	Description
v0.3	API des fichiers implémentés, ajout de typisation.
v0.4	API de configuration implémentée, certains BugFixes.
v0.5	L'API a été mise à jour correspondant aux nouvelles méthodes de sécurité Aternos. Un grand merci à LUSM554.
v0.6 / v1.0.0	Refactorisation de code, API WebSockets et enregistrement de session pour éviter de détecter l'accès à l'automatisation.
v1.0.x	Beaucoup de bugfixes, le versioning modifié (SEMVER).
v1.1.x	Documentation, tests unitaires, pylint, bugfixes, modifications de l'ATWSS.
v1.1.2 / v2.0.0	Solution pour # 25 (CloudFlare Trypassing), BugFixes dans JS Parser.
v2.0.x	Documentation, enregistrement automatique / restauration de la session, améliorations de l'API des fichiers.
v2.1.x	Correction dans l'API WebSockets, AtConnect (y compris le correctif de rafraîchissement des cookies). Prise en charge des services de résolution de CAPTCHA (View # 52).
v2.2.x	Prise en charge de l'interprète Node.js.
v3.0.0	Mises à jour partiellement réécrites, API.
v3.0.5	Non organisé.
v3.1.x	TODO: implémentation complète de l'API de configuration.
v3.2.x	TODO: API d'accès partagé et peut-être les sauvegardes Google Drive.

Spécification API inversée

Les demandes d'API privées Aternos ont été capturées dans ce fichier HAR et ont été importées dans un espace de travail Postman.
Vous pouvez utiliser les deux ressources pour explorer l'API.
Toute aide à l'amélioration de cette bibliothèque est la bienvenue.

Licence

Avis de licence:

 Copyright 2021-2022 All contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.