srcwalk 0.2.5

Tree-sitter indexed lookups — smart code reading for AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

from tasks.base import Task, GroundTruth


class FastAPIDependencyResolutionTask(Task):
    @property
    def name(self) -> str:
        return "fastapi_dependency_resolution"

    @property
    def repo(self) -> str:
        return "fastapi"

    @property
    def prompt(self) -> str:
        return (
            "Trace how FastAPI resolves dependencies at request time. Starting from when "
            "a request hits an endpoint with Depends(), show the code path through "
            "dependency resolution. What function analyzes the callable's parameters, and "
            "what function actually executes the dependency chain?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=["get_dependant", "solve_dependencies", "Dependant", "analyze_param"],
        )

    @property
    def task_type(self) -> str:
        return "navigate"


class FastAPIRequestValidationTask(Task):
    @property
    def name(self) -> str:
        return "fastapi_request_validation"

    @property
    def repo(self) -> str:
        return "fastapi"

    @property
    def prompt(self) -> str:
        return (
            "In FastAPI's routing.py, find the get_request_handler function. Show how it "
            "creates the actual request handler that processes incoming requests. Specifically, "
            "what happens when request validation fails? What exception is raised and where?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=[
                "get_request_handler",
                "solve_dependencies",
                "RequestValidationError",
                "async def app",
            ],
        )


class FastAPIDependsInternalsTask(Task):
    @property
    def name(self) -> str:
        return "fastapi_depends_internals"

    @property
    def repo(self) -> str:
        return "fastapi"

    @property
    def prompt(self) -> str:
        return (
            "In fastapi/param_functions.py, find the Depends function. Show its complete "
            "signature including all parameters. Then explain: is Depends a class or a function? "
            "What does it actually return, and where is the underlying implementation?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=["def Depends", "use_cache", "params.Depends"],
        )


class FastAPIDependsFunctionTask(Task):
    @property
    def name(self) -> str:
        return "fastapi_depends_function"

    @property
    def repo(self) -> str:
        return "fastapi"

    @property
    def prompt(self) -> str:
        return (
            "Find the Depends function in FastAPI. Show its complete signature "
            "and docstring."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=["def Depends", "use_cache"],
        )


class FastAPIDependsProcessingTask(Task):
    @property
    def name(self) -> str:
        return "fastapi_depends_processing"

    @property
    def repo(self) -> str:
        return "fastapi"

    @property
    def prompt(self) -> str:
        return (
            "Find the Depends function in fastapi/param_functions.py and show "
            "its implementation. Then find how FastAPI processes dependencies "
            "— look for the function that walks the dependency tree and resolves "
            "each Depends() call at request time."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=[
                "def Depends", "solve_dependencies",
                "Dependant", "get_dependant",
            ],
        )

    @property
    def task_type(self) -> str:
        return "navigate"