proj-flow 0.8.1__py3-none-any.whl → 0.9.0__py3-none-any.whl

{proj_flow-0.8.1.dist-info → proj_flow-0.9.0.dist-info}/RECORD

@@ -1,42 +1,60 @@
-proj_flow/__init__.py,sha256=Lh2jArf2EmXH0Aec0Q7ry2LNqIvlqj3fdsYGLfp01Pg,124
-proj_flow/__main__.py,sha256=zEdZML8h5AC9CcRXlHszmPrWzpuDSabCy69I6u1uqH8,225
-proj_flow/api/__init__.py,sha256=LnGn-VFMnHYIeTqvk6Wu9OzpPvlO5lWAGCSsbHowUtg,323
-proj_flow/api/arg.py,sha256=y2rhFdYqXYfKK21d0Syu3XsWKxigbyLI_1ZNMXC4CNo,3918
+proj_flow/__init__.py,sha256=UtRFdb2fvniMm_xApll78tgH4iEnAWu1dCbELDj2dbw,124
+proj_flow/__main__.py,sha256=xpK1_avlRKlSw55135IAmaTfRKt344-qkJrVFz45ogM,229
+proj_flow/api/__init__.py,sha256=gV2f6kll_5JXtvkGASvnx7CbOWr34PHOdck-4ce-qEk,378
+proj_flow/api/arg.py,sha256=J7_53noW7t8VJ9sfJiX4qaPs7KqWfMHNcrWYe1jIq-g,4097
 proj_flow/api/completers.py,sha256=NapNVu6QAQ_iF6dqcAzOV5kDHKD9MAMVX209Bklq-Mw,2464
 proj_flow/api/ctx.py,sha256=AXZSnfLO9w7Uiqa8VtrTzLnNegVZru2sn1-WON3RIyg,5847
-proj_flow/api/env.py,sha256=dkKWMaC2dp8h5C_WCE6ScpQjDEoboIvhl6DEcWgpX-Y,11577
+proj_flow/api/env.py,sha256=bFDHuFtUR-zEh7fTrEoPFobBLx2W4ZIl4TGJ8E9s5mM,10909
 proj_flow/api/init.py,sha256=an0czDiPCDqW4Bp0I8sGQgaAlDAozLO0ZYnP149lWqk,521
 proj_flow/api/makefile.py,sha256=hNKKe1Mf0V8JZl7yNLn5BJfHXJtjREqDVZ7JDRLkE4M,3858
-proj_flow/api/step.py,sha256=k4pP6y5ZM24Hi-slBDrhPexqadLsA3LhExUETq9MX2s,4298
-proj_flow/base/__init__.py,sha256=CItXenFNfglnmNSyY7QOZ358BvXCqVbPx4olFwxhLQo,289
+proj_flow/api/release.py,sha256=A-t4qcjeaptEgfBCZs2Q9cOjsGACrNM0CzmCorms0U4,2401
+proj_flow/api/step.py,sha256=PAqLBkQkUVQETrBvHjI6_-PAkh4Q7KLPMBUOWqW_jbk,4580
+proj_flow/base/__init__.py,sha256=RRmqiYjdVlC4i8QijXHNiRh9yzNH8305WXezrSaPjKk,311
 proj_flow/base/cmd.py,sha256=Vo3e8kd4CHRzbsUkO-MnbhQxjLXTczv7YQRUkFlcBQE,1560
-proj_flow/base/inspect.py,sha256=W08uHxLUku3j2F7Um5wGyQIIl6xx7ZP4AuKvMg0yK2U,3498
+proj_flow/base/inspect.py,sha256=lt5P19rvSZ-wMCTrCYAaQFCt2S9fUjEQXlrKK-Tmvwc,2786
 proj_flow/base/matrix.py,sha256=8XBFGYOwW6Myt_4h3WNk36V2bJ5xeqUv6DvzF4B3q_g,7767
-proj_flow/base/plugins.py,sha256=k_gj45lOxHTDe3baYJmmMzl5jMQIlti3CnwgzBcO5rw,1305
+proj_flow/base/plugins.py,sha256=ZH8p16eeqdf7r99IHPEzvTxATXonj3QSwnYhEPtJSvE,2089
+proj_flow/base/registry.py,sha256=0OdNeeZmek1CecR0yMRAcKc7zHtQ6kpKTBPdfdV8iRo,2933
 proj_flow/base/uname.py,sha256=7Awb3Es0jTAKMpyRawdrC16xc5X9M97BlPqEfQibqIk,2295
