decoupage_administratif 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3e2eef5985080f08a15b607dfbf34639566930a7ede002f3b8c1c216874116e
-  data.tar.gz: 6d439459098e99748141ec94404670b24c6e93e87eafa1bbcbd571933102fea4
+  metadata.gz: 15d8baade56f4081ec11036e1a10269d9a561eaca357835a9d6f81ae798749ec
+  data.tar.gz: dc037fd227031b91ed1f9c44035ac1ea5c58b0322ca40f7f81cff54b9327017a
 SHA512:
-  metadata.gz: e9409c585489bd09b725dd954df508636f56c3531ccda99fcab273893dd71b067c22fda01e79c06acf0a8f5056c8dee7ab750e8f346f34a0fd2c3dafc53d8807
-  data.tar.gz: 2452645b05e3dc51333d55e7a2e5350eadd61858231b8ebfb9d3261bad8f1e8890f71f218c2a22eb555b328f4be1ed0817da854d061db8e786006397b13120ca
+  metadata.gz: 6203a3495a45bbcde0201432929485e5d6aa5b8270a8afed54936712561b8c890dbea27c6a9763781e7fa1a40a8a0fef6863dbd368371313d024a4e0584850f1
+  data.tar.gz: b549a507147fba9e578d1104d521c4f2bea2e3a9d1cf9ab97406d81073b7c2fdf5f1428fa8acc23fa18ad5784bd17099c4a0218f6e39000aed503afe85d05073

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.2.0] - 2025-08-29
+
+### Changed
+- **Breaking**: Renamed `territory_intersects_with_insee_codes?` method to `includes_any_commune_code?` for better clarity and consistency with Ruby conventions
+- Method now has a more intuitive name that clearly indicates it checks if a territory includes any of the specified commune codes
+
 ## [0.1.1] - 2025-08-29
 
 ### Fixed
@@ -24,7 +30,7 @@
   - Search territories by INSEE codes
   - Find complete territories (departments, regions, EPCIs) from commune codes
   - Support for partial matching and case-insensitive searches
-- Territory intersection methods:
+- Territory inclusion methods:
   - `territory_intersects_with_insee_codes?`: Check if territory contains any of the given INSEE codes
   - `territory_insee_codes`: Get all INSEE codes for a territory
 - Flexible data configuration:

data/README.md

@@ -97,7 +97,7 @@ La gem propose des méthodes pour vérifier la correspondance entre territoires
 # Vérifier si un territoire contient au moins une commune d'une liste
 commune_codes = ['75001', '75002', '69001']
 departement = DecoupageAdministratif::Departement.find('75')
-departement.territory_intersects_with_insee_codes?(commune_codes) # => true
+departement.includes_any_commune_code?(commune_codes) # => true
 
 # Obtenir tous les codes INSEE des communes d'un territoire
 departement.territory_insee_codes # => ["75001", "75002", "75003", ...]
@@ -252,13 +252,13 @@ puts region.departements
 
 ### Territory extensions
 
