insee_number_translator/README.md

98 lines
3.5 KiB
Markdown
Raw Normal View History

2021-08-21 09:07:27 +02:00
# INSEE number translator (Français)
(English below)
Extrait les données des numéros INSEE (numéro de sécurité sociale française).
2019-07-11 00:03:31 +02:00
2021-08-21 09:07:27 +02:00
Le numéro de sécurité sociale français est *signifiant*. Cela veut dire que ce n'est pas un numéro aléatoire,
il porte des informations.
* https://www.insee.fr/fr/metadonnees/definition/c1409
* https://fr.wikipedia.org/wiki/Num%C3%A9ro_de_s%C3%A9curit%C3%A9_sociale_en_France
## Commencer
### Utiliser un programme prêt à l'emploi
Rendez-vous sur la [dernière version](https://git.augendre.info/gaugendre/insee_number_translator/releases/latest)
et téléchargez le fichier correspondant à votre système d'exploitation et à votre architecture.
Si vous ne savez pas de quoi il s'agit, essayez d'abord `amd64` puis `386` si le premier ne fonctionne pas.
Pour macOS, utilisez le fichier `darwin`.
Ensuite, utilisez la ligne de commande pour exécuter le fichier :
```shell
./insee 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
```
Rassurez-vous, ce programme ne transmet aucune information sur le réseau. Toutes les données
nécessaires à son fonctionnement sont comprises dans le fichier que vous venez de télécharger.
Votre numéro de sécurité sociale ne quitte pas votre ordinateur.
### Depuis les sources
Requiert les outils `go` (https://golang.org/).
#### Exécution directe
```shell
go run . 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
```
#### Compilation et installation
```shell
go install
insee_number_translator 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
```
# INSEE number translator (English)
Extract data from INSEE number (France).
The french social security number is significant. That means it's not a random number, it bears information.
* (fr) https://www.insee.fr/fr/metadonnees/definition/c1409
* (fr) https://fr.wikipedia.org/wiki/Num%C3%A9ro_de_s%C3%A9curit%C3%A9_sociale_en_France
2019-07-11 00:03:31 +02:00
2021-08-06 15:37:45 +02:00
## Getting started
2021-08-19 11:43:39 +02:00
### Using a pre-built binary
Go to the [latest release](https://git.augendre.info/gaugendre/insee_number_translator/releases/latest)
2021-08-21 09:07:27 +02:00
and download the binary matching your OS and architecture.
If you don't know what that means, try `amd64` first, then `386` if it doesn't work.
For macOS, choose `darwin`.
2021-08-19 11:43:39 +02:00
Then, run the tool via the command line:
```shell
./insee 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
```
2021-08-21 09:07:27 +02:00
Rest assured, this program doesn't transmit any information on the network. All the data
necessary for its operation are included in the file you just downloaded.
Your social security number doesn't leave your computer.
2021-08-19 11:43:39 +02:00
2021-08-18 19:01:17 +02:00
### From sources
2021-08-21 09:07:27 +02:00
Requires the `go` toolchain (https://golang.org/).
2021-08-18 19:01:17 +02:00
#### Run
2021-08-06 16:03:24 +02:00
```shell
go run . 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
2021-08-06 16:03:24 +02:00
```
2021-08-06 15:37:45 +02:00
2021-08-18 19:01:17 +02:00
#### Build & install
2021-08-06 15:37:45 +02:00
```shell
2021-08-18 19:01:17 +02:00
go install
insee_number_translator 269059913116714 168127982980507 299122A00498723 299129742398791 144089943287340
2021-08-06 15:37:45 +02:00
```
2021-08-21 09:07:27 +02:00
# Tinker
## Update data
You can easily update the data by downloading the CSV files available using the link in `Data sources` below.
Then, unzip the file in `data/raw_data` and run the following command:
```shell
invoke pre-process
```
2021-08-21 09:31:35 +02:00
This requires [`invoke`](https://www.pyinvoke.org/) on your machine (run `pip install -r requirements.txt`).
2021-08-21 09:07:27 +02:00
## Release
2021-08-21 09:30:58 +02:00
Run tests, create a tag and build binaries:
```
inv release <version_name>
```
2021-08-21 09:07:27 +02:00
# Data sources
2019-07-11 00:03:31 +02:00
* https://www.insee.fr/fr/information/2560452, Millésime 2021 : Téléchargement des fichiers, CSV