machineconfig 1.96__py3-none-any.whl → 1.97__py3-none-any.whl

machineconfig/scripts/linux/mcinit

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+. $HOME/scripts/activate_ve 've'
+
+# Generate random string of length 5
+random_str=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 10 | head -n 1)
+export op_script=$HOME/tmp_results/shells/$random_str/python_return_command.sh
+# op_script=$HOME/tmp_results/shells/$random_str/python_return_command.sh
+
+if [ -f "$op_script" ]; then
+  rm $op_script
+fi
+
+
+python -m machineconfig.scripts.python.ai.init "$@"
+
+if [ -f "$op_script" ]; then
+  echo "Running $op_script"
+  chmod +x $op_script
+  set --  # clear all positional parameters
+  source $op_script  # sourcing the script means the args passed to the this script are passed to the sourced script which cofuses the sources script as it contains activate_ve and it doesn't understand first.sh arguments.
+fi
+
+
+if [ -n "$VIRTUAL_ENV" ]; then
+  deactivate || true
+fi

machineconfig/scripts/python/ai/init.py

@@ -0,0 +1,56 @@
+
+
+from pathlib import Path
+from git import Repo
+
+# def add_config_for_curor(repo_root: Path, config_f):
+
+def add_ai_configs(repo_root: Path):
+    import machineconfig as mc
+    mc_root = Path(mc.__file__).parent
+
+    try:
+        _repo_obj = Repo(repo_root)
+    except Exception as e:
+        print(f"Error initializing git repo: {e}")
+        return
+
+    rules_dir = mc_root.joinpath("scripts/python/ai/rules")
+
+    python_rules_file = rules_dir.joinpath("python/dev.md")
+
+    tmp = repo_root.joinpath(".cursor/rules/python_dev.mdc")
+    tmp.parent.mkdir(parents=True, exist_ok=True)
+    tmp.write_text(data=python_rules_file.read_text(), encoding="utf-8")
+
+    # as per: https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
+    # Copilot Chat on github website chat
+    tmp = repo_root.joinpath(".github/copilot-instructions.md")
+    tmp.parent.mkdir(parents=True, exist_ok=True)
+    tmp.write_text(data=python_rules_file.read_text(), encoding="utf-8")
+
+    tmp = repo_root.joinpath(".github/instructions/python01.instructions.md")
+    tmp.parent.mkdir(parents=True, exist_ok=True)
+    tmp.write_text(data=python_rules_file.read_text(), encoding="utf-8")
+
+    tmp = repo_root.joinpath("CLAUDE.md")
+    tmp.write_text(data=python_rules_file.read_text(), encoding="utf-8")
+    tmp = repo_root.joinpath("GEMINI.md")
+    tmp.write_text(data=python_rules_file.read_text(), encoding="utf-8")
+
+    dot_ai_dir = repo_root.joinpath(".ai")
+    dot_ai_dir.mkdir(parents=True, exist_ok=True)
+    dot_git_ignore_path = dot_ai_dir.joinpath(".gitignore")
+    if dot_git_ignore_path.exists():
+        dot_git_ignore_content = dot_git_ignore_path.read_text(encoding="utf-8")
+        to_add: list[str] = []
+        if ".links" not in dot_git_ignore_content: to_add.append(".links")
+        if "notebooks" not in dot_git_ignore_content: to_add.append("notebooks")
+        if ".ai" not in dot_git_ignore_content: to_add.append(".ai")
+        # if "*.ipynb"
+        if len(to_add) > 0:
+            dot_git_ignore_path.write_text(data=dot_git_ignore_content + "\n" + "\n".join(to_add), encoding="utf-8")
+
+
+if __name__ == "__main__":
+    add_ai_configs(repo_root=Path.cwd())

machineconfig/scripts/python/ai/rules/python/dev.md