-proj_flow/flow/__init__.py,sha256=I_QIjtZKMc1rFdfXEUvY13XjU7gNexqtnXfutn9r1P0,347
-proj_flow/flow/configs.py,sha256=vE9TQg_kSqU9BhHYXZpgwaSgVRi5OJUt-JBJfZ0k3s8,4976
-proj_flow/flow/dependency.py,sha256=D6NdEtNqga4c3ppyctl9_Z2qyJVQkzDTl1linzmtxuc,4526
+proj_flow/cli/__init__.py,sha256=IpNnnr3ZOzwCmdhAzzruA8Sms04U1thdJjUvU6qpRH8,1270
+proj_flow/cli/argument.py,sha256=RFBOpeTqyUGM0KvnyKA-lzfUfZpXE-mJl9RcoQzRciY,13661
+proj_flow/cli/finder.py,sha256=5x7H1nH0k63DetDauhB_wABel_f0RQpsZ5YnhPfbkRc,1402
+proj_flow/ext/__init__.py,sha256=XD52rUFTPz3GnyRq6KZUNeWdMce7e0bB19iTx-zU6DE,169
+proj_flow/ext/markdown_changelist.py,sha256=P6FSfX2yD62Zm5_KnNDKo2XB-K_7rLZsXPcs6xH87xo,351
+proj_flow/ext/re_structured_changelist.py,sha256=u1mNCvntGRf-r6ti1fRVe-99IgWbxb5htfjzyeVml_0,360
+proj_flow/ext/github/__init__.py,sha256=_ujB0X99q0DYWMwL1H4TiYyxTzKsE_2Pvzwva91_jrw,260
+proj_flow/ext/github/cli.py,sha256=JyvEjDKf5eSQuGep7VnEPAJKaUOWSdEudSYWkNCMBjk,3430
+proj_flow/ext/github/hosting.py,sha256=3iW8QjeJk7MyqKNbv92nB-5a_Yn_B5_eEIlw_cdgUT0,519
+proj_flow/ext/python/__init__.py,sha256=GbEKEJJZ3PJ4sRHEykAWjGIR6yyyrYdlUFulldvsAGI,252
+proj_flow/ext/python/rtdocs.py,sha256=MliuI8GJ0lP7Azyeqt6qCMKLVOy0h7RdTwJbkw2Oc4c,6350
+proj_flow/ext/python/steps.py,sha256=pDHGAe_CDzzdRFAzM1AIBvkbc14KB3SNUunusKZAaaY,1815
+proj_flow/ext/python/version.py,sha256=d8cY36bJYkNNH_JQcj6v-DnBLeT2CsyIzj_nz76MUBU,3182
+proj_flow/flow/__init__.py,sha256=Y1MfQsrbk_dIT6pn7c9YIlqsEUZj4Q9n_oIGtbnhIP4,339
+proj_flow/flow/configs.py,sha256=l-pIotrXFm4oMqqpuvKP-RdtlTmDDnK_izhTJfsWbhk,5260
+proj_flow/flow/dependency.py,sha256=5o_-5Soc2e1tOu5mwvkXa6jqDFplZi_chN8edkR6vVY,4644
 proj_flow/flow/init.py,sha256=9k3cgVmmeOKtH6mJ0nc4IOmI48oXvtYXFYWx2rj60-M,1777
 proj_flow/flow/interact.py,sha256=AJknpCxk3C39GhsR6BjH5QDk33KouWCZbHEUFLjvfGc,4166
 proj_flow/flow/layer.py,sha256=6mvbhiOy9KcMP69Q9zew_7jGhf5Wqr7v-veS3YPGnmc,5720
-proj_flow/flow/steps.py,sha256=7e1sm3mQZEOPCBkcld0zygaufJ6iOxi_ZBACLCbKzxA,2926
-proj_flow/flow/cli/__init__.py,sha256=kEAm-mKbAQf5CrMy3PJh-c6RgI2tB6CH0O1vg5HH8v0,1643
-proj_flow/flow/cli/cmds.py,sha256=V3I5z4I0wdQ92n-Zn0F_YYc7pPwC47bcDw-k8261DJ4,12562
-proj_flow/flow/cli/finder.py,sha256=IrncoWzntQjBMaVLBLyEhqg7_cnrYjFseQXDaMxGRog,1407
-proj_flow/log/__init__.py,sha256=jVVE9hgi6x9QazO9qI07AJZ_c4KCDcsk-Ye5N4CT5XY,318
-proj_flow/log/commit.py,sha256=oO6rnELiMCGRc86szzW2vr7P5iiiI-w9zXCF2bEOL20,12746
+proj_flow/flow/steps.py,sha256=PN_C_B6vNvqOsjpDpa5ESvH30Sc6RM1fSSqWqXgqg-4,2804
+proj_flow/log/__init__.py,sha256=02EIgasE-K7mmbbNiIdX0IebWQMp2Co_D6H4ZBhJgcs,365
+proj_flow/log/commit.py,sha256=MQhx5ZIeVQ3_8o4w2giLNTVn6Ig-cUGxTDQhlJoN6Ig,13060
+proj_flow/log/error.py,sha256=65Nvhfs_d1xSY4EB-ISdWgjotvg-on3iKjhAWHpsBYM,841
 proj_flow/log/fmt.py,sha256=o14aO3iEt5_KKp9SqcfkscqbMKuTI83NBoSXHcrb7Kg,330
 proj_flow/log/format.py,sha256=gp1kUoW0nYj5e7Ysu1c29Fh2ssfE1KBSDIYeUbhzN9g,333
