kmpkg 0.1.0__tar.gz

kmpkg-0.1.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: kmpkg
+Version: 0.1.0
+Summary: vcpkg-compatible package manager with C++ project scaffolding
+Author-email: "Kumo Inc." <dev@kumose.cc>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/kumose/kmpkg
+Project-URL: Repository, https://github.com/kumose/kmpkg.git
+Project-URL: Documentation, https://github.com/kumose/kmpkg
+Keywords: vcpkg,package-manager,c++,cmake,kmpkg
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=12.0
+
+# kmpkg
+
+A Python reimplementation of the vcpkg package manager, with built-in C++ project scaffolding via kmcmake templates.
+
+## Installation
+
+```bash
+pip install kmpkg
+```
+
+Requires Python >= 3.8 and `cmake` on PATH.
+
+## Quick Start
+
+```bash
+# Create a C++ project from kmcmake template
+kmpkg new --project --name myapp -o ./myapp
+
+# Install a port
+kmpkg install fmt
+
+# Search available ports
+kmpkg search fmt
+
+# List installed ports
+kmpkg list
+```
+
+## Configuration
+
+kmpkg reads `kmpkg-configuration.json` from the current directory or kmpkg root:
+
+```json
+{
+  "default-registry": {
+    "kind": "git",
+    "baseline": "d5c94a00e9d3d27a88399368d789971bc7e4fca8",
+    "repository": "https://github.com/kumose/kmpkgcore.git"
+  }
+}
+```
+
+The root directory defaults to `$KMPKG_ROOT` or `/home/jeff/kmpkgcore`.
+
+## Commands
+
+### Project Creation
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg new --project --name X -o path` | Create C++ project from kmcmake template |
+| `kmpkg new --name X --version Y` | Create a new `kmpkg.json` manifest |
+| `kmpkg add fmt` | Add dependency to manifest |
+
+### Package Management
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg install fmt` | Build and install a port |
+| `kmpkg install` | Install all dependencies from `kmpkg.json` |
+| `kmpkg remove fmt` | Uninstall a port |
+| `kmpkg update` | List upgradable packages |
+| `kmpkg upgrade` | Rebuild outdated packages |
+
+### Build
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg build fmt` | Build a single port |
+| `kmpkg build fmt --overrides fmt=10.0.0` | Build with version overrides |
+| `kmpkg ci --all` | CI build all ports |
+| `kmpkg test-features fmt` | Test all feature combinations |
+| `kmpkg check-support fmt` | Check if port is supported |
+
+### Information
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg list` | List all available ports |
+| `kmpkg search fmt` | Search ports by pattern |
+| `kmpkg find fmt` | Alias for search |
+| `kmpkg package-info fmt` | Show port details |
+| `kmpkg depend-info fmt` | Show dependency tree |
+| `kmpkg owns file.h` | Find which package owns a file |
+| `kmpkg license-report` | Show licenses of installed packages |
+
+### Registry Management
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg clone -i <src> -o <dst> -p fmt` | Clone ports with recursive deps |
+| `kmpkg publish fmt` | Publish port changes |
+| `kmpkg update-registry` | Fetch latest from git registry |
+| `kmpkg regenerate` | Regenerate version DB from ports/ |
+| `kmpkg x-add-version fmt` | Update version database |
+| `kmpkg x-update-baseline --add fmt=1.0` | Add baseline entry |
+| `kmpkg gitlog` | Show registry git log |
+| `kmpkg gitlog -p fmt` | Show port change history |
+
+### Integration
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg integrate install` | Set up CMake integration |
+| `kmpkg integrate remove` | Remove CMake integration |
+| `kmpkg autocomplete bash` | Install shell completion |
+| `kmpkg autocomplete bash --remove` | Remove shell completion |
+| `kmpkg env --bin` | Create build environment |
+
+### Export & Config
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg export fmt` | Export installed packages |
+| `kmpkg config show` | Show configuration |
+| `kmpkg config default-triplet x64-linux` | Set default triplet |
+| `kmpkg version` | Show version |
+
+## Architecture
+
+```
+kmpkg/
+  cli/              -- Click-based CLI (54 commands)
+  core/             -- Core modules
+    builder.py      -- PortBuilder (cmake -P portfile.cmake)
+    dependency_resolver.py  -- Transitive dependency resolution
+    statusdb.py     -- Installed package tracking
+    binary_cache.py -- ABI-hash based binary cache
+    download_manager.py     -- Download with SHA512 verification
+    kmpkgpaths.py   -- Path discovery + registry configuration
+  registry/
+    builtin.py      -- Local files registry
+    git.py          -- Git registry (remote clone/fetch)
+    registry_set.py -- Registry routing
+    port_provider.py -- Port file provider
+  tests/            -- 74 pytest tests
+```
+
+## Development
+
+```bash
+git clone https://github.com/kumose/kmpkg
+cd kmpkg
+pip install -e .
+pytest
+```
+
+## License
+
+Apache 2.0

kmpkg-0.1.0/README.md

@@ -0,0 +1,150 @@
+# kmpkg
+
+A Python reimplementation of the vcpkg package manager, with built-in C++ project scaffolding via kmcmake templates.
+
+## Installation
+
+```bash
+pip install kmpkg
+```
+
+Requires Python >= 3.8 and `cmake` on PATH.
+
+## Quick Start
+
+```bash
+# Create a C++ project from kmcmake template
+kmpkg new --project --name myapp -o ./myapp
+
+# Install a port
+kmpkg install fmt
+
+# Search available ports
+kmpkg search fmt
+
+# List installed ports
+kmpkg list
+```
+
+## Configuration
+
+kmpkg reads `kmpkg-configuration.json` from the current directory or kmpkg root:
+
+```json
+{
+  "default-registry": {
+    "kind": "git",
+    "baseline": "d5c94a00e9d3d27a88399368d789971bc7e4fca8",
+    "repository": "https://github.com/kumose/kmpkgcore.git"
+  }
+}
+```
+
+The root directory defaults to `$KMPKG_ROOT` or `/home/jeff/kmpkgcore`.
+
+## Commands
+
+### Project Creation
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg new --project --name X -o path` | Create C++ project from kmcmake template |
+| `kmpkg new --name X --version Y` | Create a new `kmpkg.json` manifest |
+| `kmpkg add fmt` | Add dependency to manifest |
+
+### Package Management
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg install fmt` | Build and install a port |
+| `kmpkg install` | Install all dependencies from `kmpkg.json` |
+| `kmpkg remove fmt` | Uninstall a port |
+| `kmpkg update` | List upgradable packages |
+| `kmpkg upgrade` | Rebuild outdated packages |
+
+### Build
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg build fmt` | Build a single port |
+| `kmpkg build fmt --overrides fmt=10.0.0` | Build with version overrides |
+| `kmpkg ci --all` | CI build all ports |
+| `kmpkg test-features fmt` | Test all feature combinations |
+| `kmpkg check-support fmt` | Check if port is supported |
+
+### Information
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg list` | List all available ports |
+| `kmpkg search fmt` | Search ports by pattern |
+| `kmpkg find fmt` | Alias for search |
+| `kmpkg package-info fmt` | Show port details |
+| `kmpkg depend-info fmt` | Show dependency tree |
+| `kmpkg owns file.h` | Find which package owns a file |
+| `kmpkg license-report` | Show licenses of installed packages |
+
+### Registry Management
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg clone -i <src> -o <dst> -p fmt` | Clone ports with recursive deps |
+| `kmpkg publish fmt` | Publish port changes |
+| `kmpkg update-registry` | Fetch latest from git registry |
+| `kmpkg regenerate` | Regenerate version DB from ports/ |
+| `kmpkg x-add-version fmt` | Update version database |
+| `kmpkg x-update-baseline --add fmt=1.0` | Add baseline entry |
+| `kmpkg gitlog` | Show registry git log |
+| `kmpkg gitlog -p fmt` | Show port change history |
+
+### Integration
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg integrate install` | Set up CMake integration |
+| `kmpkg integrate remove` | Remove CMake integration |
+| `kmpkg autocomplete bash` | Install shell completion |
+| `kmpkg autocomplete bash --remove` | Remove shell completion |
+| `kmpkg env --bin` | Create build environment |
+
+### Export & Config
+
+| Command | Description |
+|---------|-------------|
+| `kmpkg export fmt` | Export installed packages |
+| `kmpkg config show` | Show configuration |
+| `kmpkg config default-triplet x64-linux` | Set default triplet |
+| `kmpkg version` | Show version |
+
+## Architecture
+
+```
+kmpkg/
+  cli/              -- Click-based CLI (54 commands)
+  core/             -- Core modules
+    builder.py      -- PortBuilder (cmake -P portfile.cmake)
+    dependency_resolver.py  -- Transitive dependency resolution
+    statusdb.py     -- Installed package tracking
+    binary_cache.py -- ABI-hash based binary cache
+    download_manager.py     -- Download with SHA512 verification
+    kmpkgpaths.py   -- Path discovery + registry configuration
+  registry/
+    builtin.py      -- Local files registry
+    git.py          -- Git registry (remote clone/fetch)
+    registry_set.py -- Registry routing
+    port_provider.py -- Port file provider
+  tests/            -- 74 pytest tests
+```
+
+## Development
+
+```bash
+git clone https://github.com/kumose/kmpkg
+cd kmpkg
+pip install -e .
+pytest
+```
+
+## License
+
+Apache 2.0

kmpkg-0.1.0/kmpkg/__init__.py

@@ -0,0 +1,16 @@
+# Copyright (C) Kumo inc. and its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+from __future__ import annotations
+# limitations under the License.
+

kmpkg-0.1.0/kmpkg/__main__.py

@@ -0,0 +1,20 @@
+# Copyright (C) Kumo inc. and its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+from __future__ import annotations
+# limitations under the License.
+
+from kmpkg.cli.main import main
+
+if __name__ == "__main__":
+    main()

kmpkg-0.1.0/kmpkg/cli/__init__.py

@@ -0,0 +1,16 @@
+# Copyright (C) Kumo inc. and its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+from __future__ import annotations
+# limitations under the License.
+

kmpkg-0.1.0/kmpkg/cli/commands/__init__.py

@@ -0,0 +1,152 @@
+# Copyright (C) Kumo inc. and its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+from __future__ import annotations
+# limitations under the License.
+
+from kmpkg.cli.commands.basic import (
+    bootstrap_standalone,
+    contact,
+    download_tool,
+    format_feature_baseline,
+    hash_cmd,
+    init_registry,
+)
+from kmpkg.cli.commands.build import (
+    build,
+    build_external,
+    check_support,
+    ci,
+)
+from kmpkg.cli.commands.config import config
+from kmpkg.cli.commands.export import (
+    export,
+    generate_msbuild_props,
+)
+from kmpkg.cli.commands.gitlog import gitlog
+from kmpkg.cli.commands.help_cmd import help_cmd
+from kmpkg.cli.commands.info import (
+    depend_info,
+    find,
+    license_report,
+    owns,
+    package_info,
+    portsdiff,
+)
+from kmpkg.cli.commands.install import (
+    install,
+    list_cmd,
+    remove,
+    search,
+    update_cmd,
+    upgrade,
+)
+from kmpkg.cli.commands.integrate import (
+    autocomplete,
+    env_cmd,
+    fetch,
+    integrate,
+)
+from kmpkg.cli.commands.manifest import (
+    add,
+    create,
+    edit,
+    format_manifest,
+    new,
+)
+from kmpkg.cli.commands.misc import (
+    acquire,
+    acquire_project,
+    activate,
+    ci_clean,
+    ci_verify_versions,
+    deactivate,
+    set_installed,
+    test_features,
+    use,
+    z_print_config,
+)
+from kmpkg.cli.commands.registry import (
+    regenerate,
+    update_registry,
+    x_add_version,
+    x_update_baseline,
+)
+from kmpkg.cli.commands.repo import clone, publish
+from kmpkg.cli.commands.version import version
+
+all_commands = [
+    # basic
+    version,
+    help_cmd,
+    config,
+    contact,
+    hash_cmd,
+    download_tool,
+    format_feature_baseline,
+    bootstrap_standalone,
+    init_registry,
+    # install
+    install,
+    remove,
+    list_cmd,
+    search,
+    update_cmd,
+    upgrade,
+    # manifest
+    add,
+    new,
+    format_manifest,
+    edit,
+    create,
+    # registry
+    x_add_version,
+    x_update_baseline,
+    update_registry,
+    regenerate,
+    # build
+    build,
+    build_external,
+    check_support,
+    ci,
+    # info
+    find,
+    depend_info,
+    package_info,
+    owns,
+    license_report,
+    portsdiff,
+    # integrate
+    integrate,
+    env_cmd,
+    autocomplete,
+    fetch,
+    # export
+    export,
+    generate_msbuild_props,
+    # repo
+    clone,
+    publish,
+    gitlog,
+    # misc
+    acquire,
+    acquire_project,
+    activate,
+    deactivate,
+    use,
+    set_installed,
+    test_features,
+    ci_clean,
+    ci_verify_versions,
+    z_print_config,
+]

kmpkg-0.1.0/kmpkg/cli/commands/basic.py

@@ -0,0 +1,56 @@
+# Copyright (C) Kumo inc. and its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+from __future__ import annotations
+# limitations under the License.
+
+from typing import Optional
+
+import click
+from rich.console import Console
+
+
+@click.command(name="contact", help="Display contact information")
+def contact() -> None:
+    Console().print("[cyan]contact[/cyan] stub")
+
+
+@click.command(name="hash", help="Compute file hashes")
+@click.argument("files", nargs=-1, required=True)
+def hash_cmd(files: tuple[str, ...]) -> None:
+    Console().print("[cyan]hash[/cyan] stub: {}".format(" ".join(files)))
+
+
+@click.command(name="download", help="Download a specific tool")
+@click.argument("tool", required=True)
+def download_tool(tool: str) -> None:
+    Console().print(f"[cyan]download[/cyan] stub: {tool}")
+
+
+@click.command(name="format-feature-baseline", help="Format CI feature baseline file")
+@click.argument("path", required=False)
+def format_feature_baseline(path: Optional[str] = None) -> None:
+    msg = "[cyan]format-feature-baseline[/cyan] stub"
+    if path:
+        msg += f" {path}"
+    Console().print(msg)
+
+
+@click.command(name="bootstrap-standalone", help="Bootstrap standalone kmpkg")
+def bootstrap_standalone() -> None:
+    Console().print("[cyan]bootstrap-standalone[/cyan] stub")
+
+
+@click.command(name="init-registry", help="Initialize a new registry")
+def init_registry() -> None:
+    Console().print("[cyan]init-registry[/cyan] stub")