primitive 0.1.2__tar.gz → 0.1.4__tar.gz

primitive-0.1.4/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "cSpell.words": [
+    "Checkin",
+    "loguru",
+    "machdep",
+    "Untaring",
+    "VERIBLE",
+    "verilog"
+  ]
+}

{primitive-0.1.2 → primitive-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: primitive
-Version: 0.1.2
+Version: 0.1.4
 Project-URL: Documentation, https://github.com//primitivecorp/primitive-cli#readme
 Project-URL: Issues, https://github.com//primitivecorp/primitive-cli/issues
 Project-URL: Source, https://github.com//primitivecorp/primitive-cli

primitive-0.1.4/linux setup.md

@@ -0,0 +1,26 @@
+linux setup
+
+```
+curl https://pyenv.run | bash
+
+# for .bashrc
+echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
+echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
+echo 'eval "$(pyenv init -)"' >> ~/.bashrc
+
+# for .bash_profile
+echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
+echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
+echo 'eval "$(pyenv init -)"' >> ~/.bash_profile
+
+# python compilation requirements https://github.com/pyenv/pyenv/wiki#suggested-build-environment
+# FOR UBUNTU
+sudo apt update; sudo apt install build-essential libssl-dev zlib1g-dev \
+libbz2-dev libreadline-dev libsqlite3-dev curl git \
+libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
+
+pyenv install 3.12.5
+pyenv global 3.12.5
+pip install --upgrade pip
+
+```

{primitive-0.1.2 → primitive-0.1.4}/src/primitive/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2024-present Dylan Stein <dylan@steins.studio>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "0.1.2"
+__version__ = "0.1.4"

primitive-0.1.4/src/primitive/lint/actions.py

@@ -0,0 +1,67 @@
+from pathlib import Path
+from primitive.utils.actions import BaseAction
+import subprocess
+from typing import Tuple
+from loguru import logger
+from ..utils.files import find_files_for_extension
+from ..utils.verible import install_verible
+
+
+class Lint(BaseAction):
+    def execute(self, source: Path = Path.cwd()) -> Tuple[bool, str]:
+        logger.debug("Starting linter...")
+        files = find_files_for_extension(source, ".sv")
+        if not files:
+            message = "No files found to lint."
+            logger.warning(message)
+            return False, message
+
+        logger.debug("Checking if verible is installed")
+        try:
+            subprocess.run(["verible-verilog-lint", "--version"], capture_output=True)
+        except FileNotFoundError:
+            logger.debug("Did not find verible. Installing...")
+            try:
+                system_info = self.primitive.hardware.get_system_info()
+                install_verible(system_info=system_info)
+            except Exception as exception:
+                message = f"Failed to install verible. {exception}"
+                logger.error(message)
+                return False, message
+
+        try:
+            subprocess.run(["verible-verilog-lint", "--version"], capture_output=True)
+        except FileNotFoundError:
+            message = "Verible is not installed. Please install it to run lint."
+            logger.error(message)
+            return False, message
+
+        # TODO:
+        # run is great for now! we will need to switch to Popen if we want to stream the output
+        logger.debug("Running linter...")
+        result = subprocess.run(
+            ["verible-verilog-lint", *files],
+            capture_output=True,
+            text=True,
+        )
+
+        logger.debug("Linting complete.")
+
+        message = ""
+        if self.primitive.DEBUG:
+            if result.stderr:
+                logger.error("\n" + result.stderr)
+            if result.stdout:
+                logger.info("\n" + result.stdout)
+            message = "See above logs for linter output."
+        else:
+            message = result.stderr
+
+        if result.returncode != 0:
+            if not self.primitive.DEBUG:
+                message = result.stderr
+            return (False, message)
+        else:
+            message = "Linting successful."
+
+        return True, message

primitive-0.1.4/src/primitive/lint/commands.py

@@ -0,0 +1,17 @@
+import click
+from pathlib import Path
+import typing
+from ..utils.printer import print_result
+
+if typing.TYPE_CHECKING:
+    from ..client import Primitive
+
+
+@click.command("lint")
+@click.pass_context
+@click.argument("source", type=click.Path(exists=True), default=".")
+def cli(context, source: str):
+    """Lint"""
+    primitive: Primitive = context.obj.get("PRIMITIVE")
+    result, message = primitive.lint.execute(source=Path(source))
+    print_result(message=message, context=context)

primitive-0.1.4/src/primitive/utils/files.py

@@ -0,0 +1,16 @@
+from typing import List, Tuple
+from pathlib import Path
+from loguru import logger
+
+
+def find_files_for_extension(source: Path, extensions: Tuple[str]) -> List[Path]:
+    matching_files = []
+    logger.debug(f"Looking for files at {source} with extensions {extensions}")
+    for dirpath, dirnames, filenames in source.walk():
+        for filename in filenames:
+            if filename.endswith(extensions):
+                matching_files.append(dirpath.joinpath(filename))
+    logger.debug(
+        f"Found {len(matching_files)} following files that match: {matching_files}"
+    )
+    return matching_files

{primitive-0.1.2 → primitive-0.1.4}/src/primitive/utils/printer.py

@@ -7,7 +7,7 @@ from loguru import logger
 def print_result(message: str, context: click.Context, fg: str = None):
     """Print message to stdout or stderr"""
     if context.obj["DEBUG"]:
-        logger.debug(json.dumps(message))
+        logger.info(json.dumps(message))
     else:
         if context.obj["JSON"]:
             message = json.dumps(message, indent=2)

primitive-0.1.4/src/primitive/utils/shell.py

@@ -0,0 +1,63 @@
+from pathlib import Path
+import subprocess
+
+
+def add_path_to_shell(path: Path):
+    try:
+        subprocess.run(["fish_add_path", path], capture_output=True)
+        return True
+    except FileNotFoundError:
+        pass
+
+    if Path.home() / ".bash_profile":
+        subprocess.run(
+            [
+                "echo",
+                f"'export PATH={path}:$PATH'",
+                ">>",
+                "~/.bash_profile",
+            ],
+            capture_output=True,
+        )
+    elif Path.home() / ".bashrc":
+        subprocess.run(
+            [
+                "echo",
+                f"'export PATH={path}:$PATH'",
+                ">>",
+                "~/.bashrc",
+            ],
+            capture_output=True,
+        )
+    elif Path.home() / ".zshrc":
+        subprocess.run(
+            [
+                "echo",
+                f"'export PATH={path}:$PATH'",
+                ">>",
+                "~/.zshrc",
+            ],
+            capture_output=True,
+        )
+    elif Path.home() / ".profile":
+        subprocess.run(
+            [
+                "echo",
+                f"'export PATH={path}:$PATH'",
+                ">>",
+                "~/.profile",
+            ],
+            capture_output=True,
+        )
+    elif Path.home() / ".bash_login":
+        subprocess.run(
+            [
+                "echo",
+                f"'export PATH={path}:$PATH'",
+                ">>",
+                "~/.bash_login",
+            ],
+            capture_output=True,
+        )
+    else:
+        raise Exception(f"Failed to add {path} to PATH")

primitive-0.1.4/src/primitive/utils/verible.py

@@ -0,0 +1,51 @@
+import tarfile
+import requests
+from .shell import add_path_to_shell
+from pathlib import Path
+
+from loguru import logger
+
+
+VERIBLE_MAC_OS_LINK = "https://github.com/chipsalliance/verible/releases/download/v0.0-3752-g8b64887e/verible-v0.0-3752-g8b64887e-macOS.tar.gz"
+VERIBLE_WINDOWS_64_OS_LINK = "https://github.com/chipsalliance/verible/releases/download/v0.0-3752-g8b64887e/verible-v0.0-3752-g8b64887e-win64.zip"
+VERIBLE_LINUX_X86_64_OS_LINK = "https://github.com/chipsalliance/verible/releases/download/v0.0-3752-g8b64887e/verible-v0.0-3752-g8b64887e-linux-static-x86_64.tar.gz"
+VERIBLE_LINUX_ARM64_LINK = "https://github.com/chipsalliance/verible/releases/download/v0.0-3752-g8b64887e/verible-v0.0-3752-g8b64887e-linux-static-arm64.tar.gz"
+
+
+def install_verible(system_info: dict) -> bool:
+    url = None
+    if system_info.get("os_family") == "Darwin":
+        url = VERIBLE_MAC_OS_LINK
+    elif system_info.get("os_family") == "Windows":
+        url = VERIBLE_WINDOWS_64_OS_LINK
+    elif system_info.processor == "x86_64":
+        url = VERIBLE_LINUX_X86_64_OS_LINK
+    elif system_info.processor == "arm":
+        url = VERIBLE_LINUX_X86_64_OS_LINK
+
+    verible_dir_name = url.split("/")[-1].split(".tar.gz")[0]
+    file_download_path = Path.home() / f"{verible_dir_name}.tar.gz"
+
+    logger.debug("Downloading verible")
+    response = requests.get(url, stream=True)
+    if response.status_code == 200:
+        with open(file_download_path, "wb") as file:
+            file.write(response.raw.read())
+    else:
+        raise Exception(
+            f"Failed to download verible. {response.status_code}. {response.text}"
+        )
+
+    logger.debug("Untaring verible")
+    with tarfile.open(file_download_path) as tar:
+        tar.extractall(Path.home())
+
+    logger.debug("Deleting tar.gz artifact")
+    file_download_path.unlink()
+
+    verible_bin = Path.home() / verible_dir_name / "bin"
+
+    logger.debug("Adding verible to PATH")
+    add_path_to_shell(verible_bin)
+
+    return True

primitive-0.1.2/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-  "cSpell.words": ["Checkin", "loguru", "machdep"]
-}

primitive-0.1.2/src/primitive/lint/actions.py

@@ -1,6 +0,0 @@
-from primitive.utils.actions import BaseAction
-
-
-class Lint(BaseAction):
-    def run_lint(self):
-        print("lint 100%")

primitive-0.1.2/src/primitive/lint/commands.py

@@ -1,15 +0,0 @@
-import click
-
-
-import typing
-
-if typing.TYPE_CHECKING:
-    from ..client import Primitive
-
-
-@click.command("lint")
-@click.pass_context
-def cli(context):
-    """Lint"""
-    primitive: Primitive = context.obj.get("PRIMITIVE")
-    primitive.lint.run_lint()