npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@leximpact/territoires

v1.0.1

Published

Various APIs for French territories: communes autocompleter, etc

Downloads

6

Readme

LexImpact Territoires

Diverses API pour les territoires français : autocomplétion des communes, etc

Installation

git clone https://git.leximpact.dev/leximpact/territoires.git
cd territoires/
npm install

Mise à jour des données sur les territoires

Base officielle des codes postaux

cf https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/

mkdir -p data
wget https://datanova.laposte.fr/data-fair/api/v1/datasets/laposte-hexasmal/metadata-attachments/base-officielle-codes-postaux.csv -O data/laposte_hexasmal.csv
npx tsx src/scripts/import_laposte_hexasmal.ts

Code officiel géographique

Fichier des communes
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/commune_2022.csv" -O data/commune.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_commune_2023.csv" -O data/commune.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_commune_2024.csv" -O data/commune.csv
npx tsx src/scripts/import_code_officiel_geographique_commune.ts
Fichier des communes des collectivités d'outre-mer
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/com_comer_2022.csv" -O data/com_comer.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_commune_comer_2023.csv" -O data/com_comer.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_commune_comer_2024.csv" -O data/com_comer.csv
npx tsx src/scripts/import_code_officiel_geographique_com_comer.ts
Fichier des évènements sur les communes
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/mvtcommune_2022.csv" -O data/mvtcommune.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_mvtcommune_2023.csv" -O data/mvtcommune.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_mvt_commune_2024.csv" -O data/mvtcommune.csv
npx tsx src/scripts/import_code_officiel_geographique_mvtcommune.ts
Fichier des départements
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/departement_2022.csv" -O data/departement.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_departement_2023.csv" -O data/departement.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_departement_2024.csv" -O data/departement.csv
npx tsx src/scripts/import_code_officiel_geographique_departement.ts
Fichier des collectivités d'outre-mer
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/comer_2022.csv" -O data/comer.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_comer_2023.csv" -O data/comer.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_comer_2024.csv" -O data/comer.csv
npx tsx src/scripts/import_code_officiel_geographique_comer.ts

Fichier des intercommunalités (établissements publics de coopération intercommunale, EPCI)

cf https://www.insee.fr/fr/information/2510634

cd data/
# wget "https://www.insee.fr/fr/statistiques/fichier/2510634/Intercommunalite_Metropole_au_01-01-2022.zip"
# unzip Intercommunalite_Metropole_au_01-01-2022.zip
# rm Intercommunalite_Metropole_au_01-01-2022.zip
# mv Intercommunalite_Metropole_au_01-01-2022.xlsx epci.xlsx
# wget "https://www.insee.fr/fr/statistiques/fichier/2510634/Intercommunalite_Metropole_au_01-01-2023.zip"
# unzip Intercommunalite_Metropole_au_01-01-2023.zip
# rm Intercommunalite_Metropole_au_01-01-2023.zip
# mv Intercommunalite_Metropole_au_01-01-2023.xlsx epci.xlsx
wget "https://www.insee.fr/fr/statistiques/fichier/2510634/epci_au_01-01-2024.zip"
unzip epci_au_01-01-2024.zip
rm epci_au_01-01-2024.zip
mv EPCI_au_01-01-2024.xlsx epci.xlsx
cd ../
npx tsx src/scripts/import_epci.ts

Circonscriptions législatives

Fichier Insee des circonscriptions législatives

cf https://www.insee.fr/fr/statistiques/6436476

Note : il manque dans le fichier les collectivités d'outre-mer (COM) et Mayotte (les autres départements et régions d'outre-mer (DROM) sont présents).

wget "https://www.insee.fr/fr/statistiques/fichier/6436476/circo_composition.xlsx" -O data/circo_composition.xlsx
npx tsx src/scripts/import_insee_circonscriptions_legislatives.ts
Fichier des circonscriptions législatives provenant du Ministère de l'intérieur.

cf https://www.data.gouv.fr/fr/datasets/circonscriptions-legislatives-table-de-correspondance-des-communes-et-des-cantons-pour-les-elections-legislatives-de-2012-et-sa-mise-a-jour-pour-les-elections-legislatives-2017/

Le fichier intéressant est Table_de_correspondance_circo_legislatives2017-1.xlsx.

Note : Les codes des communes de ce fichier sont plus complexes à utiliser que le fichier de l'Insee ci-dessus. Il n'est donc utilisé que pour les collectivités d'outre-mer + Mayotte et complète celui de l'Insee.

wget "https://www.data.gouv.fr/fr/datasets/r/4d0b70e1-7757-43cc-882b-5c3b04fe38b4" -O data/circonscriptions_legislatives.xlsx
npx tsx src/scripts/import_ministere_interieur_circonscriptions_legislatives_collectivites_outre-mer.ts
Fichiers des députés
cd data/
git clone https://git.en-root.org/tricoteuses/data/assemblee-nettoye/AMO30_tous_acteurs_tous_mandats_tous_organes_historique_nettoye.git
cd ../
npx tsx src/scripts/import_deputes.ts

Critères de répartition des dotations aux collectivités de la Direction générale des collectivités locales

Ces fichiers des critères de répartition des dotations aux collectivités contient un découpage territorial, mis à jour fin Mars, début Avril, plus à jour que le code officiel géographique de l'Insee.

cf :

  • http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition.php
  • https://www.dotations-dgcl.interieur.gouv.fr/consultation/dotations_en_ligne.php
# Critères de répartition des dotations communales :
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2022&ct=com" -O data/criteres_repartition_communes.xls
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2023&ct=com" -O data/criteres_repartition_communes.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2024&ct=com" -O data/criteres_repartition_communes.xls
npx tsx src/scripts/import_dgcl_criteres_repartition_communes.ts
# Critères de répartition des dotations communales :
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2022&ct=dep" -O data/criteres_repartition_departements.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2023&ct=dep" -O data/criteres_repartition_departements.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2024&ct=dep" -O data/criteres_repartition_departements.xls
npx tsx src/scripts/import_dgcl_criteres_repartition_departements.ts

Autocomplétions

Autocomplétions des communes
npx tsx src/scripts/generate_communes_autocompletions.ts
    Commune with INSEE code 18131 present in file La Poste hexasmal but missing from INSEE.
    Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
    Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
    Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
    Commune with INSEE code 95282 present in file La Poste hexasmal but missing from INSEE.
Autocomplétions des départements
npx tsx src/scripts/generate_departements_autocompletions.ts
Autocomplétions des intercommunalités (EPCI)
npx tsx src/scripts/generate_epci_autocompletions.ts
Autocomplétions des circonscriptions législatives
npx tsx src/scripts/generate_circonscriptions_legislatives_autocompletions.ts
Autocomplétions des communes DGCL
npx tsx src/scripts/generate_communes_dgcl_autocompletions.ts
Autocomplétions des départements DGCL
npx tsx src/scripts/generate_departements_dgcl_autocompletions.ts
Autocomplétions des intercommunalités (EPCI) DGCL
npx tsx src/scripts/generate_epci_dgcl_autocompletions.ts

Lancement du serveur

En développement

npm run dev

En production

npm run build

Utilisation

Recherche d'une commune par autocomplétion

wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=saint%20python"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=st%20python"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=75007%20Paris"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=Paris%207"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?field=commune&q=Paris%207"

Plus d'exemples se trouvent dans les tests.