toc_doc 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3637aae8586b1ea3b5b568a4ef64a295b3e3664ada7d252163e8176ce429aa37
-  data.tar.gz: da283d2f5efd9c37b7f6b20d6bc207dcb79f826850b8d7d0953157473f36345f
+  metadata.gz: 31301e5ab8d81e4a073f6a86da51671dd7d41673eff44b48373659831b971010
+  data.tar.gz: e308514b6009f7b703d8861e739d963ea0048ed930778329bd453b1f28f1e82c
 SHA512:
-  metadata.gz: 79a3d614929d14b5709dec397ab39a78c07db2db0e31da2e2de7423af8da4a1af5b5dbc77f3943da8b104ab25b85531328e739697384fb7a8a53451320bf9951
-  data.tar.gz: 962d1c35bb6ede7899491b93e0f00c868a3aa87ffe4a32b076576b0017d96ff09e3214eb37000bee0ba40f43269597c75d21daf18c77e92787b39d61b29b4696
+  metadata.gz: c8936171d0c8228e3a1390ef3d164ab5ca08cccecb656087cc983d61c859eaed3153d63715e4fd6f4bcd3f6b62cea4c85c1a6410669925ef3c73185f550eb28b
+  data.tar.gz: 23ad7e64604e97d9c18a0b99b8917af0b97974f2c67d1dc842d16070650a3e97ef79e0902d96f4dd4f8e71f84bdc30d09811aa16fb61342bbdcacb6e7979b8fc

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [1.1.0] - 2026-03-06
+
+### Changed
+
+- **`TocDoc::Availability`** — `#date` now returns a parsed `Date` object instead of a raw string; `#slots` now returns an array of `DateTime` objects instead of strings
+- **`TocDoc::Response::Availability#next_slot`** — falls back to inferring the next slot from the first available slot when the API response omits the `next_slot` key
+
+### Removed
+
+- **VCR** — removed VCR dependency from the test suite; HTTP interactions are now stubbed directly with WebMock
+
 ## [1.0.0] - 2026-03-04
 
 ### Added

data/README.md

@@ -2,6 +2,12 @@
 
 A Ruby gem for interacting with the (unofficial) Doctolib API. A thin, Faraday-based client with modular resource endpoints, configurable defaults, optional auto-pagination, and a clean error hierarchy.
 
