Docs: handle_uploaded_file(f) .. what is "f"?

[Thomas Güttler]

​https://docs.djangoproject.com/en/1.11/topics/http/file-uploads/

def handle_uploaded_file(f):
    with open('some/file/name.txt', 'wb+') as destination:
        for chunk in f.chunks():
            destination.write(chunk)

I talked with an other developer about this above code.

I can create a pull request.

It would be nice if you give me a matching name for this variable.

I started to stutter.

Why?

Because: What is "f"?

A more verbose name would be great.

[Tim Graham]

Look at the usage code above: handle_uploaded_file(request.FILES['file']). If you click on the docs for request.FILES, you'll see, "Each value in FILES is an UploadedFile." I'm not sure a more verbose name provides much benefit. If you read ​the Python docs for files, you'll see that f is a common variable name, probably to avoid clashing with the Python built-in file. Also, the name handle_uploaded_file implies that the argument (the thing being handled) is an uploaded file.