pio-installer 1.0.0__py3-none-any.whl

pio_installer/__init__.py

@@ -0,0 +1,44 @@
+"""
+Install embedded C and C++ libraries into a PlatformIO project.
+
+Installed with pip, it is the pio-installer command. It takes a library from
+GitHub, from a downloaded zip, or from a folder, puts it into the project's
+lib folder with a library.json written for it, and gives the whole project
+the defines it needs in platformio.ini. Every framework PlatformIO builds
+with finds it there: Arduino, ESP-IDF, STM32Cube, Zephyr and the rest.
+
+The work that is the same for any project is the shared core, in core/, from
+github.com/nimaltd/core-installer. What a PlatformIO project is, is in pio.py.
+
+See https://github.com/nimaltd/pio-installer
+"""
+
+__version__ = "1.0.0"
+
+# Before anything of the core is used: it asks the target for every answer
+# that depends on the kind of project.
+from .core import target as _target  # noqa: E402
+from .pio import PlatformIO  # noqa: E402
+
+_target.use(PlatformIO(__version__))
+
+from .core.installer import InstallError, Result, install_in_place, install_to  # noqa: E402
+from .core.manifest import Manifest, ManifestError, load  # noqa: E402
+
+__all__ = [
+    "InstallError",
+    "Manifest",
+    "ManifestError",
+    "Result",
+    "install_in_place",
+    "install_to",
+    "load",
+    "main",
+]
+
+
+def main(argv=None):
+    """Run the command line interface. Imported lazily to keep start-up cheap."""
+    from .cli import main as _main
+
+    return _main(argv=argv)

pio_installer/__main__.py

@@ -0,0 +1,8 @@
+"""Lets the package be run directly: python -m pio_installer owner/example"""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

pio_installer/cli.py

@@ -0,0 +1,14 @@
+"""
+The pio-installer command: the core's command line, with the PlatformIO target.
+
+The target is chosen when the package is imported, before this runs.
+"""
+
+import sys
+
+from .core.cli import main
+
+__all__ = ["main"]
+
+if __name__ == "__main__":
+    sys.exit(main())

pio_installer/core/__init__.py

@@ -0,0 +1,12 @@
+"""
+The shared core of the installers: stm32-installer, zephyr-installer.
+
+It fetches a library from GitHub, a zip or a folder, reads its installer.yml,
+installs what it needs first, copies its files and keeps what the user wrote
+between USER CODE markers. What a project looks like, and how a library is
+registered with it, comes from the installer through target.use().
+
+Kept in its own repository, github.com/nimaltd/core-installer, and built into
+each installer's wheel, so an installer still installs from one file with no
+internet.
+"""