How Do I run Test against a running Server?

[Risiamu]

Lets say for example, I have this test function in my pytest file, and when I run it, it is being on hold for a long time (no output no exeception):

def test_upload_successful():
    """Test successful file upload scenario."""
    with create_test_client(route_handlers=[upload_file]) as client:
        test_content = b"test file content"
        # Use proper file upload format for test client
        response = client.post(
            "/upload",
            files={"data": ("test.txt", test_content, "text/plain")},
            timeout=30
        )

        assert response.status_code == HTTP_201_CREATED
        assert "file_path" in response.json()
        assert Path("uploads/test.txt").exists()

I want to see what is happening when the router is working on this test

@post("/upload")
async def upload_file(
        data: UploadFile = Body(media_type=RequestEncodingType.MULTI_PART, default=None)
) -> dict[str, str]:

Preferably with breakpoints, how can I achieve this?
I already know how to run a debug server that support breakpoints in PyCharm, but I did not figure out how to run a certain test on this running server.

(Note: I already solved the on-hold problem, I just want to know how to run test on a certain running server)

[provinzkraut]

Why do you want to test against a "running server"? Is there something the Litestar test client doesn't cover?

From your description, it seems like you want to debug an endpoint. You should be able to simply add a breakpoint in it.

[provinzkraut]

We also have an article in the docs on how to debug using e.g. uvicorn: https://docs.litestar.dev/latest/usage/debugging.html

[Risiamu]

Why do you want to test against a "running server"? Is there something the Litestar test client doesn't cover?

From your description, it seems like you want to debug an endpoint. You should be able to simply add a breakpoint in it.

I want to check what happens inside my app.py when I use some post method.
I encountered an issue before where I send an invalid post with UploadFile:

    test_content = b"test file content"
    test_file = UploadFile(
        file_data=test_content,
        filename="test.txt",
        content_type="text/plain"
    )

    response = await test_client.post(
        "/upload",
        files={"data": test_file},
        timeout=30
    )

It sort of froze the server, and I can not see any logging from the app.py.
I spend some time figuring out this is the wrong way to create fake test files.
If I can use breakpoint with this test, then it would be easier for debugging?
Or what is the best practice in this kind of situation?
(PS: I come from an academic background, and have 0 web development experience before using Litestar XD)

[Risiamu]

Later I discovered that with the above test example, breakpoints in the app file works as usual. I just assumed it won't work without test it. Turns out to be just fine.