-proj_flow/log/msg.py,sha256=HiQDDQos9BAas95lZcUA3KgINnwyIUq9fId7BlqCE8c,6120
-proj_flow/log/release.py,sha256=hCiB8j7VjjBz2Y04XBW5sia-Qzf3DhiHSGj8TtHw9hU,902
+proj_flow/log/msg.py,sha256=zARmRZHFV3yG-fBnx00wal4Y0O5aGnL-6XcGwNBNKA4,6758
+proj_flow/log/release.py,sha256=Sv9IPtZizJqHtJVdvx2TCt-a1PNSaFnWPHo2CQaDaC8,3837
 proj_flow/log/hosting/__init__.py,sha256=9Teyw8jJcxeWH2MegqYEgW0n5OmSAWC7FFJj2u_UcrM,278
-proj_flow/log/hosting/github.py,sha256=Q1-o6gM5a-_TbRh3pKXxb2PP51aplTfwzVcm2glGdP0,6726
-proj_flow/log/rich_text/__init__.py,sha256=R375_KjoE2zXZvOAdrj7OM3DEOunqDiKQmYTKnhvH0U,647
-proj_flow/log/rich_text/api.py,sha256=ieoM98T5rI4_MkHUdCxffqCoTdBt2ho9viN6e-b92VQ,3414
+proj_flow/log/hosting/github.py,sha256=-13krmAqTWcOQ21ZPSrMeZ4ipmgBSMCgoVk9AstpsvQ,6747
+proj_flow/log/rich_text/__init__.py,sha256=D3Y2jy9xlGgnQZdNC_ekoLzQtwkF_NTgLqDTWPvSRUk,279
+proj_flow/log/rich_text/api.py,sha256=PCSAGwkmDUMoVlpN7BDsgIA1AiMZEC0H6TUZXpr_Mg8,3571
 proj_flow/log/rich_text/markdown.py,sha256=GVDH7hONyATRG4FyXkSvprEzxikRXiErGyINjiJfQx8,1618
 proj_flow/log/rich_text/re_structured_text.py,sha256=zDx4KQQy1RzYhzTfnldwCYIxl-jypyDBYOwNKP1SqN4,1818
-proj_flow/plugins/__init__.py,sha256=wKR7pMk2bhBUWzc46oc6-WJHCuWnxwx3xHpb65peV5o,304
+proj_flow/minimal/__init__.py,sha256=VsIdoFE0RRXueJf4-fVJF15iukkZUiysJsr8sTb9XIs,326
+proj_flow/minimal/bootstrap.py,sha256=PcZfBsUmj8uDPGBC55iUgD5O7W4VSkpCQb6r9GEyAaQ,556
+proj_flow/minimal/list.py,sha256=RlOqammE8olNKXsnbv1enF5uriu0MZ2wFbht37Z2ETw,4810
+proj_flow/minimal/run.py,sha256=fkirdYeWb36SFXqIq5NQEflIv0HdjNhaTpmsutzWwXA,4691
+proj_flow/minimal/system.py,sha256=9FliH5TD103JYSAe2O5EU7hkOHDgVzTqu0Exxk-WrXE,1579
+proj_flow/plugins/__init__.py,sha256=nJQiXQU2zOiM_mafqoBsCu3ivpuA_o2vAOPk4HdfBvY,308
 proj_flow/plugins/base.py,sha256=yDAn7417DazBXMzZpZs8wv1DNY_9EjqtkWRq2IOF_Oo,736
 proj_flow/plugins/github.py,sha256=hcC-le-suTxlX929wzwvghtNFSqiVn5VCcVoLDeMHj4,402
 proj_flow/plugins/cmake/__init__.py,sha256=Mk4Rm6Pqv7Jkd27cSfoP90bhVv4fxMcg3Rr0fNNJ63c,386