-The gem provides methods to check intersections between territories and INSEE code lists:
+The gem provides methods to check if territories include specific commune codes:
 
 ```ruby
-# Check if a territory intersects with municipality INSEE codes
+# Check if a territory includes any of the specified municipality codes
 commune_codes = ['75001', '75002', '69001']
 departement = DecoupageAdministratif::Departement.find('75')
-departement.territory_intersects_with_insee_codes?(commune_codes) # => true
+departement.includes_any_commune_code?(commune_codes) # => true
 
 # Get all INSEE codes of municipalities in a territory
 departement.territory_insee_codes # => ["75001", "75002", "75003", ...]

data/lib/decoupage_administratif/territory_extensions.rb

@@ -2,11 +2,11 @@
 
 module DecoupageAdministratif
   module TerritoryExtensions
-    # Check if this territory intersects with a list of commune INSEE codes
+    # Check if this territory includes any of the specified commune codes
     # @param commune_insee_codes [Array<String>] array of commune INSEE codes to check against
-    # @return [Boolean] true if territory intersects with any of the provided codes
-    def territory_intersects_with_insee_codes?(commune_insee_codes)
-      territory_strategy.intersects_with_insee_codes?(commune_insee_codes)
+    # @return [Boolean] true if territory includes any of the provided commune codes
+    def includes_any_commune_code?(commune_insee_codes)
+      territory_strategy.includes_any_commune_code?(commune_insee_codes)
     end
 
     # Get commune INSEE codes for this territory

data/lib/decoupage_administratif/territory_strategies.rb

@@ -7,10 +7,10 @@ module DecoupageAdministratif
         @territory = territory
       end
 
-      def intersects_with_insee_codes?(commune_insee_codes)
+      def includes_any_commune_code?(commune_insee_codes)
         return false if commune_insee_codes.empty?
 
-        perform_intersection(commune_insee_codes)
+        check_inclusion(commune_insee_codes)
       end
 
       def insee_codes
@@ -21,7 +21,7 @@ module DecoupageAdministratif
 
       attr_reader :territory
 
-      def perform_intersection(commune_insee_codes)
+      def check_inclusion(commune_insee_codes)
         raise NotImplementedError, "Must be implemented by subclass"
       end
 
@@ -33,7 +33,7 @@ module DecoupageAdministratif
     class CommuneStrategy < Base
       private
 
-      def perform_intersection(commune_insee_codes)
+      def check_inclusion(commune_insee_codes)
         commune_insee_codes.include?(territory.code)
       end
 
@@ -45,7 +45,7 @@ module DecoupageAdministratif
     class DepartementStrategy < Base
       private
 
-      def perform_intersection(commune_insee_codes)
+      def check_inclusion(commune_insee_codes)
         departement_prefix = territory.code.length == 2 ? territory.code : territory.code[0..1]
         commune_insee_codes.any? { |commune_code| commune_code.start_with?(departement_prefix) }
       end
@@ -58,7 +58,7 @@ module DecoupageAdministratif
     class RegionStrategy < Base
       private
 
-      def perform_intersection(commune_insee_codes)
+      def check_inclusion(commune_insee_codes)
         departement_codes = territory.departements.map(&:code)
         commune_insee_codes.any? do |commune_code|
           dept_code = commune_code.length >= 3 && commune_code[0..1].to_i >= 96 ? commune_code[0..2] : commune_code[0..1]
@@ -74,7 +74,7 @@ module DecoupageAdministratif
     class EpciStrategy < Base
       private
 
-      def perform_intersection(commune_insee_codes)
+      def check_inclusion(commune_insee_codes)
         epci_commune_codes = territory.membres.map { |membre| membre[:code] || membre["code"] }
         (epci_commune_codes & commune_insee_codes).any?
       end

data/lib/decoupage_administratif/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module DecoupageAdministratif
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
   DATA_VERSION = "5.2.0"
   DATA_SOURCE = "@etalab/decoupage-administratif"
 end

data/sig/decoupage_administratif/territory_extensions.rbs

@@ -1,6 +1,6 @@
 module DecoupageAdministratif
   module TerritoryExtensions
-    def territory_intersects_with_insee_codes?: (Array[String] commune_insee_codes) -> bool
+    def includes_any_commune_code?: (Array[String] commune_insee_codes) -> bool
 
     def territory_insee_codes: () -> Array[String]
 

data/sig/decoupage_administratif/territory_strategies.rbs

@@ -3,7 +3,7 @@ module DecoupageAdministratif
     class Base
       def initialize: (untyped territory) -> void
 
-      def intersects_with_insee_codes?: (Array[String] commune_insee_codes) -> bool
+      def includes_any_commune_code?: (Array[String] commune_insee_codes) -> bool
 
       def insee_codes: () -> Array[String]
 
@@ -11,7 +11,7 @@ module DecoupageAdministratif
 
       attr_reader territory: untyped
 
-      def perform_intersection: (Array[String] commune_insee_codes) -> bool
+      def check_inclusion: (Array[String] commune_insee_codes) -> bool
 
       def calculate_insee_codes: () -> Array[String]
     end
@@ -19,7 +19,7 @@ module DecoupageAdministratif
     class CommuneStrategy < Base
       private
 
-      def perform_intersection: (Array[String] commune_insee_codes) -> bool
+      def check_inclusion: (Array[String] commune_insee_codes) -> bool
 
       def calculate_insee_codes: () -> Array[String]
     end
@@ -27,7 +27,7 @@ module DecoupageAdministratif
     class DepartementStrategy < Base
       private
 
-      def perform_intersection: (Array[String] commune_insee_codes) -> bool
+      def check_inclusion: (Array[String] commune_insee_codes) -> bool
 
       def calculate_insee_codes: () -> Array[String]
     end
@@ -35,7 +35,7 @@ module DecoupageAdministratif
     class RegionStrategy < Base
       private
 
-      def perform_intersection: (Array[String] commune_insee_codes) -> bool
+      def check_inclusion: (Array[String] commune_insee_codes) -> bool
 
       def calculate_insee_codes: () -> Array[String]
     end
@@ -43,7 +43,7 @@ module DecoupageAdministratif
     class EpciStrategy < Base
       private
 
-      def perform_intersection: (Array[String] commune_insee_codes) -> bool
+      def check_inclusion: (Array[String] commune_insee_codes) -> bool
 
       def calculate_insee_codes: () -> Array[String]
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decoupage_administratif
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Lucien Mollard