fhir_packages_manager 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3db88fe718417bdd2a0bd82604b48928db13d036ee912094cb8891e5218d967
-  data.tar.gz: d84a0f807bcd2f479cd511fb100cfd9c723c6b59fca65c5dc41aa2e6dd829418
+  metadata.gz: 7d65db7b1f5b29ac8f0064d0cfd224529dc336b2b88c7a4de952206fe81477f7
+  data.tar.gz: c16f3255dce19c1058b3781b5695e0c059e6d76b45dc63ff1c35a94891eacaa3
 SHA512:
-  metadata.gz: 17d1da3f230507fbeb91cd949a90370561bcdeece97bdf433b169f16b7baadf960cc542bd9931f56b2b6afe93936a1d53865efe8f45e9be969e2f1883dcb5acf
-  data.tar.gz: 3b4e62d57b1b034c137869355e2d8454fc92292d3b0b59f4825abc89af0d86013afd76f563de14f95a23a03e28f1fd7783ef8b54994e7cf5137d44068bda562e
+  metadata.gz: 016d41a5b7f0aed1ce89fa445e149ea85b4e991c9c61d9ba111fab699b113e88b8e62c650f8b08314e5246ca875927dbe0abb9bbdd92b9d68dbf8306c502f68c
+  data.tar.gz: bed4d3fb7c4f7abb708837a2ebbd7ecac247c18284b16e51967b216240f98878090df35765dcfdfdf3c8700c41ab785176d05d58747dff6a076ee636ef1ff29a

data/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [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
+
+- `list` CLI command and `Manager#list_versions`/`Registry#versions`: lists every version of a
+  package published across all configured registries, without needing a version suffix on the
+  spec. Respects the ignore list the same way `fetch` does (whole-package or single-version
+  entries). (#1)
+
 ## [0.1.0] - 2026-07-10
 
 ### Added
@@ -39,5 +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.1.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

@@ -1,5 +1,7 @@
-# FhirPackagesManager
+# FHIR Packages Manager 
 
+[![Gem Version](https://badge.fury.io/rb/fhir_packages_manager.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/fhir_packages_manager)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2-CC342D?logo=ruby&logoColor=white)](fhir_packages_manager.gemspec)
 [![codecov](https://codecov.io/gh/projkov/fhir_packages_manager/graph/badge.svg)](https://codecov.io/gh/projkov/fhir_packages_manager)
 [![docs](https://img.shields.io/badge/docs-yard-blue.svg)](https://projkov.github.io/fhir_packages_manager/)
 
@@ -42,6 +44,10 @@ result.status # => :downloaded, :ignored, :not_found, or :error
 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
@@ -60,8 +66,18 @@ exe/fhir_packages_manager check hl7.fhir.us.core@6.1.0 -r https://packages.fhir.
 exe/fhir_packages_manager fetch hl7.fhir.us.core@6.1.0 hl7.fhir.r4.core \
   -r https://packages.fhir.org -r https://packages.simplifier.net \
   -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
@@ -74,7 +90,13 @@ docker run --rm -v "$(pwd)/fhir_packages:/fhir_packages" ghcr.io/projkov/fhir_pa
   fetch hl7.fhir.us.core@6.1.0 -r https://packages.fhir.org -d /fhir_packages
 ```
 
-Mount a volume (as above) to get downloaded `.tgz` files back out onto the host.
+Mount a volume (as above) to get downloaded `.tgz` files back out onto the host. `latest` and
+version tags are built for both `linux/amd64` and `linux/arm64` (e.g. Apple Silicon).
+
+To get a fresh image built from an unreleased commit (without cutting a real gem release),
+run the **Docker Snapshot** workflow manually from the Actions tab. It re-runs the test/quality
+gate, then pushes `ghcr.io/projkov/fhir_packages_manager:<gem-version>-<commit-sha>` (e.g.
+`0.1.0-9649122`) — never `latest`, so it can't be mistaken for a real release.
 
 #### Docker Compose
 

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].freeze
+    COMMANDS = %w[fetch check list sync].freeze
 
     # @return [String] usage text shown on --help and on invalid invocations
     BANNER = <<~USAGE
@@ -16,6 +16,8 @@ module FhirPackagesManager
       Commands:
         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
 
@@ -53,6 +55,10 @@ module FhirPackagesManager
         fetch(package_specs)
       when 'check'
         check(package_specs)
+      when 'list'
+        list(package_specs)
+      when 'sync'
+        sync(package_specs)
       end
     end
 
@@ -110,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
@@ -132,5 +140,26 @@ module FhirPackagesManager
       registry, version = found
       "AVAILABLE   #{package.name}@#{version} (#{registry.base_url})"
     end
+
+    def list(package_specs)
+      package_specs.each do |spec|
+        name = Package.parse(spec).name
+        list_lines(name, manager.list_versions(name)).each { |line| puts line }
+      end
+    end
+
+    def list_lines(name, versions_by_registry)
+      return ["NONE  #{name} (not found in any registry)"] if versions_by_registry.empty?
+
+      versions_by_registry.map do |base_url, versions|
+        "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

@@ -60,6 +60,40 @@ module FhirPackagesManager
       packages.map { |package| fetch(package) }
     end
 
+    # Lists every version of a package published across all configured registries, skipping
+    # registries that don't have it at all and filtering out any ignored versions.
+    #
+    # @param name [String] the package name
+    # @return [Hash{String => Array<String>}] versions, keyed by registry base_url, for
+    #   registries that have at least one non-ignored version; empty if the whole package is
+    #   ignored or no registry has it
+    # @raise [HttpError] if a registry that does have the package fails for another reason
+    #   (mirrors {#find_registry}/{Registry#version?}, which likewise only treat "not found" as
+    #   an expected, non-raising outcome)
+    def list_versions(name)
+      result = {} # : Hash[String, Array[String]]
+      return result if ignored?(Package.new(name, nil))
+
+      registries.each_with_object(result) do |registry, found|
+        versions = available_versions(registry, name)
+        found[registry.base_url] = versions unless versions.empty?
+      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)
@@ -77,13 +111,38 @@ module FhirPackagesManager
       !!ignore_list&.ignored?(package.name, package.version)
     end
 
+    def available_versions(registry, name)
+      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/registry.rb

@@ -49,6 +49,14 @@ module FhirPackagesManager
       nil
     end
 
+    # @param name [String] the package name
+    # @return [Array<String>] every version published for this package on this registry
+    # @raise [PackageNotFoundError] if the package doesn't exist on this registry
+    # @raise [HttpError] for any other non-2xx/3xx response
+    def versions(name)
+      metadata(name)['versions']&.keys || []
+    end
+
     # @param name [String] the package name
     # @param version [String] an exact version, as returned by {#version?}
     # @return [String] the tarball's download URL

data/lib/fhir_packages_manager/version.rb

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

data/sig/fhir_packages_manager/cli.rbs

@@ -30,5 +30,11 @@ module FhirPackagesManager
     def check: (Array[String] package_specs) -> void
 
     def check_line: (Package package, [Registry, String]? found) -> String
+
+    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

@@ -14,12 +14,26 @@ module FhirPackagesManager
 
     def fetch_all: (Array[String | Package] packages) -> Array[FetchResult]
 
+    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 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

data/sig/fhir_packages_manager/registry.rbs

@@ -10,6 +10,8 @@ module FhirPackagesManager
 
     def version?: (String name, ?String? version) -> String?
 
+    def versions: (String name) -> Array[String]
+
     def tarball_url: (String name, String version) -> String
 
     def download: (String name, String version, String destination_path) -> String

metadata

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