@@ -0,0 +1,31 @@
+
+
+Hello
+=====
+
+
+# Development Environment and tooling:
+* To initialize a python project, use `uv init --python 3.13`
+* To create virtual env, use `uv venv`.
+* Please run any python file using `uv run $file.py`
+* Same for tools, e.g. `un run python pytest blah`
+* To add a package, use `uv add <package_name>`.
+    * Please never mention versions of package, so uv will bring the latest.
+    * On this note, I have to say that I am seriously concerned about AI using very outdated coding style.
+        * Use python 3.13 syntax features.
+        * Use modern standards, e.g. Path from pathlib.
+
+* Never touch `pyproject.toml` manually, this file is strictly managed by `uv` tool on your behalf.
+* If you are writing a test or any temporary script for discovering or undestanding something as an intermediate step, then,
+  please keep all your temp scripts and files under ./.ai/tmp_scripts directory, its included in .gitignore and won't litter the repo.
+  Its also nice if you create a subdirectory therein to contain relevant files for the task at hand, to avoid confusion with other files from other ai agents working simulataneously on other things.
+
+# Style
+* Please type hint all the code. Use fully quilaified types, not just generics like dict, list, etc, rather dict[str, int], list[float], etc.
+* Use triple quotes and triple double quotes f-strings for string formatting and avoid when possible all goofy escaping when interpolation.
+* Make sure all the code is rigorous, no lazy stuff.
+    * For example, always avoid default values in arguments of functions. Those are evil and cause confusion. Always be explicit
+* Please avoid writing READMe files and avoid docstring and comments in code unless absolutely necessary. Use clear naming conventions instead of documenting.
+
+# Preferences:
+* If needed, opt for polars not pandas, whenever possible.

machineconfig/scripts/python/fire_jobs.py

@@ -30,7 +30,8 @@ def main() -> None:
     parser = argparse.ArgumentParser()
     parser.add_argument("path",     nargs='?', type=str, help="The directory containing the jobs", default=".")
     parser.add_argument("function", nargs='?', type=str, help="Fuction to run", default=None)
-    # parser.add_argument("--function", "-f", type=str, help="The function to run", default="")
+
+    parser.add_argument("--init", "-I", type=str, help="init this repo", default="")
     parser.add_argument("--ve",              "-v", type=str, help="virtual enviroment name", default="")
     parser.add_argument("--cmd",             "-B", action="store_true", help="Create a cmd fire command to launch the the job asynchronously.")
     parser.add_argument("--interactive",     "-i", action="store_true", help="Whether to run the job interactively using IPython")
@@ -57,7 +58,12 @@ def main() -> None:
         print(f"❌ Failed to parse arguments: {ex}")
         parser.print_help()
         raise ex
-    path_obj = sanitize_path(PathExtended(args.path))
+    path_obj = sanitize_path(PathExtended.cwd())
+
+    if args.init != "":
+        from machineconfig.scripts.python.ai.init import add_ai_configs
+        add_ai_configs(repo_root=path_obj)
+
     if not path_obj.exists():
         path_obj = match_file_name(sub_string=args.path, search_root=PathExtended.cwd())
     else: pass

machineconfig/scripts/windows/mcinit.ps1

@@ -0,0 +1,4 @@
+
+. "$HOME\scripts\activate_ve.ps1" ve
+python -m machineconfig.scripts.python.ai.init $args
+deactivate -ErrorAction SilentlyContinue

{machineconfig-1.96.dist-info → machineconfig-1.97.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 1.96
+Version: 1.97
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-1.96.dist-info → machineconfig-1.97.dist-info}/RECORD

@@ -152,6 +152,7 @@ machineconfig/scripts/linux/fzfg,sha256=ClGnJZUsIk4y0qs3W5iXGo-nd0FaqAHMsnh8uoXQ
 machineconfig/scripts/linux/fzfrga,sha256=xSdws6ae28ZXkkqz_uupZ0MYw_vxE2qpLT2DLS3WITM,460
 machineconfig/scripts/linux/gh_models,sha256=dcq6BLN5kU9Q_BSbXQJay0aFgKqnXnTZwlp9HZ-SMfE,167
 machineconfig/scripts/linux/kill_process,sha256=lZ6LDzBPonQrVxCoc0R4HWW9x9hb5L5KjBhWugnxDNU,213
+machineconfig/scripts/linux/mcinit,sha256=Oa1glh79q85Tx5ewI_dryHNH20KmMi58RlqQ0sczTg0,832
 machineconfig/scripts/linux/mount_drive,sha256=zemKofv7hOmRN_V3qK0q580GkfWw3VdikyVVQyiu8j8,3514
 machineconfig/scripts/linux/mount_nfs,sha256=HLWF7ocUjuDXaFFtOzEA9JlROTcsbDEhgosBdBpBUUA,2061
 machineconfig/scripts/linux/mount_nw_drive,sha256=fZWV2x7Slne2c0NU-65qXBmTIeJNvjAHY-NqkDgoq1U,2527