+[![Gem Version](https://badge.fury.io/rb/toc_doc.svg)](https://badge.fury.io/rb/toc_doc)
+[![CI](https://github.com/01max/toc_doc/actions/workflows/main.yml/badge.svg)](https://github.com/01max/toc_doc/actions)
+[![Coverage Status](https://coveralls.io/repos/github/01max/toc_doc/badge.svg?branch=main)](https://coveralls.io/github/01max/toc_doc?branch=main)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![YARD Docs](https://img.shields.io/badge/docs-YARD-blue.svg)](https://rubydoc.info/gems/toc_doc)
+
 > **Heads-up:** Doctolib™ does not publish a public API. This gem reverse-engineers
 > the endpoints used by the Doctolib™ website. Behaviour may change at any time
 > without notice. This project is for entertainment purposes only.
@@ -71,7 +77,7 @@ response.total      # => 5
 response.next_slot  # => "2026-02-28T10:00:00.000+01:00"
 
 response.availabilities.each do |avail|
-  puts "#{avail.date}: #{avail.slots.join(', ')}"
+  puts "#{avail.date}: #{avail.slots.map { |s| s.strftime('%H:%M') }.join(', ')}"
 end
 ```
 
@@ -189,8 +195,8 @@ Each element of `Response::Availability#availabilities`.
 
 | Method | Type | Description |
 |---|---|---|
-| `#date` | `String` | Date in `YYYY-MM-DD` format. |
-| `#slots` | `Array<String>` | ISO 8601 datetimes for each bookable slot on that date. |
+| `#date` | `Date` | Parsed date object. |
+| `#slots` | `Array<DateTime>` | Parsed datetime objects for each bookable slot on that date. |
 | `#to_h` | `Hash` | Plain-hash representation. |
 
 **Example:**
@@ -201,8 +207,8 @@ response = TocDoc.availabilities(visit_motive_ids: 123, agenda_ids: 456)
 response.total      # => 5
 response.next_slot  # => "2026-02-28T10:00:00.000+01:00"
 
-response.availabilities.first.date   # => "2026-02-28"
-response.availabilities.first.slots  # => ["2026-02-28T10:00:00.000+01:00", ...]
+response.availabilities.first.date   # => #<Date: 2026-02-28>
+response.availabilities.first.slots  # => [#<DateTime: 2026-02-28T10:00:00+01:00>, ...]
 
 response.to_h
 # => {

data/TODO.md

@@ -1,77 +1,108 @@
-# 1.0
+# PLAN
 
-## 1 – Skeleton & Tooling
+### Extra Endpoints
+- [x] Identify additional endpoints
+- [ ] Prioritize implementation of resource modules for those endpoints
+
+## 1.2
+
+### Better API usage
+- [ ] Rate limiting
+- [ ] Caching
+- [ ] Logging
+
+## 1.4
+
+### Auth / User-based actions
+- [ ] Research auth scheme
+- [ ] Authentication module + headers
+- [ ] Auth specs
+
+# Potential Endpoints
+
+- Interesting JSONs [GET]
+  - Practitioner ? 
+    - https://www.doctolib.fr/pharmacie/paris/pharmacie-faidherbe.json
+    - https://www.doctolib.fr/dentiste/bordeaux/mathilde-devun-lesparre-medoc.json
+    - https://www.doctolib.fr/a/b/mathilde-devun-lesparre-medoc.json
+    - https://www.doctolib.fr/profiles/mathilde-devun-lesparre-medoc.json
+  - Rassemblement practiciens / Place Practitioners collection
+    - https://www.doctolib.fr/profiles/pavillon-de-la-mutualite-bordeaux-rue-vital-carles.json
+  - Places
+    - https://www.doctolib.fr/patient_app/place_autocomplete.json?query=47300
+- Interesting NON JSONs
+  - City practitioners (❗️JSON-LD in a script tag of an HTML page - data-id="removable-json-ld")
+    - https://www.doctolib.fr/dentiste/bordeaux/
+    - https://www.doctolib.fr/medecin-generaliste/bordeaux/
+    - https://www.doctolib.fr/medecin-generaliste/villeneuve-sur-lot
+- Non-interesting 
+  - Legal links
+    - https://www.doctolib.fr/search/footer_legal_links.json
+  - FAQ
+    - https://www.doctolib.fr/search/footer_public_content.json?hub_search=false&display_faq=true&speciality_id=2&place_id=18733 
+  - Social media links
+    - https://www.doctolib.fr/search/footer_social_media_links.json
+  - New Booking [POST]
+    - online_booking/draft/new.json
+
+# DONE & RELEASED
+
+## 1.0
+
+### 1 – Skeleton & Tooling
 - [x] Scaffold gem & layout
 - [x] Gem spec metadata & deps
 - [x] Lib structure (default/config/client/etc.)
 - [x] CI workflow (RSpec + RuboCop)
 - [x] RSpec + WebMock + VCR setup
 
-## 2 – Configuration
+### 2 – Configuration
 - [x] Default options & ENV fallbacks
 - [x] Configurable module (keys, reset, options)
 - [x] Top-level TocDoc wiring (client, setup, delegation)
 - [x] Config specs (module + client)
 
-## 3 – Connection & HTTP
+### 3 – Connection & HTTP
 - [x] Connection module (agent, request helpers)
 - [x] ~Faraday middleware~
 - [x] URL building helpers
 - [x] Connection specs
 
-## 4 – Error Handling
+### 4 – Error Handling
 - [x] Error base class & factory
 - [x] Error subclasses (4xx/5xx)
 - [x] RaiseError middleware
 - [x] Error mapping specs
 
-## 5 – Client & Availabilities
+### 5 – Client & Availabilities
 - [x] Client includes config + connection
 - [x] Availabilities endpoint module
 - [x] TocDoc.availabilities delegation
 - [x] Availabilities specs (stubs/VCR)
 
-## 6 – Response Objects
+### 6 – Response Objects
 - [x] Resource wrapper
 - [x] Availability objects
 - [x] Client mapping to response objects
 - [x] Response specs
 
-## 8 – Pagination
+### 8 – Pagination
 - [x] Analyze pagination model
 - [x] Implement Connection#paginate
 - [x] Pagination config & specs
 
-## 9 – Docs & Release
+### 9 – Docs & Release
 - [x] README
 - [x] YARD docs
 - [x] CHANGELOG
 - [x] FIX GH CI
-- [ ] Build & publish gem 
-  - [ ] on rubygem
-  - [ ] gem.coop ?
-
-# 1.1
+- [x] Build & publish gem
+  - [x] on rubygem
+  - [x] release on GH
+  - [x] gem.coop/@maxime
+- [x] Add test coverage tool
 
-## Parse raw API data
-- [ ] Parse date / datetime
-- [ ] ?
+## 1.1
 
-## Better API usage
-- [ ] Rate limiting
-- [ ] Caching
-- [ ] Logging
-- [ ] Better multi-region support ?
-- [ ] Async support ?
-
-## Extra Endpoints
-- [ ] Identify additional endpoints
-- [ ] Implement resource modules
-- [ ] Specs per endpoint
-
-# 1.2
-
-## Auth / User-based actions
-- [ ] Research auth scheme
-- [ ] Authentication module + headers
-- [ ] Auth specs
+### Parse raw API data
+- [x] Parse date / datetime

data/lib/toc_doc/core/version.rb

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

data/lib/toc_doc/models/availability.rb

@@ -1,21 +1,35 @@
 # frozen_string_literal: true
 
+require 'date'
+
 module TocDoc
   # Represents a single availability date entry returned by the Doctolib API.
   #
   # @example
   #   avail = TocDoc::Availability.new('date' => '2026-02-28', 'slots' => ['2026-02-28T10:00:00.000+01:00'])
-  #   avail.date   #=> "2026-02-28"
-  #   avail.slots  #=> ["2026-02-28T10:00:00.000+01:00"]
+  #   avail.date       #=> #<Date: 2026-02-28>
+  #   avail.raw_date   #=> "2026-02-28"
+  #   avail.slots      #=> [#<DateTime: 2026-02-28T10:00:00.000+01:00>]
+  #   avail.raw_slots  #=> ["2026-02-28T10:00:00.000+01:00"]
   class Availability < Resource
-    # @return [String] date in ISO 8601 format (e.g. "2026-02-28")
-    def date
-      @attrs['date']
+    attr_reader :date, :slots
+
+    # @param attrs [Hash] raw attributes from the API response, expected to include
+    def initialize(*attrs)
+      super
+      raw = build_raw(@attrs)
+
+      @date = Date.parse(raw['date']) if raw['date']
+      @slots = raw['slots'].map { |s| DateTime.parse(s) }
     end
 
-    # @return [Array<String>] ISO 8601 datetime strings for each available slot
-    def slots
-      @attrs['slots'] || []
+    private
+
+    def build_raw(attrs)
+      {
+        'date' => attrs['date'],
+        'slots' => attrs['slots'] || []
+      }
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: toc_doc
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - 01max
@@ -45,7 +45,7 @@ dependencies:
         version: '2.0'
 description: |-
   A standalone Ruby gem providing a Faraday-based client
-      with modular resource endpoints, configurable defaults, and a clean error hierarchy.
+      to interact with the (unofficial) Doctolib API.
 email:
 - m.louguet@gmail.com
 executables: []
@@ -82,7 +82,6 @@ homepage: https://github.com/01max/toc_doc
 licenses:
 - GPL-3.0-or-later
 metadata:
-  allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/01max/toc_doc
   source_code_uri: https://github.com/01max/toc_doc/tree/main
   changelog_uri: https://github.com/01max/toc_doc/blob/main/CHANGELOG.md