toc_doc 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72ce333b7f46666dc6109150032a053014153937a65f89d629d1a686216d52b3
-  data.tar.gz: 064462c8ae43a562a07b5e4f9f36aff3dc1b37f15444f3e912b04b61ce2e506d
+  metadata.gz: '00208a866b7839fb071bd5fb6fee43f80ef13500a27f5b5abe3080c18b1adf09'
+  data.tar.gz: ab2ea6b3d4341e4c0168677e43fd1e6fbe9cf84ff3a9dbce6614c355eaae298e
 SHA512:
-  metadata.gz: b5750b8a84a14ba7a9144ead48313f8db74829de9f4bddaf58930ebaf1606400dc4cff0a1110cbb587999b22bf0efff490beaa3710fc21c96dbd402d4068c069
-  data.tar.gz: 563244b90ad4a8418d7348e88bb1c408955285574a2a5d7efbcac02c9e311b70410f868fbd4777b63a163ce90f525075361ec457b3618537a44ccce133fd33e4
+  metadata.gz: 2d2e0f1a82a5b177374b559e5164ab5c7e190f5a7f43d213d5050d534ca76c444537d8715482d6360af3bbd4d2a3b7d406a1c6c2d30baaaa1e27350008f934f4
+  data.tar.gz: 1fb9f0f22c644d0ebdf31382f8318633b402dc6797b0be40a94c05e569169b1cb5b94514f1dc558d89ec3e242472f9770f3721d188eb98935280bbfb59909516

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [1.10.0] - 2026-04-07
+
+### Added
+
+- **`TocDoc::Availability::Collection#booking_url`** — new method returning the Doctolib booking URL for a given availability; accepts an `availability` argument and delegates URL construction to `TocDoc::UriUtils`
+
 ## [1.9.0] - 2026-04-06
 
 ### Added

data/CODE_OF_CONDUCT.md

@@ -6,5 +6,3 @@
 * Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
 * When interpreting the words and actions of others, participants should always assume good intentions.
 * Behaviour which can be reasonably considered harassment will not be tolerated.
-
-If you have any concerns about behaviour within this project, please contact us at ["m.louguet@gmail.com"](mailto:"m.louguet@gmail.com").

data/README.md

@@ -140,7 +140,7 @@ client.get('/availabilities.json', query: { visit_motive_ids: '123', agenda_ids:
 | Option | Default | Description |
 |---|---|---|
 | `api_endpoint` | `https://www.doctolib.fr` | Base URL. Change to `.de` / `.it` for other countries. |
-| `user_agent` | `TocDoc Ruby Gem 1.8.0` | `User-Agent` header sent with every request. |
+| `user_agent` | `TocDoc Ruby Gem 1.10.0` | `User-Agent` header sent with every request. |
 | `default_media_type` | `application/json` | `Accept` and `Content-Type` headers. |
 | `per_page` | `15` | Default number of availability dates per request (capped at `15`). Emits a warning if the value exceeds the cap. |
 | `connect_timeout` | `5` | TCP connect timeout in seconds, passed to Faraday as `open_timeout`. Override via `TOCDOC_CONNECT_TIMEOUT`. |
@@ -312,6 +312,7 @@ Implements `Enumerable`, yielding `TocDoc::Availability` instances that have at
 | `#raw_availabilities` | `Array<TocDoc::Availability>` | All date entries, including those with no slots. |
 | `#more?` | `Boolean` | `true` when the API has indicated further pages exist (`next_slot` is present). |
 | `#load_next!` | `self` | Fetches the next window and merges it into this collection. Raises `StopIteration` when `#more?` is `false`. Requires a client (i.e. built via `Availability.where`). |
+| `#booking_url(availability)` | `String` | Returns the Doctolib booking URL for a given `TocDoc::Availability` instance. Delegates URL construction to `TocDoc::UriUtils`. |
 | `#to_h` | `Hash` | Plain-hash representation (only dates with slots in the `availabilities` key). |
 
 ### `TocDoc::Availability`

data/TODO.md

@@ -27,6 +27,16 @@
 
 # DONE & RELEASED
 
+## 1.10
+
+- [x] `Collection#booking_url` — Doctolib booking URL
+
+## 1.9
+
+- [x] `Collection#availabilities` / `#all` — filtered entries with memoization, invalidated by `#merge_page!`
+- [x] `Collection#slots` — all slots across the collection
+- [x] `Collection#load_next!` — renamed from `#fetch_next_page` for idiomatic mutation signalling
+
 ## 1.8
 
 - [x] Configurable availability pagination depth + `Collection#more?` / `#fetch_next_page`

data/lib/toc_doc/core/version.rb

@@ -4,5 +4,5 @@ module TocDoc
   # The current version of the TocDoc gem.
   #
   # @return [String]
-  VERSION = '1.9.0'
+  VERSION = '1.10.0'
 end

data/lib/toc_doc/models/availability/collection.rb

@@ -144,6 +144,35 @@ module TocDoc
         @availabilities = nil
         self
       end
+
+      # Builds a Doctolib booking URL for the current query context.
+      #
+      # Requires +booking_slug+ to have been passed as an option to
+      # {TocDoc::Availability.where}. Returns +nil+ when absent.
+      #
+      # The URL targets the motive-selection step of the booking funnel,
+      # pre-filled with the first practice ID and the visit motive IDs from
+      # the original query.
+      #
+      # @return [String, nil] fully-qualified booking URL, or +nil+ if
+      #   +booking_slug+ was not provided
+      #
+      # @example
+      #   collection = TocDoc::Availability.where(
+      #     visit_motive_ids: 1830057,
+      #     agenda_ids: 2359638,
+      #     booking_slug: 'dentiste/bordeaux/jane-doe'
+      #   )
+      #   collection.booking_url
+      #   #=> "https://www.doctolib.fr/dentiste/bordeaux/jane-doe/booking/motives?pid=practice-125055&vmids[]=1830057"
+      def booking_url
+        return unless @query[:booking_slug]
+
+        practice_id = [@query[:practice_ids]].flatten.first
+        "#{TocDoc.api_endpoint}/#{@query[:booking_slug]}/booking/motives" \
+          "?pid=practice-#{practice_id}" \
+          "&vmids[]=#{@query[:visit_motive_ids]}"
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: toc_doc
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - 01max