browserfetch 0.7.0__tar.gz → 0.10.0__tar.gz

{browserfetch-0.7.0 → browserfetch-0.10.0}/PKG-INFO

@@ -1,71 +1,72 @@
-Metadata-Version: 2.1
-Name: browserfetch
-Version: 0.7.0
-Summary: fetch in Python using your browser! 
-License: GNU General Public License v3 (GPLv3)
-Project-URL: Homepage, https://github.com/5j9/browserfetch
-Keywords: browser,fetch,python,cookies
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Requires-Python: >=3.11
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Requires-Dist: aiohttp
-Requires-Dist: pyperclip
-
-Fetch using your browser.
-
-Let the browser manage cookies for you.
-
-⚠️ This project is a very simple implementation. Not tested thoroughly. Consider it a proof of concept.
-
-Usage
------
-1. You'll run a Python script containing some code like this:
-
-.. code-block:: python
-
-    from asyncio import gather, new_event_loop
-
-    from browserfetch import fetch, get, post, run_server
-
-
-    async def main():
-        response1, response2, reponse3 = await gather(
-            get('https://example.com/path1', params={'a': 1}),
-            fetch('https://example.com/image.png'),
-            post('https://example.com/path2', data={'a': 1}),
-        )
-        # do stuff with retrieved responses
-
-
-    loop = new_event_loop()
-    loop.create_task(start_server())
-    loop.run_until_complete(main())
-
-
-2. Open your browser, goto http://example.com (perhaps solve a captcha and log in).
-3. Copy the contents of `browserfetch.js`_ file and paste it in browser's console. (You can use a browser extensions like violentmonkey_/tampermonkey_ to do this step for you.)
-
-That's it! Your Python script starts handling requests.
-The browser tab should remain open of-coarse.
-
-The server can handle multiple websocket connections from different websites simultaneously.
-
-How it works
-------------
-``browserfetch`` communicates with your browser using a websocket. The ``fetch`` function just passes the request to browser and it is the browser that handles the actual request. Response data is sent back to Python using the same WebSocket connection.
-
-Motivations
------------
-* `browser_cookie3 stopped working on Chrome-based browsers`_. There is a workaround: ShadowCopy, but it requires admin privilege.
-* Another issue with browser_cookie's approach is that it retrieves cookies from cookie files, but these files are not updated instantly. Thus, you might have to wait or retry a few times before you can successfully access newly set cookies.
-* ShadowCopying and File access are slow and inefficient operations.
-
-Downsides
----------
-* Setting up ``browserfetch`` is more cumbersome since it requires running a Python server and also injecting a small script into the webpage. Using ``browser_cookie3`` might be a better choice if there are many websites that you need to communicate with.
-
-.. _`browser_cookie3 stopped working on Chrome-based browsers`: https://github.com/borisbabic/browser_cookie3/issues/180
-.. _tampermonkey: https://github.com/Tampermonkey/tampermonkey
-.. _violentmonkey: https://github.com/violentmonkey/violentmonkey
-.. _browserfetch.js: https://github.com/5j9/browserfetch/blob/master/browserfetch/browserfetch.js
+Metadata-Version: 2.3
+Name: browserfetch
+Version: 0.10.0
+Summary: fetch in Python using your browser! 
+Keywords: browser,fetch,python,cookies
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Requires-Dist: aiohttp
+Requires-Dist: pyperclip
+Requires-Dist: cyclopts
+Project-URL: Homepage, https://github.com/5j9/browserfetch
+
+Fetch using your browser.
+
+Let the browser manage cookies for you.
+
+⚠️ Incomplete. Not tested thoroughly. Consider using `Playwright`_, especially for more complex scenarios.
+
+Usage
+-----
+1. You'll run a Python script containing some code like this:
+
+.. code-block:: python
+
+    from asyncio import gather, new_event_loop
+
+    from browserfetch import fetch, get, post, run_server
+
+
+    async def main():
+        response1, response2, reponse3 = await gather(
+            get('https://example.com/path1', params={'a': 1}),
+            fetch('https://example.com/image.png'),
+            post('https://example.com/path2', data={'a': 1}),
+        )
+        # do stuff with retrieved responses
+
+
+    loop = new_event_loop()
+    loop.create_task(start_server())
+    loop.run_until_complete(main())
+
+
+2. Open your browser, goto http://example.com (perhaps solve a captcha and log in).
+3. Copy the contents of `browserfetch.js`_ file and paste it in browser's console. (You can use a browser extensions like violentmonkey_/tampermonkey_ to do this step for you.)
+
+That's it! Your Python script starts handling requests.
+The browser tab should remain open of-coarse.
+
+The server can handle multiple websocket connections from different websites simultaneously.
+
+How it works
+------------
+``browserfetch`` communicates with your browser using a websocket. The ``fetch`` function just passes the request to browser and it is the browser that handles the actual request. Response data is sent back to Python using the same WebSocket connection.
+
+Motivations
+-----------
+* `browser_cookie3 stopped working on Chrome-based browsers`_. There is a workaround: ShadowCopy, but it requires admin privilege.
+* Another issue with browser_cookie's approach is that it retrieves cookies from cookie files, but these files are not updated instantly. Thus, you might have to wait or retry a few times before you can successfully access newly set cookies.
+* ShadowCopying and File access are slow and inefficient operations.
+
+Downsides
+---------
+* Setting up ``browserfetch`` is more cumbersome since it requires running a Python server and also injecting a small script into the webpage. Using ``browser_cookie3`` might be a better choice if there are many websites that you need to communicate with.
+
+.. _playwright: https://playwright.dev/python/docs/intro
+.. _`browser_cookie3 stopped working on Chrome-based browsers`: https://github.com/borisbabic/browser_cookie3/issues/180
+.. _tampermonkey: https://github.com/Tampermonkey/tampermonkey
+.. _violentmonkey: https://github.com/violentmonkey/violentmonkey
+.. _browserfetch.js: https://github.com/5j9/browserfetch/blob/master/browserfetch/browserfetch.js
+

