toc_doc 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3637aae8586b1ea3b5b568a4ef64a295b3e3664ada7d252163e8176ce429aa37
+  data.tar.gz: da283d2f5efd9c37b7f6b20d6bc207dcb79f826850b8d7d0953157473f36345f
+SHA512:
+  metadata.gz: 79a3d614929d14b5709dec397ab39a78c07db2db0e31da2e2de7423af8da4a1af5b5dbc77f3943da8b104ab25b85531328e739697384fb7a8a53451320bf9951
+  data.tar.gz: 962d1c35bb6ede7899491b93e0f00c868a3aa87ffe4a32b076576b0017d96ff09e3214eb37000bee0ba40f43269597c75d21daf18c77e92787b39d61b29b4696

data/.env.example

@@ -0,0 +1,17 @@
+# Example environment configuration for TocDoc
+# Copy this file to `.env` and adjust values as needed.
+
+# Base API endpoint (supports other regions like .de, .it)
+# TOCDOC_API_ENDPOINT=https://www.doctolib.fr
+
+# Custom user agent sent with each request
+# TOCDOC_USER_AGENT=TocDoc Ruby Gem
+
+# Default media type for requests
+# TOCDOC_MEDIA_TYPE=application/json
+
+# Default pagination limit
+# TOCDOC_PER_PAGE=3
+
+# Max retry attempts for transient HTTP errors
+# TOCDOC_RETRY_MAX=3

data/.yardopts

@@ -0,0 +1,12 @@
+--markup markdown
+--output-dir doc
+--readme README.md
+--title "TocDoc Ruby Gem Documentation"
+--charset utf-8
+--protected
+--no-private
+--hide-void-return
+lib/**/*.rb
+-
+CHANGELOG.md
+LICENSE.md

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+## [Unreleased]
+
+## [1.0.0] - 2026-03-04
+
+### Added
+
+- **Client** — `TocDoc::Client` with configurable options, method delegation from top-level `TocDoc` module, and block-based `TocDoc.setup`
+- **Configuration** — 7 config keys (`api_endpoint`, `user_agent`, `middleware`, `connection_options`, `default_media_type`, `per_page`, `auto_paginate`) with environment variable overrides (`TOCDOC_API_ENDPOINT`, etc.)
+- **Availabilities endpoint** — `Client#availabilities` supporting `visit_motive_ids`, `agenda_ids`, `start_date`, `limit`, and arbitrary extra query params
+- **Pagination** — automatic multi-page fetching via `auto_paginate` option; merges results across pages using `next_slot`-based page advancement
+- **Response models** — `TocDoc::Response::Availability` wrapping the API response with `#total`, `#next_slot`, `#availabilities` (filtered) and `#raw_availabilities` (unfiltered)
+- **Resource base model** — `TocDoc::Resource` with dot-notation attribute access, bracket access, and Hash equality
+- **Availability model** — `TocDoc::Availability` with `#date` and `#slots`
+- **Error handling** — `TocDoc::Error` base class and `TocDoc::Middleware::RaiseError` Faraday middleware wrapping Faraday errors
+- **Connection layer** — Faraday-based HTTP with `get`, `post`, `put`, `patch`, `delete`, `head` and a default middleware stack (retry, raise_error, JSON parsing)
+- **Retry middleware** — automatic retries (up to 3, configurable via `TOCDOC_RETRY_MAX`) with exponential backoff on `429`, `5xx` errors
+- **URI utilities** — `#dashed_ids` helper for Doctolib's dash-separated ID format
+- **YARD documentation**
+
+## [0.1.0] - 2026-02-27
+
+- Initial build

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"tocdoc" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* 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").