okstra 0.130.4 → 0.131.1

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 (365) hide show
  1. package/README.md +0 -1
  2. package/docs/architecture.md +2 -2
  3. package/docs/cli.md +1 -1
  4. package/docs/for-ai/README.md +0 -2
  5. package/docs/for-ai/skills/okstra-run.md +13 -2
  6. package/docs/for-ai/skills/okstra-setup.md +4 -1
  7. package/docs/project-structure-overview.md +5 -4
  8. package/docs/task-process/implementation-planning.md +13 -0
  9. package/docs/task-process/implementation.md +17 -2
  10. package/package.json +1 -1
  11. package/runtime/BUILD.json +2 -2
  12. package/runtime/agents/workers/report-writer-worker.md +7 -0
  13. package/runtime/bin/lib/okstra/usage.sh +4 -4
  14. package/runtime/prompts/lead/okstra-lead-contract.md +2 -2
  15. package/runtime/prompts/lead/plan-body-verification.md +26 -5
  16. package/runtime/prompts/lead/report-writer.md +6 -2
  17. package/runtime/prompts/profiles/_common-contract.md +2 -1
  18. package/runtime/prompts/profiles/_implementation-deliverable.md +6 -1
  19. package/runtime/prompts/profiles/_implementation-executor.md +2 -2
  20. package/runtime/prompts/profiles/_implementation-verifier.md +33 -10
  21. package/runtime/prompts/profiles/final-verification.md +21 -6
  22. package/runtime/prompts/profiles/implementation-planning.md +16 -4
  23. package/runtime/python/okstra_ctl/codex_dispatch.py +31 -0
  24. package/runtime/python/okstra_ctl/conformance.py +49 -11
  25. package/runtime/python/okstra_ctl/report_finalize.py +52 -1
  26. package/runtime/python/okstra_ctl/run.py +15 -3
  27. package/runtime/python/okstra_ctl/worker_prompt_contract.py +14 -6
  28. package/runtime/python/okstra_ctl/worker_prompt_policy.py +19 -1
  29. package/runtime/python/okstra_vendor/__init__.py +0 -44
  30. package/runtime/schemas/final-report-v1.0.schema.json +99 -5
  31. package/runtime/skills/okstra-run/SKILL.md +11 -4
  32. package/runtime/skills/okstra-setup/SKILL.md +3 -2
  33. package/runtime/skills/okstra-setup/references/project-config.md +16 -7
  34. package/runtime/templates/reports/final-report.template.md +15 -9
  35. package/runtime/templates/reports/i18n/en.json +1 -0
  36. package/runtime/templates/reports/i18n/ko.json +1 -0
  37. package/runtime/validators/lib/fixtures.sh +6 -0
  38. package/runtime/validators/validate-run.py +2019 -96
  39. package/src/cli-registry.mjs +0 -7
  40. package/src/commands/lifecycle/doctor.mjs +0 -9
  41. package/src/lib/skill-catalog.mjs +0 -1
  42. package/docs/for-ai/skills/okstra-graphify.md +0 -64
  43. package/runtime/python/okstra_ctl/graphify_cmd.py +0 -225
  44. package/runtime/python/okstra_vendor/graphify/.vendored-version +0 -1
  45. package/runtime/python/okstra_vendor/graphify/__init__.py +0 -28
  46. package/runtime/python/okstra_vendor/graphify/__main__.py +0 -1371
  47. package/runtime/python/okstra_vendor/graphify/analyze.py +0 -540
  48. package/runtime/python/okstra_vendor/graphify/benchmark.py +0 -129
  49. package/runtime/python/okstra_vendor/graphify/build.py +0 -107
  50. package/runtime/python/okstra_vendor/graphify/cache.py +0 -169
  51. package/runtime/python/okstra_vendor/graphify/cluster.py +0 -137
  52. package/runtime/python/okstra_vendor/graphify/detect.py +0 -510
  53. package/runtime/python/okstra_vendor/graphify/export.py +0 -1014
  54. package/runtime/python/okstra_vendor/graphify/extract.py +0 -3277
  55. package/runtime/python/okstra_vendor/graphify/hooks.py +0 -220
  56. package/runtime/python/okstra_vendor/graphify/ingest.py +0 -297
  57. package/runtime/python/okstra_vendor/graphify/manifest.py +0 -4
  58. package/runtime/python/okstra_vendor/graphify/report.py +0 -175
  59. package/runtime/python/okstra_vendor/graphify/security.py +0 -203
  60. package/runtime/python/okstra_vendor/graphify/serve.py +0 -373
  61. package/runtime/python/okstra_vendor/graphify/skill-aider.md +0 -1184
  62. package/runtime/python/okstra_vendor/graphify/skill-claw.md +0 -1184
  63. package/runtime/python/okstra_vendor/graphify/skill-codex.md +0 -1242
  64. package/runtime/python/okstra_vendor/graphify/skill-copilot.md +0 -1268
  65. package/runtime/python/okstra_vendor/graphify/skill-droid.md +0 -1239
  66. package/runtime/python/okstra_vendor/graphify/skill-kiro.md +0 -1183
  67. package/runtime/python/okstra_vendor/graphify/skill-opencode.md +0 -1238
  68. package/runtime/python/okstra_vendor/graphify/skill-trae.md +0 -1208
  69. package/runtime/python/okstra_vendor/graphify/skill-vscode.md +0 -253
  70. package/runtime/python/okstra_vendor/graphify/skill-windows.md +0 -1245
  71. package/runtime/python/okstra_vendor/graphify/skill.md +0 -1319
  72. package/runtime/python/okstra_vendor/graphify/transcribe.py +0 -182
  73. package/runtime/python/okstra_vendor/graphify/validate.py +0 -72
  74. package/runtime/python/okstra_vendor/graphify/watch.py +0 -188
  75. package/runtime/python/okstra_vendor/graphify/wiki.py +0 -214
  76. package/runtime/python/okstra_vendor/networkx/__init__.py +0 -62
  77. package/runtime/python/okstra_vendor/networkx/algorithms/__init__.py +0 -134
  78. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/__init__.py +0 -26
  79. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/clique.py +0 -259
  80. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/clustering_coefficient.py +0 -71
  81. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/connectivity.py +0 -412
  82. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/density.py +0 -396
  83. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/distance_measures.py +0 -150
  84. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/dominating_set.py +0 -149
  85. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/kcomponents.py +0 -369
  86. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/matching.py +0 -44
  87. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/maxcut.py +0 -143
  88. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/ramsey.py +0 -53
  89. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/steinertree.py +0 -265
  90. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/traveling_salesman.py +0 -1508
  91. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/treewidth.py +0 -255
  92. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/vertex_cover.py +0 -83
  93. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/__init__.py +0 -5
  94. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/connectivity.py +0 -122
  95. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/correlation.py +0 -302
  96. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/mixing.py +0 -255
  97. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/neighbor_degree.py +0 -160
  98. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/pairs.py +0 -127
  99. package/runtime/python/okstra_vendor/networkx/algorithms/asteroidal.py +0 -164
  100. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/__init__.py +0 -88
  101. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/basic.py +0 -322
  102. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/centrality.py +0 -290
  103. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/cluster.py +0 -289
  104. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/covering.py +0 -57
  105. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/edgelist.py +0 -360
  106. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/extendability.py +0 -105
  107. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/generators.py +0 -603
  108. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/link_analysis.py +0 -316
  109. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/matching.py +0 -590
  110. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/matrix.py +0 -232
  111. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/projection.py +0 -526
  112. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/redundancy.py +0 -112
  113. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/spectral.py +0 -69
  114. package/runtime/python/okstra_vendor/networkx/algorithms/boundary.py +0 -168
  115. package/runtime/python/okstra_vendor/networkx/algorithms/bridges.py +0 -205
  116. package/runtime/python/okstra_vendor/networkx/algorithms/broadcasting.py +0 -164
  117. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/__init__.py +0 -20
  118. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/betweenness.py +0 -591
  119. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/betweenness_subset.py +0 -236
  120. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/closeness.py +0 -282
  121. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_betweenness.py +0 -364
  122. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_betweenness_subset.py +0 -227
  123. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_closeness.py +0 -96
  124. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/degree_alg.py +0 -150
  125. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/dispersion.py +0 -107
  126. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/eigenvector.py +0 -357
  127. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/flow_matrix.py +0 -130
  128. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/group.py +0 -787
  129. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/harmonic.py +0 -88
  130. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/katz.py +0 -331
  131. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/laplacian.py +0 -150
  132. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/load.py +0 -200
  133. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/percolation.py +0 -128
  134. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/reaching.py +0 -209
  135. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/second_order.py +0 -141
  136. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/subgraph_alg.py +0 -361
  137. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/trophic.py +0 -181
  138. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/voterank_alg.py +0 -95
  139. package/runtime/python/okstra_vendor/networkx/algorithms/chains.py +0 -172
  140. package/runtime/python/okstra_vendor/networkx/algorithms/chordal.py +0 -443
  141. package/runtime/python/okstra_vendor/networkx/algorithms/clique.py +0 -818
  142. package/runtime/python/okstra_vendor/networkx/algorithms/cluster.py +0 -732
  143. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/__init__.py +0 -4
  144. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/equitable_coloring.py +0 -505
  145. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/greedy_coloring.py +0 -565
  146. package/runtime/python/okstra_vendor/networkx/algorithms/communicability_alg.py +0 -163
  147. package/runtime/python/okstra_vendor/networkx/algorithms/community/__init__.py +0 -28
  148. package/runtime/python/okstra_vendor/networkx/algorithms/community/asyn_fluid.py +0 -153
  149. package/runtime/python/okstra_vendor/networkx/algorithms/community/bipartitions.py +0 -354
  150. package/runtime/python/okstra_vendor/networkx/algorithms/community/centrality.py +0 -171
  151. package/runtime/python/okstra_vendor/networkx/algorithms/community/community_utils.py +0 -30
  152. package/runtime/python/okstra_vendor/networkx/algorithms/community/divisive.py +0 -216
  153. package/runtime/python/okstra_vendor/networkx/algorithms/community/kclique.py +0 -79
  154. package/runtime/python/okstra_vendor/networkx/algorithms/community/label_propagation.py +0 -338
  155. package/runtime/python/okstra_vendor/networkx/algorithms/community/leiden.py +0 -162
  156. package/runtime/python/okstra_vendor/networkx/algorithms/community/local.py +0 -220
  157. package/runtime/python/okstra_vendor/networkx/algorithms/community/louvain.py +0 -384
  158. package/runtime/python/okstra_vendor/networkx/algorithms/community/lukes.py +0 -227
  159. package/runtime/python/okstra_vendor/networkx/algorithms/community/modularity_max.py +0 -452
  160. package/runtime/python/okstra_vendor/networkx/algorithms/community/quality.py +0 -347
  161. package/runtime/python/okstra_vendor/networkx/algorithms/components/__init__.py +0 -6
  162. package/runtime/python/okstra_vendor/networkx/algorithms/components/attracting.py +0 -115
  163. package/runtime/python/okstra_vendor/networkx/algorithms/components/biconnected.py +0 -394
  164. package/runtime/python/okstra_vendor/networkx/algorithms/components/connected.py +0 -282
  165. package/runtime/python/okstra_vendor/networkx/algorithms/components/semiconnected.py +0 -71
  166. package/runtime/python/okstra_vendor/networkx/algorithms/components/strongly_connected.py +0 -359
  167. package/runtime/python/okstra_vendor/networkx/algorithms/components/weakly_connected.py +0 -196
  168. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/__init__.py +0 -11
  169. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/connectivity.py +0 -811
  170. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/cuts.py +0 -616
  171. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/disjoint_paths.py +0 -408
  172. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/edge_augmentation.py +0 -1270
  173. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/edge_kcomponents.py +0 -592
  174. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/kcomponents.py +0 -220
  175. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/kcutsets.py +0 -235
  176. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/stoerwagner.py +0 -152
  177. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/utils.py +0 -88
  178. package/runtime/python/okstra_vendor/networkx/algorithms/core.py +0 -588
  179. package/runtime/python/okstra_vendor/networkx/algorithms/covering.py +0 -142
  180. package/runtime/python/okstra_vendor/networkx/algorithms/cuts.py +0 -416
  181. package/runtime/python/okstra_vendor/networkx/algorithms/cycles.py +0 -1234
  182. package/runtime/python/okstra_vendor/networkx/algorithms/d_separation.py +0 -677
  183. package/runtime/python/okstra_vendor/networkx/algorithms/dag.py +0 -1392
  184. package/runtime/python/okstra_vendor/networkx/algorithms/distance_measures.py +0 -1095
  185. package/runtime/python/okstra_vendor/networkx/algorithms/distance_regular.py +0 -272
  186. package/runtime/python/okstra_vendor/networkx/algorithms/dominance.py +0 -142
  187. package/runtime/python/okstra_vendor/networkx/algorithms/dominating.py +0 -268
  188. package/runtime/python/okstra_vendor/networkx/algorithms/efficiency_measures.py +0 -167
  189. package/runtime/python/okstra_vendor/networkx/algorithms/euler.py +0 -470
  190. package/runtime/python/okstra_vendor/networkx/algorithms/flow/__init__.py +0 -11
  191. package/runtime/python/okstra_vendor/networkx/algorithms/flow/boykovkolmogorov.py +0 -370
  192. package/runtime/python/okstra_vendor/networkx/algorithms/flow/capacityscaling.py +0 -407
  193. package/runtime/python/okstra_vendor/networkx/algorithms/flow/dinitz_alg.py +0 -238
  194. package/runtime/python/okstra_vendor/networkx/algorithms/flow/edmondskarp.py +0 -241
  195. package/runtime/python/okstra_vendor/networkx/algorithms/flow/gomory_hu.py +0 -178
  196. package/runtime/python/okstra_vendor/networkx/algorithms/flow/maxflow.py +0 -611
  197. package/runtime/python/okstra_vendor/networkx/algorithms/flow/mincost.py +0 -356
  198. package/runtime/python/okstra_vendor/networkx/algorithms/flow/networksimplex.py +0 -662
  199. package/runtime/python/okstra_vendor/networkx/algorithms/flow/preflowpush.py +0 -425
  200. package/runtime/python/okstra_vendor/networkx/algorithms/flow/shortestaugmentingpath.py +0 -300
  201. package/runtime/python/okstra_vendor/networkx/algorithms/flow/utils.py +0 -194
  202. package/runtime/python/okstra_vendor/networkx/algorithms/graph_hashing.py +0 -435
  203. package/runtime/python/okstra_vendor/networkx/algorithms/graphical.py +0 -483
  204. package/runtime/python/okstra_vendor/networkx/algorithms/hierarchy.py +0 -57
  205. package/runtime/python/okstra_vendor/networkx/algorithms/hybrid.py +0 -196
  206. package/runtime/python/okstra_vendor/networkx/algorithms/isolate.py +0 -107
  207. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/__init__.py +0 -7
  208. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/ismags.py +0 -1306
  209. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/isomorph.py +0 -336
  210. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/isomorphvf2.py +0 -1262
  211. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/matchhelpers.py +0 -352
  212. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/temporalisomorphvf2.py +0 -308
  213. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/tree_isomorphism.py +0 -264
  214. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/vf2pp.py +0 -1102
  215. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/vf2userfunc.py +0 -192
  216. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/__init__.py +0 -2
  217. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/hits_alg.py +0 -337
  218. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/pagerank_alg.py +0 -498
  219. package/runtime/python/okstra_vendor/networkx/algorithms/link_prediction.py +0 -687
  220. package/runtime/python/okstra_vendor/networkx/algorithms/lowest_common_ancestors.py +0 -280
  221. package/runtime/python/okstra_vendor/networkx/algorithms/matching.py +0 -1148
  222. package/runtime/python/okstra_vendor/networkx/algorithms/minors/__init__.py +0 -27
  223. package/runtime/python/okstra_vendor/networkx/algorithms/minors/contraction.py +0 -738
  224. package/runtime/python/okstra_vendor/networkx/algorithms/mis.py +0 -78
  225. package/runtime/python/okstra_vendor/networkx/algorithms/moral.py +0 -59
  226. package/runtime/python/okstra_vendor/networkx/algorithms/node_classification.py +0 -219
  227. package/runtime/python/okstra_vendor/networkx/algorithms/non_randomness.py +0 -155
  228. package/runtime/python/okstra_vendor/networkx/algorithms/operators/__init__.py +0 -4
  229. package/runtime/python/okstra_vendor/networkx/algorithms/operators/all.py +0 -324
  230. package/runtime/python/okstra_vendor/networkx/algorithms/operators/binary.py +0 -468
  231. package/runtime/python/okstra_vendor/networkx/algorithms/operators/product.py +0 -633
  232. package/runtime/python/okstra_vendor/networkx/algorithms/operators/unary.py +0 -77
  233. package/runtime/python/okstra_vendor/networkx/algorithms/perfect_graph.py +0 -73
  234. package/runtime/python/okstra_vendor/networkx/algorithms/planar_drawing.py +0 -464
  235. package/runtime/python/okstra_vendor/networkx/algorithms/planarity.py +0 -1463
  236. package/runtime/python/okstra_vendor/networkx/algorithms/polynomials.py +0 -306
  237. package/runtime/python/okstra_vendor/networkx/algorithms/reciprocity.py +0 -98
  238. package/runtime/python/okstra_vendor/networkx/algorithms/regular.py +0 -167
  239. package/runtime/python/okstra_vendor/networkx/algorithms/richclub.py +0 -138
  240. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/__init__.py +0 -5
  241. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/astar.py +0 -239
  242. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/dense.py +0 -264
  243. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/generic.py +0 -716
  244. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/unweighted.py +0 -625
  245. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/weighted.py +0 -2542
  246. package/runtime/python/okstra_vendor/networkx/algorithms/similarity.py +0 -2107
  247. package/runtime/python/okstra_vendor/networkx/algorithms/simple_paths.py +0 -966
  248. package/runtime/python/okstra_vendor/networkx/algorithms/smallworld.py +0 -404
  249. package/runtime/python/okstra_vendor/networkx/algorithms/smetric.py +0 -30
  250. package/runtime/python/okstra_vendor/networkx/algorithms/sparsifiers.py +0 -296
  251. package/runtime/python/okstra_vendor/networkx/algorithms/structuralholes.py +0 -374
  252. package/runtime/python/okstra_vendor/networkx/algorithms/summarization.py +0 -564
  253. package/runtime/python/okstra_vendor/networkx/algorithms/swap.py +0 -406
  254. package/runtime/python/okstra_vendor/networkx/algorithms/threshold.py +0 -981
  255. package/runtime/python/okstra_vendor/networkx/algorithms/time_dependent.py +0 -142
  256. package/runtime/python/okstra_vendor/networkx/algorithms/tournament.py +0 -406
  257. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/__init__.py +0 -5
  258. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/beamsearch.py +0 -90
  259. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/breadth_first_search.py +0 -576
  260. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/depth_first_search.py +0 -529
  261. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/edgebfs.py +0 -185
  262. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/edgedfs.py +0 -182
  263. package/runtime/python/okstra_vendor/networkx/algorithms/tree/__init__.py +0 -7
  264. package/runtime/python/okstra_vendor/networkx/algorithms/tree/branchings.py +0 -1042
  265. package/runtime/python/okstra_vendor/networkx/algorithms/tree/coding.py +0 -413
  266. package/runtime/python/okstra_vendor/networkx/algorithms/tree/decomposition.py +0 -88
  267. package/runtime/python/okstra_vendor/networkx/algorithms/tree/distance_measures.py +0 -219
  268. package/runtime/python/okstra_vendor/networkx/algorithms/tree/mst.py +0 -1281
  269. package/runtime/python/okstra_vendor/networkx/algorithms/tree/operations.py +0 -106
  270. package/runtime/python/okstra_vendor/networkx/algorithms/tree/recognition.py +0 -273
  271. package/runtime/python/okstra_vendor/networkx/algorithms/triads.py +0 -500
  272. package/runtime/python/okstra_vendor/networkx/algorithms/vitality.py +0 -76
  273. package/runtime/python/okstra_vendor/networkx/algorithms/voronoi.py +0 -86
  274. package/runtime/python/okstra_vendor/networkx/algorithms/walks.py +0 -77
  275. package/runtime/python/okstra_vendor/networkx/algorithms/wiener.py +0 -278
  276. package/runtime/python/okstra_vendor/networkx/classes/__init__.py +0 -13
  277. package/runtime/python/okstra_vendor/networkx/classes/coreviews.py +0 -435
  278. package/runtime/python/okstra_vendor/networkx/classes/digraph.py +0 -1363
  279. package/runtime/python/okstra_vendor/networkx/classes/filters.py +0 -95
  280. package/runtime/python/okstra_vendor/networkx/classes/function.py +0 -1549
  281. package/runtime/python/okstra_vendor/networkx/classes/graph.py +0 -2082
  282. package/runtime/python/okstra_vendor/networkx/classes/graphviews.py +0 -269
  283. package/runtime/python/okstra_vendor/networkx/classes/multidigraph.py +0 -977
  284. package/runtime/python/okstra_vendor/networkx/classes/multigraph.py +0 -1294
  285. package/runtime/python/okstra_vendor/networkx/classes/reportviews.py +0 -1447
  286. package/runtime/python/okstra_vendor/networkx/convert.py +0 -502
  287. package/runtime/python/okstra_vendor/networkx/convert_matrix.py +0 -1314
  288. package/runtime/python/okstra_vendor/networkx/drawing/__init__.py +0 -7
  289. package/runtime/python/okstra_vendor/networkx/drawing/layout.py +0 -2036
  290. package/runtime/python/okstra_vendor/networkx/drawing/nx_agraph.py +0 -470
  291. package/runtime/python/okstra_vendor/networkx/drawing/nx_latex.py +0 -570
  292. package/runtime/python/okstra_vendor/networkx/drawing/nx_pydot.py +0 -361
  293. package/runtime/python/okstra_vendor/networkx/drawing/nx_pylab.py +0 -2978
  294. package/runtime/python/okstra_vendor/networkx/exception.py +0 -131
  295. package/runtime/python/okstra_vendor/networkx/generators/__init__.py +0 -34
  296. package/runtime/python/okstra_vendor/networkx/generators/atlas.dat.gz +0 -0
  297. package/runtime/python/okstra_vendor/networkx/generators/atlas.py +0 -227
  298. package/runtime/python/okstra_vendor/networkx/generators/classic.py +0 -1091
  299. package/runtime/python/okstra_vendor/networkx/generators/cographs.py +0 -68
  300. package/runtime/python/okstra_vendor/networkx/generators/community.py +0 -1070
  301. package/runtime/python/okstra_vendor/networkx/generators/degree_seq.py +0 -886
  302. package/runtime/python/okstra_vendor/networkx/generators/directed.py +0 -572
  303. package/runtime/python/okstra_vendor/networkx/generators/duplication.py +0 -174
  304. package/runtime/python/okstra_vendor/networkx/generators/ego.py +0 -66
  305. package/runtime/python/okstra_vendor/networkx/generators/expanders.py +0 -499
  306. package/runtime/python/okstra_vendor/networkx/generators/geometric.py +0 -1037
  307. package/runtime/python/okstra_vendor/networkx/generators/harary_graph.py +0 -163
  308. package/runtime/python/okstra_vendor/networkx/generators/internet_as_graphs.py +0 -443
  309. package/runtime/python/okstra_vendor/networkx/generators/intersection.py +0 -125
  310. package/runtime/python/okstra_vendor/networkx/generators/interval_graph.py +0 -70
  311. package/runtime/python/okstra_vendor/networkx/generators/joint_degree_seq.py +0 -664
  312. package/runtime/python/okstra_vendor/networkx/generators/lattice.py +0 -405
  313. package/runtime/python/okstra_vendor/networkx/generators/line.py +0 -501
  314. package/runtime/python/okstra_vendor/networkx/generators/mycielski.py +0 -110
  315. package/runtime/python/okstra_vendor/networkx/generators/nonisomorphic_trees.py +0 -259
  316. package/runtime/python/okstra_vendor/networkx/generators/random_clustered.py +0 -117
  317. package/runtime/python/okstra_vendor/networkx/generators/random_graphs.py +0 -1416
  318. package/runtime/python/okstra_vendor/networkx/generators/small.py +0 -1070
  319. package/runtime/python/okstra_vendor/networkx/generators/social.py +0 -554
  320. package/runtime/python/okstra_vendor/networkx/generators/spectral_graph_forge.py +0 -120
  321. package/runtime/python/okstra_vendor/networkx/generators/stochastic.py +0 -54
  322. package/runtime/python/okstra_vendor/networkx/generators/sudoku.py +0 -131
  323. package/runtime/python/okstra_vendor/networkx/generators/time_series.py +0 -74
  324. package/runtime/python/okstra_vendor/networkx/generators/trees.py +0 -1070
  325. package/runtime/python/okstra_vendor/networkx/generators/triads.py +0 -94
  326. package/runtime/python/okstra_vendor/networkx/lazy_imports.py +0 -188
  327. package/runtime/python/okstra_vendor/networkx/linalg/__init__.py +0 -13
  328. package/runtime/python/okstra_vendor/networkx/linalg/algebraicconnectivity.py +0 -650
  329. package/runtime/python/okstra_vendor/networkx/linalg/attrmatrix.py +0 -466
  330. package/runtime/python/okstra_vendor/networkx/linalg/bethehessianmatrix.py +0 -77
  331. package/runtime/python/okstra_vendor/networkx/linalg/graphmatrix.py +0 -168
  332. package/runtime/python/okstra_vendor/networkx/linalg/laplacianmatrix.py +0 -512
  333. package/runtime/python/okstra_vendor/networkx/linalg/modularitymatrix.py +0 -166
  334. package/runtime/python/okstra_vendor/networkx/linalg/spectrum.py +0 -186
  335. package/runtime/python/okstra_vendor/networkx/readwrite/__init__.py +0 -17
  336. package/runtime/python/okstra_vendor/networkx/readwrite/adjlist.py +0 -330
  337. package/runtime/python/okstra_vendor/networkx/readwrite/edgelist.py +0 -489
  338. package/runtime/python/okstra_vendor/networkx/readwrite/gexf.py +0 -1084
  339. package/runtime/python/okstra_vendor/networkx/readwrite/gml.py +0 -879
  340. package/runtime/python/okstra_vendor/networkx/readwrite/graph6.py +0 -427
  341. package/runtime/python/okstra_vendor/networkx/readwrite/graphml.py +0 -1053
  342. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/__init__.py +0 -19
  343. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/adjacency.py +0 -156
  344. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/cytoscape.py +0 -190
  345. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/node_link.py +0 -261
  346. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/tree.py +0 -137
  347. package/runtime/python/okstra_vendor/networkx/readwrite/leda.py +0 -108
  348. package/runtime/python/okstra_vendor/networkx/readwrite/multiline_adjlist.py +0 -393
  349. package/runtime/python/okstra_vendor/networkx/readwrite/p2g.py +0 -113
  350. package/runtime/python/okstra_vendor/networkx/readwrite/pajek.py +0 -286
  351. package/runtime/python/okstra_vendor/networkx/readwrite/sparse6.py +0 -379
  352. package/runtime/python/okstra_vendor/networkx/readwrite/text.py +0 -851
  353. package/runtime/python/okstra_vendor/networkx/relabel.py +0 -285
  354. package/runtime/python/okstra_vendor/networkx/utils/__init__.py +0 -8
  355. package/runtime/python/okstra_vendor/networkx/utils/backends.py +0 -2171
  356. package/runtime/python/okstra_vendor/networkx/utils/configs.py +0 -396
  357. package/runtime/python/okstra_vendor/networkx/utils/decorators.py +0 -1233
  358. package/runtime/python/okstra_vendor/networkx/utils/heaps.py +0 -338
  359. package/runtime/python/okstra_vendor/networkx/utils/mapped_queue.py +0 -297
  360. package/runtime/python/okstra_vendor/networkx/utils/misc.py +0 -703
  361. package/runtime/python/okstra_vendor/networkx/utils/random_sequence.py +0 -198
  362. package/runtime/python/okstra_vendor/networkx/utils/rcm.py +0 -159
  363. package/runtime/python/okstra_vendor/networkx/utils/union_find.py +0 -106
  364. package/runtime/skills/okstra-graphify/SKILL.md +0 -169
  365. package/src/commands/graphify.mjs +0 -32
