fhir_packages_manager 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3db88fe718417bdd2a0bd82604b48928db13d036ee912094cb8891e5218d967
-  data.tar.gz: d84a0f807bcd2f479cd511fb100cfd9c723c6b59fca65c5dc41aa2e6dd829418
+  metadata.gz: 4c2287ea505915de0f129d5ce615c60d6df687ed7253f62a0f3ef0b7f71c4a73
+  data.tar.gz: 1addb4d25614ee56ee29cbc4ebfe0598cfd2337e8cacde5ca011fcc121110b9f
 SHA512:
-  metadata.gz: 17d1da3f230507fbeb91cd949a90370561bcdeece97bdf433b169f16b7baadf960cc542bd9931f56b2b6afe93936a1d53865efe8f45e9be969e2f1883dcb5acf
-  data.tar.gz: 3b4e62d57b1b034c137869355e2d8454fc92292d3b0b59f4825abc89af0d86013afd76f563de14f95a23a03e28f1fd7783ef8b54994e7cf5137d44068bda562e
+  metadata.gz: 968af44ee62704494e47c21423c90b067c6ad0265aa4a27c254dcbd005800cc0c1e74ed691cedeefc15289e2b4c77c7012d88626ff0475148c4bfa272d0d7908
+  data.tar.gz: b1b2b5db5cf50a8a1d63cfc728ba3f0a0d69f37b3037f74d52b208c8620618276090f9c219229f8683f80988c6843044ecfb99f5fa03891ae1a7c0956167d2a3

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.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 +50,6 @@ 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.2.0...HEAD
+[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,8 @@ 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", ...], ...}
 ```
 
 The ignore list file (YAML or JSON) is a flat array where a bare string
@@ -60,6 +64,8 @@ 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
 ```
 
 ### Docker
@@ -74,7 +80,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].freeze
 
     # @return [String] usage text shown on --help and on invalid invocations
     BANNER = <<~USAGE
@@ -16,6 +16,7 @@ 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
 
     USAGE
 
@@ -53,6 +54,8 @@ module FhirPackagesManager
         fetch(package_specs)
       when 'check'
         check(package_specs)
+      when 'list'
+        list(package_specs)
       end
     end
 
@@ -132,5 +135,20 @@ 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
   end
 end

data/lib/fhir_packages_manager/manager.rb

@@ -60,6 +60,26 @@ 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
+
     private
 
     def fetch_package(package)
@@ -77,6 +97,12 @@ module FhirPackagesManager
       !!ignore_list&.ignored?(package.name, package.version)
     end
 
+    def available_versions(registry, name)
+      registry.versions(name).reject { |version| ignored?(Package.new(name, version)) }
+    rescue PackageNotFoundError
+      []
+    end
+
     def download_result(package, found)
       registry, resolved_version = found
       name = package.name

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.2.0'
 end

data/sig/fhir_packages_manager/cli.rbs

@@ -30,5 +30,9 @@ 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]
   end
 end

data/sig/fhir_packages_manager/manager.rbs

@@ -14,6 +14,8 @@ module FhirPackagesManager
 
     def fetch_all: (Array[String | Package] packages) -> Array[FetchResult]
 
+    def list_versions: (String name) -> Hash[String, Array[String]]
+
     private
 
     def fetch_package: (Package package) -> FetchResult
@@ -21,5 +23,7 @@ module FhirPackagesManager
     def ignored?: (Package package) -> bool
 
     def download_result: (Package package, [Registry, String] found) -> FetchResult
+
+    def available_versions: (Registry registry, String name) -> Array[String]
   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.2.0
 platform: ruby
 authors:
 - Pavel Rozhkov