bfast-py 0.1.0__cp38-abi3-win_amd64.whl → 1.0.4__cp38-abi3-win_amd64.whl

bfast_py-1.0.4.dist-info/METADATA

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: bfast-py
+Version: 1.0.4
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: pydantic>=2.0
+Requires-Dist: numpy
+Requires-Dist: matplotlib>=3.7.5 ; extra == 'dev'
+Requires-Dist: orjson>=3.10.15 ; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.7.1 ; extra == 'dev'
+Requires-Dist: mkdocstrings[python]>=0.26.1 ; extra == 'dev'
+Requires-Dist: pytest>=7.0 ; extra == 'dev'
+Requires-Dist: black>=23.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
+Requires-Dist: fastapi ; extra == 'fastapi'
+Provides-Extra: dev
+Provides-Extra: fastapi
+License-File: LICENSE
+Summary: ⚡ B-FAST (Binary Fast Adaptive Serialization Transfer) - Protocolo de serialização binária de ultra-alta performance, desenvolvido em Rust para o ecossistema Python e TypeScript
+Keywords: serialization,binary,fast,rust,pydantic,numpy
+Author: marcelomarkus
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/marcelomarkus/b-fast
+Project-URL: Issues, https://github.com/marcelomarkus/b-fast/issues
+Project-URL: Repository, https://github.com/marcelomarkus/b-fast
+
+## ⚡ B-FAST (Binary Fast Adaptive Serialization Transfer)
+
+O B-FAST é um protocolo de serialização binária de ultra-alta performance, desenvolvido em Rust para o ecossistema Python e TypeScript. Ele foi projetado para substituir o JSON em rotas críticas onde latência, uso de CPU e largura de banda são gargalos.
+
+
+## 🚀 Por que B-FAST?
+- **Motor Rust:** Serialização nativa sem o overhead do interpretador Python.
+- **Pydantic Native:** Lê atributos de modelos Pydantic diretamente da memória, pulando o lento processo de .model_dump().
+- **Zero-Copy NumPy:** Serializa tensores e arrays numéricos diretamente, atingindo a velocidade máxima de I/O de memória.
+- **String Interning:** Chaves repetidas (como nomes de campos em listas de objetos) são enviadas apenas uma vez.
+- **Bit-Packing:** Inteiros pequenos e booleanos ocupam apenas 4 bits dentro da tag de tipo.
+- **LZ4 Integrado:** Compressão de blocos ultra-veloz para payloads grandes.
+
+## 📊 Benchmark (Latência Média)
+Comparação de serialização de uma lista de 10.000 modelos Pydantic complexos:
+
+| Formato | Tempo (ms) | Tamanho do Payload |
+|---------|------------|-------------------|
+| JSON (Standard) | 45.2ms | 1.2 MB |
+| Orjson | 12.8ms | 1.1 MB |
+| B-FAST | 1.4ms | 240 KB |
+
+## 📦 Instalação
+
+### Backend (Python)
+```bash
+uv add bfast-py
+```
+ou
+```bash
+pip install bfast-py
+```
+
+### Frontend (TypeScript)
+```bash
+npm install bfast-client
+```
+
+## 🛠️ Como usar
+
+### 1. No FastAPI (Integração Direta)
+O B-FAST se integra perfeitamente como uma classe de resposta.
+
+```python
+from fastapi import FastAPI, Response
+from pydantic import BaseModel
+import b_fast
+
+class BFastResponse(Response):
+    media_type = "application/x-bfast"
+    
+    def __init__(self, content=None, *args, **kwargs):
+        super().__init__(content, *args, **kwargs)
+        self.encoder = b_fast.BFast()
+
+    def render(self, content) -> bytes:
+        return self.encoder.encode_packed(content, compress=True)
+
+app = FastAPI()
+
+class User(BaseModel):
+    id: int
+    name: str
+
+@app.get("/users", response_class=BFastResponse)
+async def get_users():
+    return [User(id=i, name=f"User {i}") for i in range(1000)]
+```
+
+### 2. No Frontend (React / Vue / Angular)
+```typescript
+import { BFastDecoder } from 'bfast-client';
+
+async function loadData() {
+    const response = await fetch('/users');
+    const buffer = await response.arrayBuffer();
+    
+    // Decodifica e descomprime LZ4 automaticamente
+    const users = BFastDecoder.decode(buffer);
+    console.log(users);
+}
+```
+
+## About B-FAST
+
+> "Knowledge is the only wealth that grows when we share it"
+
+B-FAST was born from the belief that high-performance tools should be accessible to everyone. This project represents our commitment to open-source innovation and the sharing of knowledge that drives the developer community forward.
+
+**Developed by:** [marcelomarkus](https://github.com/marcelomarkus)
+
+**Philosophy:** We believe that by sharing efficient solutions, we collectively raise the bar for what's possible in software development. B-FAST is our contribution to a faster, more efficient web.
+
+## 📄 Licença
+Distribuído sob a licença MIT. Veja LICENSE para mais informações.

bfast_py-1.0.4.dist-info/RECORD

@@ -0,0 +1,6 @@
+b_fast\__init__.py,sha256=3JTYzuf6_39pzLR3L8me9rsz_bnKsP4nVICPaL_tnko,107
+b_fast\b_fast.pyd,sha256=4SThnmxLVOqjauIfldkcMrZzS9kSFULqcteJoQdfqEo,322048
+bfast_py-1.0.4.dist-info\METADATA,sha256=DFW_A7geDZplrUqwKnhdYjPRmBr9RUTpxQPJMs93SsY,4963
+bfast_py-1.0.4.dist-info\WHEEL,sha256=gPqN4EsdiAyGvmfrYy_ONrF276O8o0hPitI2CKZrEFA,95
+bfast_py-1.0.4.dist-info\licenses\LICENSE,sha256=VNAIoZqWaw--dL2LFGJlzWqh5iHfmGtsJAOJvRLjJR4,1111
+bfast_py-1.0.4.dist-info\RECORD,,

bfast_py-0.1.0.dist-info/METADATA

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: bfast-py
-Version: 0.1.0
-Requires-Dist: pydantic>=2.0
-Requires-Dist: numpy
-Requires-Dist: matplotlib>=3.7.5 ; extra == 'dev'
-Requires-Dist: orjson>=3.10.15 ; extra == 'dev'
-Requires-Dist: mkdocs-material>=9.7.1 ; extra == 'dev'
-Requires-Dist: mkdocstrings[python]>=0.26.1 ; extra == 'dev'
-Requires-Dist: pytest>=7.0 ; extra == 'dev'
-Requires-Dist: black>=23.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
-Requires-Dist: fastapi ; extra == 'fastapi'
-Provides-Extra: dev
-Provides-Extra: fastapi
-License-File: LICENSE
-Requires-Python: >=3.8

bfast_py-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-b_fast\__init__.py,sha256=3JTYzuf6_39pzLR3L8me9rsz_bnKsP4nVICPaL_tnko,107
-b_fast\b_fast.pyd,sha256=b-Ykj1bKKubqBAvkv1T1aVT8U-hTuZMF0qm0MOwswmE,322048
-bfast_py-0.1.0.dist-info\METADATA,sha256=rWriqjqX-BGJaiVZMIm_94gSGagDoJ703MLnG7Ec4Lk,581
-bfast_py-0.1.0.dist-info\WHEEL,sha256=gPqN4EsdiAyGvmfrYy_ONrF276O8o0hPitI2CKZrEFA,95
-bfast_py-0.1.0.dist-info\licenses\LICENSE,sha256=VNAIoZqWaw--dL2LFGJlzWqh5iHfmGtsJAOJvRLjJR4,1111
-bfast_py-0.1.0.dist-info\RECORD,,