Krys4lide/crates/fsv-sys/README.md

# FSV-sys, bindings Rust pour le package FSV SESAM-Vitale

## Librairies FSV

### Versions supportées

| Version FSV |
|-------------|
| 1.40.14     |
| 1.40.13     |

### État d'avancement de l'implémentation des bindings FSV

Les détails de l'avancement de l'implémentation des bindings FSV sont donnés dans le fichier [PROGRESS.md](PROGRESS.md)

## Utilisation

### Pré-requis

- Installer le [package FSV](https://industriels.sesam-vitale.fr/group/fournitures-sesam-vitale)
    - Les librairies dynamiques (.lib, .dll, ...) fournies ne sont pas installés dans les emplacements standard du système, il faudra donc configurer leur chemin d'installation dans le fichier de configuration `.env.build` (voir ci-dessous)
        - Le détail des chemins d'installation est donné dans la documentation du package FSV `fsv-mi-004_pack-FSV1.40.14_V2.3.pdf`
            - Linux - par défaut : `/opt/santesocial/fsv/1.40.13/lib`
            - Windows - par défaut : `C:\Program Files\santesocial\santesocial\fsv\1.40.14\lib` (ou dans Program Files (x86) si c'est le package 32bits qui a été installé)

- Installer la [CryptolibCPS](https://industriels.sesam-vitale.fr/group/galss-cryptolib-cps)
    - Ce package fourni également l'utilitaire "CPS Gestion" pour obtenir des informations sur le lecteur de carte, etc.
        - Linux : `cpgeslux`
        - Windows : `...`

## Développement

### Pré-requis

- Pour la génération des bindings lors de la phase de `build` à l'aide de `bindgen`, il est nécessaire d'avoir installé `clang` ([documentation](https://rust-lang.github.io/rust-bindgen/requirements.html)).
feat: Première implémentation de bindings pour FSV SESAM-Vitale - Création de la crates/fsv-sys - Ajout des headers de la FSV 1.40.14.13 dans crates/fsv-sys/vendor - Génération des bindings depuis ces headers avec bindgen - Implémentation d'une structure de loading de la librairie au runtime - Implémentation d'une macro permettant de générer facilement la couche d'accès aux fonctions de la librairie 2024-09-29 12:44:57 +02:00			`# FSV-sys, bindings Rust pour le package FSV SESAM-Vitale`

feat: improve the fsv-sys README, and add a PROGESS.md for implementation tracking 2024-09-30 23:58:49 +02:00			`## Librairies FSV`

			`### Versions supportées`

			`\| Version FSV \|`
			`\|-------------\|`
			`\| 1.40.14 \|`
			`\| 1.40.13 \|`

			`### État d'avancement de l'implémentation des bindings FSV`

			`Les détails de l'avancement de l'implémentation des bindings FSV sont donnés dans le fichier [PROGRESS.md](PROGRESS.md)`

feat: Première implémentation de bindings pour FSV SESAM-Vitale - Création de la crates/fsv-sys - Ajout des headers de la FSV 1.40.14.13 dans crates/fsv-sys/vendor - Génération des bindings depuis ces headers avec bindgen - Implémentation d'une structure de loading de la librairie au runtime - Implémentation d'une macro permettant de générer facilement la couche d'accès aux fonctions de la librairie 2024-09-29 12:44:57 +02:00			`## Utilisation`

			`### Pré-requis`

			`- Installer le [package FSV](https://industriels.sesam-vitale.fr/group/fournitures-sesam-vitale)`
			- Les librairies dynamiques (.lib, .dll, ...) fournies ne sont pas installés dans les emplacements standard du système, il faudra donc configurer leur chemin d'installation dans le fichier de configuration `.env.build` (voir ci-dessous)
			- Le détail des chemins d'installation est donné dans la documentation du package FSV `fsv-mi-004_pack-FSV1.40.14_V2.3.pdf`
			- Linux - par défaut : `/opt/santesocial/fsv/1.40.13/lib`
			- Windows - par défaut : `C:\Program Files\santesocial\santesocial\fsv\1.40.14\lib` (ou dans Program Files (x86) si c'est le package 32bits qui a été installé)

			`- Installer la [CryptolibCPS](https://industriels.sesam-vitale.fr/group/galss-cryptolib-cps)`
			`- Ce package fourni également l'utilitaire "CPS Gestion" pour obtenir des informations sur le lecteur de carte, etc.`
			- Linux : `cpgeslux`
			- Windows : `...`

			`## Développement`

			`### Pré-requis`

			- Pour la génération des bindings lors de la phase de `build` à l'aide de `bindgen`, il est nécessaire d'avoir installé `clang` ([documentation](https://rust-lang.github.io/rust-bindgen/requirements.html)).