fhir_packages_manager 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c2287ea505915de0f129d5ce615c60d6df687ed7253f62a0f3ef0b7f71c4a73
-  data.tar.gz: 1addb4d25614ee56ee29cbc4ebfe0598cfd2337e8cacde5ca011fcc121110b9f
+  metadata.gz: 7d65db7b1f5b29ac8f0064d0cfd224529dc336b2b88c7a4de952206fe81477f7
+  data.tar.gz: c16f3255dce19c1058b3781b5695e0c059e6d76b45dc63ff1c35a94891eacaa3
 SHA512:
-  metadata.gz: 968af44ee62704494e47c21423c90b067c6ad0265aa4a27c254dcbd005800cc0c1e74ed691cedeefc15289e2b4c77c7012d88626ff0475148c4bfa272d0d7908
-  data.tar.gz: b1b2b5db5cf50a8a1d63cfc728ba3f0a0d69f37b3037f74d52b208c8620618276090f9c219229f8683f80988c6843044ecfb99f5fa03891ae1a7c0956167d2a3
+  metadata.gz: 016d41a5b7f0aed1ce89fa445e149ea85b4e991c9c61d9ba111fab699b113e88b8e62c650f8b08314e5246ca875927dbe0abb9bbdd92b9d68dbf8306c502f68c
+  data.tar.gz: bed4d3fb7c4f7abb708837a2ebbd7ecac247c18284b16e51967b216240f98878090df35765dcfdfdf3c8700c41ab785176d05d58747dff6a076ee636ef1ff29a

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-07-10
+
+### Added
+
+- `sync` CLI command and `Manager#sync`: downloads every non-ignored version of a package not
+  already present in the destination folder (checked as `name-version.tgz`, the same naming
+  `fetch` uses), reusing `#fetch` for the actual download of each missing version. Output reuses
+  `fetch`'s `OK`/`SKIP`/`MISS`/`ERR` lines, with `SKIP` covering both an ignored version and one
+  already on disk. (#3)
+
 ## [0.2.0] - 2026-07-10
 
 ### Added
@@ -50,6 +60,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Documentation**: YARD doc comments across the public API, and a Codecov/docs badge pair
   in the README.
 
-[Unreleased]: https://github.com/projkov/fhir_packages_manager/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/projkov/fhir_packages_manager/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/projkov/fhir_packages_manager/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/projkov/fhir_packages_manager/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/projkov/fhir_packages_manager/releases/tag/v0.1.0

data/README.md

@@ -46,6 +46,8 @@ result.path   # => "./fhir_packages/hl7.fhir.us.core-6.1.0.tgz" when downloaded
 manager.fetch_all(["hl7.fhir.us.core@6.1.0", "hl7.fhir.r4.core"]) # bare name = latest
 
 manager.list_versions("hl7.fhir.us.core") # => {"https://packages.fhir.org" => ["1.0.0", "1.0.1", ...], ...}
+
+manager.sync("hl7.fhir.us.core") # fetches every non-ignored version not already in destination
 ```
 
 The ignore list file (YAML or JSON) is a flat array where a bare string
@@ -66,8 +68,16 @@ exe/fhir_packages_manager fetch hl7.fhir.us.core@6.1.0 hl7.fhir.r4.core \
   -d ./fhir_packages -i fhir_packages_ignore.yml
 exe/fhir_packages_manager list hl7.fhir.us.core \
   -r https://packages.fhir.org -r https://packages.simplifier.net
+exe/fhir_packages_manager sync hl7.fhir.us.core \
+  -r https://packages.fhir.org -d ./fhir_packages -i fhir_packages_ignore.yml
 ```
 
+`sync` downloads every non-ignored version of a package that isn't already in the destination
+folder (checked as `name-version.tgz`, the same naming `fetch` uses — keep that naming if you
+move the files afterward, since a bare `version.tgz` can collide between two IGs that happen to
+publish the same version number). Its output reuses `fetch`'s `OK`/`SKIP`/`MISS`/`ERR` lines,
+with `SKIP` covering both an ignored version and one already on disk.
+
 ### Docker
 
 The CLI is also published as a container image, so it can be used without installing Ruby

data/lib/fhir_packages_manager/cli.rb

@@ -7,7 +7,7 @@ module FhirPackagesManager
   # See the "CLI" section of the README for usage examples.
   class CLI
     # @return [Array<String>] the supported subcommands
-    COMMANDS = %w[fetch check list].freeze
+    COMMANDS = %w[fetch check list sync].freeze
 
     # @return [String] usage text shown on --help and on invalid invocations
     BANNER = <<~USAGE
@@ -17,6 +17,7 @@ module FhirPackagesManager
         fetch   Download packages into the destination folder
         check   Report which registry (if any) has each package/version
         list    List every version of a package available across registries
+        sync    Download every non-ignored version not already in the destination folder
 
     USAGE
 
@@ -56,6 +57,8 @@ module FhirPackagesManager
         check(package_specs)
       when 'list'
         list(package_specs)
+      when 'sync'
+        sync(package_specs)
       end
     end
 
@@ -113,9 +116,11 @@ module FhirPackagesManager
 
     def fetch_line(result)
       package = result.package
+      path = result.path
       case result.status
-      when :downloaded then "OK    #{package} -> #{result.path} (#{result.registry})"
+      when :downloaded then "OK    #{package} -> #{path} (#{result.registry})"
       when :ignored then "SKIP  #{package} (ignored)"
+      when :skipped then "SKIP  #{package} (already exists at #{path})"
       when :not_found then "MISS  #{package} (not found in any registry)"
       when :error then "ERR   #{package}: #{result.error}"
       end
@@ -150,5 +155,11 @@ module FhirPackagesManager
         "FOUND #{name} @ #{base_url}: #{versions.sort.join(', ')}"
       end
     end
+
+    def sync(package_specs)
+      results = package_specs.flat_map { |spec| manager.sync(Package.parse(spec).name) }
+      results.each { |result| puts fetch_line(result) }
+      exit 1 if results.any? { |result| result.not_found? || result.error? }
+    end
   end
 end

data/lib/fhir_packages_manager/fetch_result.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 module FhirPackagesManager
-  # Outcome of {Manager#fetch} for a single package.
+  # Outcome of {Manager#fetch} (or {Manager#sync}) for a single package/version.
   #
   # @!attribute package
   #   @return [Package] the package that was requested (version resolved, when downloaded)
   # @!attribute status
-  #   @return [Symbol] one of :downloaded, :ignored, :not_found, :error
+  #   @return [Symbol] one of :downloaded, :ignored, :skipped, :not_found, :error
   # @!attribute registry
   #   @return [String, nil] the base URL of the registry that served the package, if downloaded
   # @!attribute path
-  #   @return [String, nil] where the tarball was written, if downloaded
+  #   @return [String, nil] where the tarball was (or already is) on disk, if downloaded/skipped
   # @!attribute error
   #   @return [String, nil] the error message, when status is :error
   class FetchResult < Struct.new(:package, :status, :registry, :path, :error, keyword_init: true)
@@ -24,6 +24,11 @@ module FhirPackagesManager
       status == :ignored
     end
 
+    # @return [Boolean] true if {Manager#sync} skipped it because it was already downloaded
+    def skipped?
+      status == :skipped
+    end
+
     # @return [Boolean] true if no registry had the package/version
     def not_found?
       status == :not_found

data/lib/fhir_packages_manager/manager.rb

@@ -80,6 +80,20 @@ module FhirPackagesManager
       end
     end
 
+    # Downloads every non-ignored version of a package that isn't already present in
+    # {#destination} (as `name-version.tgz`, the same convention {#fetch} downloads use).
+    # A whole-package ignore skips it entirely, without querying any registry; an individual
+    # ignored version instead surfaces as a normal `:ignored` {FetchResult}, same as {#fetch}.
+    #
+    # @param name [String] the package name
+    # @return [Array<FetchResult>] one result per version considered, across all registries
+    def sync(name)
+      whole_package = Package.new(name, nil)
+      return [FetchResult.new(package: whole_package, status: :ignored)] if ignored?(whole_package)
+
+      candidate_versions(name).map { |version| sync_version(Package.new(name, version)) }
+    end
+
     private
 
     def fetch_package(package)
@@ -98,18 +112,37 @@ module FhirPackagesManager
     end
 
     def available_versions(registry, name)
-      registry.versions(name).reject { |version| ignored?(Package.new(name, version)) }
+      raw_versions(registry, name).reject { |version| ignored?(Package.new(name, version)) }
+    end
+
+    def raw_versions(registry, name)
+      registry.versions(name)
     rescue PackageNotFoundError
       []
     end
 
+    def candidate_versions(name)
+      registries.flat_map { |registry| raw_versions(registry, name) }.uniq
+    end
+
+    def sync_version(package)
+      existing_path = download_path(package)
+      return FetchResult.new(package: package, status: :skipped, path: existing_path) if File.exist?(existing_path)
+
+      fetch(package)
+    end
+
+    def download_path(package)
+      File.join(destination, "#{package.name}-#{package.version}.tgz")
+    end
+
     def download_result(package, found)
       registry, resolved_version = found
       name = package.name
-      target = File.join(destination, "#{name}-#{resolved_version}.tgz")
+      resolved_package = Package.new(name, resolved_version)
+      target = download_path(resolved_package)
       registry.download(name, resolved_version, target)
-      FetchResult.new(package: Package.new(name, resolved_version), status: :downloaded,
-                      registry: registry.base_url, path: target)
+      FetchResult.new(package: resolved_package, status: :downloaded, registry: registry.base_url, path: target)
     end
   end
 end

data/lib/fhir_packages_manager/version.rb

@@ -2,5 +2,5 @@
 
 module FhirPackagesManager
   # @return [String] the gem's version, following semver
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/sig/fhir_packages_manager/cli.rbs

@@ -34,5 +34,7 @@ module FhirPackagesManager
     def list: (Array[String] package_specs) -> void
 
     def list_lines: (String name, Hash[String, Array[String]] versions_by_registry) -> Array[String]
+
+    def sync: (Array[String] package_specs) -> void
   end
 end

data/sig/fhir_packages_manager/fetch_result.rbs

@@ -12,6 +12,8 @@ module FhirPackagesManager
 
     def ignored?: () -> bool
 
+    def skipped?: () -> bool
+
     def not_found?: () -> bool
 
     def error?: () -> bool

data/sig/fhir_packages_manager/manager.rbs

@@ -16,14 +16,24 @@ module FhirPackagesManager
 
     def list_versions: (String name) -> Hash[String, Array[String]]
 
+    def sync: (String name) -> Array[FetchResult]
+
     private
 
     def fetch_package: (Package package) -> FetchResult
 
     def ignored?: (Package package) -> bool
 
-    def download_result: (Package package, [Registry, String] found) -> FetchResult
-
     def available_versions: (Registry registry, String name) -> Array[String]
+
+    def raw_versions: (Registry registry, String name) -> Array[String]
+
+    def candidate_versions: (String name) -> Array[String]
+
+    def sync_version: (Package package) -> FetchResult
+
+    def download_path: (Package package) -> String
+
+    def download_result: (Package package, [Registry, String] found) -> FetchResult
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fhir_packages_manager
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Pavel Rozhkov