@@ -189,7 +190,7 @@ machineconfig/scripts/python/devops_devapps_install.py,sha256=xddA4qmdYoMKnSR2eR
 machineconfig/scripts/python/devops_update_repos.py,sha256=B6p9hCV4nVYGqYsWnu4i-Myne0k0V3rpXYqkTEl6gsQ,3921
 machineconfig/scripts/python/dotfile.py,sha256=qq59lrE2JWCsD79cSqhbAy2IqCw2s-gWA_8YWKYi8Jc,2169
 machineconfig/scripts/python/fire_agents.py,sha256=zSQ_ap7ToVzAcdGinAPdRWa50gJzpFMJa5JFnIOydJQ,3241
-machineconfig/scripts/python/fire_jobs.py,sha256=X89GGaNlC0hImuawr2O-SYB14KWk4w4-Y1YVnDe2N_s,19603
+machineconfig/scripts/python/fire_jobs.py,sha256=ooZZkh-TMB_jmxuU-to-aDmP9rCbcpCSWSXlsGR8_a8,19729
 machineconfig/scripts/python/ftpx.py,sha256=EGslb07y4fVVTlm5MFwQUJWej7ucN9TuISi4Vzph1gM,9691
 machineconfig/scripts/python/get_zellij_cmd.py,sha256=6irkwgbeC18OWBnTBAF4i0klqZ6GlwagXaQIUBRFxVQ,596
 machineconfig/scripts/python/gh_models.py,sha256=EE8U4mMIOeiLKlqDCVcr4BXwSUJ_yKaZV_7tQ_tqAyo,5396
@@ -212,16 +213,19 @@ machineconfig/scripts/python/__pycache__/__init__.cpython-313.pyc,sha256=CrRHLNL
 machineconfig/scripts/python/__pycache__/cloud_copy.cpython-311.pyc,sha256=ofEjvoXvuGSMnfm2ISBSKAyW8IG8eJwfjxEmKusFV1M,13591
 machineconfig/scripts/python/__pycache__/cloud_mount.cpython-311.pyc,sha256=Ww9YQ61mkCgLoXzyfWCYJwy4E2Q8erpILzZoF0AXUBQ,9365
 machineconfig/scripts/python/__pycache__/cloud_sync.cpython-311.pyc,sha256=Xa-bn9m5eGugaqmBiPIHhUOJT47SXtYswQYL4nhAW4A,5060
-machineconfig/scripts/python/__pycache__/croshell.cpython-311.pyc,sha256=9M8Gb5S1115XlwjzWzNNvldVlwrWycqGvnzsjLtO-xU,11468
+machineconfig/scripts/python/__pycache__/croshell.cpython-311.pyc,sha256=uXED5tp8k3s1XYX1NoJEXup363eAk9zo0qm2rKy6BzY,11528
 machineconfig/scripts/python/__pycache__/devops.cpython-311.pyc,sha256=EQ2ryP_0dbQ9R6bLzcUnijxyLZsEjinAVDGY1uxD5w4,13287
 machineconfig/scripts/python/__pycache__/devops_backup_retrieve.cpython-311.pyc,sha256=Bo--NSxW10D7iO-VubPbwH_P-SJsb4hULXAwtx3WhFc,10426
 machineconfig/scripts/python/__pycache__/devops_devapps_install.cpython-311.pyc,sha256=mSfuG3ehhkbtZnU5PMDv9mS4LcMhj5NDKQBi882nFlc,10162
 machineconfig/scripts/python/__pycache__/devops_update_repos.cpython-311.pyc,sha256=lqrkZtc8WDeFWf2KkU0AYD2hce-dtKQxHyRpYGPByqo,6590
 machineconfig/scripts/python/__pycache__/fire_agents.cpython-311.pyc,sha256=N1AkkdkjZ7rtAbUB_xWnV8BypychQSw2eOJoEqNjiH8,5589
