nice 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2383669fde6abef553cb3f5cfe2cfa277ea687483e8109ff83c56b355b93b8ad
-  data.tar.gz: 6c12ca762ff25c2eb8683d58d901fdd113353a4814a01dcaac83cf56d97c551e
+  metadata.gz: 9a7c4f589ce84353843f51bead144c5baa739032ac3de0efe7fa223510a97f97
+  data.tar.gz: cc875cb0407b2489e00342d6f78e78cb72d5cdbbaa0d7c2bb4d244a29b5537df
 SHA512:
-  metadata.gz: da046cd4168816b909a662428a16c6bf5d84fdd738bf6d2b6ac0e7e59ac6f97596b13b651c80d405806a3f5a59dc3e1f9721f45402bb0f9d69ebaa8e7515b233
-  data.tar.gz: 3f64640ce6cb5ca6af4f93125a6932c08424b74800d0906d13d0b813ed29504cbbde6639b56bbbb44a4f35bb43f3cd88007c631efd4640ed25d1430443f9ab6c
+  metadata.gz: 88001fdd0e6d14fbc07526e1b81c769bbb1d3c54bd05c1881c6e8acfe35361c8420a279f8b1feecb2e383ca10371a0caef455b229b20024126e95bc625a91ee7
+  data.tar.gz: 0df0cd12ad4c61f79d3c62f8b79dfc7c7086d48cdc893eb3ed398ffd54d4cb87f0226e56261a9bf56a61f94fb13c397ee12dedfd60d6a0f4715da50d398c83a5

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.0.1"
+  ".": "1.1.0"
 }

data/.talismanrc

