httpee 0.1.0__py3-none-any.whl

httpee/__init__.py

@@ -0,0 +1,204 @@
+"""httpee — HTTP для людей. Теперь пайплайнами.
+
+Тонкая обёртка над httpx для eelang: запрос собирается пайплайном, результат
+проверяется паттернами::
+
+    from httpee import POST, headers, Response
+
+    user =
+        {'name': 'kenneth', 'role': 'admin'}
+        ..headers: {'Authorization': 'Bearer ...'}
+        ..POST: 'https://api.example.com/users'
+        ..assert:
+            Response(status=201)
+
+    page =
+        httpee()
+        ..GET: 'https://api.example.com/users'
+        ..assert:
+            Response(status=200)
+
+4xx/5xx исключений не вызывают — статус проверяется ``..assert:``/``..match:``.
+"""
+
+import httpx
+
+__version__ = "0.1.0"
+
+
+class Response(httpx.Response):
+    """httpx.Response + свойство ``status`` для паттерна ``Response(status=200)``.
+
+    Остальное — родное: ``.json()``, ``.text``, ``.content``, ``.headers``,
+    ``.raise_for_status()``.
+    """
+
+    @property
+    def status(self):
+        return self.status_code
+
+
+class _Request:
+    """Накопленное состояние запроса. Пользователю не виден."""
+
+    __slots__ = ('method', 'url', 'body', 'json_body', 'headers', 'params',
+                 'timeout', 'cookies', 'auth')
+
+    def __init__(self, body=None):
+        self.method = None
+        self.url = None
+        self.body = body
+        self.json_body = None
+        self.headers = {}
+        self.params = {}
+        self.timeout = None
+        self.cookies = None
+        self.auth = None
+
+
+def httpee():
+    """Пустой запрос: httpee() ..GET: url — когда тела нет."""
+    return _Request()
+
+
+def _ensure(value):
+    """Тело или _Request → _Request; на Response — внятный TypeError."""
+    if isinstance(value, Response):
+        raise TypeError(
+            'это уже Response — модификаторы и глаголы идут до выполнения запроса')
+    return value if isinstance(value, _Request) else _Request(body=value)
+
+
+def _wrap(resp):
+    """httpx.Response → httpee.Response (для class-паттернов)."""
+    return Response(
+        resp.status_code,
+        headers=resp.headers,
+        content=resp.content,
+        request=resp.request,
+        extensions=resp.extensions,
+        history=resp.history,
+        default_encoding=resp.default_encoding,
+    )
+
+
+def _execute(req):
+    """Отправить _Request новым httpx.Client и вернуть Response."""
+    if req.url is None:
+        raise TypeError(
+            'запрос без адреса: задайте ..url: или вызовите ..GET:/..POST: с адресом')
+    method = (req.method or 'GET').upper()
+    kwargs = {}
+    if req.json_body is not None:
+        kwargs['json'] = req.json_body
+    else:
+        body = req.body
+        if body is None:
+            pass
+        elif isinstance(body, dict):
+            kwargs['data'] = body
+        elif isinstance(body, str):
+            kwargs['content'] = body.encode()
+        elif isinstance(body, (bytes, bytearray, memoryview)):
+            kwargs['content'] = bytes(body)
+        else:
+            raise TypeError(
+                f'неподдерживаемое тело запроса: {type(body).__name__} '
+                '(ожидаются dict/str/bytes)')
+    with httpx.Client(timeout=req.timeout) as client:
+        resp = client.request(method, req.url, headers=req.headers or None,
+                              params=req.params or None, cookies=req.cookies,
+                              auth=req.auth, **kwargs)
+    return _wrap(resp)
+
+
+def _verb(method):
+    """Глагол: ..GET: url → GET(url, значение) — выполняет запрос сразу."""
+
+    def run(url, value):
+        req = _ensure(value)
+        req.method = method
+        req.url = url
+        return _execute(req)
+
+    run.__name__ = method
+    run.__qualname__ = method
+    run.__doc__ = (
+        f'Выполнить {method}-запрос: ..{method}: url. '
+        'Значение пайплайна — тело или накопленный запрос.')
+    return run
+
+
+GET = _verb('GET')
+POST = _verb('POST')
+PUT = _verb('PUT')
+PATCH = _verb('PATCH')
+DELETE = _verb('DELETE')
+HEAD = _verb('HEAD')
+OPTIONS = _verb('OPTIONS')
+
+
+def send(value):
+    """Выполнить запрос с заранее заданными ..method:/..url: (..send())."""
+    return _execute(_ensure(value))
+
+
+def headers(headers_value, value):
+    """..headers: {...} — заголовки запроса (повторные вызовы дополняют)."""
+    req = _ensure(value)
+    req.headers.update(dict(headers_value))
+    return req
+
+
+def query(params_value, value):
+    """..query: {...} — query-параметры URL (повторные вызовы дополняют)."""
+    req = _ensure(value)
+    req.params.update(dict(params_value))
+    return req
+
+
+def timeout(timeout_value, value):
+    """..timeout: 5.0 — таймаут запроса в секундах."""
+    req = _ensure(value)
+    req.timeout = timeout_value
+    return req
+
+
+def cookies(cookies_value, value):
+    """..cookies: {...} — куки запроса."""
+    req = _ensure(value)
+    req.cookies = cookies_value
+    return req
+
+
+def auth(auth_value, value):
+    """..auth: ('user', 'pass') — basic-auth; можно httpx.Auth."""
+    req = _ensure(value)
+    req.auth = auth_value
+    return req
+
+
+def json(json_value, value):
+    """..json: {...} — тело JSON-ом (побеждает над телом пайплайна)."""
+    req = _ensure(value)
+    req.json_body = json_value
+    return req
+
+
+def method(method_value, value):
+    """..method: 'PATCH' — метод заранее; выполняется ..send()."""
+    req = _ensure(value)
+    req.method = str(method_value).upper()
+    return req
+
+
+def url(url_value, value):
+    """..url: 'https://...' — адрес заранее; выполняется ..send()."""
+    req = _ensure(value)
+    req.url = url_value
+    return req
+
+
+__all__ = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS',
+           'send', 'headers', 'query', 'timeout', 'cookies', 'auth', 'json',
+           'method', 'url', 'Response', 'httpee']