@@ -1,137 +0,0 @@
1
- from itertools import chain
2
-
3
- import networkx as nx
4
-
5
- __all__ = ["tree_data", "tree_graph"]
6
-
7
-
8
- def tree_data(G, root, ident="id", children="children"):
9
- """Returns data in tree format that is suitable for JSON serialization
10
- and use in JavaScript documents.
11
-
12
- Parameters
13
- ----------
14
- G : NetworkX graph
15
- G must be an oriented tree
16
-
17
- root : node
18
- The root of the tree
19
-
20
- ident : string
21
- Attribute name for storing NetworkX-internal graph data. `ident` must
22
- have a different value than `children`. The default is 'id'.
23
-
24
- children : string
25
- Attribute name for storing NetworkX-internal graph data. `children`
26
- must have a different value than `ident`. The default is 'children'.
27
-
28
- Returns
29
- -------
30
- data : dict
31
- A dictionary with node-link formatted data.
32
-
33
- Raises
34
- ------
35
- NetworkXError
36
- If `children` and `ident` attributes are identical.
37
-
38
- Examples
39
- --------
40
- >>> from networkx.readwrite import json_graph
41
- >>> G = nx.DiGraph([(1, 2)])
42
- >>> data = json_graph.tree_data(G, root=1)
43
-
44
- To serialize with json
45
-
46
- >>> import json
47
- >>> s = json.dumps(data)
48
-
49
- Notes
50
- -----
51
- Node attributes are stored in this format but keys
52
- for attributes must be strings if you want to serialize with JSON.
53
-
54
- Graph and edge attributes are not stored.
55
-
56
- See Also
57
- --------
58
- tree_graph, node_link_data, adjacency_data
59
- """
60
- if G.number_of_nodes() != G.number_of_edges() + 1:
61
- raise TypeError("G is not a tree.")
62
- if not G.is_directed():
63
- raise TypeError("G is not directed.")
64
- if not nx.is_weakly_connected(G):
65
- raise TypeError("G is not weakly connected.")
66
-
67
- if ident == children:
68
- raise nx.NetworkXError("The values for `id` and `children` must be different.")
69
-
70
- def add_children(n, G):
71
- nbrs = G[n]
72
- if len(nbrs) == 0:
73
- return []
74
- children_ = []
75
- for child in nbrs:
76
- d = {**G.nodes[child], ident: child}
77
- c = add_children(child, G)
78
- if c:
79
- d[children] = c
80
- children_.append(d)
81
- return children_
82
-
83
- return {**G.nodes[root], ident: root, children: add_children(root, G)}
84
-
85
-
86
- @nx._dispatchable(graphs=None, returns_graph=True)
87
- def tree_graph(data, ident="id", children="children"):
88
- """Returns graph from tree data format.
89
-
90
- Parameters
91
- ----------
92
- data : dict
93
- Tree formatted graph data
94
-
95
- ident : string
96
- Attribute name for storing NetworkX-internal graph data. `ident` must
97
- have a different value than `children`. The default is 'id'.
98
-
99
- children : string
100
- Attribute name for storing NetworkX-internal graph data. `children`
101
- must have a different value than `ident`. The default is 'children'.
102
-
103
- Returns
104
- -------
105
- G : NetworkX DiGraph
106
-
107
- Examples
108
- --------
109
- >>> from networkx.readwrite import json_graph
110
- >>> G = nx.DiGraph([(1, 2)])
111
- >>> data = json_graph.tree_data(G, root=1)
112
- >>> H = json_graph.tree_graph(data)
113
-
114
- See Also
115
- --------
116
- tree_data, node_link_data, adjacency_data
117
- """
118
- graph = nx.DiGraph()
119
-
120
- def add_children(parent, children_):
121
- for data in children_:
122
- child = data[ident]
123
- graph.add_edge(parent, child)
124
- grandchildren = data.get(children, [])
125
- if grandchildren:
126
- add_children(child, grandchildren)
127
- nodedata = {
128
- str(k): v for k, v in data.items() if k != ident and k != children
129
- }
130
- graph.add_node(child, **nodedata)
131
-
132
- root = data[ident]
133
- children_ = data.get(children, [])
134
- nodedata = {str(k): v for k, v in data.items() if k != ident and k != children}
135
- graph.add_node(root, **nodedata)
136
- add_children(root, children_)
137
- return graph
@@ -1,108 +0,0 @@
1
- """
2
- Read graphs in LEDA format.
3
-
4
- LEDA is a C++ class library for efficient data types and algorithms.
5
-
6
- Format
7
- ------
8
- See http://www.algorithmic-solutions.info/leda_guide/graphs/leda_native_graph_fileformat.html
9
-
10
- """
11
- # Original author: D. Eppstein, UC Irvine, August 12, 2003.
12
- # The original code at http://www.ics.uci.edu/~eppstein/PADS/ is public domain.
13
-
14
- __all__ = ["read_leda", "parse_leda"]
15
-
16
- import networkx as nx
17
- from networkx.exception import NetworkXError
18
- from networkx.utils import open_file
19
-
20
-
21
- @open_file(0, mode="rb")
22
- @nx._dispatchable(graphs=None, returns_graph=True)
23
- def read_leda(path, encoding="UTF-8"):
24
- """Read graph in LEDA format from path.
25
-
26
- Parameters
27
- ----------
28
- path : file or string
29
- Filename or file handle to read.
30
- Filenames ending in .gz or .bz2 will be decompressed.
31
-
32
- Returns
33
- -------
34
- G : NetworkX graph
35
-
36
- Examples
37
- --------
38
- >>> G = nx.read_leda("file.leda") # doctest: +SKIP
39
-
40
- References
41
- ----------
42
- .. [1] http://www.algorithmic-solutions.info/leda_guide/graphs/leda_native_graph_fileformat.html
43
- """
44
- lines = (line.decode(encoding) for line in path)
45
- G = parse_leda(lines)
46
- return G
47
-
48
-
49
- @nx._dispatchable(graphs=None, returns_graph=True)
50
- def parse_leda(lines):
51
- """Read graph in LEDA format from string or iterable.
52
-
53
- Parameters
54
- ----------
55
- lines : string or iterable
56
- Data in LEDA format.
57
-
58
- Returns
59
- -------
60
- G : NetworkX graph
61
-
62
- Examples
63
- --------
64
- >>> G = nx.parse_leda(string) # doctest: +SKIP
65
-
66
- References
67
- ----------
68
- .. [1] http://www.algorithmic-solutions.info/leda_guide/graphs/leda_native_graph_fileformat.html
69
- """
70
- if isinstance(lines, str):
71
- lines = iter(lines.split("\n"))
72
- lines = iter(
73
- [
74
- line.rstrip("\n")
75
- for line in lines
76
- if not (line.startswith(("#", "\n")) or line == "")
77
- ]
78
- )
79
- for i in range(3):
80
- next(lines)
81
- # Graph
82
- du = int(next(lines)) # -1=directed, -2=undirected
83
- if du == -1:
84
- G = nx.DiGraph()
85
- else:
86
- G = nx.Graph()
87
-
88
- # Nodes
89
- n = int(next(lines)) # number of nodes
90
- node = {}
91
- for i in range(1, n + 1): # LEDA counts from 1 to n
92
- symbol = next(lines).rstrip().strip("|{}| ")
93
- if symbol == "":
94
- symbol = str(i) # use int if no label - could be trouble
95
- node[i] = symbol
96
-
97
- G.add_nodes_from([s for i, s in node.items()])
98
-
99
- # Edges
100
- m = int(next(lines)) # number of edges
101
- for i in range(m):
102
- try:
103
- s, t, reversal, label = next(lines).split()
104
- except BaseException as err:
105
- raise NetworkXError(f"Too few fields in LEDA.GRAPH edge {i + 1}") from err
106
- # BEWARE: no handling of reversal edges
107
- G.add_edge(node[int(s)], node[int(t)], label=label[2:-2])
108
- return G
@@ -1,393 +0,0 @@
1
- """
2
- *************************
3
- Multi-line Adjacency List
4
- *************************
5
- Read and write NetworkX graphs as multi-line adjacency lists.
6
-
7
- The multi-line adjacency list format is useful for graphs with
8
- nodes that can be meaningfully represented as strings. With this format
9
- simple edge data can be stored but node or graph data is not.
10
-
11
- Format
12
- ------
13
- The first label in a line is the source node label followed by the node degree
14
- d. The next d lines are target node labels and optional edge data.
15
- That pattern repeats for all nodes in the graph.
16
-
17
- The graph with edges a-b, a-c, d-e can be represented as the following
18
- adjacency list (anything following the # in a line is a comment)::
19
-
20
- # example.multiline-adjlist
21
- a 2
22
- b
23
- c
24
- d 1
25
- e
26
- """
27
-
28
- __all__ = [
29
- "generate_multiline_adjlist",
30
- "write_multiline_adjlist",
31
- "parse_multiline_adjlist",
32
- "read_multiline_adjlist",
33
- ]
34
-
35
- import networkx as nx
36
- from networkx.utils import open_file
37
-
38
-
39
- def generate_multiline_adjlist(G, delimiter=" "):
40
- """Generate a single line of the graph G in multiline adjacency list format.
41
-
42
- Parameters
43
- ----------
44
- G : NetworkX graph
45
-
46
- delimiter : string, optional
47
- Separator for node labels
48
-
49
- Returns
50
- -------
51
- lines : string
52
- Lines of data in multiline adjlist format.
53
-
54
- Examples
55
- --------
56
- >>> G = nx.lollipop_graph(4, 3)
57
- >>> for line in nx.generate_multiline_adjlist(G):
58
- ... print(line)
59
- 0 3
60
- 1 {}
61
- 2 {}
62
- 3 {}
63
- 1 2
64
- 2 {}
65
- 3 {}
66
- 2 1
67
- 3 {}
68
- 3 1
69
- 4 {}
70
- 4 1
71
- 5 {}
72
- 5 1
73
- 6 {}
74
- 6 0
75
-
76
- See Also
77
- --------
78
- write_multiline_adjlist, read_multiline_adjlist
79
- """
80
- if G.is_directed():
81
- if G.is_multigraph():
82
- for s, nbrs in G.adjacency():
83
- nbr_edges = [
84
- (u, data)
85
- for u, datadict in nbrs.items()
86
- for key, data in datadict.items()
87
- ]
88
- deg = len(nbr_edges)
89
- yield str(s) + delimiter + str(deg)
90
- for u, d in nbr_edges:
91
- if d is None:
92
- yield str(u)
93
- else:
94
- yield str(u) + delimiter + str(d)
95
- else: # directed single edges
96
- for s, nbrs in G.adjacency():
97
- deg = len(nbrs)
98
- yield str(s) + delimiter + str(deg)
99
- for u, d in nbrs.items():
100
- if d is None:
101
- yield str(u)
102
- else:
103
- yield str(u) + delimiter + str(d)
104
- else: # undirected
105
- if G.is_multigraph():
106
- seen = set() # helper dict used to avoid duplicate edges
107
- for s, nbrs in G.adjacency():
108
- nbr_edges = [
109
- (u, data)
110
- for u, datadict in nbrs.items()
111
- if u not in seen
112
- for key, data in datadict.items()
113
- ]
114
- deg = len(nbr_edges)
115
- yield str(s) + delimiter + str(deg)
116
- for u, d in nbr_edges:
117
- if d is None:
118
- yield str(u)
119
- else:
120
- yield str(u) + delimiter + str(d)
121
- seen.add(s)
122
- else: # undirected single edges
123
- seen = set() # helper dict used to avoid duplicate edges
124
- for s, nbrs in G.adjacency():
125
- nbr_edges = [(u, d) for u, d in nbrs.items() if u not in seen]
126
- deg = len(nbr_edges)
127
- yield str(s) + delimiter + str(deg)
128
- for u, d in nbr_edges:
129
- if d is None:
130
- yield str(u)
131
- else:
132
- yield str(u) + delimiter + str(d)
133
- seen.add(s)
134
-
135
-
136
- @open_file(1, mode="wb")
137
- def write_multiline_adjlist(G, path, delimiter=" ", comments="#", encoding="utf-8"):
138
- """Write the graph G in multiline adjacency list format to path
139
-
140
- Parameters
141
- ----------
142
- G : NetworkX graph
143
-
144
- path : string or file
145
- Filename or file handle to write to.
146
- Filenames ending in .gz or .bz2 will be compressed.
147
-
148
- comments : string, optional
149
- Marker for comment lines
150
-
151
- delimiter : string, optional
152
- Separator for node labels
153
-
154
- encoding : string, optional
155
- Text encoding.
156
-
157
- Examples
158
- --------
159
- >>> G = nx.path_graph(4)
160
- >>> nx.write_multiline_adjlist(G, "test.multi_adjlist")
161
-
162
- The path can be a file handle or a string with the name of the file. If a
163
- file handle is provided, it has to be opened in 'wb' mode.
164
-
165
- >>> fh = open("test.multi_adjlist2", "wb")
166
- >>> nx.write_multiline_adjlist(G, fh)
167
-
168
- Filenames ending in .gz or .bz2 will be compressed.
169
-
170
- >>> nx.write_multiline_adjlist(G, "test.multi_adjlist.gz")
171
-
172
- See Also
173
- --------
174
- read_multiline_adjlist
175
- """
176
- import sys
177
- import time
178
-
179
- pargs = comments + " ".join(sys.argv)
180
- header = (
181
- f"{pargs}\n"
182
- + comments
183
- + f" GMT {time.asctime(time.gmtime())}\n"
184
- + comments
185
- + f" {G.name}\n"
186
- )
187
- path.write(header.encode(encoding))
188
-
189
- for multiline in generate_multiline_adjlist(G, delimiter):
190
- multiline += "\n"
191
- path.write(multiline.encode(encoding))
192
-
193
-
194
- @nx._dispatchable(graphs=None, returns_graph=True)
195
- def parse_multiline_adjlist(
196
- lines, comments="#", delimiter=None, create_using=None, nodetype=None, edgetype=None
197
- ):
198
- """Parse lines of a multiline adjacency list representation of a graph.
199
-
200
- Parameters
201
- ----------
202
- lines : list or iterator of strings
203
- Input data in multiline adjlist format
204
-
205
- create_using : NetworkX graph constructor, optional (default=nx.Graph)
206
- Graph type to create. If graph instance, then cleared before populated.
207
-
208
- nodetype : Python type, optional
209
- Convert nodes to this type.
210
-
211
- edgetype : Python type, optional
212
- Convert edges to this type.
213
-
214
- comments : string, optional
215
- Marker for comment lines
216
-
217
- delimiter : string, optional
218
- Separator for node labels. The default is whitespace.
219
-
220
- Returns
221
- -------
222
- G: NetworkX graph
223
- The graph corresponding to the lines in multiline adjacency list format.
224
-
225
- Examples
226
- --------
227
- >>> lines = [
228
- ... "1 2",
229
- ... "2 {'weight':3, 'name': 'Frodo'}",
230
- ... "3 {}",
231
- ... "2 1",
232
- ... "5 {'weight':6, 'name': 'Saruman'}",
233
- ... ]
234
- >>> G = nx.parse_multiline_adjlist(iter(lines), nodetype=int)
235
- >>> list(G)
236
- [1, 2, 3, 5]
237
-
238
- """
239
- from ast import literal_eval
240
-
241
- G = nx.empty_graph(0, create_using)
242
- for line in lines:
243
- p = line.find(comments)
244
- if p >= 0:
245
- line = line[:p]
246
- if not line:
247
- continue
248
- try:
249
- (u, deg) = line.rstrip("\n").split(delimiter)
250
- deg = int(deg)
251
- except BaseException as err:
252
- raise TypeError(f"Failed to read node and degree on line ({line})") from err
253
- if nodetype is not None:
254
- try:
255
- u = nodetype(u)
256
- except BaseException as err:
257
- raise TypeError(
258
- f"Failed to convert node ({u}) to type {nodetype}"
259
- ) from err
260
- G.add_node(u)
261
- for i in range(deg):
262
- while True:
263
- try:
264
- line = next(lines)
265
- except StopIteration as err:
266
- msg = f"Failed to find neighbor for node ({u})"
267
- raise TypeError(msg) from err
268
- p = line.find(comments)
269
- if p >= 0:
270
- line = line[:p]
271
- if line:
272
- break
273
- vlist = line.rstrip("\n").split(delimiter)
274
- numb = len(vlist)
275
- if numb < 1:
276
- continue # isolated node
277
- v = vlist.pop(0)
278
- data = "".join(vlist)
279
- if nodetype is not None:
280
- try:
281
- v = nodetype(v)
282
- except BaseException as err:
283
- raise TypeError(
284
- f"Failed to convert node ({v}) to type {nodetype}"
285
- ) from err
286
- if edgetype is not None:
287
- try:
288
- edgedata = {"weight": edgetype(data)}
289
- except BaseException as err:
290
- raise TypeError(
291
- f"Failed to convert edge data ({data}) to type {edgetype}"
292
- ) from err
293
- else:
294
- try: # try to evaluate
295
- edgedata = literal_eval(data)
296
- except:
297
- edgedata = {}
298
- G.add_edge(u, v, **edgedata)
299
-
300
- return G
301
-
302
-
303
- @open_file(0, mode="rb")
304
- @nx._dispatchable(graphs=None, returns_graph=True)
305
- def read_multiline_adjlist(
306
- path,
307
- comments="#",
308
- delimiter=None,
309
- create_using=None,
310
- nodetype=None,
311
- edgetype=None,
312
- encoding="utf-8",
313
- ):
314
- """Read graph in multi-line adjacency list format from path.
315
-
316
- Parameters
317
- ----------
318
- path : string or file
319
- Filename or file handle to read.
320
- Filenames ending in .gz or .bz2 will be decompressed.
321
-
322
- create_using : NetworkX graph constructor, optional (default=nx.Graph)
323
- Graph type to create. If graph instance, then cleared before populated.
324
-
325
- nodetype : Python type, optional
326
- Convert nodes to this type.
327
-
328
- edgetype : Python type, optional
329
- Convert edge data to this type.
330
-
331
- comments : string, optional
332
- Marker for comment lines
333
-
334
- delimiter : string, optional
335
- Separator for node labels. The default is whitespace.
336
-
337
- Returns
338
- -------
339
- G: NetworkX graph
340
-
341
- Examples
342
- --------
343
- >>> G = nx.path_graph(4)
344
- >>> nx.write_multiline_adjlist(G, "test.multi_adjlistP4")
345
- >>> G = nx.read_multiline_adjlist("test.multi_adjlistP4")
346
-
347
- The path can be a file or a string with the name of the file. If a
348
- file s provided, it has to be opened in 'rb' mode.
349
-
350
- >>> fh = open("test.multi_adjlistP4", "rb")
351
- >>> G = nx.read_multiline_adjlist(fh)
352
-
353
- Filenames ending in .gz or .bz2 will be compressed.
354
-
355
- >>> nx.write_multiline_adjlist(G, "test.multi_adjlistP4.gz")
356
- >>> G = nx.read_multiline_adjlist("test.multi_adjlistP4.gz")
357
-
358
- The optional nodetype is a function to convert node strings to nodetype.
359
-
360
- For example
361
-
362
- >>> G = nx.read_multiline_adjlist("test.multi_adjlistP4", nodetype=int)
363
-
364
- will attempt to convert all nodes to integer type.
365
-
366
- The optional edgetype is a function to convert edge data strings to
367
- edgetype.
368
-
369
- >>> G = nx.read_multiline_adjlist("test.multi_adjlistP4")
370
-
371
- The optional create_using parameter is a NetworkX graph container.
372
- The default is Graph(), an undirected graph. To read the data as
373
- a directed graph use
374
-
375
- >>> G = nx.read_multiline_adjlist("test.multi_adjlistP4", create_using=nx.DiGraph)
376
-
377
- Notes
378
- -----
379
- This format does not store graph, node, or edge data.
380
-
381
- See Also
382
- --------
383
- write_multiline_adjlist
384
- """
385
- lines = (line.decode(encoding) for line in path)
386
- return parse_multiline_adjlist(
387
- lines,
388
- comments=comments,
389
- delimiter=delimiter,
390
- create_using=create_using,
391
- nodetype=nodetype,
392
- edgetype=edgetype,
393
- )