torequests 4.8.6

Async wrapper for requests / aiohttp, and some python crawler toolkits. Let synchronization code enjoy the performance of asynchronous programming. Read more: https://github.com/ClericPy/torequests.

Welcome to torequests’s documentation!

Github

Document

Quickstart

To start:

pip install torequests -U

requirements:

requests

futures # python2

aiohttp >= 3.0.5 # python3

uvloop # python3

optional:

jsonpath_rw_ext

lxml

objectpath

psutil

fuzzywuzzy

python-Levenshtein

pyperclip

Examples:

1. Async, threads - make functions asynchronous

from torequests.main import Async, threads
import time


def use_submit(i):
    time.sleep(i)
    result = 'use_submit: %s' % i
    print(result)
    return result


@threads()
def use_decorator(i):
    time.sleep(i)
    result = 'use_decorator: %s' % i
    print(result)
    return result


new_use_submit = Async(use_submit)
tasks = [new_use_submit(i) for i in (2, 1, 0)
        ] + [use_decorator(i) for i in (2, 1, 0)]
print([type(i) for i in tasks])
results = [i.x for i in tasks]
print(results)

# use_submit: 0
# use_decorator: 0
# [<class 'torequests.main.NewFuture'>, <class 'torequests.main.NewFuture'>, <class 'torequests.main.NewFuture'>, <class 'torequests.main.NewFuture'>, <class 'torequests.main.NewFuture'>, <class 'torequests.main.NewFuture'>]
# use_submit: 1
# use_decorator: 1
# use_submit: 2
# use_decorator: 2
# ['use_submit: 2', 'use_submit: 1', 'use_submit: 0', 'use_decorator: 2', 'use_decorator: 1', 'use_decorator: 0']

2. tPool - thread pool for async-requests

from torequests.main import tPool
from torequests.logs import print_info

trequests = tPool()
test_url = 'http://p.3.cn'
ss = [
    trequests.get(
        test_url,
        retry=2,
        callback=lambda x: (len(x.content), print_info(len(x.content))))
    for i in range(3)
]
# or [i.x for i in ss]
trequests.x
ss = [i.cx for i in ss]
print_info(ss)

# [2018-03-18 21:18:09]: 612
# [2018-03-18 21:18:09]: 612
# [2018-03-18 21:18:09]: 612
# [2018-03-18 21:18:09]: [(612, None), (612, None), (612, None)]

3. Requests - aiohttp-wrapper

from torequests.dummy import Requests
from torequests.logs import print_info
trequests = Requests(frequencies={'p.3.cn': (2, 2)})
ss = [
    trequests.get(
        'http://p.3.cn', retry=1, timeout=5,
        callback=lambda x: (len(x.content), print_info(trequests.frequencies)))
    for i in range(4)
]
trequests.x
ss = [i.cx for i in ss]
print_info(ss)

# [2018-03-19 00:57:36]: {'p.3.cn': Frequency(sem=<1/2>, interval=2)}
# [2018-03-19 00:57:36]: {'p.3.cn': Frequency(sem=<0/2>, interval=2)}
# [2018-03-19 00:57:38]: {'p.3.cn': Frequency(sem=<1/2>, interval=2)}
# [2018-03-19 00:57:38]: {'p.3.cn': Frequency(sem=<2/2>, interval=2)}
# [2018-03-19 00:57:38]: [(612, None), (612, None), (612, None), (612, None)]

4. utils: some useful crawler toolkits

ClipboardWatcher: watch your clipboard changing.

Counts: counter while every time being called.

Null: will return self when be called, and alway be False.

Regex: Regex Mapper for string -> regex -> object.

Saver: simple object persistent toolkit with pickle/json.

Timer: timing tool.

UA: some common User-Agents for crawler.

curlparse: translate curl-string into dict of request.

md5: str(obj) -> md5_string.

print_mem: show the proc-mem-cost with psutil, use this only for lazinesssss.

ptime: %Y-%m-%d %H:%M:%S -> timestamp.

ttime: timestamp -> %Y-%m-%d %H:%M:%S

slice_by_size: slice a sequence into chunks, return as a generation of chunks with size.

slice_into_pieces: slice a sequence into n pieces, return a generation of n pieces.

timeago: show the seconds as human-readable.

unique: unique one sequence.

Read More