httpee-0.1.0.dist-info/METADATA

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: httpee
+Version: 0.1.0
+Summary: httpee — thin httpx wrapper for eelang pipelines
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Dynamic: license-file
+
+# httpee
+
+`httpee` is a thin wrapper around [httpx](https://www.python-httpx.org/) for
+[eelang](https://github.com/eel-lang/eelang-py): requests are written as pipelines,
+responses are checked with patterns.
+
+```python
+from httpee import POST, headers, httpee, Response
+
+user =
+    {'name': 'kenneth', 'role': 'admin'}      # dict → form-encoded, like requests data=
+    ..headers: {'Authorization': f'Bearer {token}'}
+    ..POST: 'https://api.example.com/users'
+    ..assert:
+        Response(status=201)
+
+page =
+    httpee()                                  # empty request — no body
+    ..query: {'page': 2}
+    ..GET: 'https://api.example.com/users'
+    ..assert:
+        Response(status=200)
+```
+
+## Cheatsheet
+
+```python
+from httpee import (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, send,
+                    httpee, headers, query, timeout, cookies, auth, json,
+                    method, url, Response)
+from eelang import MatchError
+```
+
+### A request is a pipeline
+
+```python
+r =
+    {'name': 'kenneth', 'role': 'admin'}     # dict → form-encoded
+    ..headers: {'X-Key': v}                  # headers (repeats add keys)
+    ..query: {'page': 2}                     # query parameters (repeats add keys)
+    ..POST: 'https://api.example.com/users'  # verb performs the request
+    ..assert:
+        Response(status=201)                 # failure → MatchError
+```
+
+### Bodies
+
+| Value | Sent as |
+|---|---|
+| dict | form-encoded (`data=`, like requests) |
+| str | text |
+| bytes | raw bytes |
+| `httpee()` | empty request — no body |
+| `..json: {…}` | JSON — takes precedence over the pipeline body |
+
+### Dynamic method — `..send()`
+
+```python
+r =
+    {'role': 'moderator'}
+    ..method: m                          # any method, even from a variable
+    ..url: 'https://…'
+    ..send()                             # without ..method: defaults to GET
+    ..assert:
+        Response(status=200)
+```
+
+### Pattern checks
+
+```python
+# ..assert: — shape check, binds variables, failure → MatchError
+p =
+    httpee()
+    ..GET: url
+    ..assert:
+        Response(status=s)               # s is available afterwards
+
+# ..match: — branch on status; no match → the value is unchanged
+verdict =
+    httpee()
+    ..GET: url
+    ..match:
+        case Response(status=200): 'ok'
+        case Response(status=n): f'HTTP {n}'
+```
+
+### Errors
+
+- 4xx/5xx do **not** raise: check the status with a pattern.
+- Network errors and timeouts are httpx exceptions (`ConnectError`, `TimeoutException`).
+- `Response` is `httpx.Response` plus `.status`: `.json()`, `.text`, `.headers` work as usual.
+
+### Modifiers at a glance
+
+`..headers:` · `..query:` · `..timeout: 5.0` · `..cookies:` · `..auth: (u, p)` · `..json:` · `..method:` · `..url:`
+
+## How it works
+
+- The pipeline's initial value is the request body: dict → form-encoded, str → text,
+  bytes → raw bytes. JSON goes through an explicit `..json: {…}`. A request without
+  a body starts with `httpee()`.
+- Modifiers accumulate parameters (repeatable, in any order); the verb at the end
+  performs the request and returns a `Response`.
+- 4xx/5xx do not raise — the status is checked with a pattern; a failed `..assert:`
+  raises `MatchError`. Network errors and timeouts are httpx exceptions.
+
+## Verbs
+
+| Verb | Example | What it does |
+|---|---|---|
+| `GET` … `OPTIONS` | `..GET: url` | performs the request with this method |
+| `send` | `..send()` | performs the request with a previously set `..method:`/`..url:` |
+
+The method can be set up front — and can be anything:
+
+```python
+patch =
+    {'role': 'moderator'}
+    ..method: 'PATCH'                          # or from a variable
+    ..url: 'https://api.example.com/users/1'
+    ..send()
+    ..assert:
+        Response(status=200)
+```
+
+## Modifiers
+
+| Modifier | Example | What it does |
+|---|---|---|
+| `headers` | `..headers: {'X-Key': v}` | headers (repeats add keys) |
+| `query` | `..query: {'page': 2}` | URL query parameters (repeats add keys) |
+| `timeout` | `..timeout: 5.0` | request timeout, seconds |
+| `cookies` | `..cookies: {'sid': v}` | cookies |
+| `auth` | `..auth: ('user', 'pass')` | basic auth (any `httpx.Auth` works) |
+| `json` | `..json: {…}` | JSON body (takes precedence over the pipeline body) |
+| `method` | `..method: 'PATCH'` | method up front — for `..send()` |
+| `url` | `..url: 'https://…'` | URL up front — for `..send()` |
+
+## Installation
+
+```sh
+pip install httpee
+```
+
+From source:
+
+```sh
+git clone https://github.com/eel-lang/httpee
+pip install ./httpee
+```
+
+Requires CPython 3.15 + [eelang](https://github.com/eel-lang/eelang-py) to run `.eel`
+files — the package itself is plain Python, and httpx is its only dependency.
+Works under gevent (`gevent.monkey.patch_all()`).
+
+## Tests
+
+```sh
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT (`LICENSE`).

httpee-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+httpee/__init__.py,sha256=7J7iS6VTl8dG970V0ShkU5JneNXWkfOgozDqxGowIe4,6421
+httpee-0.1.0.dist-info/licenses/LICENSE,sha256=e5O-ASdm-ay53Ombr3FGTuTCHitjde-7X9cOqWEA5nw,1063
+httpee-0.1.0.dist-info/METADATA,sha256=LfuLdXYEz79ScK68GQLAPnNcdUuwJ7s7NjPAka2jKig,5125
+httpee-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+httpee-0.1.0.dist-info/top_level.txt,sha256=4CRnPD5HgDwCZ2xgs5z306QWHMgAGNGzZsk7-5VT4V4,7
+httpee-0.1.0.dist-info/RECORD,,

httpee-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

httpee-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pwtail
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

httpee-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+httpee