{browserfetch-0.7.0 → browserfetch-0.10.0}/README.rst

@@ -2,7 +2,7 @@ Fetch using your browser.
 
 Let the browser manage cookies for you.
 
-⚠️ This project is a very simple implementation. Not tested thoroughly. Consider it a proof of concept.
+⚠️ Incomplete. Not tested thoroughly. Consider using `Playwright`_, especially for more complex scenarios.
 
 Usage
 -----
@@ -51,6 +51,7 @@ Downsides
 ---------
 * Setting up ``browserfetch`` is more cumbersome since it requires running a Python server and also injecting a small script into the webpage. Using ``browser_cookie3`` might be a better choice if there are many websites that you need to communicate with.
 
+.. _playwright: https://playwright.dev/python/docs/intro
 .. _`browser_cookie3 stopped working on Chrome-based browsers`: https://github.com/borisbabic/browser_cookie3/issues/180
 .. _tampermonkey: https://github.com/Tampermonkey/tampermonkey
 .. _violentmonkey: https://github.com/violentmonkey/violentmonkey

{browserfetch-0.7.0 → browserfetch-0.10.0}/browserfetch/__init__.py

@@ -1,30 +1,36 @@
-__version__ = '0.7.0'
-
+__version__ = '0.10.0'
 import atexit
 from asyncio import (
     AbstractEventLoop,
     CancelledError,
     Event,
+    Task,
     get_running_loop,
     wait_for,
-    Task,
 )
 from collections import defaultdict
 from dataclasses import dataclass
+from html import escape
 from json import dumps, loads
 from logging import getLogger
-from typing import Any
 from urllib.parse import urlencode
 
 from aiohttp import ClientSession, ClientWebSocketResponse