@@ -48,11 +66,7 @@ proj_flow/plugins/cmake/pack.py,sha256=2rBaPePbqJn55pFBAkPQSjQJeK14HWfu6ogu9ZtVP
 proj_flow/plugins/cmake/parser.py,sha256=MA1PB1lWybDC0YGYhaXEuHawGRPRRsjpJJ4qFqkDf8U,4223
 proj_flow/plugins/cmake/test.py,sha256=POUa5QBb9mTTCYhS7wLjkqtVRiFGoJxD8O556bDYHXs,790
 proj_flow/plugins/commands/__init__.py,sha256=-5jT0bfrrGds3TbAOIRZOFJjH2Q8IUKDzm02Ac7PO_4,298
-proj_flow/plugins/commands/bootstrap.py,sha256=Lqp15skMXaH0OOUvXIWRSfGiR3WfELMgdhLGIc3Na2U,570
 proj_flow/plugins/commands/init.py,sha256=MrdxMv9G-0oYZgLk5OOKjd36Z-b55mdJaTV9ix3va9o,2090
-proj_flow/plugins/commands/list.py,sha256=1hRgPamQmNulxwVHCtd8rA3wEQQdLMWozPLdj9ULsog,4733
-proj_flow/plugins/commands/run.py,sha256=yMyT37U2QXVNWC-CEJEOoMtBU-O1mTMmXC1Z1ArOOxc,4434
-proj_flow/plugins/commands/system.py,sha256=VsfC3O7PrgVCtrgJwvmR4e7ggmt0puLSTC0NTH6Qbl8,1593
 proj_flow/plugins/commands/ci/__init__.py,sha256=4PkKCd2HoCHypAzO7GZatCkrV0fteLWdoICviQXoyAg,369
 proj_flow/plugins/commands/ci/changelog.py,sha256=Q2f-JGuFxmK0IJg7K8RN3z_Rv_29haexgoFQWUysUM0,1296
 proj_flow/plugins/commands/ci/matrix.py,sha256=tjEpyCTdNvIY4xvyGNy5KffCkmOXnVUUXVTds9WeDeA,1362
@@ -77,10 +91,10 @@ proj_flow/template/layers/base/flow,sha256=aPBLCgYNAZFl3FcP3HPwPnUxuRGxeV1Dp_6qF
 proj_flow/template/layers/base/flow.cmd,sha256=LQplRzLw4n86xvMXxOd1SzH2xJAN71Ou1uWsST8D6Ik,239
 proj_flow/template/layers/base/.flow/config.yml,sha256=7dc7u0FVBWP0nwOCzWNHEGeOM_APR467vyMuT_Mjfto,773
 proj_flow/template/layers/base/.flow/flow.py.mustache,sha256=UpCW3-DVa3d_4XmVkmzQu_L6vfiDr7RGUJiyFz5ykRM,4679
-proj_flow/template/layers/base/.flow/matrix.yml,sha256=yk8kU8GhDcAE6FdX9ty-yyJCCDTVBKu1AlaDQwsQhbQ,1259
+proj_flow/template/layers/base/.flow/matrix.yml,sha256=XgDC-F8YfeZEILBwHPkGNeRCxgaDK79f-JoWfHlVrgc,1257
 proj_flow/template/layers/base/.flow/official.yml,sha256=2nQgxoQJ5IAnPQVn50LrVD0B2p9KpLYSVz1b7IFu0Zc,71
 proj_flow/template/layers/cmake/CMakeGraphVizOptions.cmake,sha256=lAuNOIFDOAPnU_Zfz0ZCxephIp2bqteVlMSsuVg0BTM,368
-proj_flow/template/layers/cmake/CMakeLists.txt.mustache,sha256=anZ6ym-bMFpJ-kgscLFB2vwH3EIJAn3lYlqPXr_xGcU,6257
+proj_flow/template/layers/cmake/CMakeLists.txt.mustache,sha256=qZ7LQcBG5-jUq69ZoGxpHTH3nYLLbUnXNeDJvwEGZ8Y,6251
 proj_flow/template/layers/cmake/CMakePresets.json,sha256=B6j0Cxh_l8QfxHNV1IIWoGyMBz4unVHyAGbUUKJWBFM,5487
 proj_flow/template/layers/cmake/.flow/cmake/common.cmake.mustache,sha256=ntar1ypWUH10JwrebdrnOjQz0Nk8KpDyE6Qh4M2y86I,1053
 proj_flow/template/layers/cmake/.flow/extensions/wall/__init__.py.mustache,sha256=oEnCHoU4KtUZb-4SX3ld255jHT06nEx7pS6gW-w-zIc,127
