picobuild 0.0.4__tar.gz

picobuild-0.0.4/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,2 @@
+# picobuild
+CPython building tools

picobuild-0.0.4/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "picobuild"
+description = "Building tools for CPython extensions"
+readme = "README.md"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [{ name = "ckirua", email = "aquipongoalgo.dsz@gmail.com" }]
+requires-python = ">=3.12"
+dynamic = ["version"]
+dependencies = [
+    "setuptools>=80.9.0",
+]
+
+[project.optional-dependencies]
+dev = ["black", "build", "flake8", "isort", "mypy"]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"picobuild" = ["**/*.pyx", "**/*.pxd", "**/*.pyi", "**/*.pxi", "**/*.h", "**/*.c", "**/*.hpp", "**/*.cpp"]
+
+[tool.setuptools.dynamic]
+version = { attr = "picobuild.__about__.__version__" }

picobuild-0.0.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

picobuild-0.0.4/setup.py

@@ -0,0 +1,9 @@
+from setuptools import find_packages, setup
+
+
+if __name__ == "__main__":
+    setup(
+        packages=find_packages(where="src"),
+        package_dir={"": "src"},
+        
+    )

picobuild-0.0.4/src/picobuild/__about__.py

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

picobuild-0.0.4/src/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-0.0.4/src/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-0.0.4/src/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-0.0.4/src/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/src/picobuild.egg-info/PKG-INFO

@@ -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/src/picobuild.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+src/picobuild/__about__.py
+src/picobuild/__init__.py
+src/picobuild/_setuptools.py
+src/picobuild/cython_utils.py
+src/picobuild/executable.py
+src/picobuild.egg-info/PKG-INFO
+src/picobuild.egg-info/SOURCES.txt
+src/picobuild.egg-info/dependency_links.txt
+src/picobuild.egg-info/requires.txt
+src/picobuild.egg-info/top_level.txt
+tests/test_cython_utils.py
+tests/test_picobuild.py
+tests/test_setuptools.py

picobuild-0.0.4/src/picobuild.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

picobuild-0.0.4/src/picobuild.egg-info/requires.txt

@@ -0,0 +1,8 @@
+setuptools>=80.9.0
+
+[dev]
+black
+build
+flake8
+isort
+mypy

picobuild-0.0.4/src/picobuild.egg-info/top_level.txt

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

picobuild-0.0.4/tests/test_cython_utils.py

@@ -0,0 +1,23 @@
+import os
+import tempfile
+import unittest
+
+from picobuild import get_cython_build_dir, Extension, cythonize
+
+
+class TestCythonUtils(unittest.TestCase):
+    def test_get_cython_build_dir(self):
+        result = get_cython_build_dir()
+        self.assertIsInstance(result, str)
+        self.assertTrue(result.startswith("build/cython."))
+
+    def test_cythonize(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            test_pyx = os.path.join(tmpdir, "test.pyx")
+            with open(test_pyx, "w") as f:
+                f.write("def hello(): pass\n")
+            result = cythonize([Extension("test", [test_pyx])])
+            self.assertIsInstance(result, list)
+            self.assertEqual(len(result), 1)
+            self.assertIsInstance(result[0], Extension)
+            self.assertEqual(result[0].name, "test")

picobuild-0.0.4/tests/test_picobuild.py

@@ -0,0 +1,9 @@
+import unittest
+
+import picobuild
+
+
+class TestPicobuild(unittest.TestCase):
+    def test_all_exports(self):
+        for name in picobuild.__all__:
+            self.assertTrue(hasattr(picobuild, name))

picobuild-0.0.4/tests/test_setuptools.py

@@ -0,0 +1,10 @@
+import unittest
+
+from picobuild import Extension, find_packages, setup
+
+
+class TestSetuptools(unittest.TestCase):
+    def test_imports(self):
+        self.assertIsNotNone(Extension)
+        self.assertIsNotNone(find_packages)
+        self.assertIsNotNone(setup)