frida 16.2.1 → 16.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (386) hide show
  1. package/BSDmakefile +6 -0
  2. package/Makefile +16 -0
  3. package/README.md +14 -11
  4. package/configure +18 -0
  5. package/configure.bat +22 -0
  6. package/dist/native.js +0 -8
  7. package/lib/application.ts +98 -0
  8. package/lib/authentication.ts +3 -0
  9. package/lib/build.py +50 -0
  10. package/lib/bus.ts +30 -0
  11. package/lib/cancellable.ts +33 -0
  12. package/lib/child.ts +15 -0
  13. package/lib/crash.ts +11 -0
  14. package/lib/device.ts +329 -0
  15. package/lib/device_manager.ts +69 -0
  16. package/lib/endpoint_parameters.ts +56 -0
  17. package/lib/icon.ts +15 -0
  18. package/lib/index.ts +311 -0
  19. package/lib/iostream.ts +78 -0
  20. package/lib/meson.build +53 -0
  21. package/lib/native.ts +9 -0
  22. package/lib/portal_membership.ts +10 -0
  23. package/lib/portal_service.ts +105 -0
  24. package/lib/process.ts +57 -0
  25. package/lib/relay.ts +44 -0
  26. package/lib/script.ts +352 -0
  27. package/lib/session.ts +113 -0
  28. package/lib/signals.ts +45 -0
  29. package/lib/socket_address.ts +35 -0
  30. package/lib/spawn.ts +4 -0
  31. package/lib/system_parameters.ts +78 -0
  32. package/make.bat +23 -0
  33. package/meson.build +160 -0
  34. package/meson.options +11 -0
  35. package/package.json +27 -6
  36. package/releng/deps.py +1133 -0
  37. package/releng/deps.toml +391 -0
  38. package/releng/devkit-assets/frida-core-example-unix.c +188 -0
  39. package/releng/devkit-assets/frida-core-example-windows.c +197 -0
  40. package/releng/devkit-assets/frida-core-example.sln +28 -0
  41. package/releng/devkit-assets/frida-core-example.vcxproj +157 -0
  42. package/releng/devkit-assets/frida-core-example.vcxproj.filters +27 -0
  43. package/releng/devkit-assets/frida-gum-example-unix.c +122 -0
  44. package/releng/devkit-assets/frida-gum-example-windows.c +132 -0
  45. package/releng/devkit-assets/frida-gum-example.sln +28 -0
  46. package/releng/devkit-assets/frida-gum-example.vcxproj +157 -0
  47. package/releng/devkit-assets/frida-gum-example.vcxproj.filters +27 -0
  48. package/releng/devkit-assets/frida-gumjs-example-unix.c +84 -0
  49. package/releng/devkit-assets/frida-gumjs-example-windows.c +91 -0
  50. package/releng/devkit-assets/frida-gumjs-example.sln +28 -0
  51. package/releng/devkit-assets/frida-gumjs-example.vcxproj +157 -0
  52. package/releng/devkit-assets/frida-gumjs-example.vcxproj.filters +27 -0
  53. package/releng/devkit.py +535 -0
  54. package/releng/env.py +420 -0
  55. package/releng/env_android.py +150 -0
  56. package/releng/env_apple.py +176 -0
  57. package/releng/env_generic.py +373 -0
  58. package/releng/frida_version.py +69 -0
  59. package/releng/machine_file.py +44 -0
  60. package/releng/machine_spec.py +290 -0
  61. package/releng/meson/meson.py +27 -0
  62. package/releng/meson/mesonbuild/__init__.py +0 -0
  63. package/releng/meson/mesonbuild/_pathlib.py +63 -0
  64. package/releng/meson/mesonbuild/_typing.py +69 -0
  65. package/releng/meson/mesonbuild/arglist.py +321 -0
  66. package/releng/meson/mesonbuild/ast/__init__.py +23 -0
  67. package/releng/meson/mesonbuild/ast/interpreter.py +441 -0
  68. package/releng/meson/mesonbuild/ast/introspection.py +374 -0
  69. package/releng/meson/mesonbuild/ast/postprocess.py +109 -0
  70. package/releng/meson/mesonbuild/ast/printer.py +620 -0
  71. package/releng/meson/mesonbuild/ast/visitor.py +161 -0
  72. package/releng/meson/mesonbuild/backend/__init__.py +0 -0
  73. package/releng/meson/mesonbuild/backend/backends.py +2047 -0
  74. package/releng/meson/mesonbuild/backend/ninjabackend.py +3808 -0
  75. package/releng/meson/mesonbuild/backend/nonebackend.py +26 -0
  76. package/releng/meson/mesonbuild/backend/vs2010backend.py +2078 -0
  77. package/releng/meson/mesonbuild/backend/vs2012backend.py +35 -0
  78. package/releng/meson/mesonbuild/backend/vs2013backend.py +34 -0
  79. package/releng/meson/mesonbuild/backend/vs2015backend.py +35 -0
  80. package/releng/meson/mesonbuild/backend/vs2017backend.py +59 -0
  81. package/releng/meson/mesonbuild/backend/vs2019backend.py +54 -0
  82. package/releng/meson/mesonbuild/backend/vs2022backend.py +54 -0
  83. package/releng/meson/mesonbuild/backend/xcodebackend.py +1781 -0
  84. package/releng/meson/mesonbuild/build.py +3249 -0
  85. package/releng/meson/mesonbuild/cargo/__init__.py +5 -0
  86. package/releng/meson/mesonbuild/cargo/builder.py +238 -0
  87. package/releng/meson/mesonbuild/cargo/cfg.py +274 -0
  88. package/releng/meson/mesonbuild/cargo/interpreter.py +733 -0
  89. package/releng/meson/mesonbuild/cargo/manifest.py +227 -0
  90. package/releng/meson/mesonbuild/cargo/version.py +95 -0
  91. package/releng/meson/mesonbuild/cmake/__init__.py +28 -0
  92. package/releng/meson/mesonbuild/cmake/common.py +331 -0
  93. package/releng/meson/mesonbuild/cmake/data/__init__.py +0 -0
  94. package/releng/meson/mesonbuild/cmake/data/preload.cmake +82 -0
  95. package/releng/meson/mesonbuild/cmake/executor.py +241 -0
  96. package/releng/meson/mesonbuild/cmake/fileapi.py +324 -0
  97. package/releng/meson/mesonbuild/cmake/generator.py +186 -0
  98. package/releng/meson/mesonbuild/cmake/interpreter.py +1267 -0
  99. package/releng/meson/mesonbuild/cmake/toolchain.py +248 -0
  100. package/releng/meson/mesonbuild/cmake/traceparser.py +814 -0
  101. package/releng/meson/mesonbuild/cmake/tracetargets.py +161 -0
  102. package/releng/meson/mesonbuild/compilers/__init__.py +86 -0
  103. package/releng/meson/mesonbuild/compilers/asm.py +307 -0
  104. package/releng/meson/mesonbuild/compilers/c.py +788 -0
  105. package/releng/meson/mesonbuild/compilers/c_function_attributes.py +143 -0
  106. package/releng/meson/mesonbuild/compilers/compilers.py +1388 -0
  107. package/releng/meson/mesonbuild/compilers/cpp.py +1035 -0
  108. package/releng/meson/mesonbuild/compilers/cs.py +136 -0
  109. package/releng/meson/mesonbuild/compilers/cuda.py +806 -0
  110. package/releng/meson/mesonbuild/compilers/cython.py +91 -0
  111. package/releng/meson/mesonbuild/compilers/d.py +861 -0
  112. package/releng/meson/mesonbuild/compilers/detect.py +1396 -0
  113. package/releng/meson/mesonbuild/compilers/fortran.py +523 -0
  114. package/releng/meson/mesonbuild/compilers/java.py +113 -0
  115. package/releng/meson/mesonbuild/compilers/mixins/__init__.py +0 -0
  116. package/releng/meson/mesonbuild/compilers/mixins/arm.py +167 -0
  117. package/releng/meson/mesonbuild/compilers/mixins/ccrx.py +113 -0
  118. package/releng/meson/mesonbuild/compilers/mixins/clang.py +170 -0
  119. package/releng/meson/mesonbuild/compilers/mixins/clike.py +1330 -0
  120. package/releng/meson/mesonbuild/compilers/mixins/compcert.py +117 -0
  121. package/releng/meson/mesonbuild/compilers/mixins/elbrus.py +93 -0
  122. package/releng/meson/mesonbuild/compilers/mixins/emscripten.py +89 -0
  123. package/releng/meson/mesonbuild/compilers/mixins/gnu.py +629 -0
  124. package/releng/meson/mesonbuild/compilers/mixins/intel.py +167 -0
  125. package/releng/meson/mesonbuild/compilers/mixins/islinker.py +120 -0
  126. package/releng/meson/mesonbuild/compilers/mixins/metrowerks.py +279 -0
  127. package/releng/meson/mesonbuild/compilers/mixins/pgi.py +88 -0
  128. package/releng/meson/mesonbuild/compilers/mixins/ti.py +130 -0
  129. package/releng/meson/mesonbuild/compilers/mixins/visualstudio.py +458 -0
  130. package/releng/meson/mesonbuild/compilers/mixins/xc16.py +111 -0
  131. package/releng/meson/mesonbuild/compilers/objc.py +120 -0
  132. package/releng/meson/mesonbuild/compilers/objcpp.py +102 -0
  133. package/releng/meson/mesonbuild/compilers/rust.py +230 -0
  134. package/releng/meson/mesonbuild/compilers/swift.py +131 -0
  135. package/releng/meson/mesonbuild/compilers/vala.py +121 -0
  136. package/releng/meson/mesonbuild/coredata.py +1532 -0
  137. package/releng/meson/mesonbuild/dependencies/__init__.py +252 -0
  138. package/releng/meson/mesonbuild/dependencies/base.py +663 -0
  139. package/releng/meson/mesonbuild/dependencies/boost.py +1083 -0
  140. package/releng/meson/mesonbuild/dependencies/cmake.py +656 -0
  141. package/releng/meson/mesonbuild/dependencies/coarrays.py +80 -0
  142. package/releng/meson/mesonbuild/dependencies/configtool.py +163 -0
  143. package/releng/meson/mesonbuild/dependencies/cuda.py +295 -0
  144. package/releng/meson/mesonbuild/dependencies/data/CMakeLists.txt +102 -0
  145. package/releng/meson/mesonbuild/dependencies/data/CMakeListsLLVM.txt +204 -0
  146. package/releng/meson/mesonbuild/dependencies/data/CMakePathInfo.txt +31 -0
  147. package/releng/meson/mesonbuild/dependencies/data/__init__.py +0 -0
  148. package/releng/meson/mesonbuild/dependencies/detect.py +225 -0
  149. package/releng/meson/mesonbuild/dependencies/dev.py +707 -0
  150. package/releng/meson/mesonbuild/dependencies/dub.py +424 -0
  151. package/releng/meson/mesonbuild/dependencies/factory.py +146 -0
  152. package/releng/meson/mesonbuild/dependencies/framework.py +111 -0
  153. package/releng/meson/mesonbuild/dependencies/hdf5.py +168 -0
  154. package/releng/meson/mesonbuild/dependencies/misc.py +618 -0
  155. package/releng/meson/mesonbuild/dependencies/mpi.py +231 -0
  156. package/releng/meson/mesonbuild/dependencies/pkgconfig.py +570 -0
  157. package/releng/meson/mesonbuild/dependencies/platform.py +52 -0
  158. package/releng/meson/mesonbuild/dependencies/python.py +431 -0
  159. package/releng/meson/mesonbuild/dependencies/qt.py +484 -0
  160. package/releng/meson/mesonbuild/dependencies/scalapack.py +142 -0
  161. package/releng/meson/mesonbuild/dependencies/ui.py +281 -0
  162. package/releng/meson/mesonbuild/depfile.py +82 -0
  163. package/releng/meson/mesonbuild/envconfig.py +480 -0
  164. package/releng/meson/mesonbuild/environment.py +987 -0
  165. package/releng/meson/mesonbuild/interpreter/__init__.py +47 -0
  166. package/releng/meson/mesonbuild/interpreter/compiler.py +900 -0
  167. package/releng/meson/mesonbuild/interpreter/dependencyfallbacks.py +386 -0
  168. package/releng/meson/mesonbuild/interpreter/interpreter.py +3595 -0
  169. package/releng/meson/mesonbuild/interpreter/interpreterobjects.py +1096 -0
  170. package/releng/meson/mesonbuild/interpreter/kwargs.py +479 -0
  171. package/releng/meson/mesonbuild/interpreter/mesonmain.py +487 -0
  172. package/releng/meson/mesonbuild/interpreter/primitives/__init__.py +29 -0
  173. package/releng/meson/mesonbuild/interpreter/primitives/array.py +108 -0
  174. package/releng/meson/mesonbuild/interpreter/primitives/boolean.py +52 -0
  175. package/releng/meson/mesonbuild/interpreter/primitives/dict.py +88 -0
  176. package/releng/meson/mesonbuild/interpreter/primitives/integer.py +86 -0
  177. package/releng/meson/mesonbuild/interpreter/primitives/range.py +38 -0
  178. package/releng/meson/mesonbuild/interpreter/primitives/string.py +247 -0
  179. package/releng/meson/mesonbuild/interpreter/type_checking.py +853 -0
  180. package/releng/meson/mesonbuild/interpreterbase/__init__.py +126 -0
  181. package/releng/meson/mesonbuild/interpreterbase/_unholder.py +25 -0
  182. package/releng/meson/mesonbuild/interpreterbase/baseobjects.py +174 -0
  183. package/releng/meson/mesonbuild/interpreterbase/decorators.py +806 -0
  184. package/releng/meson/mesonbuild/interpreterbase/disabler.py +35 -0
  185. package/releng/meson/mesonbuild/interpreterbase/exceptions.py +22 -0
  186. package/releng/meson/mesonbuild/interpreterbase/helpers.py +67 -0
  187. package/releng/meson/mesonbuild/interpreterbase/interpreterbase.py +665 -0
  188. package/releng/meson/mesonbuild/interpreterbase/operator.py +32 -0
  189. package/releng/meson/mesonbuild/linkers/__init__.py +20 -0
  190. package/releng/meson/mesonbuild/linkers/base.py +39 -0
  191. package/releng/meson/mesonbuild/linkers/detect.py +229 -0
  192. package/releng/meson/mesonbuild/linkers/linkers.py +1614 -0
  193. package/releng/meson/mesonbuild/mcompile.py +380 -0
  194. package/releng/meson/mesonbuild/mconf.py +368 -0
  195. package/releng/meson/mesonbuild/mdevenv.py +234 -0
  196. package/releng/meson/mesonbuild/mdist.py +376 -0
  197. package/releng/meson/mesonbuild/mesondata.py +38 -0
  198. package/releng/meson/mesonbuild/mesonlib.py +23 -0
  199. package/releng/meson/mesonbuild/mesonmain.py +289 -0
  200. package/releng/meson/mesonbuild/minit.py +204 -0
  201. package/releng/meson/mesonbuild/minstall.py +864 -0
  202. package/releng/meson/mesonbuild/mintro.py +667 -0
  203. package/releng/meson/mesonbuild/mlog.py +542 -0
  204. package/releng/meson/mesonbuild/modules/__init__.py +270 -0
  205. package/releng/meson/mesonbuild/modules/cmake.py +442 -0
  206. package/releng/meson/mesonbuild/modules/cuda.py +377 -0
  207. package/releng/meson/mesonbuild/modules/dlang.py +117 -0
  208. package/releng/meson/mesonbuild/modules/external_project.py +306 -0
  209. package/releng/meson/mesonbuild/modules/fs.py +323 -0
  210. package/releng/meson/mesonbuild/modules/gnome.py +2215 -0
  211. package/releng/meson/mesonbuild/modules/hotdoc.py +487 -0
  212. package/releng/meson/mesonbuild/modules/i18n.py +405 -0
  213. package/releng/meson/mesonbuild/modules/icestorm.py +123 -0
  214. package/releng/meson/mesonbuild/modules/java.py +112 -0
  215. package/releng/meson/mesonbuild/modules/keyval.py +65 -0
  216. package/releng/meson/mesonbuild/modules/modtest.py +33 -0
  217. package/releng/meson/mesonbuild/modules/pkgconfig.py +744 -0
  218. package/releng/meson/mesonbuild/modules/python.py +556 -0
  219. package/releng/meson/mesonbuild/modules/python3.py +85 -0
  220. package/releng/meson/mesonbuild/modules/qt.py +621 -0
  221. package/releng/meson/mesonbuild/modules/qt4.py +23 -0
  222. package/releng/meson/mesonbuild/modules/qt5.py +23 -0
  223. package/releng/meson/mesonbuild/modules/qt6.py +22 -0
  224. package/releng/meson/mesonbuild/modules/rust.py +355 -0
  225. package/releng/meson/mesonbuild/modules/simd.py +114 -0
  226. package/releng/meson/mesonbuild/modules/sourceset.py +291 -0
  227. package/releng/meson/mesonbuild/modules/wayland.py +151 -0
  228. package/releng/meson/mesonbuild/modules/windows.py +207 -0
  229. package/releng/meson/mesonbuild/mparser.py +1114 -0
  230. package/releng/meson/mesonbuild/msetup.py +365 -0
  231. package/releng/meson/mesonbuild/msubprojects.py +764 -0
  232. package/releng/meson/mesonbuild/mtest.py +2201 -0
  233. package/releng/meson/mesonbuild/munstable_coredata.py +107 -0
  234. package/releng/meson/mesonbuild/optinterpreter.py +276 -0
  235. package/releng/meson/mesonbuild/programs.py +367 -0
  236. package/releng/meson/mesonbuild/rewriter.py +1075 -0
  237. package/releng/meson/mesonbuild/scripts/__init__.py +10 -0
  238. package/releng/meson/mesonbuild/scripts/clangformat.py +55 -0
  239. package/releng/meson/mesonbuild/scripts/clangtidy.py +30 -0
  240. package/releng/meson/mesonbuild/scripts/cleantrees.py +35 -0
  241. package/releng/meson/mesonbuild/scripts/cmake_run_ctgt.py +103 -0
  242. package/releng/meson/mesonbuild/scripts/cmd_or_ps.ps1 +17 -0
  243. package/releng/meson/mesonbuild/scripts/copy.py +19 -0
  244. package/releng/meson/mesonbuild/scripts/coverage.py +214 -0
  245. package/releng/meson/mesonbuild/scripts/delwithsuffix.py +27 -0
  246. package/releng/meson/mesonbuild/scripts/depfixer.py +495 -0
  247. package/releng/meson/mesonbuild/scripts/depscan.py +198 -0
  248. package/releng/meson/mesonbuild/scripts/dirchanger.py +20 -0
  249. package/releng/meson/mesonbuild/scripts/env2mfile.py +402 -0
  250. package/releng/meson/mesonbuild/scripts/externalproject.py +106 -0
  251. package/releng/meson/mesonbuild/scripts/gettext.py +86 -0
  252. package/releng/meson/mesonbuild/scripts/gtkdochelper.py +286 -0
  253. package/releng/meson/mesonbuild/scripts/hotdochelper.py +40 -0
  254. package/releng/meson/mesonbuild/scripts/itstool.py +77 -0
  255. package/releng/meson/mesonbuild/scripts/meson_exe.py +115 -0
  256. package/releng/meson/mesonbuild/scripts/msgfmthelper.py +29 -0
  257. package/releng/meson/mesonbuild/scripts/pycompile.py +54 -0
  258. package/releng/meson/mesonbuild/scripts/python_info.py +121 -0
  259. package/releng/meson/mesonbuild/scripts/regen_checker.py +55 -0
  260. package/releng/meson/mesonbuild/scripts/run_tool.py +58 -0
  261. package/releng/meson/mesonbuild/scripts/scanbuild.py +57 -0
  262. package/releng/meson/mesonbuild/scripts/symbolextractor.py +322 -0
  263. package/releng/meson/mesonbuild/scripts/tags.py +44 -0
  264. package/releng/meson/mesonbuild/scripts/test_loaded_modules.py +14 -0
  265. package/releng/meson/mesonbuild/scripts/uninstall.py +41 -0
  266. package/releng/meson/mesonbuild/scripts/vcstagger.py +35 -0
  267. package/releng/meson/mesonbuild/scripts/yasm.py +24 -0
  268. package/releng/meson/mesonbuild/templates/__init__.py +0 -0
  269. package/releng/meson/mesonbuild/templates/cpptemplates.py +143 -0
  270. package/releng/meson/mesonbuild/templates/cstemplates.py +90 -0
  271. package/releng/meson/mesonbuild/templates/ctemplates.py +126 -0
  272. package/releng/meson/mesonbuild/templates/cudatemplates.py +143 -0
  273. package/releng/meson/mesonbuild/templates/dlangtemplates.py +109 -0
  274. package/releng/meson/mesonbuild/templates/fortrantemplates.py +101 -0
  275. package/releng/meson/mesonbuild/templates/javatemplates.py +94 -0
  276. package/releng/meson/mesonbuild/templates/mesontemplates.py +70 -0
  277. package/releng/meson/mesonbuild/templates/objcpptemplates.py +126 -0
  278. package/releng/meson/mesonbuild/templates/objctemplates.py +126 -0
  279. package/releng/meson/mesonbuild/templates/rusttemplates.py +79 -0
  280. package/releng/meson/mesonbuild/templates/samplefactory.py +41 -0
  281. package/releng/meson/mesonbuild/templates/sampleimpl.py +160 -0
  282. package/releng/meson/mesonbuild/templates/valatemplates.py +82 -0
  283. package/releng/meson/mesonbuild/utils/__init__.py +0 -0
  284. package/releng/meson/mesonbuild/utils/core.py +166 -0
  285. package/releng/meson/mesonbuild/utils/platform.py +27 -0
  286. package/releng/meson/mesonbuild/utils/posix.py +32 -0
  287. package/releng/meson/mesonbuild/utils/universal.py +2445 -0
  288. package/releng/meson/mesonbuild/utils/vsenv.py +126 -0
  289. package/releng/meson/mesonbuild/utils/win32.py +29 -0
  290. package/releng/meson/mesonbuild/wrap/__init__.py +59 -0
  291. package/releng/meson/mesonbuild/wrap/wrap.py +846 -0
  292. package/releng/meson/mesonbuild/wrap/wraptool.py +198 -0
  293. package/releng/meson-scripts/BSDmakefile +6 -0
  294. package/releng/meson-scripts/Makefile +16 -0
  295. package/releng/meson-scripts/configure +18 -0
  296. package/releng/meson-scripts/configure.bat +22 -0
  297. package/releng/meson-scripts/make.bat +23 -0
  298. package/releng/meson_configure.py +506 -0
  299. package/releng/meson_make.py +131 -0
  300. package/releng/mkdevkit.py +107 -0
  301. package/releng/mkfatmacho.py +54 -0
  302. package/releng/post-process-oabi.py +97 -0
  303. package/releng/progress.py +14 -0
  304. package/releng/sync-from-upstream.py +185 -0
  305. package/releng/tomlkit/tomlkit/__init__.py +59 -0
  306. package/releng/tomlkit/tomlkit/_compat.py +22 -0
  307. package/releng/tomlkit/tomlkit/_types.py +83 -0
  308. package/releng/tomlkit/tomlkit/_utils.py +158 -0
  309. package/releng/tomlkit/tomlkit/api.py +308 -0
  310. package/releng/tomlkit/tomlkit/container.py +875 -0
  311. package/releng/tomlkit/tomlkit/exceptions.py +227 -0
  312. package/releng/tomlkit/tomlkit/items.py +1967 -0
  313. package/releng/tomlkit/tomlkit/parser.py +1141 -0
  314. package/releng/tomlkit/tomlkit/py.typed +0 -0
  315. package/releng/tomlkit/tomlkit/source.py +180 -0
  316. package/releng/tomlkit/tomlkit/toml_char.py +52 -0
  317. package/releng/tomlkit/tomlkit/toml_document.py +7 -0
  318. package/releng/tomlkit/tomlkit/toml_file.py +58 -0
  319. package/releng/winenv.py +140 -0
  320. package/scripts/adjust-version.py +19 -0
  321. package/scripts/detect-version.py +40 -0
  322. package/scripts/fetch-abi-bits.py +343 -0
  323. package/scripts/install.js +23 -0
  324. package/scripts/package.py +15 -0
  325. package/src/addon.cc +76 -0
  326. package/src/application.cc +148 -0
  327. package/src/application.h +31 -0
  328. package/src/authentication.cc +174 -0
  329. package/src/authentication.h +24 -0
  330. package/src/bus.cc +167 -0
  331. package/src/bus.h +33 -0
  332. package/src/cancellable.cc +117 -0
  333. package/src/cancellable.h +31 -0
  334. package/src/child.cc +150 -0
  335. package/src/child.h +32 -0
  336. package/src/crash.cc +122 -0
  337. package/src/crash.h +30 -0
  338. package/src/device.cc +1302 -0
  339. package/src/device.h +55 -0
  340. package/src/device_manager.cc +362 -0
  341. package/src/device_manager.h +35 -0
  342. package/src/endpoint_parameters.cc +171 -0
  343. package/src/endpoint_parameters.h +28 -0
  344. package/src/glib_context.cc +62 -0
  345. package/src/glib_context.h +29 -0
  346. package/src/glib_object.cc +25 -0
  347. package/src/glib_object.h +37 -0
  348. package/src/iostream.cc +247 -0
  349. package/src/iostream.h +30 -0
  350. package/src/meson.build +26 -0
  351. package/src/operation.h +94 -0
  352. package/src/portal_membership.cc +100 -0
  353. package/src/portal_membership.h +26 -0
  354. package/src/portal_service.cc +401 -0
  355. package/src/portal_service.h +40 -0
  356. package/src/process.cc +135 -0
  357. package/src/process.h +30 -0
  358. package/src/relay.cc +139 -0
  359. package/src/relay.h +31 -0
  360. package/src/runtime.cc +443 -0
  361. package/src/runtime.h +64 -0
  362. package/src/script.cc +301 -0
  363. package/src/script.h +36 -0
  364. package/src/session.cc +860 -0
  365. package/src/session.h +42 -0
  366. package/src/signals.cc +334 -0
  367. package/src/signals.h +47 -0
  368. package/src/spawn.cc +95 -0
  369. package/src/spawn.h +27 -0
  370. package/src/usage_monitor.h +117 -0
  371. package/src/uv_context.cc +118 -0
  372. package/src/uv_context.h +40 -0
  373. package/src/win_delay_load_hook.cc +63 -0
  374. package/subprojects/frida-core.wrap +8 -0
  375. package/subprojects/nan.wrap +9 -0
  376. package/subprojects/packagefiles/nan.patch +13 -0
  377. package/test/data/index.ts +13 -0
  378. package/test/data/unixvictim-linux-x86 +0 -0
  379. package/test/data/unixvictim-linux-x86_64 +0 -0
  380. package/test/data/unixvictim-macos +0 -0
  381. package/test/device.ts +27 -0
  382. package/test/device_manager.ts +16 -0
  383. package/test/labrat.ts +32 -0
  384. package/test/script.ts +176 -0
  385. package/test/session.ts +73 -0
  386. package/tsconfig.json +18 -0
