Merge pull request #14 from git-pkgs/add-init-operation

Add init operation for 22 package managers

Author: andrew

README.md

@@ -4,7 +4,7 @@ A Go library that wraps package manager CLIs behind a common interface. Part of
 
 ## What it does
 
-Translates generic operations (install, add, remove, list, outdated, update, vendor, resolve) into the correct CLI commands for each package manager. Define what you want to do once, and the library figures out the right command for npm, bundler, cargo, go, or any other supported manager.
+Translates generic operations (init, install, add, remove, list, outdated, update, vendor, resolve) into the correct CLI commands for each package manager. Define what you want to do once, and the library figures out the right command for npm, bundler, cargo, go, or any other supported manager.
 
 ```go
 translator := managers.NewTranslator()
@@ -83,7 +83,7 @@ cmd, _ = translator.BuildCommand("bundler", "add", managers.CommandInput{
 | helm | helm | Chart.lock |
 | brew | homebrew | - |
 
-Most managers support: install, add, remove, list, outdated, update, resolve. Some also support vendor and path. Some managers (maven, gradle, sbt, lein) have limited CLI support for add/remove operations.
+Most managers support: install, add, remove, list, outdated, update, resolve. Some also support init, vendor and path. Some managers (maven, gradle, sbt, lein) have limited CLI support for add/remove operations.
 
 ## Installation
 
@@ -211,6 +211,7 @@ Built-in policies include AllowAllPolicy, DenyAllPolicy, and PackageBlocklistPol
 
 | Operation | Description |
 |-----------|-------------|
+| `init` | Initialize a new project with manifest file |
 | `install` | Install dependencies from lockfile |
 | `add` | Add a new dependency |
 | `remove` | Remove a dependency |
@@ -229,6 +230,20 @@ Built-in policies include AllowAllPolicy, DenyAllPolicy, and PackageBlocklistPol
 | `frozen` | Fail if lockfile would change (CI mode) |
 | `json` | Output in JSON format (where supported) |
 
+### Initializing projects
+
+The `init` operation creates a new project manifest in the current directory. This is useful for creating temporary projects for dependency resolution or scaffolding new projects.
+
+```go
+manager, _ := managers.Detect("/path/to/empty/dir")
+result, _ := manager.Init(ctx)
+// Creates package.json (npm), Gemfile (bundler), Cargo.toml (cargo), etc.
+```
+
+Only managers that can scaffold in-place are supported. Managers whose `new` command always creates a child directory (mix, lein, helm, stack, pub, rebar3) or whose `init` command bootstraps global state rather than a project (opam) are excluded.
+
+**Managers with init support:** npm, pnpm, yarn, bun, bundler, cargo, gomod, uv, poetry, deno, composer, swift, nuget, gradle, conan, conda, cabal, nimble, luarocks, shards, vcpkg, renv
+
 ### Getting package paths
 
 The `path` operation returns the filesystem path to an installed package, useful for source exploration or editor integration:

definitions/bun.yaml

@@ -18,6 +18,12 @@ detection:
   priority: 25  # Higher than npm/yarn/pnpm when bun lockfile present
 
 commands:
+  init:
+    base: [init, -y]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -92,6 +98,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/bundler.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: '(\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -125,6 +131,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/cabal.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'cabal-install version (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, -n, -p, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [build, --only-dependencies]
     flags:
@@ -63,6 +69,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - list
   - outdated

definitions/cargo.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: 'cargo (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, --lib]
+    exit_codes:
+      0: success
+      1: error
+
   # cargo fetch downloads dependencies without building
   # cargo build would also work but does more than just install
   install:
@@ -129,6 +135,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/composer.yaml

@@ -17,6 +17,13 @@ detection:
   priority: 10
 
 commands:
+  init:
+    base: [init, -n]
+    default_flags: [--name, resolve/tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -91,6 +98,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - add_dev

definitions/conan.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'Conan version (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [new, basic, -d, "name=resolve_tmp", -d, "version=0.1"]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, .]
     flags:
@@ -82,6 +88,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/conda.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'conda (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [create, -n, resolve-tmp, --yes]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, --yes]
     base_overrides:
@@ -96,6 +102,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/deno.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'deno (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -86,6 +92,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/gomod.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: 'go(\d+\.\d+(?:\.\d+)?)'
 
 commands:
+  init:
+    base: [mod, init, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   # go mod download fetches dependencies
   install:
     base: [mod, download]
@@ -124,6 +130,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove