machineconfig 3.7__py3-none-any.whl → 7.69__py3-none-any.whl

machineconfig/scripts/python/ai/scripts/lint_and_type_check.sh

@@ -5,9 +5,50 @@ if [ ! -f "./pyproject.toml" ]; then
     exit 1
 fi
 
-echo "Running linting and type checking..."
+# Color definitions
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+BOLD='\033[1m'
+UNDERLINE='\033[4m'
+NC='\033[0m' # No Color
 
-echo "Setting up environment..."
+# Box drawing functions
+draw_box() {
+    local text="$1"
+    local color="$2"
+    local width=60
+    local padding=$(( (width - ${#text}) / 2 ))
+    local line=""
+    for ((i=0; i<width; i++)); do line="${line}─"; done
+    
+    echo -e "${color}┌${line}┐${NC}"
+    printf "${color}│%*s%s%*s│${NC}\n" $padding "" "$text" $padding ""
+    echo -e "${color}└${line}┘${NC}"
+}
+
+draw_progress() {
+    local current="$1"
+    local total="$2"
+    local description="$3"
+    echo -e "${CYAN}┌────────────────────────────────────────────────────────────┐${NC}"
+    echo -e "${CYAN}│${NC} ${BOLD}${WHITE}Step ${current}/${total}:${NC} ${description}${CYAN}$(printf '%*s' $((50 - ${#description} - 8)) "")│${NC}"
+    echo -e "${CYAN}└────────────────────────────────────────────────────────────┘${NC}"
+}
+
+TOTAL_STEPS=7
+CURRENT_STEP=0
+
+draw_box "🚀 LINTING & TYPE CHECKING SUITE 🚀" "${BOLD}${CYAN}"
+echo
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Environment Setup"
+echo -e "${BLUE}🔧 Installing and updating development dependencies...${NC}"
 # uv add pylint pyright mypy pyrefly ruff ty --dev  # linters and type checkers
 # uv add --dev cleanpy pylint pyright mypy pyrefly --upgrade-package cleanpy pylint pyright mypy pyrefly
 uv add --dev pyright --upgrade-package pyright
@@ -16,37 +57,62 @@ uv add --dev mypy --upgrade-package mypy
 uv add --dev pyrefly --upgrade-package pyrefly
 uv add --dev cleanpy --upgrade-package cleanpy
 
-
 uv add types-requests types-toml types-PyYAML types-pytz types-paramiko types-urllib3 --dev
 uv add types-mysqlclient types-SQLAlchemy --dev
 
+echo -e "${GREEN}✅ Environment setup complete!${NC}"
+echo
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Code Cleanup"
+echo -e "${YELLOW}🧹 Cleaning and formatting code...${NC}"
 uv run -m cleanpy .
 uv run -m ruff clean
 # uv run -m ruff format .
 uv run -m ruff check . --fix
-uv run --no-dev --project $HOME/code/machineconfig -m machineconfig.scripts.python.ai.generate_files
 
-mkdir .linters
+mkdir .ai/linters
+
+echo -e "${GREEN}🧹 Code cleanup complete!${NC}"
+echo
+
+draw_box "🔍 TYPE CHECKERS & LINTERS 🔍" "${BOLD}${PURPLE}"
 
-echo "Running pyright..."
-rm ./.linters/pyright_result.md || true
-uv run pyright . > ./.linters/pyright_result.md
-echo "Results of pyright are in ./.linters/pyright_result.md"
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyright Type Checker"
+echo -e "${BLUE}📋 Analyzing types with Pyright...${NC}"
+rm ./.ai/linters/issues_pyright.md || true
+uv run pyright . > ./.ai/linters/issues_pyright.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyright.md${NC}"
 
-rm ./.linters/mypy_result.md || true
-uv run mypy . > ./.linters/mypy_result.md
-echo "Results of mypy are in ./.linters/mypy_result.md"
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "MyPy Type Checker"
+echo -e "${BLUE}📋 Analyzing types with MyPy...${NC}"
+rm ./.ai/linters/issues_mypy.md || true
+uv run mypy . > ./.ai/linters/issues_mypy.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_mypy.md${NC}"
 
-rm ./.linters/pylint_result.md || true
-uv run pylint ./src/ > ./.linters/pylint_result.md
-echo "Results of pylint are in ./.linters/pylint_result.md"
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pylint Code Analysis"
+echo -e "${BLUE}📋 Analyzing code quality with Pylint...${NC}"
+rm ./.ai/linters/issues_pylint.md || true
+uv run pylint ./src/ > ./.ai/linters/issues_pylint.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pylint.md${NC}"
 
-rm ./.linters/pylint_result.md || true
-uv run pyrefly check . > ./.linters/pyrefly_result.md
-echo "Results of pyrefly are in ./.linters/pyrefly_result.md"
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyrefly Type Checker"
+echo -e "${BLUE}📋 Analyzing types with Pyrefly...${NC}"
+rm ./.ai/linters/issues_pyrefly.md || true
+uv run pyrefly check . > ./.ai/linters/issues_pyrefly.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyrefly.md${NC}"
 
-rm ./.linters/ruff_result.md || true
-uv run ruff check . > ./.linters/ruff_result.md
-echo "Results of ruff are in ./.linters/ruff_result.md"
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Ruff Linter"
+echo -e "${BLUE}📋 Checking code style with Ruff...${NC}"
+rm ./.ai/linters/issues_ruff.md || true
+uv run ruff check . > ./.ai/linters/issues_ruff.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_ruff.md${NC}"
 
-echo "All done! Please check the .linters directory for results."
+echo
+draw_box "🎉 ALL CHECKS COMPLETED! 🎉" "${BOLD}${GREEN}"
+echo -e "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.ai/linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"

machineconfig/scripts/python/ai/solutions/_shared.py

@@ -2,4 +2,12 @@ from pathlib import Path
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 def get_generic_instructions_path() -> Path:
-    return LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md")
+    path = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md")
+    text = path.read_text(encoding="utf-8")
+    import platform
+    if platform.system().lower() == "windows":
+        text = text.replace("bash", "powershell").replace(".sh", ".ps1")
+    import tempfile
+    temp_path = Path(tempfile.gettempdir()).joinpath("generic_instructions.md")
+    temp_path.write_text(data=text, encoding="utf-8")
+    return temp_path

machineconfig/scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md

@@ -34,7 +34,7 @@ applyTo: "**/*.py"
 * when finished, run a linting static analysis check against files you touched, Any fix any mistakes.
 * Please run `uv run -m pyright $file_touched` and address all issues. if `pyright is not there, first run `uv add pyright --dev`.
 * For all type checkers and linters, like mypy, pyright, pyrefly and pylint, there are config files at different levels of the repo all the way up to home directory level. You don't need to worry about them, just be mindful that they exist. The tools themselves will respect the configs therein.
-* If you want to run all linters and pycheckers agains the entire project to make sure everything is clean, I prepared a nice shell script, you can run it from the repo root as `./.scripts/lint_and_typecheck.sh`. It will produce markdown files that are you are meant to look at @ ./.linters/*.md
+* If you want to run all linters and pycheckers agains the entire project to make sure everything is clean, I prepared a nice shell script, you can run it from the repo root as `./.ai/scripts/lint_and_type_check.sh`. It will produce markdown files that are you are meant to look at @ ./.ai/linters/*.md
 
 # General Programming Ethos:
 * Make sure all the code is rigorous, no lazy stuff.
@@ -43,3 +43,6 @@ applyTo: "**/*.py"
 * Please avoid writing README files and avoid docstring and comments in code unless absolutely necessary. Use clear naming conventions instead of documenting.
 * Always prefer to functional style of programming over OOP.
 * When passing arguments or constructing dicts or lists or tuples, avoid breaking lines too much, try to use ~ 150 characters per line before breaking to new one.
+
+# Privacy:
+* No matter what, never ever open/read/write/list anything under ~/dotfiles

machineconfig/scripts/python/ai/solutions/copilot/prompts/pyright_fix.md

@@ -0,0 +1,16 @@
+---
+mode: agent
+---
+
+
+$PYRIGHT_ISSUES_FILE = "./.ai/linters/issues_pyright.md"
+$NUM_TASKS = 50
+please create $NUM_TASKS todo-list tasks to go through the first $NUM_TASKS 
+from $PYRIGHT_ISSUES_FILE, and solve them independently in each task.
+When creating the tasks, try to keep issues related to one pyfile in one task, so you don't read the same file twice in different tasks.
+
+once you solved them, you will have 2 months break from work.
+
+Start by runing `./.ai/scripts/lint_and_type_check.sh` to generate $PYRIGHT_ISSUES_FILE only once.
+
+

machineconfig/scripts/python/ai/solutions/gemini/settings.json

@@ -69,7 +69,7 @@
   "customThemes": {
     "MyCustomTheme": {
       "name": "MyCustomTheme",
-      "type": "custom",
+      "type": "CMD",
       "Background": "#181818",
       "Foreground": "#F8F8F2",
       "AccentBlue": "#61AFEF",

machineconfig/scripts/python/ai/solutions/generic.py

@@ -1,14 +1,36 @@
+
 from pathlib import Path
+import platform
 
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 
 def create_dot_scripts(repo_root: Path) -> None:
     scripts_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/scripts")
-    target_dir = repo_root.joinpath(".scripts")
+    target_dir = repo_root.joinpath(".ai/scripts")
+    import shutil
+    shutil.rmtree(target_dir, ignore_errors=True)
     target_dir.mkdir(parents=True, exist_ok=True)
-    for script_path in scripts_dir.iterdir():
-        target_dir.joinpath(script_path.name).write_text(data=script_path.read_text(encoding="utf-8"), encoding="utf-8")
+    import platform
+    if platform.system() == "Windows":
+        script_path = scripts_dir.joinpath("lint_and_type_check.ps1")
+    elif platform.system() in ["Linux", "Darwin"]:
+        script_path = scripts_dir.joinpath("lint_and_type_check.sh")
+    else:
+        raise NotImplementedError(f"Platform {platform.system()} is not supported.")
+    target_dir.joinpath(script_path.name).write_text(data=script_path.read_text(encoding="utf-8"), encoding="utf-8")
+
+
+def adjust_for_os(config_path: Path) -> str:
+    if config_path.suffix not in [".md", ".txt"]:
+        return config_path.read_text(encoding="utf-8")
+    english_text = config_path.read_text(encoding="utf-8")
+    if platform.system() == "Windows":
+        return english_text.replace("bash", "PowerShell").replace("sh ", "pwsh ").replace("./", ".\\").replace(".sh", ".ps1")
+    elif platform.system() in ["Linux", "Darwin"]:
+        return english_text.replace("PowerShell", "bash").replace("pwsh ", "sh ").replace(".\\", "./").replace(".ps1", ".sh")
+    else:
+        raise NotImplementedError(f"Platform {platform.system()} is not supported.")
 
 
 def adjust_gitignore(repo_root: Path) -> None:
@@ -22,10 +44,11 @@ def adjust_gitignore(repo_root: Path) -> None:
         ".links",
         "notebooks",
         ".ai",
-        ".scripts",
         "GEMINI.md",
         "CLAUDE.md",
+        "CRUSH.md",
         ".cursor",
+        ".clinerules",
         ".github/instructions",
         ".github/chatmodes",
         ".github/prompts",

machineconfig/scripts/python/ai/vscode_tasks.py

@@ -0,0 +1,37 @@
+import json
+from pathlib import Path
+from typing import Any
+
+
+def add_lint_and_type_check_task(repo_root: Path) -> None:
+    vscode_dir = repo_root / ".vscode"
+    vscode_dir.mkdir(parents=True, exist_ok=True)
+    tasks_json_path = vscode_dir / "tasks.json"
+
+    task_to_add = {
+        "label": "lint_and_type_check",
+        "type": "shell",
+        "linux": {"command": "bash", "args": ["./.ai/scripts/lint_and_type_check.sh"]},
+        "osx": {"command": "bash", "args": ["./.ai/scripts/lint_and_type_check.sh"]},
+        "windows": {"command": "pwsh", "args": ["-File", "./.ai/scripts/lint_and_type_check.ps1"]},
+        "presentation": {"reveal": "always", "panel": "new"},
+        "problemMatcher": [],
+    }
+
+    if tasks_json_path.exists():
+        json_data = tasks_json_path.read_text(encoding="utf-8")
+        if not json_data.strip():
+            tasks_config: dict[str, Any] = {"version": "2.0.0", "tasks": []}
+        else:
+            tasks_config = json.loads(json_data)
+            assert isinstance(tasks_config, dict)
+        if "tasks" not in tasks_config:
+            tasks_config["tasks"] = []
+        existing_labels = {task.get("label") for task in tasks_config.get("tasks", [])}
+        if "lintAndTypeCheck" not in existing_labels:
+            tasks_config["tasks"].append(task_to_add)
+    else:
+        tasks_config = {"version": "2.0.0", "tasks": [task_to_add]}
+
+    with tasks_json_path.open("w") as f:
+        json.dump(tasks_config, f, indent="\t")

machineconfig/scripts/python/cloud.py

@@ -0,0 +1,29 @@
+
+import typer
+from machineconfig.scripts.python.helpers_cloud.cloud_sync import main as sync_main
+from machineconfig.scripts.python.helpers_cloud.cloud_copy import main as copy_main
+from machineconfig.scripts.python.helpers_cloud.cloud_mount import mount as mount_main
+
+def get_app():
+    app = typer.Typer(add_completion=False, no_args_is_help=True)
+
+    app.command(name="sync", no_args_is_help=True, help="""🔄 [s] Synchronize files/folders between local and cloud storage.""")(sync_main)
+    app.command(name="s", no_args_is_help=True, hidden=True)(sync_main)  # short alias
+
+    app.command(name="copy", no_args_is_help=True, short_help="""📤 [c] Upload or 📥 Download files/folders to/from cloud storage services like Google Drive, Dropbox, OneDrive, etc.""")(copy_main)
+    app.command(name="c", no_args_is_help=True, hidden=True)(copy_main)  # short alias
+
+    app.command(name="mount", no_args_is_help=True, short_help="""🔗 [m] Mount cloud storage services like Google Drive, Dropbox, OneDrive, etc. as local drives.""")(mount_main)
+    app.command(name="m", no_args_is_help=True, hidden=True)(mount_main)  # short alias
+
+    return app
+
+
+def main():
+    app = get_app()
+    app()
+
+
+if __name__ == "__main__":
+    pass
+    # a = get_app()(asdf)