cpro-client 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d6e3e9d0a4d4ff1848daa453f05afde782c62d4f17ee335981c7ff326cc9036
-  data.tar.gz: a9f2e83538efb36298ee64fd3df20ba04de571511c447ca4388e64295fa755f9
+  metadata.gz: eed2218b6135210909bb231938a2adf3d8f9b432a19468576b232ffd2f352d7a
+  data.tar.gz: 95739510c05be2fdc248b2f001e4b53e08b3487162dbb29f50bc26606d929e06
 SHA512:
-  metadata.gz: ad2b85661fc6009da13f5a44d284799d4149c9013ddc278a3350afd594c44ab830f7f010c1c0d8da3217da3af0fb259a08e22da568d876af09cf6665071c255b
-  data.tar.gz: 23f10b4ec03ac82f59a7e7be4dc7592e202ab05ee84beb1756c963055ef3c53b19a246006d8aa8f3920a7941723b4cdb86127de9be1597a358337b7f835932ca
+  metadata.gz: 7208819c95be0220d40498c3d09c5df5479619c652c6103aac41903ce1cac6054f47b53a7c87638fd7b474e99581a61b6924ab1d0f17b633bb18a72d431e8a94
+  data.tar.gz: 4c292e8c13863bdff0fe54ab567e42880c4d25e5d928ca70fb6c1a83284198912cc14b5dd787f0733763e181a7923f08ab7768a0ee5007b5b4e52b3719c4b7f0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cpro-client (0.2.3)
+    cpro-client (0.2.4)
       faraday (>= 0.9, < 3.0)
 
 GEM

data/lib/cpro/adressage.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Cpro
+  # Situe une valeur d'adressage dans la hiérarchie de l'annuaire : SIREN → SIRET → service.
+  # Quatre formes sont acceptées — SIREN, SIRET, SIRET_SERVICE et SIREN_SIRET_SERVICE.
+  #
+  # Le service ne se lit jamais par découpage sur « _ » : il en contient lui-même
+  # (SERVICE_PUBLIQUE_1_71915767420316) et peut être purement numérique ("2026"). Il se lit comme
+  # tout ce qui suit le SIRET.
+  class Adressage
+    PREFIXE_SIREN = /\A(\d{9})_(?=\d{14})/.freeze
+    SIRET = /\A(\d{14})/.freeze
+    SIREN_SEUL = /\A(\d{9})\z/.freeze
+
+    attr_reader :siren, :siret, :service
+
+    def self.parse(valeur)
+      texte = valeur.to_s.strip
+      raise ArgumentError, "valeur d'adressage vide" if texte.empty?
+
+      prefixe = texte[PREFIXE_SIREN, 1]
+      reste = prefixe ? texte[10..] : texte
+      depuis_siret(prefixe, reste) || depuis_siren(reste) ||
+        raise(ArgumentError, "valeur d'adressage illisible : #{valeur.inspect} " \
+                             "(attendus : SIREN, SIRET, SIRET_SERVICE ou SIREN_SIRET_SERVICE)")
+    end
+
+    def self.depuis_siret(prefixe, reste)
+      siret = reste[SIRET, 1]
+      return nil if siret.nil?
+
+      raise ArgumentError, "SIREN #{prefixe} incohérent avec le SIRET #{siret}" if prefixe && prefixe != siret[0, 9]
+
+      new(siren: siret[0, 9], siret: siret, service: reste[14..].to_s.sub(/\A_/, ""))
+    end
+    private_class_method :depuis_siret
+
+    def self.depuis_siren(reste)
+      siren = reste[SIREN_SEUL, 1]
+      siren && new(siren: siren, siret: nil, service: nil)
+    end
+    private_class_method :depuis_siren
+
+    def initialize(siren:, siret: nil, service: nil)
+      @siren = siren
+      @siret = siret
+      @service = service.nil? || service.empty? ? nil : service
+    end
+
+    # Du plus précis au plus général : la valeur elle-même, puis ses parents successifs. C'est
+    # l'ordre dans lequel une adresse active est cherchée.
+    def paliers
+      [
+        (self.class.new(siren: siren, siret: siret, service: service) if service),
+        (self.class.new(siren: siren, siret: siret) if siret),
+        self.class.new(siren: siren)
+      ].compact
+    end
+
+    # Une ligne d'annuaire correspond à ce palier si elle décrit le même niveau de précision.
+    def correspond?(ligne)
+      ligne.siret == siret && ligne.identifiant_routage.to_s.empty? == service.nil? &&
+        (service.nil? || ligne.identifiant_routage == service)
+    end
+
+    def to_s
+      [siret ? "#{siren}_#{siret}" : siren, service].compact.join("_")
+    end
+  end
+end

data/lib/cpro/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cpro
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cpro-client
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Hôtentic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-03 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -53,6 +53,7 @@ files:
 - lib/cpro-client.rb
 - lib/cpro.rb
 - lib/cpro/account.rb
+- lib/cpro/adressage.rb
 - lib/cpro/archive.rb
 - lib/cpro/auth/token.rb
 - lib/cpro/auth/token_provider.rb