@@ -0,0 +1,368 @@
1
+ # SPDX-License-Identifier: Apache-2.0
2
+ # Copyright 2014-2016 The Meson development team
3
+ # Copyright © 2023-2024 Intel Corporation
4
+
5
+ from __future__ import annotations
6
+
7
+ import itertools
8
+ import hashlib
9
+ import shutil
10
+ import os
11
+ import textwrap
12
+ import typing as T
13
+ import collections
14
+
15
+ from . import build
16
+ from . import coredata
17
+ from . import environment
18
+ from . import mesonlib
19
+ from . import mintro
20
+ from . import mlog
21
+ from .ast import AstIDGenerator, IntrospectionInterpreter
22
+ from .mesonlib import MachineChoice, OptionKey
23
+ from .optinterpreter import OptionInterpreter
24
+
25
+ if T.TYPE_CHECKING:
26
+ from typing_extensions import Protocol
27
+ import argparse
28
+
29
+ class CMDOptions(coredata.SharedCMDOptions, Protocol):
30
+
31
+ builddir: str
32
+ clearcache: bool
33
+ pager: bool
34
+
35
+ # cannot be TV_Loggable, because non-ansidecorators do direct string concat
36
+ LOGLINE = T.Union[str, mlog.AnsiDecorator]
37
+
38
+ # Note: when adding arguments, please also add them to the completion
39
+ # scripts in $MESONSRC/data/shell-completions/
40
+ def add_arguments(parser: 'argparse.ArgumentParser') -> None:
41
+ coredata.register_builtin_arguments(parser)
42
+ parser.add_argument('builddir', nargs='?', default='.')
43
+ parser.add_argument('--clearcache', action='store_true', default=False,
44
+ help='Clear cached state (e.g. found dependencies)')
45
+ parser.add_argument('--no-pager', action='store_false', dest='pager',
46
+ help='Do not redirect output to a pager')
47
+
48
+ def stringify(val: T.Any) -> str:
49
+ if isinstance(val, bool):
50
+ return str(val).lower()
51
+ elif isinstance(val, list):
52
+ s = ', '.join(stringify(i) for i in val)
53
+ return f'[{s}]'
54
+ elif val is None:
55
+ return ''
56
+ else:
57
+ return str(val)
58
+
59
+
60
+ class ConfException(mesonlib.MesonException):
61
+ pass
62
+
63
+
64
+ class Conf:
65
+ def __init__(self, build_dir: str):
66
+ self.build_dir = os.path.abspath(os.path.realpath(build_dir))
67
+ if 'meson.build' in [os.path.basename(self.build_dir), self.build_dir]:
68
+ self.build_dir = os.path.dirname(self.build_dir)
69
+ self.build = None
70
+ self.max_choices_line_length = 60
71
+ self.name_col: T.List[LOGLINE] = []
72
+ self.value_col: T.List[LOGLINE] = []
73
+ self.choices_col: T.List[LOGLINE] = []
74
+ self.descr_col: T.List[LOGLINE] = []
75
+ self.all_subprojects: T.Set[str] = set()
76
+
77
+ if os.path.isdir(os.path.join(self.build_dir, 'meson-private')):
78
+ self.build = build.load(self.build_dir)
79
+ self.source_dir = self.build.environment.get_source_dir()
80
+ self.coredata = self.build.environment.coredata
81
+ self.default_values_only = False
82
+
83
+ # if the option file has been updated, reload it
84
+ # This cannot handle options for a new subproject that has not yet
85
+ # been configured.
86
+ for sub, options in self.coredata.options_files.items():
87
+ if options is not None and os.path.exists(options[0]):
88
+ opfile = options[0]
89
+ with open(opfile, 'rb') as f:
90
+ ophash = hashlib.sha1(f.read()).hexdigest()
91
+ if ophash != options[1]:
92
+ oi = OptionInterpreter(sub)
93
+ oi.process(opfile)
94
+ self.coredata.update_project_options(oi.options, sub)
95
+ self.coredata.options_files[sub] = (opfile, ophash)
96
+ else:
97
+ opfile = os.path.join(self.source_dir, 'meson.options')
98
+ if not os.path.exists(opfile):
99
+ opfile = os.path.join(self.source_dir, 'meson_options.txt')
100
+ if os.path.exists(opfile):
101
+ oi = OptionInterpreter(sub)
102
+ oi.process(opfile)
103
+ self.coredata.update_project_options(oi.options, sub)
104
+ with open(opfile, 'rb') as f:
105
+ ophash = hashlib.sha1(f.read()).hexdigest()
106
+ self.coredata.options_files[sub] = (opfile, ophash)
107
+ else:
108
+ self.coredata.update_project_options({}, sub)
109
+ elif os.path.isfile(os.path.join(self.build_dir, environment.build_filename)):
110
+ # Make sure that log entries in other parts of meson don't interfere with the JSON output
111
+ with mlog.no_logging():
112
+ self.source_dir = os.path.abspath(os.path.realpath(self.build_dir))
113
+ intr = IntrospectionInterpreter(self.source_dir, '', 'ninja', visitors = [AstIDGenerator()])
114
+ intr.analyze()
115
+ self.coredata = intr.coredata
116
+ self.default_values_only = True
117
+ else:
118
+ raise ConfException(f'Directory {build_dir} is neither a Meson build directory nor a project source directory.')
119
+
120
+ def clear_cache(self) -> None:
121
+ self.coredata.clear_cache()
122
+
123
+ def set_options(self, options: T.Dict[OptionKey, str]) -> bool:
124
+ return self.coredata.set_options(options)
125
+
126
+ def save(self) -> None:
127
+ # Do nothing when using introspection
128
+ if self.default_values_only:
129
+ return
130
+ coredata.save(self.coredata, self.build_dir)
131
+ # We don't write the build file because any changes to it
132
+ # are erased when Meson is executed the next time, i.e. when
133
+ # Ninja is run.
134
+
135
+ def print_aligned(self) -> None:
136
+ """Do the actual printing.
137
+
138
+ This prints the generated output in an aligned, pretty form. it aims
139
+ for a total width of 160 characters, but will use whatever the tty
140
+ reports it's value to be. Though this is much wider than the standard
141
+ 80 characters of terminals, and even than the newer 120, compressing
142
+ it to those lengths makes the output hard to read.
143
+
144
+ Each column will have a specific width, and will be line wrapped.
145
+ """
146
+ total_width = shutil.get_terminal_size(fallback=(160, 0))[0]
147
+ _col = max(total_width // 5, 20)
148
+ last_column = total_width - (3 * _col) - 3
149
+ four_column = (_col, _col, _col, last_column if last_column > 1 else _col)
150
+
151
+ for line in zip(self.name_col, self.value_col, self.choices_col, self.descr_col):
152
+ if not any(line):
153
+ mlog.log('')
154
+ continue
155
+
156
+ # This is a header, like `Subproject foo:`,
157
+ # We just want to print that and get on with it
158
+ if line[0] and not any(line[1:]):
159
+ mlog.log(line[0])
160
+ continue
161
+
162
+ def wrap_text(text: LOGLINE, width: int) -> mlog.TV_LoggableList:
163
+ raw = text.text if isinstance(text, mlog.AnsiDecorator) else text
164
+ indent = ' ' if raw.startswith('[') else ''
165
+ wrapped_ = textwrap.wrap(raw, width, subsequent_indent=indent)
166
+ # We cast this because https://github.com/python/mypy/issues/1965
167
+ # mlog.TV_LoggableList does not provide __len__ for stringprotocol
168
+ if isinstance(text, mlog.AnsiDecorator):
169
+ wrapped = T.cast('T.List[LOGLINE]', [mlog.AnsiDecorator(i, text.code) for i in wrapped_])
170
+ else:
171
+ wrapped = T.cast('T.List[LOGLINE]', wrapped_)
172
+ # Add padding here to get even rows, as `textwrap.wrap()` will
173
+ # only shorten, not lengthen each item
174
+ return [str(i) + ' ' * (width - len(i)) for i in wrapped]
175
+
176
+ # wrap will take a long string, and create a list of strings no
177
+ # longer than the size given. Then that list can be zipped into, to
178
+ # print each line of the output, such the that columns are printed
179
+ # to the right width, row by row.
180
+ name = wrap_text(line[0], four_column[0])
181
+ val = wrap_text(line[1], four_column[1])
182
+ choice = wrap_text(line[2], four_column[2])
183
+ desc = wrap_text(line[3], four_column[3])
184
+ for l in itertools.zip_longest(name, val, choice, desc, fillvalue=''):
185
+ items = [l[i] if l[i] else ' ' * four_column[i] for i in range(4)]
186
+ mlog.log(*items)
187
+
188
+ def split_options_per_subproject(self, options: 'coredata.KeyedOptionDictType') -> T.Dict[str, 'coredata.MutableKeyedOptionDictType']:
189
+ result: T.Dict[str, 'coredata.MutableKeyedOptionDictType'] = {}
190
+ for k, o in options.items():
191
+ if k.subproject:
192
+ self.all_subprojects.add(k.subproject)
193
+ result.setdefault(k.subproject, {})[k] = o
194
+ return result
195
+
196
+ def _add_line(self, name: LOGLINE, value: LOGLINE, choices: LOGLINE, descr: LOGLINE) -> None:
197
+ if isinstance(name, mlog.AnsiDecorator):
198
+ name.text = ' ' * self.print_margin + name.text
199
+ else:
200
+ name = ' ' * self.print_margin + name
201
+ self.name_col.append(name)
202
+ self.value_col.append(value)
203
+ self.choices_col.append(choices)
204
+ self.descr_col.append(descr)
205
+
206
+ def add_option(self, name: str, descr: str, value: T.Any, choices: T.Any) -> None:
207
+ value = stringify(value)
208
+ choices = stringify(choices)
209
+ self._add_line(mlog.green(name), mlog.yellow(value), mlog.blue(choices), descr)
210
+
211
+ def add_title(self, title: str) -> None:
212
+ newtitle = mlog.cyan(title)
213
+ descr = mlog.cyan('Description')
214
+ value = mlog.cyan('Default Value' if self.default_values_only else 'Current Value')
215
+ choices = mlog.cyan('Possible Values')
216
+ self._add_line('', '', '', '')
217
+ self._add_line(newtitle, value, choices, descr)
218
+ self._add_line('-' * len(newtitle), '-' * len(value), '-' * len(choices), '-' * len(descr))
219
+
220
+ def add_section(self, section: str) -> None:
221
+ self.print_margin = 0
222
+ self._add_line('', '', '', '')
223
+ self._add_line(mlog.normal_yellow(section + ':'), '', '', '')
224
+ self.print_margin = 2
225
+
226
+ def print_options(self, title: str, options: 'coredata.KeyedOptionDictType') -> None:
227
+ if not options:
228
+ return
229
+ if title:
230
+ self.add_title(title)
231
+ auto = T.cast('coredata.UserFeatureOption', self.coredata.options[OptionKey('auto_features')])
232
+ for k, o in sorted(options.items()):
233
+ printable_value = o.printable_value()
234
+ root = k.as_root()
235
+ if o.yielding and k.subproject and root in self.coredata.options:
236
+ printable_value = '<inherited from main project>'
237
+ if isinstance(o, coredata.UserFeatureOption) and o.is_auto():
238
+ printable_value = auto.printable_value()
239
+ self.add_option(str(root), o.description, printable_value, o.choices)
240
+
241
+ def print_conf(self, pager: bool) -> None:
242
+ if pager:
243
+ mlog.start_pager()
244
+
245
+ def print_default_values_warning() -> None:
246
+ mlog.warning('The source directory instead of the build directory was specified.')
247
+ mlog.warning('Only the default values for the project are printed.')
248
+
249
+ if self.default_values_only:
250
+ print_default_values_warning()
251
+ mlog.log('')
252
+
253
+ mlog.log('Core properties:')
254
+ mlog.log(' Source dir', self.source_dir)
255
+ if not self.default_values_only:
256
+ mlog.log(' Build dir ', self.build_dir)
257
+
258
+ dir_option_names = set(coredata.BUILTIN_DIR_OPTIONS)
259
+ test_option_names = {OptionKey('errorlogs'),
260
+ OptionKey('stdsplit')}
261
+
262
+ dir_options: 'coredata.MutableKeyedOptionDictType' = {}
263
+ test_options: 'coredata.MutableKeyedOptionDictType' = {}
264
+ core_options: 'coredata.MutableKeyedOptionDictType' = {}
265
+ module_options: T.Dict[str, 'coredata.MutableKeyedOptionDictType'] = collections.defaultdict(dict)
266
+ for k, v in self.coredata.options.items():
267
+ if k in dir_option_names:
268
+ dir_options[k] = v
269
+ elif k in test_option_names:
270
+ test_options[k] = v
271
+ elif k.module:
272
+ # Ignore module options if we did not use that module during
273
+ # configuration.
274
+ if self.build and k.module not in self.build.modules:
275
+ continue
276
+ module_options[k.module][k] = v
277
+ elif k.is_builtin():
278
+ core_options[k] = v
279
+
280
+ host_core_options = self.split_options_per_subproject({k: v for k, v in core_options.items() if k.machine is MachineChoice.HOST})
281
+ build_core_options = self.split_options_per_subproject({k: v for k, v in core_options.items() if k.machine is MachineChoice.BUILD})
282
+ host_compiler_options = self.split_options_per_subproject({k: v for k, v in self.coredata.options.items() if k.is_compiler() and k.machine is MachineChoice.HOST})
283
+ build_compiler_options = self.split_options_per_subproject({k: v for k, v in self.coredata.options.items() if k.is_compiler() and k.machine is MachineChoice.BUILD})
284
+ project_options = self.split_options_per_subproject({k: v for k, v in self.coredata.options.items() if k.is_project()})
285
+ show_build_options = self.default_values_only or self.build.environment.is_cross_build()
286
+
287
+ self.add_section('Main project options')
288
+ self.print_options('Core options', host_core_options[''])
289
+ if show_build_options:
290
+ self.print_options('', build_core_options[''])
291
+ self.print_options('Backend options', {k: v for k, v in self.coredata.options.items() if k.is_backend()})
292
+ self.print_options('Base options', {k: v for k, v in self.coredata.options.items() if k.is_base()})
293
+ self.print_options('Compiler options', host_compiler_options.get('', {}))
294
+ if show_build_options:
295
+ self.print_options('', build_compiler_options.get('', {}))
296
+ for mod, mod_options in module_options.items():
297
+ self.print_options(f'{mod} module options', mod_options)
298
+ self.print_options('Directories', dir_options)
299
+ self.print_options('Testing options', test_options)
300
+ self.print_options('Project options', project_options.get('', {}))
301
+ for subproject in sorted(self.all_subprojects):
302
+ if subproject == '':
303
+ continue
304
+ self.add_section('Subproject ' + subproject)
305
+ if subproject in host_core_options:
306
+ self.print_options('Core options', host_core_options[subproject])
307
+ if subproject in build_core_options and show_build_options:
308
+ self.print_options('', build_core_options[subproject])
309
+ if subproject in host_compiler_options:
310
+ self.print_options('Compiler options', host_compiler_options[subproject])
311
+ if subproject in build_compiler_options and show_build_options:
312
+ self.print_options('', build_compiler_options[subproject])
313
+ if subproject in project_options:
314
+ self.print_options('Project options', project_options[subproject])
315
+ self.print_aligned()
316
+
317
+ # Print the warning twice so that the user shouldn't be able to miss it
318
+ if self.default_values_only:
319
+ mlog.log('')
320
+ print_default_values_warning()
321
+
322
+ self.print_nondefault_buildtype_options()
323
+
324
+ def print_nondefault_buildtype_options(self) -> None:
325
+ mismatching = self.coredata.get_nondefault_buildtype_args()
326
+ if not mismatching:
327
+ return
328
+ mlog.log("\nThe following option(s) have a different value than the build type default\n")
329
+ mlog.log(' current default')
330
+ for m in mismatching:
331
+ mlog.log(f'{m[0]:21}{m[1]:10}{m[2]:10}')
332
+
333
+ def run_impl(options: CMDOptions, builddir: str) -> int:
334
+ print_only = not options.cmd_line_options and not options.clearcache
335
+ c = None
336
+ try:
337
+ c = Conf(builddir)
338
+ if c.default_values_only and not print_only:
339
+ raise mesonlib.MesonException('No valid build directory found, cannot modify options.')
340
+ if c.default_values_only or print_only:
341
+ c.print_conf(options.pager)
342
+ return 0
343
+
344
+ save = False
345
+ if options.cmd_line_options:
346
+ save = c.set_options(options.cmd_line_options)
347
+ coredata.update_cmd_line_file(builddir, options)
348
+ if options.clearcache:
349
+ c.clear_cache()
350
+ save = True
351
+ if save:
352
+ c.save()
353
+ mintro.update_build_options(c.coredata, c.build.environment.info_dir)
354
+ mintro.write_meson_info_file(c.build, [])
355
+ except ConfException as e:
356
+ mlog.log('Meson configurator encountered an error:')
357
+ if c is not None and c.build is not None:
358
+ mintro.write_meson_info_file(c.build, [e])
359
+ raise e
360
+ except BrokenPipeError:
361
+ # Pager quit before we wrote everything.
362
+ pass
363
+ return 0
364
+
365
+ def run(options: CMDOptions) -> int:
366
+ coredata.parse_cmd_line_options(options)
367
+ builddir = os.path.abspath(os.path.realpath(options.builddir))
368
+ return run_impl(options, builddir)
@@ -0,0 +1,234 @@
1
+ from __future__ import annotations
2
+
3
+ import os, subprocess
4
+ import argparse
5
+ import tempfile
6
+ import shutil
7
+ import itertools
8
+ import typing as T
9
+
10
+ from pathlib import Path
11
+ from . import build, minstall
12
+ from .mesonlib import (EnvironmentVariables, MesonException, is_windows, setup_vsenv, OptionKey,
13
+ get_wine_shortpath, MachineChoice)
14
+ from . import mlog
15
+
16
+
17
+ if T.TYPE_CHECKING:
18
+ from .backend.backends import InstallData
19
+
20
+ POWERSHELL_EXES = {'pwsh.exe', 'powershell.exe'}
21
+
22
+ # Note: when adding arguments, please also add them to the completion
23
+ # scripts in $MESONSRC/data/shell-completions/
24
+ def add_arguments(parser: argparse.ArgumentParser) -> None:
25
+ parser.add_argument('-C', dest='builddir', type=Path, default='.',
26
+ help='Path to build directory')
27
+ parser.add_argument('--workdir', '-w', type=Path, default=None,
28
+ help='Directory to cd into before running (default: builddir, Since 1.0.0)')
29
+ parser.add_argument('--dump', nargs='?', const=True,
30
+ help='Only print required environment (Since 0.62.0) ' +
31
+ 'Takes an optional file path (Since 1.1.0)')
32
+ parser.add_argument('--dump-format', default='export',
33
+ choices=['sh', 'export', 'vscode'],
34
+ help='Format used with --dump (Since 1.1.0)')
35
+ parser.add_argument('devcmd', nargs=argparse.REMAINDER, metavar='command',
36
+ help='Command to run in developer environment (default: interactive shell)')
37
+
38
+ def get_windows_shell() -> T.Optional[str]:
39
+ mesonbuild = Path(__file__).parent
40
+ script = mesonbuild / 'scripts' / 'cmd_or_ps.ps1'
41
+ for shell in POWERSHELL_EXES:
42
+ try:
43
+ command = [shell, '-noprofile', '-executionpolicy', 'bypass', '-file', str(script)]
44
+ result = subprocess.check_output(command)
45
+ return result.decode().strip()
46
+ except (subprocess.CalledProcessError, OSError):
47
+ pass
48
+ return None
49
+
50
+ def reduce_winepath(env: T.Dict[str, str]) -> None:
51
+ winepath = env.get('WINEPATH')
52
+ if not winepath:
53
+ return
54
+ winecmd = shutil.which('wine64') or shutil.which('wine')
55
+ if not winecmd:
56
+ return
57
+ env['WINEPATH'] = get_wine_shortpath([winecmd], winepath.split(';'))
58
+ mlog.log('Meson detected wine and has set WINEPATH accordingly')
59
+
60
+ def get_env(b: build.Build, dump_fmt: T.Optional[str]) -> T.Tuple[T.Dict[str, str], T.Set[str]]:
61
+ extra_env = EnvironmentVariables()
62
+ extra_env.set('MESON_DEVENV', ['1'])
63
+ extra_env.set('MESON_PROJECT_NAME', [b.project_name])
64
+
65
+ sysroot = b.environment.properties[MachineChoice.HOST].get_sys_root()
66
+ if sysroot:
67
+ extra_env.set('QEMU_LD_PREFIX', [sysroot])
68
+
69
+ env = {} if dump_fmt else os.environ.copy()
70
+ default_fmt = '${0}' if dump_fmt in {'sh', 'export'} else None
71
+ varnames = set()
72
+ for i in itertools.chain(b.devenv, {extra_env}):
73
+ env = i.get_env(env, default_fmt)
74
+ varnames |= i.get_names()
75
+
76
+ reduce_winepath(env)
77
+
78
+ return env, varnames
79
+
80
+ def bash_completion_files(b: build.Build, install_data: 'InstallData') -> T.List[str]:
81
+ from .dependencies.pkgconfig import PkgConfigDependency
82
+ result = []
83
+ dep = PkgConfigDependency('bash-completion', b.environment,
84
+ {'required': False, 'silent': True, 'version': '>=2.10'})
85
+ if dep.found():
86
+ prefix = b.environment.coredata.get_option(OptionKey('prefix'))
87
+ assert isinstance(prefix, str), 'for mypy'
88
+ datadir = b.environment.coredata.get_option(OptionKey('datadir'))
89
+ assert isinstance(datadir, str), 'for mypy'
90
+ datadir_abs = os.path.join(prefix, datadir)
91
+ completionsdir = dep.get_variable(pkgconfig='completionsdir', pkgconfig_define=(('datadir', datadir_abs),))
92
+ assert isinstance(completionsdir, str), 'for mypy'
93
+ completionsdir_path = Path(completionsdir)
94
+ for f in install_data.data:
95
+ if completionsdir_path in Path(f.install_path).parents:
96
+ result.append(f.path)
97
+ return result
98
+
99
+ def add_gdb_auto_load(autoload_path: Path, gdb_helper: str, fname: Path) -> None:
100
+ # Copy or symlink the GDB helper into our private directory tree
101
+ destdir = autoload_path / fname.parent
102
+ destdir.mkdir(parents=True, exist_ok=True)
103
+ try:
104
+ if is_windows():
105
+ shutil.copy(gdb_helper, str(destdir / os.path.basename(gdb_helper)))
106
+ else:
107
+ os.symlink(gdb_helper, str(destdir / os.path.basename(gdb_helper)))
108
+ except (FileExistsError, shutil.SameFileError):
109
+ pass
110
+
111
+ def write_gdb_script(privatedir: Path, install_data: 'InstallData', workdir: Path) -> None:
112
+ if not shutil.which('gdb'):
113
+ return
114
+ bdir = privatedir.parent
115
+ autoload_basedir = privatedir / 'gdb-auto-load'
116
+ autoload_path = Path(autoload_basedir, *bdir.parts[1:])
117
+ have_gdb_helpers = False
118
+ for d in install_data.data:
119
+ if d.path.endswith('-gdb.py') or d.path.endswith('-gdb.gdb') or d.path.endswith('-gdb.scm'):
120
+ # This GDB helper is made for a specific shared library, search if
121
+ # we have it in our builddir.
122
+ libname = Path(d.path).name.rsplit('-', 1)[0]
123
+ for t in install_data.targets:
124
+ path = Path(t.fname)
125
+ if path.name == libname:
126
+ add_gdb_auto_load(autoload_path, d.path, path)
127
+ have_gdb_helpers = True
128
+ if have_gdb_helpers:
129
+ gdbinit_line = f'add-auto-load-scripts-directory {autoload_basedir}\n'
130
+ gdbinit_path = bdir / '.gdbinit'
131
+ first_time = False
132
+ try:
133
+ with gdbinit_path.open('r+', encoding='utf-8') as f:
134
+ if gdbinit_line not in f.readlines():
135
+ f.write(gdbinit_line)
136
+ first_time = True
137
+ except FileNotFoundError:
138
+ gdbinit_path.write_text(gdbinit_line, encoding='utf-8')
139
+ first_time = True
140
+ if first_time:
141
+ gdbinit_path = gdbinit_path.resolve()
142
+ workdir_path = workdir.resolve()
143
+ rel_path = gdbinit_path.relative_to(workdir_path)
144
+ mlog.log('Meson detected GDB helpers and added config in', mlog.bold(str(rel_path)))
145
+ mlog.log('To load it automatically you might need to:')
146
+ mlog.log(' - Add', mlog.bold(f'add-auto-load-safe-path {gdbinit_path.parent}'),
147
+ 'in', mlog.bold('~/.gdbinit'))
148
+ if gdbinit_path.parent != workdir_path:
149
+ mlog.log(' - Change current workdir to', mlog.bold(str(rel_path.parent)),
150
+ 'or use', mlog.bold(f'--init-command {rel_path}'))
151
+
152
+ def dump(devenv: T.Dict[str, str], varnames: T.Set[str], dump_format: T.Optional[str], output: T.Optional[T.TextIO] = None) -> None:
153
+ for name in varnames:
154
+ print(f'{name}="{devenv[name]}"', file=output)
155
+ if dump_format == 'export':
156
+ print(f'export {name}', file=output)
157
+
158
+ def run(options: argparse.Namespace) -> int:
159
+ privatedir = Path(options.builddir) / 'meson-private'
160
+ buildfile = privatedir / 'build.dat'
161
+ if not buildfile.is_file():
162
+ raise MesonException(f'Directory {options.builddir!r} does not seem to be a Meson build directory.')
163
+ b = build.load(options.builddir)
164
+ workdir = options.workdir or options.builddir
165
+
166
+ need_vsenv = T.cast('bool', b.environment.coredata.get_option(OptionKey('vsenv')))
167
+ setup_vsenv(need_vsenv) # Call it before get_env to get vsenv vars as well
168
+ dump_fmt = options.dump_format if options.dump else None
169
+ devenv, varnames = get_env(b, dump_fmt)
170
+ if options.dump:
171
+ if options.devcmd:
172
+ raise MesonException('--dump option does not allow running other command.')
173
+ if options.dump is True:
174
+ dump(devenv, varnames, dump_fmt)
175
+ else:
176
+ with open(options.dump, "w", encoding='utf-8') as output:
177
+ dump(devenv, varnames, dump_fmt, output)
178
+ return 0
179
+
180
+ if b.environment.need_exe_wrapper():
181
+ m = 'An executable wrapper could be required'
182
+ exe_wrapper = b.environment.get_exe_wrapper()
183
+ if exe_wrapper:
184
+ cmd = ' '.join(exe_wrapper.get_command())
185
+ m += f': {cmd}'
186
+ mlog.log(m)
187
+
188
+ install_data = minstall.load_install_data(str(privatedir / 'install.dat'))
189
+ write_gdb_script(privatedir, install_data, workdir)
190
+
191
+ args = options.devcmd
192
+ if not args:
193
+ prompt_prefix = f'[{b.project_name}]'
194
+ shell_env = os.environ.get("SHELL")
195
+ # Prefer $SHELL in a MSYS2 bash despite it being Windows
196
+ if shell_env and os.path.exists(shell_env):
197
+ args = [shell_env]
198
+ elif is_windows():
199
+ shell = get_windows_shell()
200
+ if not shell:
201
+ mlog.warning('Failed to determine Windows shell, fallback to cmd.exe')
202
+ if shell in POWERSHELL_EXES:
203
+ args = [shell, '-NoLogo', '-NoExit']
204
+ prompt = f'function global:prompt {{ "{prompt_prefix} PS " + $PWD + "> "}}'
205
+ args += ['-Command', prompt]
206
+ else:
207
+ args = [os.environ.get("COMSPEC", r"C:\WINDOWS\system32\cmd.exe")]
208
+ args += ['/k', f'prompt {prompt_prefix} $P$G']
209
+ else:
210
+ args = [os.environ.get("SHELL", os.path.realpath("/bin/sh"))]
211
+ if "bash" in args[0]:
212
+ # Let the GC remove the tmp file
213
+ tmprc = tempfile.NamedTemporaryFile(mode='w')
214
+ tmprc.write('[ -e ~/.bashrc ] && . ~/.bashrc\n')
215
+ if not os.environ.get("MESON_DISABLE_PS1_OVERRIDE"):
216
+ tmprc.write(f'export PS1="{prompt_prefix} $PS1"\n')
217
+ for f in bash_completion_files(b, install_data):
218
+ tmprc.write(f'. "{f}"\n')
219
+ tmprc.flush()
220
+ args.append("--rcfile")
221
+ args.append(tmprc.name)
222
+ else:
223
+ # Try to resolve executable using devenv's PATH
224
+ abs_path = shutil.which(args[0], path=devenv.get('PATH', None))
225
+ args[0] = abs_path or args[0]
226
+
227
+ try:
228
+ return subprocess.call(args, close_fds=False,
229
+ env=devenv,
230
+ cwd=workdir)
231
+ except subprocess.CalledProcessError as e:
232
+ return e.returncode
233
+ except FileNotFoundError:
234
+ raise MesonException(f'Command not found: {args[0]}')