@@ -108,19 +122,19 @@ proj_flow/template/layers/conan/.flow/cmake/output_dirs_setup.cmake,sha256=-GSDi
 proj_flow/template/layers/github_actions/CPPLINT.cfg,sha256=JX88FBnJ3pECU0QS-8CjOfvWo_my6lSgX8kc1oi-mmY,385
 proj_flow/template/layers/github_actions/.github/linters/.isort.cfg,sha256=9gpUkeq6rXGxXeeokeGkTDjOBvDpdlcup8ipxCpJQ9s,79
 proj_flow/template/layers/github_actions/.github/linters/.mypy.ini,sha256=13DnGOzVFyXtkXH-48LlblCLfiXc2Xbzk78pllCKbSo,37
-proj_flow/template/layers/github_actions/.github/workflows/build.yml,sha256=OKrcUpfBCqPKKSoc7SmUD13UoVZQbVjWxk0RMVPw-A8,8170
+proj_flow/template/layers/github_actions/.github/workflows/build.yml,sha256=K1a_bk3ybA2NfVazDQNvInVHHSD4lG-zxaRSuDjw994,8166
 proj_flow/template/layers/github_actions/.github/workflows/linter.yml,sha256=Ffg-ptQ9kjw4X0UyQax9-3AMIP2H62ikDkbgPi0ypeM,1545
 proj_flow/template/layers/github_social/CODE_OF_CONDUCT.md.mustache,sha256=XzXW9p1pX7AA5DcWW7cz-Onrxa0J32WclgCYWeYLT3Y,3347
 proj_flow/template/layers/github_social/CONTRIBUTING.md,sha256=nw1FZgDtKXubnRqvBaQgSmUqpsvDy_433VGmy5W-BH4,239
 proj_flow/template/layers/github_social/.github/ISSUE_TEMPLATE/bug_report.md.mustache,sha256=n1O-WANLPD3hMBLKXB_jwuFIb6xQ77elaVjqasRQwp4,1041
-proj_flow/template/layers/github_social/.github/ISSUE_TEMPLATE/feature_request.md.mustache,sha256=xlMU9LV_Qf-Khuq_nuR678LmHDVCauWq_BTLF2yKMcU,844
+proj_flow/template/layers/github_social/.github/ISSUE_TEMPLATE/feature_request.md.mustache,sha256=scmkwO5qgwX0HkoAhUybnbZOWZ1-tEViR1A7378LdcA,843
 proj_flow/template/licenses/0BSD.mustache,sha256=GXHBGk29Tviv6M-ysTRNH_IHh7j8CKBGCPAMG7zXZSY,651
 proj_flow/template/licenses/MIT.mustache,sha256=NncPoQaNsuy-WmRmboik3fyhJJ8m5pc2RVsfeelYA9s,1081
 proj_flow/template/licenses/Unlicense.mustache,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
 proj_flow/template/licenses/WTFPL.mustache,sha256=lvF4V_PrKKfZPa2TC8CZo8tlqaKvs3Bpv9G6XsWWQ4k,483
 proj_flow/template/licenses/Zlib.mustache,sha256=uIj-mhSjes2HJ3rRapyy2ALflKRz4xQgS4mVM9827C0,868
-proj_flow-0.8.1.dist-info/METADATA,sha256=Dsb9gCw7eHcm0vX3so_wAMfoiN8PvDNWzRCkfZQ4DW4,2744
-proj_flow-0.8.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-proj_flow-0.8.1.dist-info/entry_points.txt,sha256=_NJZ0JMtHVvk7EBQnxuIUSPSgQDAdtrVmqzt5Z7T9k8,54
-proj_flow-0.8.1.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
-proj_flow-0.8.1.dist-info/RECORD,,
+proj_flow-0.9.0.dist-info/METADATA,sha256=ApEM1wxQjZ2gejY6uTBx0FbkJCl-iwOp8TKjLoScf7c,2780
+proj_flow-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+proj_flow-0.9.0.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
+proj_flow-0.9.0.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
+proj_flow-0.9.0.dist-info/RECORD,,

proj_flow-0.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+proj-flow = proj_flow.cli:main

proj_flow/flow/cli/__init__.py