@@ -0,0 +1,47 @@
+fileignoreconfig:
+- filename: Gemfile
+  checksum: 353d470f3ce5ab7497984d7f64877eb0287f1b4475ce5c1c3ab1cf24b0cf0c2a
+- filename: examples/usage.rb
+  checksum: a76ef74606f089575e525b4eb152e4d55f6a089fbaccf7cf602ce976639492b9
+- filename: Gemfile.lock
+  checksum: 8019973a6e588d2330e19364ed8c0205a761586e51fd6da46bf50fd42a3dbeb2
+- filename: README.md
+  checksum: 2f48f043b33ba99067ca5fcd248bf3506b0a90870955e84bdf426de6ffeda470
+- filename: lib/nice/recruitment/client.rb
+  checksum: 9db5cd0f085195b53152021dffa7eb7bebe8212e9be570e6568ae2c16b54be42
+- filename: lib/nice/recruitment/job_offer.rb
+  checksum: 20f1786a4207b314cd713e2b5d98bda02e63d291799a15f5c85f6d4d5e954037
+- filename: spec/nice/recruitment/client_spec.rb
+  checksum: 54892d592185bdfce321d3684c90f63207b48f94655c221e2995487c09b51128
+- filename: spec/nice/client_spec.rb
+  checksum: ""
+  ignore_detectors: [filecontent]
+- filename: spec/spec_helper.rb
+  checksum: ""
+  ignore_detectors: [filecontent]
+- filename: spec/cassettes/**/*
+  checksum: ""
+  ignore_detectors: [filecontent]
+- filename: spec/cassettes/Nice_Recruitment_Client/_job/returns_a_fully_populated_JobOffer.yml
+  checksum: ec15c95a53f15a54e4e133afa3b1ac9ba1359f5222db8831ecff30baca5b6606
+- filename: spec/cassettes/Nice_Recruitment_Client/_job/raises_Nice_APIError_for_an_unknown_id.yml
+  checksum: e9b954b26a5891c94295c7f8ad5547654ee267bbc229eaf95dda633c2e034bd8
+- filename: spec/cassettes/Nice_Recruitment_Client/_jobs/returns_an_array_of_JobOffer_objects_from_the_listing.yml
+  checksum: 475e281374ac762f281c7ad4cd92d1d00a403a9ac5311415bc2460600f73d43e
+- filename: spec/cassettes/Nice_Recruitment_Client/_jobs/returns_a_filtered_subset_for_a_keyword_search.yml
+  checksum: 9bb958134b18d41c0edc517239ab49e7ea91904e7c6e047fde255a6503734194
+- filename: spec/cassettes/Nice_Recruitment_Client/_jobs/filters_by_category_label.yml
+  checksum: c1ecff9c2f1dc9a524347b5b06fb3dbc2624b76cc91a1771d60947c81ff2b9a6
+- filename: spec/cassettes/Nice_Recruitment_Client/_jobs/raises_ArgumentError_for_an_unknown_filter_value.yml
+  checksum: 33dd21225ea24ad00c443de10f2afa35eb881014b3376221a43882c6515b67e9
+- filename: spec/cassettes/Nice_Recruitment_Client/_search_options/returns_the_filter_vocabularies_parsed_from_the_listing_page.yml
+  checksum: 2247a959e229631142d7a326f737bbf2b03af578a3ab8aa67deca2c1ba0592f1
+
+scopeconfig:
+- scope: ruby
+  ignore_detectors: []
+
+allowed_patterns:
+- NICE_CKAN_API_KEY
+- test-api-key
+- <NICE_CKAN_API_KEY>

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.1.0](https://github.com/nicolasleger/nice/compare/v1.0.1...v1.1.0) (2026-07-27)
+
+
+### Features
+
+* add recruitment job offers client ([#12](https://github.com/nicolasleger/nice/issues/12)) ([92fd2de](https://github.com/nicolasleger/nice/commit/92fd2dedacdf5d42c9cfe997b387e27c06b4bdbc))
+
+
+### Bug Fixes
+
+* security remediation ([#8](https://github.com/nicolasleger/nice/issues/8)) ([daf837c](https://github.com/nicolasleger/nice/commit/daf837c9d212d3383cd217edc1a53f09cf2ff91a))
+
 ## [1.0.1](https://github.com/nicolasleger/nice/compare/v1.0.0...v1.0.1) (2026-02-16)
 
 

data/Gemfile

@@ -2,5 +2,5 @@ source 'https://rubygems.org'
 
 gemspec
 
-# Use nicolasleger updated CKAN fork for v3 API support
-gem 'ckan', github: 'nicolasleger/ckan', branch: 'feat/add-ckan-v3-support'
+# Use nicolasleger updated CKAN fork for v3 API support — pinned to reviewed SHA
+gem 'ckan', github: 'nicolasleger/ckan', ref: '0f89d5f23b62b83c98b5371d9243e36c2d42839e'

data/Gemfile.lock

@@ -1,22 +1,23 @@
 GIT
   remote: https://github.com/nicolasleger/ckan.git
   revision: 0f89d5f23b62b83c98b5371d9243e36c2d42839e
-  branch: feat/add-ckan-v3-support
+  ref: 0f89d5f23b62b83c98b5371d9243e36c2d42839e
   specs:
     ckan (0.0.3)
 
 PATH
   remote: .
   specs:
-    nice (1.0.1)
-      ckan
+    nice (1.1.0)
+      ckan (~> 0.0.3)
       httparty (~> 0.21)
       json (~> 2.6)
+      nokogiri (~> 1.15)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.8)
+    addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     bigdecimal (4.0.1)
@@ -34,13 +35,21 @@ GEM
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
     io-console (0.8.2)
-    json (2.18.1)
+    json (2.19.9)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     method_source (1.1.0)
     mini_mime (1.1.5)
+    mini_portile2 (2.8.9)
     multi_xml (0.8.1)
       bigdecimal (>= 3.1, < 5)
+    nokogiri (1.19.4)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
+    nokogiri (1.19.4-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.19.4-x86_64-linux-gnu)
+      racc (~> 1.4)
     parallel (1.27.0)
     parser (3.3.10.1)
       ast (~> 2.4.1)
@@ -53,7 +62,7 @@ GEM
     pry-byebug (3.12.0)
       byebug (~> 13.0)
       pry (>= 0.13, < 0.17)
-    public_suffix (7.0.2)
+    public_suffix (5.1.1)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.1)
@@ -115,7 +124,7 @@ DEPENDENCIES
   webmock (~> 3.0)
 
 CHECKSUMS
-  addressable (2.8.8) sha256=7c13b8f9536cf6364c03b9d417c19986019e28f7c00ac8132da4eb0fe393b057
+  addressable (2.9.0) sha256=7fdf6ac3660f7f4e867a0838be3f6cf722ace541dd97767fa42bc6cfa980c7af
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
   byebug (13.0.0) sha256=d2263efe751941ca520fa29744b71972d39cbc41839496706f5d9b22e92ae05d
@@ -127,19 +136,23 @@ CHECKSUMS
   hashdiff (1.2.1) sha256=9c079dbc513dfc8833ab59c0c2d8f230fa28499cc5efb4b8dd276cf931457cd1
   httparty (0.24.2) sha256=8fca6a54aa0c4aa4303a0fd33e5e2156175d6a5334f714263b458abd7fda9c38
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
+  json (2.19.9) sha256=9b9025b7cdddafa38d316eca0b2358488e42d417045c1b90d216a9fefe46b79a
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
   method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
   mini_mime (1.1.5) sha256=8681b7e2e4215f2a159f9400b5816d85e9d8c6c6b491e96a12797e798f8bccef
+  mini_portile2 (2.8.9) sha256=0cd7c7f824e010c072e33f68bc02d85a00aeb6fce05bb4819c03dfd3c140c289
   multi_xml (0.8.1) sha256=addba0290bac34e9088bfe73dc4878530297a82a7bbd66cb44dcd0a4b86edf5a
-  nice (1.0.1)
+  nice (1.1.0)
+  nokogiri (1.19.4) sha256=50c951611c92bca05c51411aef45f1cbc50f2821c4802758c5c6d34696533ab5
+  nokogiri (1.19.4-arm64-darwin) sha256=a46db9853286e6597b36ebc6953817d15acf3a299583eb3f89fdc6f91dd63527
+  nokogiri (1.19.4-x86_64-linux-gnu) sha256=379fae440b28915e3f19d752ce2dcf8465ed2b2fbefd2a7ca0dd497bc981a06a
   parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
   parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
   prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
   pry (0.16.0) sha256=d76c69065698ed1f85e717bd33d7942c38a50868f6b0673c636192b3d1b6054e
   pry-byebug (3.12.0) sha256=594e094ae8a8390a7ad4c7b36ae36e13304ed02664c67417d108dc5f7213d1b7
-  public_suffix (7.0.2) sha256=9114090c8e4e7135c1fd0e7acfea33afaab38101884320c65aaa0ffb8e26a857
+  public_suffix (5.1.1) sha256=250ec74630d735194c797491c85e3c6a141d7b5d9bd0b66a3fa6268cf67066ed
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c

data/README.md

@@ -100,6 +100,44 @@ groups = client.list_groups
 resource = client.get_resource("resource-id")
 ```
 
+### Job offers (recrutement.nicecotedazur.org)
+
+Job offers are read from the metropolitan recruitment site (Eqwa ATS). The
+platform exposes no public API or feed, so the client parses the
+server-rendered pages — expect occasional breakage if the site's markup
+changes.
+
+```ruby
+recruitment = Nice::Recruitment::Client.new
+
+# All current offers (one request; summary fields)
+offers = recruitment.jobs
+puts "#{offers.count} offers"
+
+# Filtered search — pass ids or exact labels, see recruitment.search_options
+recruitment.jobs(keywords: "informatique")
+recruitment.jobs(categories: %w[A B], sectors: ["Technique"])
+recruitment.jobs(domain: "INFORMATIQUE & TIC", entity: "Ville de Nice")
+
+# Full detail for one offer
+offer = recruitment.job(offers.first.id)
+offer.title        # => "Auxiliaire de Puériculture vacataire (H/F)"
+offer.contract     # => "Contrat vacataire"
+offer.organization # => "VILLE DE NICE"
+offer.deadline     # => Date (or nil)
+offer.description  # plain text
+offer.profile      # plain text
+
+# Full details for everything (one request per offer — be considerate)
+detailed = recruitment.jobs.map { |o| recruitment.job(o.id) }
+```
+
+Listing offers carry summary fields (`updated_at`, `recruitment_nature`);
+detail offers carry the full set (`contract`, `organization`, `department`,
+`location`, `workplace`, `sector`, `domain`, `employment_framework`,
+`introduction`, `description`, `profile`). Fields missing from a given
+source are `nil`.
+
 ## Development
 
 After checking out the repo, run `bundle install` to install dependencies.

data/examples/usage.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/nice'
+
+# Configure via environment variables (recommended — never hardcode credentials):
+#   export NICE_CKAN_URL="https://opendata.nicecotedazur.org/data/"
+#   export NICE_CKAN_API_KEY="your-api-key-here"
+#
+# The library reads these automatically. You can also override them explicitly:
+Nice.configure do |config|
+  config.ckan_url = ENV.fetch('NICE_CKAN_URL', 'https://opendata.nicecotedazur.org/data/')
+  config.api_key  = ENV.fetch('NICE_CKAN_API_KEY', nil)
+end
+
+# Create a client
+client = Nice::Client.new
+
+# List all packages
+puts "Listing packages..."
+packages = client.list_packages
+puts "Found #{packages.count} packages"
+
+# Search for specific datasets
+puts "\nSearching for 'transport' datasets..."
+results = client.search_packages("transport")
+puts "Found #{results['count']} matches"
+
+# Get specific package details
+if packages.any?
+  package_id = packages.first
+  puts "\nGetting details for package: #{package_id}"
+  package = client.get_package(package_id)
+  puts "Package name: #{package['name']}"
+  puts "Package title: #{package['title']}"
+end
+
+# List organizations
+puts "\nListing organizations..."
+orgs = client.list_organizations
+puts "Found #{orgs.count} organizations"
+
+# Alternative: pass credentials directly (still read from env to avoid hardcoding)
+# client = Nice::Client.new(
+#   ckan_url: ENV.fetch('NICE_CKAN_URL'),
+#   api_key:  ENV.fetch('NICE_CKAN_API_KEY', nil)
+# )
+
+# --- Job offers (recrutement.nicecotedazur.org, no credentials needed) ---
+puts "\nListing job offers..."
+recruitment = Nice::Recruitment::Client.new
+offers = recruitment.jobs
+puts "Found #{offers.count} job offers"
+
+if offers.any?
+  offer = recruitment.job(offers.first.id)
+  puts "First offer: #{offer.title} (#{offer.contract}) — deadline: #{offer.deadline || 'n/a'}"
+end
+
+# Discover the available filter vocabularies (domains, functions, contracts,
+# sectors, categories, entities) before building a filtered search.
+puts "\nAvailable job filters..."
+options = recruitment.search_options
+puts "Domains: #{options[:domains].values.take(3).join(', ')}..."
+puts "Contracts: #{options[:contracts].values.join(', ')}"
+
+# Search job offers with filters. Each filter accepts an id or an exact label
+# (case-insensitive); the multi-valued ones (contracts, sectors, categories)
+# also take arrays. See #search_options above for valid values.
+puts "\nSearching job offers with filters..."
+filtered = recruitment.jobs(
+  keywords: 'informatique',
+  contracts: ['Titulaire / Lauréat de concours'],
+  entity: 'Ville de Nice'
+)
+puts "Found #{filtered.count} matching offers"
+filtered.first(5).each do |job|
+  puts "- #{job.title} (#{job.recruitment_nature}) — #{job.category}"
+end

data/lib/nice/data_gouv/client.rb

@@ -10,6 +10,7 @@ module Nice
       include HTTParty
       base_uri 'https://www.data.gouv.fr/api/1'
       follow_redirects true
+      default_timeout 30
 
       attr_reader :api_key
 
@@ -52,6 +53,7 @@ module Nice
 
       # Get organization by ID or slug
       def organization(id_or_slug)
+        validate_id_or_slug!(id_or_slug)
         response = self.class.get("/organizations/#{id_or_slug}", headers: headers)
         handle_response(response) do |data|
           Organization.new(data)
@@ -60,6 +62,7 @@ module Nice
 
       # List organization datasets
       def organization_datasets(org_id_or_slug, page: 1, page_size: 20)
+        validate_id_or_slug!(org_id_or_slug)
         response = self.class.get(
           "/organizations/#{org_id_or_slug}/datasets",
           query: { page: page, page_size: page_size },
@@ -72,6 +75,7 @@ module Nice
 
       # Get dataset by ID or slug
       def dataset(id_or_slug)
+        validate_id_or_slug!(id_or_slug)
         response = self.class.get("/datasets/#{id_or_slug}/", headers: headers)
         handle_response(response) do |data|
           Dataset.new(data)
@@ -80,6 +84,12 @@ module Nice
 
       private
 
+      VALID_ID_OR_SLUG = /\A[\w\-]+\z/
+
+      def validate_id_or_slug!(value)
+        raise ArgumentError, "Invalid ID or slug: #{value.inspect}" unless value.to_s.match?(VALID_ID_OR_SLUG)
+      end
+
       def headers
         headers = { 'Accept' => 'application/json' }
         headers['X-API-KEY'] = @api_key if @api_key

data/lib/nice/recruitment/client.rb

@@ -0,0 +1,363 @@
+require 'httparty'
+require 'json'
+require 'nokogiri'
+
+require_relative 'job_offer'
+
+module Nice
+  module Recruitment
+    # Client for recrutement.nicecotedazur.org (Eqwa ATS).
+    #
+    # The platform exposes no public API or feed, so offers are read from the
+    # server-rendered pages: the listing page carries every current offer in a
+    # single response, and detail pages carry the full field set. Filtered
+    # search replays the site's own form flow (CSRF-protected POST followed by
+    # a session-scoped redirect).
+    class Client
+      include HTTParty
+      base_uri 'https://recrutement.nicecotedazur.org'
+      follow_redirects true
+      default_timeout 30
+
+      LISTING_PATH = '/front-jobs.html'.freeze
+      DETAIL_PATH = '/front-jobs-detail.html'.freeze
+
+      # The CSRF token must be posted back in a form field named after the
+      # cookie itself (the site's csrfprotector.js overrides the field name
+      # with the value of #csrfp_hidden_data_token). A wrong or missing token
+      # makes the server silently ignore the filters.
+      CSRF_COOKIE = '__Secure-CSRFP-Token'.freeze
+
+      # id_identite values wired to the entity tiles by front-jobs.js.
+      ENTITIES = {
+        1 => "Métropole Nice Côte d'Azur",
+        2 => 'CCAS de Nice',
+        3 => 'Ville de Nice'
+      }.freeze
+
+      # Normalized French <dt> labels on the detail page => JobOffer attributes.
+      DETAIL_LABELS = {
+        'référence' => 'reference',
+        'contrat' => 'contract',
+        'collectivité' => 'organization',
+        'direction' => 'department',
+        'localisation' => 'location',
+        'lieu de travail' => 'workplace',
+        'filière' => 'sector',
+        'domaine' => 'domain',
+        'catégorie' => 'category',
+        "cadre d'emploi" => 'employment_framework',
+        "cadre d'emplois" => 'employment_framework',
+        'date limite' => 'deadline'
+      }.freeze
+
+      # List current job offers. Without filters this is a single stateless
+      # GET returning every offer. Filters accept ids or exact labels (see
+      # #search_options): keywords (String), domain, function (requires
+      # domain), entity, and the multi-valued contracts, sectors, categories.
+      def jobs(keywords: nil, domain: nil, function: nil, contracts: [], sectors: [], categories: [], entity: nil)
+        filters = {
+          'keywords' => keywords,
+          'domain' => domain,
+          'function' => function,
+          'contracts' => Array(contracts),
+          'sectors' => Array(sectors),
+          'categories' => Array(categories),
+          'entity' => entity
+        }
+        return all_jobs if filters.values.all? { |v| v.nil? || (v.is_a?(Array) && v.empty?) }
+
+        filtered_jobs(filters)
+      end
+
+      # Get a fully populated offer from its detail page.
+      def job(id)
+        validate_id!(id)
+        response = self.class.get(DETAIL_PATH, query: { id_job: id, id_origin: 0 }, headers: headers)
+        handle_response(response) { |html| parse_detail(html, id.to_i) }
+      end
+
+      # Available filter vocabularies, parsed from the listing page:
+      # { domains: {id => label}, functions: {domain_id => {id => label}},
+      #   contracts:, sectors:, categories:, entities: }.
+      def search_options
+        response = self.class.get(LISTING_PATH, headers: headers)
+        handle_response(response) { |html| parse_search_options(html) }
+      end
+
+      private
+
+      VALID_ID = /\A\d+\z/.freeze
+
+      def validate_id!(id)
+        raise ArgumentError, "Invalid job id: #{id.inspect}" unless id.to_s.match?(VALID_ID)
+      end
+
+      def headers
+        { 'Accept' => 'text/html' }
+      end
+
+      def all_jobs
+        response = self.class.get(LISTING_PATH, headers: headers)
+        handle_response(response) { |html| parse_listing(html) }
+      end
+
+      # The site's search flow: GET the listing (session + CSRF cookies, filter
+      # vocabularies), POST the form with the token echoed as a field, then GET
+      # the listing again with the same session to read the filtered table.
+      def filtered_jobs(filters)
+        first = self.class.get(LISTING_PATH, headers: headers)
+        listing_html = handle_response(first) { |html| html }
+        cookies = session_cookies(first)
+        token = cookies[CSRF_COOKIE]
+        raise Nice::APIError, 'CSRF token cookie missing from listing response' unless token
+
+        form = build_filter_form(filters, parse_search_options(listing_html), token)
+        post = self.class.post(
+          LISTING_PATH,
+          body: form,
+          headers: headers.merge('Cookie' => cookie_header(cookies)),
+          follow_redirects: false
+        )
+        # A validated POST stores the filter in the session and redirects; a
+        # rejected one (stripped params) renders the full list directly with 200.
+        raise Nice::APIError, "Filtered search rejected (expected redirect, got #{post.code})" unless post.code == 302
+
+        cookies.merge!(session_cookies(post))
+        response = self.class.get(LISTING_PATH, headers: headers.merge('Cookie' => cookie_header(cookies)))
+        handle_response(response) { |html| parse_listing(html) }
+      end
+
+      def build_filter_form(filters, options, token)
+        form = {
+          'filter' => 1,
+          'id_identite' => filters['entity'] ? resolve_option(filters['entity'], options[:entities], 'entity') : 0,
+          'id_domaine' => filters['domain'] ? resolve_option(filters['domain'], options[:domains], 'domain') : 0,
+          'mots_cles' => filters['keywords'].to_s
+        }
+
+        if filters['function']
+          raise ArgumentError, 'The function filter requires a domain' unless filters['domain']
+
+          functions = options[:functions][form['id_domaine']] || {}
+          form['id_fonction'] = resolve_option(filters['function'], functions, 'function')
+        end
+
+        if filters['contracts'].any?
+          form['ids_contrat'] = filters['contracts'].map do |v|
+            resolve_option(v, options[:contracts], 'contract')
+          end
+        end
+        if filters['sectors'].any?
+          form['ids_fp_filiere'] = filters['sectors'].map do |v|
+            resolve_option(v, options[:sectors], 'sector')
+          end
+        end
+        if filters['categories'].any?
+          form['ids_fp_categorie'] = filters['categories'].map do |v|
+            resolve_option(v, options[:categories], 'category')
+          end
+        end
+
+        form[CSRF_COOKIE] = token
+        form
+      end
+
+      # Accepts an id (Integer or numeric String) present in the map, or an
+      # exact label (case-insensitive). Raises rather than letting a typo fall
+      # through to an unfiltered search.
+      def resolve_option(value, options_map, kind)
+        if value.is_a?(Integer) || value.to_s.match?(VALID_ID)
+          id = value.to_i
+          return id if options_map.key?(id)
+        else
+          match = options_map.find { |_, label| label.casecmp?(value.to_s.strip) }
+          return match.first if match
+        end
+
+        raise ArgumentError, "Unknown #{kind}: #{value.inspect} (see #search_options for valid values)"
+      end
+
+      def session_cookies(response)
+        fields = response.headers.get_fields('set-cookie') || []
+        fields.each_with_object({}) do |raw, acc|
+          pair = raw.split(';').first
+          next unless pair&.include?('=')
+
+          name, value = pair.split('=', 2)
+          acc[name.strip] = value
+        end
+      end
+
+      def cookie_header(cookies)
+        cookies.map { |name, value| "#{name}=#{value}" }.join('; ')
+      end
+
+      def handle_response(response)
+        case response.code
+        when 200
+          yield ensure_utf8(response.body.to_s)
+        when 404
+          raise Nice::APIError, 'Resource not found'
+        when 401, 403
+          raise Nice::APIError, 'Authentication failed or access denied'
+        else
+          raise Nice::APIError, "Request failed with status #{response.code}"
+        end
+      end
+
+      def ensure_utf8(html)
+        return html if html.encoding == Encoding::UTF_8 && html.valid_encoding?
+
+        html.dup.force_encoding(Encoding::UTF_8)
+      end
+
+      # Listing table columns: 0 = update date (hidden), 1 = logo, 2 = title
+      # cell (link + optional "Date limite"/"réf" labels), 3 = contract type,
+      # 4 = category.
+      def parse_listing(html)
+        doc = Nokogiri::HTML(html)
+        doc.css('table.with-datatable tbody tr').filter_map do |row|
+          link = row.at_css('a[href*="front-jobs-detail"]')
+          next unless link
+
+          id = link['href'].to_s[/id_job=(\d+)/, 1]
+          next unless id
+
+          cells = row.css('td')
+          labels = row.css('span.label').filter_map { |span| clean_text(span.text) }
+
+          JobOffer.new(
+            'id' => id.to_i,
+            'url' => job_url(id),
+            'title' => clean_text(link['title']) || clean_text(link.text),
+            'updated_at' => clean_text(cells[0]&.text),
+            'recruitment_nature' => clean_text(cells[3]&.text),
+            'category' => clean_text(cells[4]&.text),
+            'deadline' => label_value(labels, /date limite/i),
+            'reference' => label_value(labels, /\Ar[ée]f/i)
+          )
+        end
+      end
+
+      # Text after the first colon of the matching "label : value" span.
+      def label_value(labels, pattern)
+        labels.find { |text| text.match?(pattern) }&.sub(/\A[^:]*:\s*/, '')
+      end
+
+      def job_url(id)
+        "#{self.class.base_uri}#{DETAIL_PATH}?id_job=#{id}&id_origin=0"
+      end
+
+      def parse_detail(html, id)
+        doc = Nokogiri::HTML(html)
+        dl = doc.at_css('dl.dl-horizontal')
+        # Unknown ids are redirected to the listing (HTTP 200 once followed),
+        # so "not found" means the detail structure is absent.
+        raise Nice::APIError, "Job offer #{id} not found" unless dl && doc.at_css('h1')
+
+        attributes = {
+          'id' => id,
+          'url' => job_url(id),
+          'title' => clean_text(doc.at_css('h1').text),
+          'introduction' => block_text(doc.at_css('div.job-detail-commentaire')),
+          'description' => section_text(doc, /contexte du recrutement/i),
+          'profile' => section_text(doc, /profil recherch/i)
+        }
+
+        dl.css('dt').each do |dt|
+          key = DETAIL_LABELS[normalize_label(dt.text)]
+          next unless key
+
+          value = clean_text(dt.at_xpath('following-sibling::dd[1]')&.text)
+          attributes[key] = value if value && !attributes[key]
+        end
+
+        # The dt.visible-xs deadline dd is often empty; the deadline also
+        # appears as plain text elsewhere on the page.
+        attributes['deadline'] ||= doc.text[/date limite\s*:?\s*(\d{1,2}-\d{1,2}-\d{4})/i, 1]
+
+        JobOffer.new(attributes)
+      end
+
+      def normalize_label(text)
+        clean_text(text)&.downcase&.tr('’', "'")&.chomp(':')&.strip
+      end
+
+      # Content between the matching <h2> and the next <h2> in the description.
+      def section_text(doc, heading_pattern)
+        heading = doc.css('div.job-detail-desc h2').find { |h2| h2.text.match?(heading_pattern) }
+        return nil unless heading
+
+        nodes = []
+        node = heading.next
+        while node && !(node.element? && node.name == 'h2')
+          nodes << node
+          node = node.next
+        end
+        block_text(Nokogiri::HTML.fragment(nodes.map(&:to_html).join))
+      end
+
+      def parse_search_options(html)
+        doc = Nokogiri::HTML(html)
+        {
+          domains: select_options(doc, 'id_domaine'),
+          functions: functions_by_domain(html),
+          contracts: select_options(doc, 'ids_contrat'),
+          sectors: select_options(doc, 'ids_fp_filiere'),
+          categories: select_options(doc, 'ids_fp_categorie'),
+          entities: ENTITIES
+        }
+      end
+
+      def select_options(doc, select_id)
+        doc.css("select##{select_id} option").each_with_object({}) do |option, acc|
+          value = option['value'].to_s
+          next if value.empty? || value == '0'
+
+          label = clean_text(option.text)
+          acc[value.to_i] = label if label
+        end
+      end
+
+      # The domain => functions map is embedded as JSON in the listing page
+      # (window.FrontJobsData.mapFunctionParentChildren).
+      def functions_by_domain(html)
+        json = html[/mapFunctionParentChildren\s*:\s*(\{.*\})\s*,\s*$/, 1]
+        return {} unless json
+
+        JSON.parse(json).each_with_object({}) do |(domain_id, functions), acc|
+          acc[domain_id.to_i] = functions.each_with_object({}) do |function, map|
+            map[function['id'].to_i] = function['name']
+          end
+        end
+      rescue JSON::ParserError
+        {}
+      end
+
+      # Plain text preserving block structure: <br> and block-element
+      # boundaries become newlines.
+      def block_text(node)
+        return nil unless node
+
+        node = node.dup
+        node.css('br').each { |br| br.replace("\n") }
+        node.css('p, div, li, ul, ol, h2, h3, h4, tr').each { |el| el.add_next_sibling("\n") }
+        text = node.text
+                   .tr("\u00A0", ' ')
+                   .gsub(/[ \t]+/, ' ')
+                   .gsub(/ ?\n ?/, "\n")
+                   .gsub(/\n{3,}/, "\n\n")
+                   .strip
+        text.empty? ? nil : text
+      end
+
+      def clean_text(text)
+        return nil if text.nil?
+
+        cleaned = text.tr("\u00A0", ' ').gsub(/\s+/, ' ').strip
+        cleaned.empty? ? nil : cleaned
+      end
+    end
+  end
+end

data/lib/nice/recruitment/job_offer.rb

@@ -0,0 +1,82 @@
+require 'date'
+
+module Nice
+  module Recruitment
+    # A job offer from recrutement.nicecotedazur.org.
+    #
+    # Offers built from the listing page carry summary fields only
+    # (updated_at, recruitment_nature); offers built from a detail page carry
+    # the full set (contract, organization, description, ...). Fields absent
+    # from the source page are nil.
+    class JobOffer
+      attr_reader :id, :title, :url, :reference, :category, :deadline,
+                  :updated_at, :recruitment_nature, :contract, :organization,
+                  :department, :location, :workplace, :sector, :domain,
+                  :employment_framework, :introduction, :description, :profile
+
+      def initialize(attributes = {})
+        @id = attributes['id']
+        @title = attributes['title']
+        @url = attributes['url']
+        @reference = attributes['reference']
+        @category = attributes['category']
+        @deadline = parse_date(attributes['deadline'])
+        @updated_at = parse_date(attributes['updated_at'])
+        @recruitment_nature = attributes['recruitment_nature']
+        @contract = attributes['contract']
+        @organization = attributes['organization']
+        @department = attributes['department']
+        @location = attributes['location']
+        @workplace = attributes['workplace']
+        @sector = attributes['sector']
+        @domain = attributes['domain']
+        @employment_framework = attributes['employment_framework']
+        @introduction = attributes['introduction']
+        @description = attributes['description']
+        @profile = attributes['profile']
+      end
+
+      def to_h
+        {
+          'id' => @id,
+          'title' => @title,
+          'url' => @url,
+          'reference' => @reference,
+          'category' => @category,
+          'deadline' => @deadline,
+          'updated_at' => @updated_at,
+          'recruitment_nature' => @recruitment_nature,
+          'contract' => @contract,
+          'organization' => @organization,
+          'department' => @department,
+          'location' => @location,
+          'workplace' => @workplace,
+          'sector' => @sector,
+          'domain' => @domain,
+          'employment_framework' => @employment_framework,
+          'introduction' => @introduction,
+          'description' => @description,
+          'profile' => @profile
+        }
+      end
+
+      private
+
+      # Accepts a Date (pass-through), "YYYY-MM-DD" (listing update date) or
+      # "DD-MM-YYYY" (deadline). Returns nil for blank or unparseable values.
+      def parse_date(value)
+        return value if value.is_a?(Date)
+
+        text = value.to_s.strip
+        case text
+        when /\A\d{4}-\d{2}-\d{2}\z/
+          Date.strptime(text, '%Y-%m-%d')
+        when /\A\d{1,2}-\d{1,2}-\d{4}\z/
+          Date.strptime(text, '%d-%m-%Y')
+        end
+      rescue ArgumentError
+        nil
+      end
+    end
+  end
+end

data/lib/nice/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nice
-  VERSION = '1.0.1'
+  VERSION = '1.1.0'
 end

data/lib/nice.rb

@@ -4,6 +4,7 @@ require_relative 'nice/client'
 require_relative 'nice/version'
 
 require_relative 'nice/data_gouv/client'
+require_relative 'nice/recruitment/client'
 
 module Nice
   class Error < StandardError; end
@@ -28,9 +29,5 @@ module Nice
       @api_key = ENV['NICE_CKAN_API_KEY']
     end
 
-    def validate!
-      raise ConfigurationError, "CKAN URL is required" if ckan_url.nil? || ckan_url.empty?
-      raise ConfigurationError, "API key is required" if api_key.nil? || api_key.empty?
-    end
   end
 end

data/nice.gemspec

@@ -25,12 +25,14 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # CKAN dependency
-  spec.add_dependency "ckan"
+  # CKAN dependency — pin to known-good version until upstream gem supports CKAN v3
+  spec.add_dependency "ckan", "~> 0.0.3"
   
   # Additional useful dependencies
   spec.add_dependency "httparty", "~> 0.21"
   spec.add_dependency "json", "~> 2.6"
+  # HTML parsing for the recruitment site (no public API/feed available)
+  spec.add_dependency "nokogiri", "~> 1.15"
 
   # Development dependencies
   spec.add_development_dependency "rake", "~> 13.0"

data/release-please-config.json

@@ -2,6 +2,7 @@
   "packages": {
     ".": {
       "package-name": "nice",
+      "release-type": "ruby",
       "version-file": "lib/nice/version.rb",
       "extra-files": ["Gemfile.lock"]
     }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nice
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Nicolas Leger
@@ -13,16 +13,16 @@ dependencies:
   name: ckan
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.0.3
 - !ruby/object:Gem::Dependency
   name: httparty
   requirement: !ruby/object:Gem::Requirement
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -159,18 +173,22 @@ extra_rdoc_files: []
 files:
 - ".release-please-manifest.json"
 - ".rspec"
+- ".talismanrc"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
+- examples/usage.rb
 - lib/nice.rb
 - lib/nice/client.rb
 - lib/nice/data_gouv/client.rb
 - lib/nice/data_gouv/dataset.rb
 - lib/nice/data_gouv/organization.rb
 - lib/nice/data_gouv/resource.rb
+- lib/nice/recruitment/client.rb
+- lib/nice/recruitment/job_offer.rb
 - lib/nice/version.rb
 - nice.gemspec
 - release-please-config.json
@@ -195,7 +213,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.16
 specification_version: 4
 summary: OpenData NCA - Métropole Nice Côte d'Azur
 test_files: []