package_json 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7701de73f335d8ffa510d3b70b14760f14e9f6e0f788731dae5906b161096f0
-  data.tar.gz: b69e61483d713e9042f3caa6f6ab9aef9fd34b544ee71c43e576a7d865995023
+  metadata.gz: f55805d478e11aa4c918eb7b8acd0b1dc2dfead0488cc931f50a10a1b0b4ea18
+  data.tar.gz: 727ce06575bfe624628999e5ad6ef18b07caf10c4bad32af75a8fb78837b4f6d
 SHA512:
-  metadata.gz: fc64ad921756cbdd7a4c9e31b3378dcb70e71d92a2c396d3458c61d0945c73ae0a6a05dfef3d407eba4f42529e04f80f363175523d407835e3460a7a14879447
-  data.tar.gz: a6ac06b455574ac417158caaf27f5d2a5472c11c9645d2a7a967fd6af017f5f6d4ccfc897e6fb4c4a5699e7168a4ad29cf68f0dd8143811f46e1dc92d8504e65
+  metadata.gz: 876cae7108678cb22b42c15e8fa68a65e301235b4420309a077410dc06fc311a531335d0d5382c581477d70e2cd96dabc5f7177b2be05c05f7b9d623ae19ef97
+  data.tar.gz: f91171d95c197651ee4257d0beb728d9b5c504cd2d3290a8bfae5a36d1d18163108ec119a17c04408c3bf9c9c7fec0da8600b909a6f44989f9b4c8b477bac8ff

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [0.2.0] - 2025-11-06
+
+### Added
+
+- Add support for `exact` parameter in `add` method to install packages with
+  exact versions ([#29](https://github.com/shakacode/package_json/pull/29))
+
+### Fixed
+
+- Ensure RBS for `PackageJson` class is correct
+  ([#39](https://github.com/shakacode/package_json/pull/39))
+
 ## [0.1.1] - 2025-11-04
 
 ### Changed

data/CLAUDE.md

@@ -79,6 +79,13 @@ files and JavaScript package managers.
 - **Testing**: RSpec for Ruby tests
 - **Linting**: RuboCop for Ruby
 
+## Type Signatures & Documentation
+
+**This project uses RBS (Ruby Signature) files for type documentation**
+
+Everything should be captured in the type definitions, including private
+methods.
+
 ## Important Notes
 
 - This gem provides a "middle-level" abstraction over JavaScript package

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    package_json (0.1.1)
+    package_json (0.2.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -177,11 +177,15 @@ package_json.manager.add(["eslint", "prettier"], type: :dev)
 
 # adds dotenv-webpack v6 as a production dependency
 package_json.manager.add(["dotenv-webpack@^6"])
+
+# adds react-on-rails with exact version (no ^ or ~)
+package_json.manager.add(["react-on-rails@16.0.0"], exact: true)
 ```
 
-| Option | Description                                                                                 |
-| ------ | ------------------------------------------------------------------------------------------- |
-| `type` | The type to add the dependencies as; either `:production` (default), `:dev`, or `:optional` |
+| Option  | Description                                                                                 |
+| ------- | ------------------------------------------------------------------------------------------- |
+| `type`  | The type to add the dependencies as; either `:production` (default), `:dev`, or `:optional` |
+| `exact` | If true, saves packages with exact versions (no `^` or `~` prefix)                          |
 
 #### Removing dependencies
 

data/lib/package_json/managers/base.rb

@@ -40,13 +40,13 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
+      def add(packages, type: :production, exact: false)
         raise NotImplementedError
       end
 
       # Adds the given packages
-      def add!(packages, type: :production)
-        raise_exited_with_non_zero_code_error unless add(packages, type: type)
+      def add!(packages, type: :production, exact: false)
+        raise_exited_with_non_zero_code_error unless add(packages, type: type, exact: exact)
       end
 
       # Removes the given packages

data/lib/package_json/managers/bun_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -62,6 +63,12 @@ class PackageJson
         []
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/npm_like.rb

@@ -22,8 +22,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("install", [package_type_install_flag(type)] + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("install", flags + packages)
       end
 
       # Removes the given packages
@@ -66,6 +67,12 @@ class PackageJson
         args
       end
 
+      def exact_flag(exact)
+        return "--save-exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/pnpm_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)] + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -67,6 +68,12 @@ class PackageJson
         ["--no-frozen-lockfile"]
       end
 
+      def exact_flag(exact)
+        return "--save-exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/yarn_berry_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -64,6 +65,12 @@ class PackageJson
         ["--no-immutable"]
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/yarn_classic_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -79,6 +80,12 @@ class PackageJson
         []
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class PackageJson
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/sig/package_json/managers/base.rbs

@@ -13,9 +13,9 @@ class PackageJson
 
       def native_install_command: (?frozen: bool) -> Array[String]
 
-      def add: (Array[String] packages, ?type: :production | :dev | :optional) -> (bool | nil)
+      def add: (Array[String] packages, ?type: :production | :dev | :optional, ?exact: bool) -> (bool | nil)
 
-      def add!: (Array[String] packages, ?type: :production | :dev | :optional) -> void
+      def add!: (Array[String] packages, ?type: :production | :dev | :optional, ?exact: bool) -> void
 
       def remove: (Array[String] packages) -> (bool | nil)
 

data/sig/package_json/managers/bun_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json/managers/npm_like.rbs

@@ -11,6 +11,8 @@ class PackageJson
           silent: bool
         ) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> String
     end
   end

data/sig/package_json/managers/pnpm_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> String
     end
   end

data/sig/package_json/managers/yarn_berry_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json/managers/yarn_classic_like.rbs

@@ -15,6 +15,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json.rbs

@@ -12,14 +12,18 @@ class PackageJson
 
   def self.fetch_default_fallback_manager: () -> Symbol
 
-  def self.read: (?String path_to_directory, ?package_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
+  def self.read: (?String path_to_directory, ?fallback_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
 
-  def initialize: (?String path_to_directory, ?package_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
+  def initialize: (?String path_to_directory, ?fallback_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
 
   def fetch: (String key, ?untyped default) -> (String | Hash[String, untyped] | Array[untyped])
 
   def merge!: () { (Hash[String | Symbol, untyped]) -> Hash[String | Symbol, untyped] } -> void
 
+  def delete!: (String key) -> untyped
+
+  def record_package_manager!: () -> void
+
   private
 
   @directory: String
@@ -30,9 +34,9 @@ class PackageJson
 
   def package_json_path: () -> String
 
-  def ensure_package_json_exists: ((:npm | :yarn_berry | :yarn_classic | :pnpm | :bun) package_manager) -> void
+  def ensure_package_json_exists: () -> bool
 
-  def read_package_json: () -> void
+  def read_package_json: () -> Hash[String, untyped]
 
   def write_package_json: (_ToJson contents) -> void
 end

metadata

@@ -1,16 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: package_json
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Gareth Jones
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description:
 email:
 - open-source@ackama.com
 executables: []
@@ -56,7 +54,6 @@ metadata:
   source_code_uri: https://github.com/shakacode/package_json
   changelog_uri: https://github.com/shakacode/package_json/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -71,8 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: The missing gem for managing package.json files in Ruby
 test_files: []