@@ -1,66 +0,0 @@
-# PYTHON_ARGCOMPLETE_OK
-
-# Copyright (c) 2025 Marcin Zdun
-# This code is licensed under MIT license (see LICENSE for details)
-
-"""
-The **proj_flow.flow.cli** provides command-line entry for the *C++ flow*.
-"""
-
-import argparse
-import os
-import sys
-from typing import Dict, List, cast
-
-from proj_flow import __version__
-from proj_flow.api import env
-from proj_flow.flow import steps
-from proj_flow.flow.cli import cmds, finder
-
-
-def _change_dir():
-    root = argparse.ArgumentParser(
-        prog="proj-flow",
-        usage="proj-flow [-h] [--version] [-C [dir]] {command} ...",
-        add_help=False,
-    )
-    root.add_argument("-C", dest="cd", nargs="?")
-
-    args, _ = root.parse_known_args()
-    if args.cd:
-        os.chdir(args.cd)
-
-
-def _expand_shortcuts(parser: argparse.ArgumentParser, args: argparse.Namespace):
-    args_kwargs = dict(args._get_kwargs())
-    shortcuts: Dict[str, List[str]] = parser.shortcuts  # type: ignore
-    for key in shortcuts:
-        try:
-            if not args_kwargs[key]:
-                continue
-            cast(List[str], args.configs).extend(shortcuts[key])
-            break
-        except KeyError:
-            continue
-
-
-def __main():
-    _change_dir()
-
-    flow_cfg = env.FlowConfig(root=finder.autocomplete.find_project())
-    steps.clean_aliases(flow_cfg)
-
-    parser = cmds.build_argparser(flow_cfg)
-    finder.autocomplete(parser)
-    args = parser.parse_args()
-    _expand_shortcuts(parser, args)
-
-    sys.exit(cmds.BuiltinEntry.run_entry(args, flow_cfg))
-
-
-def main():
-    """Entry point for *C++ flow* tool."""
-    try:
-        __main()
-    except KeyboardInterrupt:
-        sys.exit(1)

proj_flow/flow/cli/cmds.py

