picobuild 0.0.4__py313-none-any.whl

picobuild/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.0.4"

picobuild/__init__.py

@@ -0,0 +1,19 @@
+from .__about__ import __version__
+from ._setuptools import Extension, find_packages, setup
+from .cython_utils import cythonize, get_cython_build_dir
+from .executable import ExecutableParameters, build_cython_executable
+
+__all__: tuple[str, ...] = (
+    # About
+    "__version__",
+    # CythonUtils
+    "get_cython_build_dir",
+    "cythonize",
+    # Setuptools
+    "Extension",
+    "find_packages",
+    "setup",
+    # Executable
+    "build_cython_executable",
+    "ExecutableParameters",
+)

picobuild/_setuptools.py

@@ -0,0 +1,9 @@
+from typing import Any, Callable, TypeAlias
+
+from setuptools import Extension as _Extension
+from setuptools import find_packages as _find_packages
+from setuptools import setup as _setup
+
+Extension: TypeAlias = _Extension
+find_packages: Callable[..., list[str]] = _find_packages
+setup: Callable[..., Any] = _setup

picobuild/cython_utils.py

@@ -0,0 +1,34 @@
+import platform
+import sys
+
+from Cython.Build import cythonize as _cythonize
+from setuptools import Extension
+
+
+def get_cython_build_dir(build_dir: str = "build"):
+    """
+    Get the build directory for the given build directory.
+    Args:
+        build_dir: The build directory.
+    Returns:
+        The build directory.
+    # Example: build/cython.linux-x86_64-cpython-313
+    """
+    plat = platform.system().lower()
+    machine = platform.machine().lower()
+    py_version = f"{sys.version_info.major}{sys.version_info.minor}"
+    impl = platform.python_implementation().lower()
+    return f"{build_dir}/cython.{plat}-{machine}-{impl}-{py_version}"
+
+
+def cythonize(*args, **kwargs) -> list[Extension]:
+    """
+    Cythonize the given extensions.
+    Args:
+        *args: The extensions to cythonize.
+        **kwargs: The keyword arguments to pass to the cythonize function.
+    Returns:
+        The list of cythonized extensions.
+    """
+    build_dir: str = kwargs.pop("build_dir", "build")
+    return _cythonize(*args, **kwargs, build_dir=get_cython_build_dir(build_dir))

picobuild/executable.py

