codekingpro/portable-devtools

1import re
2from _typeshed import StrOrBytesPath, StrPath
3from collections.abc import Callable, Iterable, Mapping
4from typing import (
5    IO,
6    Any,
7    Concatenate,
8    Final,
9    Literal as L,
10    Never,
11    ParamSpec,
12    TypeAlias,
13    overload,
14)
15
16from .__version__ import version
17from .auxfuncs import isintent_dict as isintent_dict
18
19###
20
21_Tss = ParamSpec("_Tss")
22
23_VisitResult: TypeAlias = list[Any] | dict[str, Any] | None
24_VisitItem: TypeAlias = tuple[str | None, _VisitResult]
25_VisitFunc: TypeAlias = Callable[Concatenate[_VisitItem, list[_VisitItem], _VisitResult, _Tss], _VisitItem | None]
26
27###
28
29COMMON_FREE_EXTENSIONS: Final[list[str]] = ...
30COMMON_FIXED_EXTENSIONS: Final[list[str]] = ...
31
32f2py_version: Final = version
33tabchar: Final[str] = "    "
34
35f77modulename: str
36pyffilename: str
37sourcecodeform: L["fix", "gree"]
38strictf77: L[0, 1]
39quiet: L[0, 1]
40verbose: L[0, 1, 2]
41skipemptyends: L[0, 1]
42ignorecontains: L[1]
43dolowercase: L[1]
44
45beginpattern: str | re.Pattern[str]
46currentfilename: str
47filepositiontext: str
48expectbegin: L[0, 1]
49gotnextfile: L[0, 1]
50neededmodule: int
51skipblocksuntil: int
52groupcounter: int
53groupname: dict[int, str] | str
54groupcache: dict[int, dict[str, Any]] | None
55grouplist: dict[int, list[dict[str, Any]]] | None
56previous_context: tuple[str, str, int] | None
57
58f90modulevars: dict[str, dict[str, Any]] = {}
59debug: list[Never] = []
60include_paths: list[str] = []
61onlyfuncs: list[str] = []
62skipfuncs: list[str] = []
63skipfunctions: Final[list[str]] = []
64usermodules: Final[list[dict[str, Any]]] = []
65
66defaultimplicitrules: Final[dict[str, dict[str, str]]] = {}
67badnames: Final[dict[str, str]] = {}
68invbadnames: Final[dict[str, str]] = {}
69
70beforethisafter: Final[str] = ...
71fortrantypes: Final[str] = ...
72groupbegins77: Final[str] = ...
73groupbegins90: Final[str] = ...
74groupends: Final[str] = ...
75endifs: Final[str] = ...
76moduleprocedures: Final[str] = ...
77
78beginpattern77: Final[tuple[re.Pattern[str], L["begin"]]] = ...
79beginpattern90: Final[tuple[re.Pattern[str], L["begin"]]] = ...
80callpattern: Final[tuple[re.Pattern[str], L["call"]]] = ...
81callfunpattern: Final[tuple[re.Pattern[str], L["callfun"]]] = ...
82commonpattern: Final[tuple[re.Pattern[str], L["common"]]] = ...
83containspattern: Final[tuple[re.Pattern[str], L["contains"]]] = ...
84datapattern: Final[tuple[re.Pattern[str], L["data"]]] = ...
85dimensionpattern: Final[tuple[re.Pattern[str], L["dimension"]]] = ...
86endifpattern: Final[tuple[re.Pattern[str], L["endif"]]] = ...
87endpattern: Final[tuple[re.Pattern[str], L["end"]]] = ...
88entrypattern: Final[tuple[re.Pattern[str], L["entry"]]] = ...
89externalpattern: Final[tuple[re.Pattern[str], L["external"]]] = ...
90f2pyenhancementspattern: Final[tuple[re.Pattern[str], L["f2pyenhancements"]]] = ...
91formatpattern: Final[tuple[re.Pattern[str], L["format"]]] = ...
92functionpattern: Final[tuple[re.Pattern[str], L["begin"]]] = ...
93implicitpattern: Final[tuple[re.Pattern[str], L["implicit"]]] = ...
94intentpattern: Final[tuple[re.Pattern[str], L["intent"]]] = ...
95intrinsicpattern: Final[tuple[re.Pattern[str], L["intrinsic"]]] = ...
96optionalpattern: Final[tuple[re.Pattern[str], L["optional"]]] = ...
97moduleprocedurepattern: Final[tuple[re.Pattern[str], L["moduleprocedure"]]] = ...
98multilinepattern: Final[tuple[re.Pattern[str], L["multiline"]]] = ...
99parameterpattern: Final[tuple[re.Pattern[str], L["parameter"]]] = ...
100privatepattern: Final[tuple[re.Pattern[str], L["private"]]] = ...
101publicpattern: Final[tuple[re.Pattern[str], L["public"]]] = ...
102requiredpattern: Final[tuple[re.Pattern[str], L["required"]]] = ...
103subroutinepattern: Final[tuple[re.Pattern[str], L["begin"]]] = ...
104typespattern: Final[tuple[re.Pattern[str], L["type"]]] = ...
105usepattern: Final[tuple[re.Pattern[str], L["use"]]] = ...
106
107analyzeargs_re_1: Final[re.Pattern[str]] = ...
108callnameargspattern: Final[re.Pattern[str]] = ...
109charselector: Final[re.Pattern[str]] = ...
110crackline_bind_1: Final[re.Pattern[str]] = ...
111crackline_bindlang: Final[re.Pattern[str]] = ...
112crackline_re_1: Final[re.Pattern[str]] = ...
113determineexprtype_re_1: Final[re.Pattern[str]] = ...
114determineexprtype_re_2: Final[re.Pattern[str]] = ...
115determineexprtype_re_3: Final[re.Pattern[str]] = ...
116determineexprtype_re_4: Final[re.Pattern[str]] = ...
117determineexprtype_re_5: Final[re.Pattern[str]] = ...
118getlincoef_re_1: Final[re.Pattern[str]] = ...
119kindselector: Final[re.Pattern[str]] = ...
120lenarraypattern: Final[re.Pattern[str]] = ...
121lenkindpattern: Final[re.Pattern[str]] = ...
122namepattern: Final[re.Pattern[str]] = ...
123nameargspattern: Final[re.Pattern[str]] = ...
124operatorpattern: Final[re.Pattern[str]] = ...
125real16pattern: Final[re.Pattern[str]] = ...
126real8pattern: Final[re.Pattern[str]] = ...
127selectpattern: Final[re.Pattern[str]] = ...
128typedefpattern: Final[re.Pattern[str]] = ...
129typespattern4implicit: Final[re.Pattern[str]] = ...
130word_pattern: Final[re.Pattern[str]] = ...
131
132post_processing_hooks: Final[list[_VisitFunc[...]]] = []
133
134#
135def outmess(line: str, flag: int = 1) -> None: ...
136def reset_global_f2py_vars() -> None: ...
137
138#
139def rmbadname1(name: str) -> str: ...
140def undo_rmbadname1(name: str) -> str: ...
141def rmbadname(names: Iterable[str]) -> list[str]: ...
142def undo_rmbadname(names: Iterable[str]) -> list[str]: ...
143
144#
145def openhook(filename: StrPath, mode: str) -> IO[Any]: ...
146def is_free_format(fname: StrPath) -> bool: ...
147def readfortrancode(
148    ffile: StrOrBytesPath | Iterable[StrOrBytesPath],
149    dowithline: Callable[[str, int], object] = ...,
150    istop: int = 1,
151) -> None: ...
152
153#
154def split_by_unquoted(line: str, characters: str) -> tuple[str, str]: ...
155
156#
157def crackline(line: str, reset: int = 0) -> None: ...
158def markouterparen(line: str) -> str: ...
159def markoutercomma(line: str, comma: str = ",") -> str: ...
160def unmarkouterparen(line: str) -> str: ...
161def appenddecl(decl: Mapping[str, object] | None, decl2: Mapping[str, object] | None, force: int = 1) -> dict[str, Any]: ...
162
163#
164def parse_name_for_bind(line: str) -> tuple[str, str | None]: ...
165def analyzeline(m: re.Match[str], case: str, line: str) -> None: ...
166def appendmultiline(group: dict[str, Any], context_name: str, ml: str) -> None: ...
167def cracktypespec0(typespec: str, ll: str | None) -> tuple[str, str | None, str | None, str | None]: ...
168
169#
170def removespaces(expr: str) -> str: ...
171def markinnerspaces(line: str) -> str: ...
172def updatevars(typespec: str, selector: str | None, attrspec: str, entitydecl: str) -> str: ...
173def cracktypespec(typespec: str, selector: str | None) -> tuple[dict[str, str] | None, dict[str, str] | None, str | None]: ...
174
175#
176def setattrspec(decl: dict[str, list[str]], attr: str | None, force: int = 0) -> dict[str, list[str]]: ...
177def setkindselector(decl: dict[str, dict[str, str]], sel: dict[str, str], force: int = 0) -> dict[str, dict[str, str]]: ...
178def setcharselector(decl: dict[str, dict[str, str]], sel: dict[str, str], force: int = 0) -> dict[str, dict[str, str]]: ...
179def getblockname(block: Mapping[str, object], unknown: str = "unknown") -> str: ...
180def setmesstext(block: Mapping[str, object]) -> None: ...
181def get_usedict(block: Mapping[str, object]) -> dict[str, str]: ...
182def get_useparameters(block: Mapping[str, object], param_map: Mapping[str, str] | None = None) -> dict[str, str]: ...
183
184#
185@overload
186def postcrack2(
187    block: dict[str, Any],
188    tab: str = "",
189    param_map: Mapping[str, str] | None = None,
190) -> dict[str, str | Any]: ...
191@overload
192def postcrack2(
193    block: list[dict[str, Any]],
194    tab: str = "",
195    param_map: Mapping[str, str] | None = None,
196) -> list[dict[str, str | Any]]: ...
197
198#
199@overload
200def postcrack(block: dict[str, Any], args: Mapping[str, str] | None = None, tab: str = "") -> dict[str, Any]: ...
201@overload
202def postcrack(block: list[dict[str, str]], args: Mapping[str, str] | None = None, tab: str = "") -> list[dict[str, Any]]: ...
203
204#
205def sortvarnames(vars: Mapping[str, object]) -> list[str]: ...
206def analyzecommon(block: Mapping[str, object]) -> dict[str, Any]: ...
207def analyzebody(block: Mapping[str, object], args: Mapping[str, str], tab: str = "") -> list[dict[str, Any]]: ...
208def buildimplicitrules(block: Mapping[str, object]) -> tuple[dict[str, dict[str, str]], dict[str, str]]: ...
209def myeval(e: str, g: object | None = None, l: object | None = None) -> float: ...
210
211#
212def getlincoef(e: str, xset: set[str]) -> tuple[float | None, float | None, str | None]: ...
213
214#
215def get_sorted_names(vars: Mapping[str, Mapping[str, str]]) -> list[str]: ...
216def get_parameters(vars: Mapping[str, Mapping[str, str]], global_params: dict[str, str] = {}) -> dict[str, str]: ...
217
218#
219def analyzevars(block: Mapping[str, Any]) -> dict[str, dict[str, str]]: ...
220
221#
222def param_eval(v: str, g_params: dict[str, Any], params: Mapping[str, object], dimspec: str | None = None) -> dict[str, Any]: ...
223def param_parse(d: str, params: Mapping[str, str]) -> str: ...
224def expr2name(a: str, block: Mapping[str, object], args: list[str] = []) -> str: ...
225def analyzeargs(block: Mapping[str, object]) -> dict[str, Any]: ...
226
227#
228def determineexprtype(expr: str, vars: Mapping[str, object], rules: dict[str, Any] = {}) -> dict[str, Any]: ...
229def crack2fortrangen(block: Mapping[str, object], tab: str = "\n", as_interface: bool = False) -> str: ...
230def common2fortran(common: Mapping[str, object], tab: str = "") -> str: ...
231def use2fortran(use: Mapping[str, object], tab: str = "") -> str: ...
232def true_intent_list(var: dict[str, list[str]]) -> list[str]: ...
233def vars2fortran(
234    block: Mapping[str, Mapping[str, object]],
235    vars: Mapping[str, object],
236    args: Mapping[str, str],
237    tab: str = "",
238    as_interface: bool = False,
239) -> str: ...
240
241#
242def crackfortran(files: StrOrBytesPath | Iterable[StrOrBytesPath]) -> list[dict[str, Any]]: ...
243def crack2fortran(block: Mapping[str, Any]) -> str: ...
244
245#
246def traverse(
247    obj: tuple[str | None, _VisitResult],
248    visit: _VisitFunc[_Tss],
249    parents: list[tuple[str | None, _VisitResult]] = [],
250    result: list[Any] | dict[str, Any] | None = None,
251    *args: _Tss.args,
252    **kwargs: _Tss.kwargs,
253) -> _VisitItem | _VisitResult: ...
254
255#
256def character_backward_compatibility_hook(
257    item: _VisitItem,
258    parents: list[_VisitItem],
259    result: object,  # ignored
260    *args: object,  # ignored
261    **kwargs: object,  # ignored
262) -> _VisitItem | None: ...
263
264# namespace pollution
265c: str
266n: str
267