Modulo di controllo A-Parser tramite API per Python

Compatibilità

Il modulo è compatibile con Python versione 2.7.* e >=3.8

Installazione

pip install a-parser

Utilizzo

Connessione del modulo e verifica del suo funzionamento tramite il metodo ping.

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

Risultato:

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

Aggiunta di un'attività tramite addTask. Il metodo waitForTask() è analizzato più in dettaglio di seguito nella sezione Metodi.

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))

Risultato:

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

Aggiunta di un'attività tramite oneRequest.

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

Risultato:

{
   "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"
   }
}

Metodi

Nel modulo sono implementati tutti i metodi disponibili per l'uso nell'API di A-Parser. Potete trovare il loro elenco qui

waitForTask

Il metodo waitForTask() permette di attendere il completamento di un'attività. Come argomenti è necessario indicare l'id dell'attività e l'intervallo in secondi (opzionale). Per impostazione predefinita, l'intervallo di controllo dello stato dell'attività è impostato a 5 secondi. Non appena lo stato dell'attività sarà uguale a completed, il metodo restituirà questo valore