@@ -0,0 +1,121 @@
+import subprocess
+import sysconfig
+from typing import Optional
+
+from Cython.Compiler import Options as CythonOptions
+from Cython.Compiler.Main import compile as cython_compile
+from Cython.Compiler.Options import CompilationOptions
+
+# pylint: disable=pointless-string-statement
+"""
+# TODO
+*Cython*
+This is embedded, doesnt require env activation to be run.
+TODO:
+    - cythonize is better option i think
+    - maebe a class CythonExecutable with methods:
+        - build
+        - compile
+    - add moar args
+
+*C*
+Issa not embedded, activate env to run.
+TODO:
+    - c file generator
+    - compile (think is same as cython)
+
+*Impl*
+    - shall i clean cy/c files after executable is done? idkidk
+"""
+
+
+class ExecutableParameters:
+    """
+    Parameters for building a standalone executable from a Python source file.
+
+    Args:
+        source_file: Python source file (e.g., "hello.py")
+        build_dir: Output directory for the executable (e.g., "bin")
+        executable_name: Name of the executable (e.g., "hello")
+    """
+
+    def __init__(
+        self, source_file: str, build_dir: str, executable_name: Optional[str] = None
+    ):
+        """
+        Initialize the ExecutableParameters.
+
+        Args:
+            source_file: Python source file (e.g., "hello.py")
+            build_dir: Output directory for the executable (e.g., "bin")
+            executable_name: Name of the executable (e.g., "hello")
+        """
+        self._build_dir = build_dir
+
+        self._source_file = source_file
+        self._executable_name = executable_name or source_file.split("/")[
+            -1
+        ].removesuffix(".py")
+        self._executable_file = f"{self._build_dir}/{self._executable_name}"
+        self._c_file = f"{self._build_dir}/{self._executable_name}.c"
+
+    def as_tuple(self):
+        """
+        Return the source file and executable name as a tuple.
+        """
+        return (self._source_file, self._executable_file)
+
+
+def _cythonize_executable(source_file: str, dest_file: str = None):
+    """
+    Cythonize the source_file to a C file suitable for embedding in a standalone executable.
+    Equivalent to: cython --embed hello.py -o bin/hello_cy.c
+    """
+    # This is equivalent to --embed
+    CythonOptions.embed = "main"
+
+    options = CompilationOptions()
+    if dest_file:
+        options.output_file = dest_file
+
+    cython_compile(source_file, options)
+
+
+def _build_cython_executable(c_file: str, dest_file: str):
+    """
+    Compile the C file to an executable using gcc.
+    Equivalent to: gcc bin/hello_cy.c -o bin/hello_cy \
+       $(python -c "import sysconfig as s; print(f'-I{s.get_path(\"include\")} -L{s.get_config_var(\"LIBDIR\")} -lpython{s.get_config_var(\"VERSION\")}')")
+    """
+    include_dir = sysconfig.get_path("include")
+    lib_dir = sysconfig.get_config_var("LIBDIR")
+    python_version = sysconfig.get_config_var("VERSION")
+
+    cmd = [
+        "gcc",
+        c_file,
+        "-o",
+        dest_file,
+        f"-I{include_dir}",
+        f"-L{lib_dir}",
+        f"-lpython{python_version}",
+    ]
+
+    subprocess.run(cmd, check=True)
+
+
+def build_cython_executable(source_file: str, dest_file: str = None):
+    """
+    Build a standalone executable from a Python source file.
+
+    Args:
+        source_file: Python source file (e.g., "hello.py")
+        dest_file: Output executable path (e.g., "hello"). If None, derived from source_file.
+    """
+    if dest_file is None:
+        dest_file = source_file.removesuffix(".py")
+
+    c_file = f"{dest_file}.c"
+
+    _cythonize_executable(source_file, c_file)
+    _build_cython_executable(c_file, dest_file)

picobuild-0.0.4.dist-info/METADATA

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: picobuild
+Version: 0.0.4
+Summary: Building tools for CPython extensions
+Author-email: ckirua <aquipongoalgo.dsz@gmail.com>
+License-Expression: BSD-3-Clause
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools>=80.9.0
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# picobuild
+CPython building tools

picobuild-0.0.4.dist-info/RECORD

@@ -0,0 +1,10 @@
+picobuild/__about__.py,sha256=1mptEzQihbdyqqzMgdns_j5ZGK9gz7hR2bsgA_TnjO4,22
+picobuild/__init__.py,sha256=ler7AILWx0Y4Lsp8KkjBVGs-Em8-OsoH2vIVoB_uhSo,490
+picobuild/_setuptools.py,sha256=ZYMNjPArHNgEUbCPVgWgQvZ3NjtrlIh474AUNEO0zRk,313
+picobuild/cython_utils.py,sha256=b5639Q8oOQnIQuMHZcVadcRSU6qiio8c6dq0WvWBUs4,1079
+picobuild/executable.py,sha256=G2YLtTZlshSc4PMgtjm3zT9Dt4fpsubGU1JY7fDQLsw,3606
+picobuild-0.0.4.dist-info/licenses/LICENSE,sha256=Gco-IPwzTMCrnepWMoAaFPEli4JMiJs0GWz_PN2H6ss,1493
+picobuild-0.0.4.dist-info/METADATA,sha256=cmJtwL4z_hAVZYQt-7FvaIYI6_NER1F7-9eGX03FcPU,567
+picobuild-0.0.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+picobuild-0.0.4.dist-info/top_level.txt,sha256=MTdsM-BZRhOrXapaSjQB9TRgly0bk5XT2v88zJ8Sjt0,10
+picobuild-0.0.4.dist-info/RECORD,,

picobuild-0.0.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

picobuild-0.0.4.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, ckirua
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

picobuild-0.0.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+picobuild