-from aiohttp.web import Application, RouteTableDef, WebSocketResponse
+from aiohttp.web import (
+    Application,
+    Request,
+    Response as _Response,
+    RouteTableDef,
+    WebSocketResponse,
+)
 from aiohttp.web_runner import AppRunner, TCPSite
 
 logger = getLogger(__name__)
 # maps host to its host_ready event or its websocket
-hosts: dict[
+hosts: defaultdict[
     str, Event | WebSocketResponse | ClientWebSocketResponse
 ] = defaultdict(Event)
+
 # maps response event id to its response event or response dict
 responses: dict[int, Event | dict] = {}
 
@@ -81,12 +87,15 @@ async def _request(
     if body is not None:
         bytes_ += b'\0' + body
 
-    ws = hosts[host]
-    if isinstance(ws, Event):
-        await ws.wait()
-        ws = hosts[host]
-
-    await ws.send_bytes(bytes_)
+    value = hosts[host]
+    match value:
+        case Event():
+            # wait for the Event to be turned into a websocket response
+            await value.wait()
+            ws = hosts[host]
+            await ws.send_bytes(bytes_)  # type: ignore
+        case WebSocketResponse() | ClientWebSocketResponse():
+            await value.send_bytes(bytes_)
 
     try:
         await wait_for(response_ready.wait(), data['timeout'])
@@ -94,7 +103,8 @@ async def _request(
         responses.pop(event_id, None)
         raise
 
-    return responses.pop(event_id)
+    # this must return a dict at this point, not an Event
+    return responses.pop(event_id)  # type: ignore
 
 
 async def receive_responses(ws: WebSocketResponse | ClientWebSocketResponse):
@@ -105,14 +115,17 @@ async def receive_responses(ws: WebSocketResponse | ClientWebSocketResponse):
         j['body'] = body
         event_id = j.pop('event_id')
         try:
-            event = responses[event_id]
+            # We expect only one response to be recieved for each event,
+            # therefore this must be an Event, not a dict.
+            response_ready: Event = responses[event_id]  # type: ignore
         except KeyError:  # lock has reached timeout already
             continue
         responses[event_id] = j
-        event.set()
+        response_ready.set()
 
 
 routes = RouteTableDef()
+PROTOCOL = '3'
 
 
 @routes.get('/ws')
@@ -120,7 +133,10 @@ async def _(request):
     ws = WebSocketResponse()
     await ws.prepare(request)
 
-    host = await ws.receive_str()
+    version, _, host = (await ws.receive_str()).partition(' ')
+    assert version == PROTOCOL, (
+        f'JavaScript protocol version: {version}, expected: {PROTOCOL}'
+    )
     logger.info('registering host %s', host)
 
     ws_or_e = hosts[host]
@@ -133,10 +149,11 @@ async def _(request):
     except TypeError:
         logger.info('host WebSocket was closed')
         hosts[host] = Event()
+    return ws
 
 
 @routes.get('/relay')
-async def _(request):
+async def _(request: Request) -> WebSocketResponse:
     ws = WebSocketResponse()
     await ws.prepare(request)
 
@@ -144,13 +161,15 @@ async def _(request):
         try:
             bytes_ = await ws.receive_bytes()
         except TypeError:  # ws closed
-            return
+            return ws
         data, null, body = bytes_.partition(b'\0')
         data = loads(data)
         relay_event_id = data['event_id']
 
         try:
-            r = await _request(data.pop('host'), data, body if null else None)
+            r: dict = await _request(
+                data.pop('host'), data, body if null else None
+            )
         except TimeoutError:
             r = {'error': 'TimeoutError in relay'}
 
@@ -159,6 +178,22 @@ async def _(request):
         await ws.send_bytes(dumps(r).encode() + b'\0' + body)
 
 
+@routes.get('/')
+async def _(_) -> _Response:
+    hosts_html = '\n'.join(
+        [f'<li>{k}: {escape(str(v))}</li>' for k, v in hosts.items()]
+    )
+    responses_html = '\n'.join(
+        [f'<li>{k}: {escape(str(v))}</li>' for k, v in responses.items()]
+    )
+    return _Response(
+        body='<meta charset="utf-8">\n<title>browserfetch</title>\n'
+        f'Hosts:\n{hosts_html}\n'
+        f'Responses:\n{responses_html}',
+        content_type='text/html',
+    )
+
+
 async def relay_client(server_host, server_port):
     async with ClientSession() as session:
         relay_url = f'ws://{server_host}:{server_port}/relay'
@@ -183,14 +218,26 @@ async def relay_client(server_host, server_port):
                 return
 
 
+async def evaluate(
+    string: str,
+    host: str,
+    timeout: int | float = 95,
+):
+    """Evaluate string in browser context and return JSON.stringify(result)."""
+    d = await _request(
+        host, {'action': 'eval', 'string': string, 'timeout': timeout}, None
+    )
+    return d['result']
+
+
 async def fetch(
     url: str,
     *,
-    params: dict = None,
-    body: bytes = None,
+    params: dict | None = None,
+    body: bytes | None = None,
     timeout: int | float = 95,
-    options: dict = None,
-    host=None,
+    options: dict | None = None,
+    host: str | None = None,
 ) -> Response:
     """Fetch using browser fetch API available on host.
 
@@ -209,6 +256,7 @@ async def fetch(
     d = await _request(
         host,
         {
+            'action': 'fetch',
             'url': url,
             'options': options,
             'timeout': timeout,
@@ -225,9 +273,9 @@ async def fetch(
 async def get(
     url: str,
     *,
-    params: dict = None,
-    options: dict = None,
-    host: str = None,
+    params: dict | None = None,
+    options: dict | None = None,
+    host: str | None = None,
     timeout: int | float = 95,
 ) -> Response:
     if options is None:
@@ -242,30 +290,33 @@ async def get(
 async def post(
     url: str,
     *,
-    params: dict = None,
-    body: bytes = None,
-    data: dict = None,
-    json=None,
+    params: dict | None = None,
+    data: bytes | dict | str | None = None,
+    form: dict | None = None,
     timeout: int | float = 95,
-    options: dict = None,
-    host: str = None,
+    options: dict | None = None,
+    host: str | None = None,
 ) -> Response:
     if options is None:
-        options: dict[str, Any] = {'method': 'POST'}
+        options = {'method': 'POST'}
     else:
         options['method'] = 'POST'
 
-    if json is not None:
-        assert body is None
-        body = dumps(json).encode()
-        headers = options.setdefault('headers', {})
-        headers['Content-Type'] = 'application/json'
-
     if data is not None:
-        assert body is None
-        body = urlencode(data).encode()
+        if isinstance(data, str):
+            body = data.encode()
+        elif isinstance(data, bytes):
+            body = data
+        else:
+            body = dumps(data).encode()
+            headers = options.setdefault('headers', {})
+            headers['Content-Type'] = 'application/json'
+    elif form is not None:
+        body = urlencode(form).encode()
         headers = options.setdefault('headers', {})
         headers['Content-Type'] = 'application/x-www-form-urlencoded'
+    else:
+        body = None
 
     return await fetch(
         url,
@@ -288,7 +339,7 @@ def _shutdown_server(loop: AbstractEventLoop):
 
 
 def _cancel_relay_task(loop: AbstractEventLoop, task: Task):
-    logger.info(f'cancelling relay task')
+    logger.info('cancelling relay task')
     task.cancel()
     try:
         loop.run_until_complete(task)

browserfetch-0.10.0/browserfetch/__main__.py

@@ -0,0 +1,36 @@
+from pathlib import Path
+
+
+def read_js(host_name_generator: str | None):
+    js = (Path(__file__).parent / 'browserfetch.js').read_bytes().decode()
+    if host_name_generator is not None:
+        return js.replace(
+            'async function generateHostName() { return location.host };',
+            host_name_generator,
+            1,
+        )
+    return js
+
+
+def copyjs(*, host_name_generator: str | None = None):
+    """Copy contents of browserfetch.js to clipboard.
+
+    `host_name_generator` should be a string containing
+    an async JavaScript function named `generateHostName()`. This file's
+    contents will be copied into the generated js script and will be used
+    to generate a host name for connections. The default
+    `generateHostName` function returns `location.host`.
+    """
+    from pyperclip import copy
+
+    copy(read_js(host_name_generator))
+
+
+if __name__ == '__main__':
+    from cyclopts import App
+
+    from browserfetch import __version__
+
+    app = App(version=__version__)
+    app.command(copyjs)
+    app()

browserfetch-0.10.0/browserfetch/browserfetch.js

@@ -0,0 +1,147 @@
+// ==UserScript==
+// @name        browserfetch
+// @namespace   https://github.com/5j9/browserfetch
+// @match       https://example.com/
+// @grant       GM_registerMenuCommand
+// ==/UserScript==
+// @ts-check
+(async () => {
+    /**
+     * @param {Uint8Array | null} body 
+     * @param {Object} req
+     * @returns {Promise<Blob>}
+     */
+    async function doFetch(req, body) {
+        var returnData, response;
+        var options = req['options'] || {};
+
+        if (req['timeout']) {
+            options.signal = AbortSignal.timeout(req['timeout'] * 1000);
+        }
+
+        if (body !== null) {
+            options.body = body;
+        }
+
+        try {
+            var r = await fetch(req['url'], options);
+            returnData = {
+                'event_id': req['event_id'],
+                'headers': Object.fromEntries([...r.headers]),
+                'ok': r.ok,
+                'redirected': r.redirected,
+                'status': r.status,
+                'status_text': r.statusText,
+                'type': r.type,
+                'url': r.url
+            };
+            response = await r.blob();
+        } catch (err) {
+            returnData = {
+                'event_id': req['event_id'],
+                'error': err.toString()
+            };
+            response = "";
+        };
+        return new Blob([new TextEncoder().encode(JSON.stringify(returnData)), "\0", response]);
+    }
+
+    /**
+     * 
+     * @param {Object} req
+     * @returns {Promise<Uint8Array>}
+     */
+    async function doEval(req) {
+        var evalled, resp;
+        try {
+            evalled = eval(req['string']);
+            switch (evalled.constructor.name) {
+                case 'AsyncFunction':
+                    evalled = await evalled;
+                    break;
+                case 'Promise':
+                    evalled = await evalled;
+                    break;
+                case 'Function':
+                    evalled = evalled();
+                    break;
+            }
+            resp = { 'result': evalled, 'event_id': req['event_id'] };
+        } catch (err) {
+            resp = { 'result': err.toString(), 'event_id': req['event_id'] };
+        }
+        return new TextEncoder().encode(JSON.stringify(resp));
+    }
+
+    /**
+     * 
+     * @param {ArrayBuffer} d 
+     * @returns {[Uint8Array | null, Object]}
+     */
+    function parseData(d) {
+        var blob, jArray;
+        var dArray = new Uint8Array(d);
+        var nullIndex = dArray.indexOf(0);
+        if (nullIndex === -1) {
+            blob = null;
+            jArray = dArray;
+        } else {
+            blob = dArray.slice(nullIndex + 1);
+            jArray = dArray.slice(0, nullIndex)
+        }
+
+        return [blob, JSON.parse(new TextDecoder().decode(jArray))]
+    }
+
+    async function generateHostName() { return location.host };
+    var hostName;
+
+    function connect() {
+        var protocol = '3'
+        var ws = new WebSocket("ws://127.0.0.1:9404/ws");
+        ws.binaryType = "arraybuffer";
+
+        ws.onopen = async () => {
+            if (!hostName) {
+                hostName = await generateHostName();
+            }
+            ws.send(protocol + ' ' + hostName);
+        }
+
+        ws.onclose = () => {
+            console.error('WebSocket was closed; will retry in 5 seconds');
+            setTimeout(connect, 5000);
+        };
+
+        ws.onmessage = async (evt) => {
+            var /**@type {Uint8Array | Blob} */ result, j, b;
+            [b, j] = parseData(evt.data);
+            switch (j['action']) {
+                case 'fetch':
+                    result = await doFetch(j, b);
+                    break;
+                case 'eval':
+                    result = await doEval(j);
+                    break;
+                default:
+                    result = new TextEncoder().encode(JSON.stringify({
+                        'event_id': j['event_id'],
+                        'error': `Action ${j['action']} is not defined.`
+                    }));
+                    break;
+            }
+            ws.send(result);
+        }
+    };
+
+    // @ts-ignore
+    if (window.GM_registerMenuCommand) {
+        // @ts-ignore
+        GM_registerMenuCommand(
+            'connect to browserfetch',
+            connect
+        );
+    } else {
+        connect();
+    }
+})();

browserfetch-0.10.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ['flit_core >=3.2,<4']
+build-backend = 'flit_core.buildapi'
+
+[project]
+name = "browserfetch"
+description = "fetch in Python using your browser! "
+keywords = ["browser", "fetch", "python", "cookies"]
+classifiers = [
+    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+]
+requires-python = ">=3.11"
+dynamic = ["version"]
+dependencies = [
+    "aiohttp",
+    "pyperclip",
+    "cyclopts",
+]
+
+[[authors]]
+name = "5j9"
+email = "5j9@users.noreply.github.com"
+
+[project.license]
+text = "GNU General Public License v3 (GPLv3)"
+
+[project.readme]
+file = "README.rst"
+content-type = "text/x-rst"
+
+[project.urls]
+Homepage = "https://github.com/5j9/browserfetch"
+
+[tool.ruff]
+line-length = 79
+format.quote-style = 'single'
+lint.isort.combine-as-imports = true
+lint.extend-select = [
+    'W605', # invalid-escape-sequence
+    'FA',  # flake8-future-annotations
+    'I',  # isort
+    'UP',  # pyupgrade
+]
+lint.ignore = [
+    'E721',  # Do not compare types, use `isinstance()`
+]
+
+[tool.pytest.ini_options]
+addopts = '--quiet --tb=short'
+
+[tool.pyright]
+typeCheckingMode = 'standard'
+reportDeprecated = "warning"
+reportPropertyTypeMismatch = "warning"
+reportUnnecessaryCast = "warning"
+reportUnnecessaryContains = "warning"
+reportUnnecessaryIsInstance = "warning"
+reportUnnecessaryTypeIgnoreComment = true
+reportInvalidStringEscapeSequence = false
+reportConstantRedefinition = 'error'
+reportTypeCommentUsage = 'warning'
+reportUnnecessaryComparison = 'warning'

browserfetch-0.7.0/browserfetch/__main__.py

@@ -1,24 +0,0 @@
-from argparse import ArgumentDefaultsHelpFormatter, ArgumentParser
-from pathlib import Path
-
-from pyperclip import copy
-
-
-def main():
-    parser = ArgumentParser(
-        description='The command-line entry for browserfetch.',
-        formatter_class=ArgumentDefaultsHelpFormatter,
-    )
-
-    parser.add_argument(
-        'copyjs', help='copy contents of browserfetch.js to clipboard'
-    )
-    args = parser.parse_args()
-
-    if args.copyjs:
-        with (Path(__file__).parent / 'browserfetch.js').open() as f:
-            copy(f.read())
-
-
-if __name__ == '__main__':
-    main()

browserfetch-0.7.0/browserfetch/browserfetch.js

@@ -1,75 +0,0 @@
-// ==UserScript==
-// @name        browserfetch
-// @namespace   https://github.com/5j9/browserfetch
-// @match       https://example.com/
-// @grant       GM_registerMenuCommand
-// ==/UserScript==
-(() => {
-    function connect() {
-        var ws = new WebSocket("ws://127.0.0.1:9404/ws");
-        ws.binaryType = "arraybuffer";
-
-        ws.onopen = () => {
-            ws.send(location.host);
-        }
-
-        ws.onclose = function () {
-            console.error('browserfetch: WebSocket was closed; will retry in 5 seconds');
-            setTimeout(connect, 5000);
-        };
-
-        ws.onmessage = async (evt) => {
-            var returnData, responseBlob, body, jArray;
-            var requestArray = new Uint8Array(evt.data);
-            var nullIndex = requestArray.indexOf(0);
-            if (nullIndex === -1) {
-                body = null;
-                jArray = requestArray;
-            } else {
-                body = requestArray.slice(nullIndex + 1);
-                jArray = requestArray.slice(0, nullIndex)
-            }
-            var j = JSON.parse(new TextDecoder().decode(jArray));
-            var options = j['options'] || {};
-
-            if (j['timeout']) {
-                options.signal = AbortSignal.timeout(j['timeout'] * 1000);
-            }
-
-            if (body !== null) {
-                options.body = body;
-            }
-
-            try {
-                var r = await fetch(j['url'], options);
-                returnData = {
-                    'event_id': j['event_id'],
-                    'headers': Object.fromEntries([...r.headers]),
-                    'ok': r.ok,
-                    'redirected': r.redirected,
-                    'status': r.status,
-                    'status_text': r.statusText,
-                    'type': r.type,
-                    'url': r.url
-                };
-                responseBlob = await r.blob();
-            } catch (err) {
-                returnData = {
-                    'event_id': j['event_id'],
-                    'error': err.toString()
-                };
-                responseBlob = "";
-            };
-            ws.send(new Blob([new TextEncoder().encode(JSON.stringify(returnData)), "\0", responseBlob]));
-        }
-    };
-
-    if (window.GM_registerMenuCommand) {
-        GM_registerMenuCommand(
-            'connect to browserfetch',
-            connect
-        );
-    } else {
-        connect();
-    }
-})();

browserfetch-0.7.0/browserfetch.egg-info/PKG-INFO

@@ -1,71 +0,0 @@
-Metadata-Version: 2.1
-Name: browserfetch
-Version: 0.7.0
-Summary: fetch in Python using your browser! 
-License: GNU General Public License v3 (GPLv3)
-Project-URL: Homepage, https://github.com/5j9/browserfetch
-Keywords: browser,fetch,python,cookies
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Requires-Python: >=3.11
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Requires-Dist: aiohttp
-Requires-Dist: pyperclip
-
-Fetch using your browser.
-
-Let the browser manage cookies for you.
-
-⚠️ This project is a very simple implementation. Not tested thoroughly. Consider it a proof of concept.
-
-Usage
------
-1. You'll run a Python script containing some code like this:
-
-.. code-block:: python
-
-    from asyncio import gather, new_event_loop
-
-    from browserfetch import fetch, get, post, run_server
-
-
-    async def main():
-        response1, response2, reponse3 = await gather(
-            get('https://example.com/path1', params={'a': 1}),
-            fetch('https://example.com/image.png'),
-            post('https://example.com/path2', data={'a': 1}),
-        )
-        # do stuff with retrieved responses
-
-
-    loop = new_event_loop()
-    loop.create_task(start_server())
-    loop.run_until_complete(main())
-
-
-2. Open your browser, goto http://example.com (perhaps solve a captcha and log in).
-3. Copy the contents of `browserfetch.js`_ file and paste it in browser's console. (You can use a browser extensions like violentmonkey_/tampermonkey_ to do this step for you.)
-
-That's it! Your Python script starts handling requests.
-The browser tab should remain open of-coarse.
-
-The server can handle multiple websocket connections from different websites simultaneously.
-
-How it works
-------------
-``browserfetch`` communicates with your browser using a websocket. The ``fetch`` function just passes the request to browser and it is the browser that handles the actual request. Response data is sent back to Python using the same WebSocket connection.
-
-Motivations
------------
-* `browser_cookie3 stopped working on Chrome-based browsers`_. There is a workaround: ShadowCopy, but it requires admin privilege.
-* Another issue with browser_cookie's approach is that it retrieves cookies from cookie files, but these files are not updated instantly. Thus, you might have to wait or retry a few times before you can successfully access newly set cookies.
-* ShadowCopying and File access are slow and inefficient operations.
-
-Downsides
----------
-* Setting up ``browserfetch`` is more cumbersome since it requires running a Python server and also injecting a small script into the webpage. Using ``browser_cookie3`` might be a better choice if there are many websites that you need to communicate with.
-
-.. _`browser_cookie3 stopped working on Chrome-based browsers`: https://github.com/borisbabic/browser_cookie3/issues/180
-.. _tampermonkey: https://github.com/Tampermonkey/tampermonkey
-.. _violentmonkey: https://github.com/violentmonkey/violentmonkey
-.. _browserfetch.js: https://github.com/5j9/browserfetch/blob/master/browserfetch/browserfetch.js

browserfetch-0.7.0/browserfetch.egg-info/SOURCES.txt

@@ -1,12 +0,0 @@
-LICENSE
-README.rst
-pyproject.toml
-browserfetch/__init__.py
-browserfetch/__main__.py
-browserfetch/browserfetch.js
-browserfetch.egg-info/PKG-INFO
-browserfetch.egg-info/SOURCES.txt
-browserfetch.egg-info/dependency_links.txt
-browserfetch.egg-info/not-zip-safe
-browserfetch.egg-info/requires.txt
-browserfetch.egg-info/top_level.txt

browserfetch-0.7.0/browserfetch.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

browserfetch-0.7.0/browserfetch.egg-info/not-zip-safe

@@ -1 +0,0 @@
-

browserfetch-0.7.0/browserfetch.egg-info/requires.txt

@@ -1,2 +0,0 @@
-aiohttp
-pyperclip

browserfetch-0.7.0/browserfetch.egg-info/top_level.txt

@@ -1 +0,0 @@
-browserfetch

browserfetch-0.7.0/pyproject.toml

@@ -1,50 +0,0 @@
-[build-system]
-requires = [
-    "setuptools>=66.1.0",
-    "wheel",
-]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "browserfetch"
-description = "fetch in Python using your browser! "
-keywords = ["browser", "fetch", "python", "cookies"]
-classifiers = [
-    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
-]
-requires-python = ">=3.11"
-dynamic = ["version"]
-dependencies = [
-    "aiohttp",
-    "pyperclip",
-]
-
-[[authors]]
-name = "5j9"
-email = "5j9@users.noreply.github.com"
-
-[project.license]
-text = "GNU General Public License v3 (GPLv3)"
-
-[project.readme]
-file = "README.rst"
-content-type = "text/x-rst"
-
-[project.urls]
-Homepage = "https://github.com/5j9/browserfetch"
-
-[tool.setuptools]
-packages = ["browserfetch"]
-zip-safe = false
-include-package-data = false
-
-[tool.setuptools.dynamic.version]
-attr = "browserfetch.__version__"
-
-[tool.setuptools.package-data]
-browserfetch = ["*.js"]
-
-[tool.ruff]
-format.quote-style = 'single'
-line-length = 79
-isort.combine-as-imports = true

browserfetch-0.7.0/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-