From 00f83636e50ff2e052594a6b87fb578dfe585a92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C3=ABl=20Gangloff?= <contact@maelgangloff.fr>
Date: Wed, 26 Apr 2023 02:07:27 +0200
Subject: [PATCH] docs: add example for toCSV. Ref #12

---
 README.md    | 17 +++++++++++++++--
 src/index.ts | 16 ++++++++++++++--
 2 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index f93758f..988851b 100644
--- a/README.md
+++ b/README.md
@@ -259,7 +259,7 @@ Il est possible de le convertir au format iCalendar.
 **Example**  
 ```js
 const { writeFileSync } = require('node:fs')
-const {Skolengo} = require('scolengo-api')
+const { Skolengo } = require('scolengo-api')
 
 Skolengo.fromConfigObject(config).then(async user => {
   const studentId = 'ESKO-P-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
@@ -439,7 +439,8 @@ Envoyer un message dans un fil de discussion existant
 <a name="Skolengo+getAbsenceFiles"></a>
 
 ### skolengo.getAbsenceFiles(studentId, limit, offset)
-Récupérer les absences et retards d'un étudiant
+Récupérer les absences et retards d'un étudiant.
+Il est possible d'exporter les absences au format CSV.
 
 **Kind**: instance method of [<code>Skolengo</code>](#Skolengo)  
 
@@ -449,6 +450,18 @@ Récupérer les absences et retards d'un étudiant
 | limit | <code>number</code> | <code>20</code> | Limite |
 | offset | <code>offset</code> | <code>0</code> | Offset |
 
+**Example**  
+```js
+const { writeFileSync } = require('node:fs')
+const { Skolengo } = require('scolengo-api')
+
+Skolengo.fromConfigObject(config).then(async user => {
+  const studentId = 'ESKO-P-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+  const absenceFiles = await user.getAbsenceFiles(studentId)
+
+  writeFileSync('export.csv', agenda.toCSV())
+})
+```
 <a name="Skolengo+getAbsenceFile"></a>
 
 ### skolengo.getAbsenceFile(folderId)
diff --git a/src/index.ts b/src/index.ts
index a1adb4d..6829a9f 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -477,7 +477,7 @@ export class Skolengo {
    * @async
    * @example ```js
    * const { writeFileSync } = require('node:fs')
-   * const {Skolengo} = require('scolengo-api')
+   * const { Skolengo } = require('scolengo-api')
    *
    * Skolengo.fromConfigObject(config).then(async user => {
    *   const studentId = 'ESKO-P-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
@@ -793,11 +793,23 @@ export class Skolengo {
   }
 
   /**
-   * Récupérer les absences et retards d'un étudiant
+   * Récupérer les absences et retards d'un étudiant.
+   * Il est possible d'exporter les absences au format CSV.
    * @param {string} studentId Identifiant d'un étudiant
    * @param {number} limit Limite
    * @param {offset} offset Offset
    * @async
+   * @example ```js
+   * const { writeFileSync } = require('node:fs')
+   * const { Skolengo } = require('scolengo-api')
+   *
+   * Skolengo.fromConfigObject(config).then(async user => {
+   *   const studentId = 'ESKO-P-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+   *   const absenceFiles = await user.getAbsenceFiles(studentId)
+   *
+   *   writeFileSync('export.csv', agenda.toCSV())
+   * })
+   * ```
    */
   public async getAbsenceFiles (studentId: string, limit = 20, offset = 0): Promise<AbsenceFilesResponse> {
     return new AbsenceFilesResponse((await this.request<SkolengoResponse<AbsenceFile[], AbsenceFileIncluded>>({