@@ -1,385 +0,0 @@
-# Copyright (c) 2025 Marcin Zdun
-# This code is licensed under MIT license (see LICENSE for details)
-
-"""
-The **proj_flow.flow.cli.cmds** provides command-line builders and runners,
-supporting the functions defined in :mod:`proj_flow.commands`.
-"""
-
-import argparse
-import typing
-from dataclasses import dataclass, field
-from typing import Dict, List, Optional, Tuple, Union, cast
-
-from proj_flow import __version__
-from proj_flow.api import arg, completers, env
-from proj_flow.base import inspect as _inspect
-from proj_flow.flow.configs import Configs
-
-
-def build_argparser(flow_cfg: env.FlowConfig):
-    parser = argparse.ArgumentParser(
-        prog="proj-flow",
-        description="C++ project maintenance, automated",
-        add_help=False,
-    )
-    parser.add_argument(
-        "-h", "--help", action="help", help="Show this help message and exit"
-    )
-    parser.add_argument(
-        "-v",
-        "--version",
-        action="version",
-        default=argparse.SUPPRESS,
-        version=f"%(prog)s version {__version__}",
-        help="Show proj-flow's version and exit",
-    )
-    parser.add_argument(
-        "-C",
-        metavar="dir",
-        nargs="?",
-        help="Run as if proj-flow was started in <dir> instead of the current "
-        "working directory. This directory must exist.",
-    ).completer = completers.cd_completer  # type: ignore
-
-    BuiltinEntry.visit_all(parser, flow_cfg)
-    return parser
-
-
-@dataclass
-class SpecialArg:
-    name: str
-    ctor: callable  # type: ignore
-
-    def create(self, rt: env.Runtime, args: argparse.Namespace):
-        if self.ctor == env.Runtime:
-            return rt
-        return self.ctor(rt, args)
-
-
-@dataclass
-class EntryArg:
-    name: str
-    argument: arg.Argument
-
-    def visit(self, parser: argparse.ArgumentParser):
-        return self.argument.visit(parser, self.name)
-
-
-@dataclass
-class BuiltinEntry:
-    name: str
-    doc: str
-    entry: callable  # type: ignore
-    args: List[EntryArg]
-    additional: List[SpecialArg]
-    children: List["BuiltinEntry"] = field(default_factory=list)
-
-    @staticmethod
-    def run_entry(args: argparse.Namespace, cfg: env.FlowConfig):
-        builtin_entries = {entry.name for entry in command_list}
-        aliases = cfg.aliases
-
-        rt = env.Runtime(args, cfg)
-
-        if args.command in builtin_entries:
-            command = first(lambda command: command.name == args.command, command_list)
-            if command:
-                return command.run(args, rt)
-        elif args.command in {alias.name for alias in aliases}:
-            command = first(lambda command: command.name == "run", command_list)
-            alias = first(lambda alias: alias.name == args.command, aliases)
-            if command and alias:
-                args.cli_steps.append(",".join(alias.steps))
-                return command.run(args, rt)
-
-        print("known commands:")
-        for command in command_list:
-            print(f"   {command.name}: {command.doc}")
-        for alias in aliases:
-            print(f"   {alias.name}: {alias.doc}")
-        return 1
-
-    def run(self, args: argparse.Namespace, rt: env.Runtime, level=0):
-        if level == 0 and rt.only_host:
-            rt.only_host = self.name == "run"
-
-        subcommand_name = None
-
-        if len(self.children):
-            subcommand_attribute = f"command_{level}"
-            if hasattr(args, subcommand_attribute):
-                subcommand_name = getattr(args, subcommand_attribute)
-
-        if subcommand_name is not None:
-            subcommand = first(
-                lambda command: command.name == subcommand_name, self.children
-            )
-            if not subcommand:
-                return 1
-            return subcommand.run(args, rt, level=level + 1)
-
-        kwargs = {}
-        for arg in self.args:
-            kwargs[arg.name] = getattr(args, arg.name, None)
-
-        for additional in self.additional:
-            arg = additional.create(rt, args)
-            kwargs[additional.name] = arg
-
-        result = self.entry(**kwargs)
-        return 0 if result is None else result
-
-    @staticmethod
-    def visit_all(parser: argparse.ArgumentParser, cfg: env.FlowConfig):
-        global command_list
-        command_list = BuiltinEntry.build_menu(arg.get_commands().subs)
-        shortcut_configs = BuiltinEntry.build_shortcuts(cfg)
-
-        parser.flow = cfg  # type: ignore
-        parser.shortcuts = shortcut_configs  # type: ignore
-
-        subparsers = parser.add_subparsers(
-            dest="command", metavar="{command}", help="Known command name, see below"
-        )
-
-        subparsers.parent = parser  # type: ignore
-
-        run: Optional[BuiltinEntry] = None
-        for entry in command_list:
-            entry.visit(subparsers)
-            if entry.name == "run":
-                run = entry
-
-        if run is not None and len(cfg.aliases) > 0:
-            builtin_entries = {entry.name for entry in command_list}
-            cfg.aliases = [
-                alias for alias in cfg.aliases if alias.name not in builtin_entries
-            ]
-            for alias in cfg.aliases:
-                run.visit(subparsers, alias=alias.name, doc=alias.doc)
-        else:
-            cfg.aliases = []
-
-    def visit(
-        self,
-        subparsers,
-        alias: Optional[str] = None,
-        doc: Optional[str] = None,
-        level=0,
-    ):
-        if not doc:
-            doc = self.doc
-        if not alias:
-            alias = self.name
-
-        parser: argparse.ArgumentParser = subparsers.add_parser(
-            alias, help=doc.split("\n\n")[0], description=doc, add_help=False
-        )
-
-        parent = getattr(subparsers, "parent")
-        parser.flow = getattr(parent, "flow")  # type: ignore
-        parser.shortcuts = getattr(parent, "shortcuts")  # type: ignore
-
-        assert parent.flow is not None
-        assert parent.shortcuts is not None
-
-        parser.add_argument(
-            "-h",
-            "--help",
-            action="help",
-            default=argparse.SUPPRESS,
-            help="Show this help message and exit",
-        )
-
-        parser.add_argument(
-            "--dry-run",
-            action="store_true",
-            required=False,
-            help="Print steps and commands, do nothing",
-        )
-
-        verbosity = parser.add_mutually_exclusive_group()
-        verbosity.add_argument(
-            "--silent",
-            action="store_true",
-            required=False,
-            help="Remove most of the output",
-        )
-        verbosity.add_argument(
-            "--verbose",
-            action="store_true",
-            required=False,
-            help="Add even more output",
-        )
-
-        has_config = False
-        for additional in self.additional:
-            if additional.ctor == Configs:
-                has_config = True
-                break
-
-        if has_config:
-            parser.add_argument(
-                "-D",
-                dest="configs",
-                metavar="key=value",
-                nargs="*",
-                action="store",
-                default=[],
-                help="Run only builds on matching configs. The key is one of "
-                'the keys into "matrix" object in .flow/matrix.yml definition '
-                "and the value is one of the possible values for that key. In "
-                "case of boolean flags, such as sanitizer, the true value is "
-                'one of "true", "on", "yes", "1" and "with-<key>", '
-                'i.e. "with-sanitizer" for sanitizer.'
-                " "
-                "If given key is never used, all values from .flow/matrix.yaml "
-                "for that key are used. Otherwise, only values from command "
-                "line are used.",
-            ).completer = completers.matrix_completer  # type: ignore
-
-            parser.add_argument(
-                "--official",
-                action="store_true",
-                required=False,
-                help="Cut matrix to release builds only",
-            )
-
-            if len(parser.shortcuts):  # type: ignore
-                group = parser.add_mutually_exclusive_group()
-
-                for shortcut_name in sorted(parser.shortcuts.keys()):  # type: ignore
-                    config = parser.shortcuts[shortcut_name]  # type: ignore
-                    group.add_argument(
-                        f"--{shortcut_name}",
-                        required=False,
-                        action="store_true",
-                        help=f'Shortcut for "-D {" ".join(config)}"',
-                    )
-
-        for arg in self.args:
-            arg.visit(parser)
-
-        if len(self.children):
-            subparsers = parser.add_subparsers(
-                dest=f"command_{level}",
-                metavar="{command}",
-                help="Known command name, see below",
-            )
-            subparsers.parent = parser  # type: ignore
-
-            for entry in self.children:
-                entry.visit(subparsers, level=level + 1)
-
-    @staticmethod
-    def build_shortcuts(cfg: env.FlowConfig) -> Dict[str, List[str]]:
-        shortcut_configs: Dict[str, List[str]] = {}
-        args: List[Tuple[str, List[str], bool, bool]] = []
-
-        shortcuts = cfg.shortcuts
-        for shortcut_name in sorted(shortcuts.keys()):
-            has_os = False
-            has_compiler = False
-            shortcut = shortcuts[shortcut_name]
-            config: List[str] = []
-            for key in sorted(shortcut.keys()):
-                has_os = has_os or key == "os"
-                has_compiler = has_compiler or key == "os"
-                value = shortcut[key]
-                if isinstance(value, list):
-                    for v in value:
-                        config.append(f"{key}={_shortcut_value(v)}")
-                else:
-                    config.append(f"{key}={_shortcut_value(value)}")
-            if len(config) > 0:
-                args.append((shortcut_name, config, has_os, has_compiler))
-
-        if len(args):
-            os_prefix = f"os={env.platform}"
-            compiler_prefix = f"compiler={env.default_compiler()}"
-
-            for shortcut_name, config, has_os, has_compiler in args:
-                if not has_compiler:
-                    config.insert(0, compiler_prefix)
-                if not has_os:
-                    config.insert(0, os_prefix)
-                shortcut_configs[shortcut_name] = config
-
-        return shortcut_configs
-
-    @staticmethod
-    def build_menu(commands: Dict[str, arg._Command]):
-        result: List[BuiltinEntry] = []
-        for cmd in commands.values():
-            name = cmd.name
-            doc = cmd.doc or ""
-            entry = cmd.entry or (lambda: 0)
-            children = BuiltinEntry.build_menu(cmd.subs)
-
-            args = _extract_args(entry)
-            special_args = [entry for entry in args if isinstance(entry, SpecialArg)]
-            entry_args = [entry for entry in args if isinstance(entry, EntryArg)]
-
-            result.append(
-                BuiltinEntry(
-                    name=name,
-                    doc=doc,
-                    entry=entry,
-                    args=entry_args,
-                    additional=special_args,
-                    children=children,
-                )
-            )
-
-        return result
-
-
-def _shortcut_value(value) -> str:
-    if isinstance(value, bool):
-        return "ON" if value else "OFF"
-    return str(value)
-
-
-def _extract_arg(argument: _inspect.Argument):
-    for ctor in [Configs, env.Runtime]:
-        if argument.type is ctor:
-            return SpecialArg(argument.name, ctor)
-
-    metadata: Optional[arg.Argument] = first(
-        lambda meta: isinstance(meta, arg.Argument), argument.metadata
-    )
-
-    if metadata is None or argument.type is None:
-        return None
-
-    optional = metadata.opt
-    if optional is None:
-        optional = typing.get_origin(argument.type) is Union and type(
-            None
-        ) in typing.get_args(argument.type)
-    metadata.opt = optional
-
-    return EntryArg(argument.name, metadata)
-
-
-AnArg = Union[EntryArg, SpecialArg]
-
-
-def _extract_args(entry: callable):  # type: ignore
-    args_with_possible_nones = map(_extract_arg, _inspect.signature(entry))
-    args = filter(lambda item: item is not None, args_with_possible_nones)
-    return cast(List[AnArg], list(args))
-
-
-T = typing.TypeVar("T")
-
-
-def first(fltr: typing.Callable[[T], bool], items: typing.Iterable[T]) -> Optional[T]:
-    try:
-        return next(filter(fltr, items))
-    except StopIteration:
-        return None
-
-
-command_list: List[BuiltinEntry] = []

proj_flow-0.8.1.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-proj-flow = proj_flow.flow.cli:main