SkillLink 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

SkillLink/SkillLink.py

@@ -0,0 +1,103 @@
+import logging
+import os
+import requests
+import zipfile
+import shutil
+from io import BytesIO
+
+logger = logging.getLogger(__name__)
+
+class SkillLink:
+    def __init__(self, githubRepo: str = None, repoFolder: str = None, localDir: str = None):
+        self.githubRepo = githubRepo
+        self.repoFolder = repoFolder
+        self.localDir   = localDir
+        if not self.githubRepo:
+            raise ValueError("GitHub repo must be specified e.g., 'TristanMcBrideSr/SkillForge'")
+        if not self.repoFolder:
+            raise ValueError("Repo folder must be specified e.g., 'SkillForge'")
+        if not self.localDir:
+            raise ValueError("Local dir must be specified e.g., '/your/path/skills'")
+
+    def syncNewFiles(self, srcDir, dstDir, skillList=None, override=False):
+        onlyFiles = None
+        if skillList:
+            normalized = set()
+            for name in skillList:
+                name = name.lower()
+                normalized.add(name)
+                if not name.endswith(".py"):
+                    normalized.add(f"{name}.py")
+            onlyFiles = normalized
+
+        for root, dirs, files in os.walk(srcDir):
+            relRoot = os.path.relpath(root, srcDir)
+            targetRoot = os.path.join(dstDir, relRoot) if relRoot != '.' else dstDir
+            os.makedirs(targetRoot, exist_ok=True)
+            for file in files:
+                if onlyFiles and file.lower() not in onlyFiles:
+                    continue
+                srcFile = os.path.join(root, file)
+                dstFile = os.path.join(targetRoot, file)
+                if os.path.exists(dstFile):
+                    if override:
+                        shutil.copy2(srcFile, dstFile)
+                        print(f"Overridden {dstFile} with {srcFile}")
+                        logger.info(f"Overridden {dstFile} with {srcFile}")
+                    else:
+                        print(f"File {dstFile} already exists locally. Skipping (preserving local).")
+                        logger.info(f"File {dstFile} already exists locally. Skipping (preserving local).")
+                    continue
+                shutil.copy2(srcFile, dstFile)
+                print(f"Copied {srcFile} to {dstFile}")
+                logger.info(f"Copied {srcFile} to {dstFile}")
+
+    def startSync(self, **kwargs):
+        """
+        Syncs skills from a GitHub repo zip to local directory.
+
+        Kwargs:
+            skillList: list of skills to sync (default: all)
+            override: bool, if True always overwrite local (default: False)
+            githubToken: str, GitHub token for private repos (default: None)
+            branch: str, Git branch (default: 'master')
+        """
+        skillList   = kwargs.get('skillList')
+        override    = kwargs.get('override', False)
+        githubToken = kwargs.get('githubToken')
+        branch      = kwargs.get('branch', 'master')
+
+        logger.info(f"Starting {self.repoFolder} connection...")
+        zipUrl = f"https://github.com/{self.githubRepo}/archive/refs/heads/{branch}.zip"
+        logger.info("Starting sync...")
+        logger.info(f"Downloading {zipUrl} ...")
+        headers = {"User-Agent": "Mozilla/5.0"}
+        if githubToken:
+            headers["Authorization"] = f"Bearer {githubToken}"
+
+        try:
+            r = requests.get(zipUrl, headers=headers)
+            r.raise_for_status()
+            tempDir = "tmpDownload"
+            z = zipfile.ZipFile(BytesIO(r.content))
+            z.extractall(tempDir)
+
+            extractedRoot = os.path.join(tempDir, os.listdir(tempDir)[0])
+            skillsSrc = os.path.join(extractedRoot, self.repoFolder)
+
+            if not os.path.exists(skillsSrc):
+                logger.error(f"Can't find {self.repoFolder} in the repo!")
+                shutil.rmtree(tempDir)
+                raise FileNotFoundError(f"Can't find {self.repoFolder} in the repo!")
+
+            os.makedirs(self.localDir, exist_ok=True)
+
+            self.syncNewFiles(skillsSrc, self.localDir, skillList, override)
+
+            shutil.rmtree(tempDir)
+            logger.info("Sync complete.")
+            return True
+
+        except Exception as e:
+            logger.error(f"Sync failed: {e}", exc_info=True)
+            return False

SkillLink/__init__.py

@@ -0,0 +1 @@
+from .SkillLink import SkillLink

{skilllink-0.1.0.dist-info → skilllink-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SkillLink
-Version: 0.1.0
+Version: 0.1.1
 Summary: A Modern way to sync skills
 Author: Tristan McBride Sr.
 Author-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
@@ -167,6 +167,12 @@ syncer.startSync(
 
 ---
 
+## Code Examples
+
+You can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).
+
+---
+
 ## License
 
 This project is licensed under the [Apache License, Version 2.0](LICENSE).
@@ -174,7 +180,9 @@ Copyright 2025 Tristan McBride Sr.
 
 ---
 
-**Authors:**
+## Acknowledgements
+
+Project by:
 - Tristan McBride Sr.
 - Sybil
 

skilllink-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+SkillLink/SkillLink.py,sha256=boenTeVIr4sAfeHcLiNcZCAw1FHEw7Orp1-UN-esAaU,4341
+SkillLink/__init__.py,sha256=b6TVK2Ve_Cct2wu3FLn_2X7cXzCqhI6kTIM81OorPMM,32
+skilllink-0.1.1.dist-info/METADATA,sha256=CrnAat_Xw7T-rplELWnBZO6E-QWz8wJfuUuqURMW7N4,4710
+skilllink-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+skilllink-0.1.1.dist-info/top_level.txt,sha256=8Nq2y-9CjjC46x0nlmsBxabHDFhJcw5FnprPDQz3RKY,10
+skilllink-0.1.1.dist-info/RECORD,,

skilllink-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+SkillLink

skilllink-0.1.0.dist-info/RECORD

@@ -1,4 +0,0 @@
-skilllink-0.1.0.dist-info/METADATA,sha256=kfBFsjjH2DhlPLSRmN0FjRKGWTrpymX_tmiNR2NJ-EY,4558
-skilllink-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-skilllink-0.1.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-skilllink-0.1.0.dist-info/RECORD,,

skilllink-0.1.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-