FletX HTTP Client Bug Report when using FletXService

[semajbaker]

Describe the bug
The FletX HTTP Client module contains several critical bugs that prevent proper HTTP request execution, particularly affecting authentication services and API communication. The issues spanned parameter naming conflicts, exception handling incompatibilities, and method signature problems.

To Reproduce
Create a simple FletXService class that is going to make requests. for example:

class SignInService(FletXService):

def __init__(self):
    # Get the backend URL from environment variable
    backend_url = os.getenv("BACKEND_URL", "http://localhost:3000")
    super().__init__(http_client=HTTPClient(base_url=backend_url))

async def post(self, email: str, password: str):
    """
    Sign in user with email and password
    
    Args:
        email: User's email address
        password: User's password
        
    Returns:
        Response from the backend API
    """
    try:
        payload = {
            "email": email,
            "password": password
        }
        response = await self.http_client.post(               
                endpoint="/api/auth/login",
                json_data=payload          
            )


        return response
    except Exception as e:
        print(f"SignIn Error: {e}")
        raise

Expected behavior
This is suppose to make a simple request to our API, however i kept encountering this error:

flet_app | /usr/local/lib/python3.12/site-packages/aiohttp/connector.py:963: DeprecationWarning: enable_cleanup_closed ignored because python/cpython#118960 is fixed in Python version sys.version_info(major=3, minor=12, micro=12, releaselevel='final', serial=0)
flet_app | super().init(
flet_app | SignIn Error: ClientSession.request() missing 1 required positional argument: 'method'
flet_app | 2025-11-27 06:50:49,804 - FletX.Reactive - DEBUG - Value changed: → An error occurred: ClientSession.request() missing 1 required positional argument: 'method'

the http client was calling the post method but it kept on throwing this problem.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
I have managed to fix the fix issue. There was a typo in fletx.core.http in the async with self._session.request.
"metho = method" it is suppose to be "method = method". Moreover in wait self._apply_middlewares_before, there is "json = json_data" it is suppose to be "json_data = json_data. Then finally in fletx.utils.exceptions, i have modified the exceptions to accept custom parameters than just the message. this is how i modified them: ####

NETWORK ERROR CLASS

class NetworkError(FletXError):
"""
Exception raised when there's a network error with http operations.
"""
def init(self, message=None, original_exception=None):
self.message = message
self.original_exception = original_exception
super().init(self.message or "Network error occurred")

RATE LIMIT ERROR CLASS

class RateLimitError(FletXError):
"""
Exception raised when there's a rate limit error with http operations.
"""
def init(self, message=None, status_code=None, raw_response=None, headers=None):
self.message = message
self.status_code = status_code
self.raw_response = raw_response
self.headers = headers
super().init(self.message or "Rate limit exceeded")

API ERROR CLASS

class APIError(FletXError):
"""
Exception raised when there's an API error with http operations.
"""
def init(self, message=None, status_code=None, response_data=None):
self.message = message
self.status_code = status_code
self.response_data = response_data
super().init(self.message or "API error occurred")

i have already forked this repository. With your permission, i would like to contribute my solution. Thank you

[Einswilli]

Hello @semajbaker what is your FletX version please?

[semajbaker]

i am using FletXr ==0.1.3 and Flet==0.28.3

[Einswilli]

This is an old version of FletX @semajbaker . Those issues are already fixed, try the latest pre-release version 0.1.4b230.

pip install FletXr --pre

[semajbaker]

that makes sense. thanks. let me uninstall and reinstall.

[semajbaker]

ok when running FletXr --pre, i am getting this error:flet_app | Traceback (most recent call last):
flet_app | File "/usr/local/bin/fletx", line 3, in
flet_app | from fletx.main import main
flet_app | ModuleNotFoundError: No module named 'fletx.main'this is how i am running my main.py: """
Main application file with responsive system integration.

File: main.py
"""
import warnings
import flet as ft
from fletx.app import FletXApp
from fletx.core import RxInt, RxStr
from pages.auth.signin_screen import SignInScreen
from pages.auth.signup_screen import SignUpScreen
from pages.auth.forgot_password_screen import ForgotPasswordScreen
from utils.responsive_manager import MediaQuery
from fletx.navigation import router_config

def main(page: ft.Page):
mobile_text = RxStr('mobile')
mobile_min_width = RxStr(0)
mobile_max_width = RxInt(768)
tablet_text = RxStr('tablet')
tablet_min_width = RxStr(768)
tablet_max_width = RxStr(1024)
desktop_text = RxStr('desktop')
desktop_min_width = RxStr(1024)
desktop_max_width = RxStr(1924)
# Add your route
routes = [
{
"path": "/signin",
"component": SignInScreen,

    },
    {
        "path": "/signup",
        "component": SignUpScreen,

    },
    {
        "path": "/forgot-password",
        "component": ForgotPasswordScreen,

    }
]
router_config.add_routes(routes)

# Initialize MediaQuery first
MediaQuery.initialize_with_page(page)

# Register all breakpoints
MediaQuery.register(mobile_text.value, mobile_min_width.value, mobile_max_width.value)     
MediaQuery.register(tablet_text.value, tablet_min_width.value, tablet_max_width.value)     
MediaQuery.register(desktop_text.value, desktop_min_width.value, desktop_max_width.value)     

# Complete registration - this will trigger the initial breakpoint check
MediaQuery.complete_registration()

# Create the FletXr app
app = FletXApp(
    title="FletXr Responsive UI",
    initial_route="/signin",
    debug=True,
).with_theme(
    ft.Theme(color_scheme_seed=ft.Colors.BLUE)
)

# Run the app
app._main(page)

if name == "main":
warnings.filterwarnings("ignore", message=".websockets.", category=DeprecationWarning)
warnings.filterwarnings("ignore", message=".ws_handler.", category=DeprecationWarning)
ft.app(target=main)

[semajbaker]

If you do have the time, can you please look at my FletXr-responsive example repo. Thats the example project i am working on. https://github.com/semajbaker/FletXr-Responsive. The FletXService class is in /services/auth_service.py. Thank you so much once again.

[Einswilli]

ok when running FletXr --pre, i am getting this error:flet_app | Traceback (most recent call last):
flet_app | File "/usr/local/bin/fletx", line 3, in
flet_app | from fletx.main import main
flet_app | ModuleNotFoundError: No module named 'fletx.main'this is how i am running my main.py: """
Main application file with responsive system integration.

File: main.py
"""
import warnings
import flet as ft
from fletx.app import FletXApp
from fletx.core import RxInt, RxStr
from pages.auth.signin_screen import SignInScreen
from pages.auth.signup_screen import SignUpScreen
from pages.auth.forgot_password_screen import ForgotPasswordScreen
from utils.responsive_manager import MediaQuery
from fletx.navigation import router_config

def main(page: ft.Page):
mobile_text = RxStr('mobile')
mobile_min_width = RxStr(0)
mobile_max_width = RxInt(768)
tablet_text = RxStr('tablet')
tablet_min_width = RxStr(768)
tablet_max_width = RxStr(1024)
desktop_text = RxStr('desktop')
desktop_min_width = RxStr(1024)
desktop_max_width = RxStr(1924)
# Add your route
routes = [
{
"path": "/signin",
"component": SignInScreen,

    },
    {
        "path": "/signup",
        "component": SignUpScreen,

    },
    {
        "path": "/forgot-password",
        "component": ForgotPasswordScreen,

    }
]
router_config.add_routes(routes)

# Initialize MediaQuery first
MediaQuery.initialize_with_page(page)

# Register all breakpoints
MediaQuery.register(mobile_text.value, mobile_min_width.value, mobile_max_width.value)     
MediaQuery.register(tablet_text.value, tablet_min_width.value, tablet_max_width.value)     
MediaQuery.register(desktop_text.value, desktop_min_width.value, desktop_max_width.value)     

# Complete registration - this will trigger the initial breakpoint check
MediaQuery.complete_registration()

# Create the FletXr app
app = FletXApp(
    title="FletXr Responsive UI",
    initial_route="/signin",
    debug=True,
).with_theme(
    ft.Theme(color_scheme_seed=ft.Colors.BLUE)
)

# Run the app
app._main(page)

if name == "main":
warnings.filterwarnings("ignore", message=".websockets.", category=DeprecationWarning)
warnings.filterwarnings("ignore", message=".ws_handler.", category=DeprecationWarning)
ft.app(target=main)

FletXApp.main() method was removed since 0.1.4* versions, use app.run() or app.run_async() instead.

We recommend creating FletX projects using FletXCLI:
fletx new my-project

See README or the documentation for more.

[Einswilli]

Here is a complete example project with FletX.

[semajbaker]

bro!! thanks a lot man! However the FletXService issue still persists. perhaps it's my pc that has the problem because i ran pip install flet[all] and pip install fletxr>=0.1.4.a2 and created the new fletxr project using the cli: "flex new project_name", just like the fakeshop example you provided, But the fletx.core.http is still broken:

async with self._session.request(
metho = method,
url = url,
headers = merged_headers,
params = params,
data = data,
json = json_data,
proxy = self.proxy,
allow_redirects = self.follow_redirects,
max_redirects = self.max_redirects,
**kwargs
) as response:
elapsed = monotonic() - start_time

as you can see: "metho = method", there is a typo here. Moreover, this part:

    request_kwargs = await self._apply_middlewares_before(
        method, url, headers=merged_headers, params=params, 
        data=data, json=json_data, files=files, **kwargs
    )

"json=json_data" should it really be json=json_data or it should be "json_data = json_data"? anyway here is my pip list:

flet ==0.28.3
flet-cli==0.28.3
flet-desktop==0.28.3
flet-web==0.28.3
FletXr==0.1.4a2

The main error i am getting is this when making the http request to my node express server: SignIn Error: ClientSession.request() missing 1 required positional argument: 'method'
2025-11-28 13:25:06,590 - FletX.Reactive - DEBUG - Value changed: → An error occurred: ClientSession.request() missing 1 required positional argument: 'method

I have tested it both using Docker an my windows host machine. Never the less thanks a lot for your patience man! May The Lord Jesus Christ of Nazareth bless you and your team for creating such an amazing library. Ill figure out a way to make it don't worry. I wont contribute my solutions as they may mess up the library. Thanks a lot!

[Einswilli]

Hi @semajbaker , thanks for pointing that out.
Please try installing Fletx from git to have the latest version.

pip install git+https://github.com/AllDotPy/FletX.git@master#egg=FletXr

[semajbaker]

Awesome man!! awesome work. Finally it works perfectly now. Thanks a lot man. really appreciate it!

[Wgoeh]

Hi @semajbaker, thanks for giving FletX a try and pointing that out.
A new release candidate will be published very soon.

Your contributions are more than welcome.
Thanks.

[semajbaker]

Hi @semajbaker, thanks for giving FletX a try and pointing that out. A new release candidate will be published very soon.

Your contributions are more than welcome. Thanks.

That means a lot. or one more thing. I tried to build a python image with this FletXr version: git+https://github.com/AllDotPy/FletX.git@master#egg=FletXr

I got this error: 21.93 ERROR: Package 'fletxr' requires a different Python: 3.12.12 not in '==3.12' i guess it has to do with the pyproject.toml, probably there is the requires-python = "==3.12" argument which is very specific and I'm using 3.12.12.

on my windows host machine, it works just fine, only when building the docker image.

here is my Dockerfile:

FROM python:3.12

ENV DEBIAN_FRONTEND=noninteractive

Create a new user 'james' with password 'semaj'

RUN useradd -m -d /home/james -s /bin/bash james && echo "james:semaj" | chpasswd

Add user 'james' to the sudoers group

RUN usermod -aG sudo james
RUN echo "james ALL=(ALL) NOPASSWD:ALL"

Set working directory

WORKDIR /home/james

Install necessary packages

RUN apt-get update --fix-missing && apt-get install -y
sudo iputils-ping cmake build-essential nodejs npm

Install Qt dependencies

RUN apt-get install -y '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev libxcb-util1 \
libdbus-1-3 libinput-dev libxcb-xinerama0 libxcb-xinput0\
libxcb-image0 libxcb-keysyms1 libxcb-icccm4 libxcb-cursor0 libxcb-render-util0 \
libxext6 libxrandr2 libqt5widgets5 libqt5gui5 libqt5core5a

Install Flutter dependencies

RUN apt-get install -y libmpv-dev libmpv2
RUN apt-get install -y gstreamer1.0-plugins-base
RUN ln -s /usr/lib/x86_64-linux-gnu/libmpv.so /usr/lib/libmpv.so.1

RUN apt-get install -y dos2unix

Install curl, git, etc

RUN apt-get install -y curl git unzip xz-utils zip libglu1-mesa

Copy requirements.txt to the working directory

COPY requirements.txt /home/james/

Install Python dependencies

RUN pip install --upgrade pip
RUN pip install -r requirements.txt
RUN pip install git+https://github.com/AllDotPy/FletX.git@master#egg=FletXr

Add local bin to PATH for user 'james'

ENV PATH="/home/james/.local/bin:$PATH"

Set permissions for the working directory

RUN chown -R james:james /home/james