-machineconfig/scripts/python/__pycache__/fire_jobs.cpython-311.pyc,sha256=ZmkYyfr2lZKAFaQ556l6gkdW3SFxDuGqDeKy57zv4MQ,21663
+machineconfig/scripts/python/__pycache__/fire_jobs.cpython-311.pyc,sha256=nXHfprUt_TQb7plJ_e8Ab-XIyRmIDz8-fOLP3g61-Qs,21969
 machineconfig/scripts/python/__pycache__/fire_jobs.cpython-313.pyc,sha256=wMwq9RL120uZ2j6Zex8-SVubEFnaFZantHF2lcW6IwY,20181
 machineconfig/scripts/python/__pycache__/get_zellij_cmd.cpython-311.pyc,sha256=vDgQ-_22m3AyNJKjrXHZEPOOFiZ4Zh2z9NtdQvCWdXY,891
 machineconfig/scripts/python/__pycache__/repos.cpython-311.pyc,sha256=ka0LHOdCwCu8R1RPCMBkndJrXXewG3UthfZl_l9gOZA,17583
+machineconfig/scripts/python/ai/init.py,sha256=kDOP0SRz5fPftkUA2KCLIpDO-WvkmlpwDuqaPPPEJ-0,2202
+machineconfig/scripts/python/ai/__pycache__/init.cpython-311.pyc,sha256=eCeXgwIQcCxy_OY3SHGd3MqkKLDWBOB7t3Gc0elC9Rg,3522
+machineconfig/scripts/python/ai/rules/python/dev.md,sha256=vfQGgq3g4d-BFD4vsan8p2NEOMZkmyREoOSiESSvye4,1860
 machineconfig/scripts/python/archive/im2text.py,sha256=WLyic89vxi_pqQMzo-MOrGf39JEZjCdvDrXYUMVvZNY,1163
 machineconfig/scripts/python/archive/tmate_conn.py,sha256=bUztIO87JReVFzcm7RsOokDXI6wD6u6cTSSWTBwO0Ec,1251
 machineconfig/scripts/python/archive/tmate_start.py,sha256=UcgOxkTegHomeaZp0PeXuubJerzAA2mMzS_wxA1K074,1530
@@ -257,6 +261,7 @@ machineconfig/scripts/windows/fzfrga.bat,sha256=rU_KBMO6ii2EZ0akMnmDk9vpuhKSUZqk
 machineconfig/scripts/windows/gpt.ps1,sha256=78oqOADLMuIZ7uY18lhcp_-IAIj57dkFh0uieanscjU,359
 machineconfig/scripts/windows/grep.ps1,sha256=sUP_cXtqPEWLQ8_TdGJX7_-CO6CQYTP4pA-ZmkdPLdY,49
 machineconfig/scripts/windows/kill_process.ps1,sha256=EESikl97AC3Wpjy8flS6tuSCso1FxDhLjwrvyCO21TM,189
+machineconfig/scripts/windows/mcinit.ps1,sha256=9eqnE8_K0izDCEPU30FZyKnFPML-YSrUgmmOx6DQNA4,132
 machineconfig/scripts/windows/mount_nfs.ps1,sha256=wGIxPe62AE3tLzjSIeYJGva4D_HiMCEsGUa8BsMyDkI,2073
 machineconfig/scripts/windows/mount_nw.ps1,sha256=puxcfZc3ZCJerm8pj8OZGVoTYkhzp-h7oV-MrksSqIE,454
 machineconfig/scripts/windows/mount_smb.ps1,sha256=PzYWpIO9BpwXjdWlUQL9pnMRnOGNSkxfh4bHukJFme8,69
@@ -431,7 +436,7 @@ machineconfig/utils/cloud/onedrive/transaction.py,sha256=AZljZsooDbHC6Qx494J8Sxl
 machineconfig/utils/installer_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/utils/installer_utils/installer_abc.py,sha256=GrAzsCAq7C2JMgmIuodc2n8gBofQd87PFoZD9mPiTYM,5051
 machineconfig/utils/installer_utils/installer_class.py,sha256=4_bibp2I9EDsYWEIS3zX35ksWwtZPiUdB_FfDzRm9Eg,16167
-machineconfig-1.96.dist-info/METADATA,sha256=kIw2qJ63VFPpt2H2m4dYOOSePFEwoszqdqdt2gV_DA0,6987
-machineconfig-1.96.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-machineconfig-1.96.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
-machineconfig-1.96.dist-info/RECORD,,
+machineconfig-1.97.dist-info/METADATA,sha256=z_lJ-U1QunWY1lRmqa2oJt39eSkB6wgKsSHbznWSyOU,6987
+machineconfig-1.97.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+machineconfig-1.97.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
+machineconfig-1.97.dist-info/RECORD,,