Module de gestion A-Parser via API pour Python

Compatibilité

Le module est compatible avec Python versions 2.7.* et >=3.8

Installation

pip install a-parser

Utilisation

Connexion du module et vérification de son fonctionnement via la méthode ping.

from a_parser import AParser
aparser = AParser('http://127.0.0.1:9091/API', 'password')
print(aparser.ping())

Résultat :

{ 'success': 1, 'data': 'pong' }

Ajout d'une tâche via addTask. La méthode waitForTask() est détaillée plus bas dans la section Méthodes.

taskId = aparser.addTask(
    [['SE::Google', 'default',
        {
            'type': 'override',
            'id': 'formatresult',
            'value': '$serp.format("$anchor\\n")'
        }, {
            'type': 'override',
            'id': 'pagecount',
            'value': 1
        }, {
            'type': 'override',
            'id': 'useproxy',
            'value': False
        }
    ]],
    'default',
    'text',
    'diamond',
    resultsFormat= '$p1.preset',
    uniqueQueries= False,
    queryFormat= ['$query'],
    resultsUnique= 'no',
    resultsSaveTo= 'file',
    resultsFileName= '$datefile.format().txt',
    doLog= 'no',
    keepUnique= 'No',
    moreOptions= False,
    resultsPrepend= '',
    resultsAppend= '',
    configOverrides= [],
    queryBuilders= []
)['data']

aparser.waitForTask(taskId)
print(aparser.getTaskResultsFile(taskId))

Résultat :

{'success': 1, 'data': 'http://127.0.0.1:9091/downloadResults?fileName=Jul-29_17-33-37.txt&token=utmxidbc'}

Ajout d'une tâche via oneRequest.

print(aparser.oneRequest('SE::Yahoo::Suggest', 'default', 'spider'))

Résultat :

{
   "success" : 1,
   "data" : {
      "logs" : [
         [
            0,
            1596033005,
            "Parser SE::Yahoo::Suggest::0 parse query spider"
         ],
         [
            0,
            1596033005,
            "Use proxy http://51.255.55.144:28466"
         ],
         [
            0,
            1596033006,
            "GET(1): http://sugg.search.yahoo.com/gossip-us-fp/?nresults=10&output=yjson&version=&command=spider - 200 OK (0.3 KB)"
         ],
         [
            3,
            1596033006,
            1
         ],
         [
            0,
            1596033006,
            "Thread complete work"
         ]
      ],
      "resultString" : "spider - spider:\nspider solitaire\nspiderman\nspider bites\nspider bite pictures\nspider solitaire two suits\nspider plant\nspider-man\nspider solitaire free\nspider bites pictures and symptoms\nspider monkey\n"
   }
}

Méthodes

Toutes les méthodes disponibles dans l'API A-Parser sont implémentées dans le module. Vous pouvez trouver leur liste ici

waitForTask

La méthode waitForTask() permet d'attendre la fin de l'exécution d'une tâche. L'ID de la tâche et l'intervalle en secondes (optionnel) doivent être spécifiés comme arguments. Par défaut, l'intervalle de vérification de l'état de la tâche est fixé à 5 secondes. Dès que le statut de la tâche est completed, la méthode renverra cette valeur.