Add references to pylsp client

[kvptkr]

• Pylsp supports the references method. This change adds support for the references method to this client
• Per the contribution guidelines, I've validated that this change is passing the test build step - https://github.com/kvptkr/pylspclient/actions/runs/8093185516
• I've also tested this out locally and things look good

[yeger00]

Hi,
Thank you for your contribution.
As you can see we are in a transition to pydantic models, and these structs already exists there.
Please change the implementation to pydantic, you can see an example here: https://github.com/yeger00/pylspclient/pull/42/files
Also, please add a test.

Thanks,
Avi

[kvptkr]

Sounds good Avi! Before I make the change, is there a type pre-defined pydantic struct for context? If not, I'm happy to implement it myself, but is there a place from which you're getting the schema for all of these structs from?

[yeger00]

The context is not implemented yet. It should be something like that (not tested):

from pydantic import BaseModel
from typing import Optional

class TextDocumentIdentifier(BaseModel):
    """
    Identifies a text document using its URI.
    """
    uri: str

class Position(BaseModel):
    """
    Represents a position in a text document.
    """
    line: int
    character: int

class TextDocumentPositionParams(BaseModel):
    """
    A base class including the text document identifier and a position within that document.
    """
    textDocument: TextDocumentIdentifier
    position: Position

class ReferenceContext(BaseModel):
    """
    Additional information about the context of a reference request.
    """
    includeDeclaration: bool  # Whether to include the declaration of the symbol being referenced

class ReferenceParams(TextDocumentPositionParams):
    """
    Parameters for a Reference Request in the Language Server Protocol.
    """
    context: ReferenceContext
    workDoneToken: Optional[str] = None  # Optional; used for progress reporting
    partialResultToken: Optional[str] = None  # Optional; used for partial results

# Example Usage
reference_params = ReferenceParams(
    textDocument=TextDocumentIdentifier(uri="file:///path/to/file.py"),
    position=Position(line=20, character=5),
    context=ReferenceContext(includeDeclaration=True)
)
print(reference_params)

It can be without the reference_params sruct and pass the params directly to the function.

[yeger00]

I added an example of more classes here: #47