etalab / inventaire-codes-sources-organismes-publics

Inventaire des codes sources des organismes publics (archivé)
17 stars 2 forks source link

+title: Inventaire des dépôts de code source publiés par les organismes publics

Ce dépôt n'est plus maintenu. Il est remplacé par [[https://github.com/etalab/data-codes-sources-fr][data-codes-sources-fr]], sur lequel vos contributions sont les bienvenues.

Si vous êtes un organisme public, vous pouvez aussi ajouter votre compte d'organisation Github en faisant une /pull request/ de mise à jour de [[https://github.com/DISIC/politique-de-contribution-open-source/blob/master/OrgAccounts][ce fichier]].

Le contenu ci-dessous est laissé à titre d'archivage.

Le but de ce dépôt est de donner de la visibilité à l'ensemble des dépôts publiés par les comptes d'organisation d'organismes publics.

Ne sont pour l'instant traités que les comptes présents sur GitHub. Les comptes présents sur d'autres plates-formes (par ex. GitLab) pourront être intégrés dans un second temps.

Pour ajouter le compte d'organisation de votre organisme, vous pouvez proposer de modifier [[https://github.com/DISIC/politique-de-contribution-open-source/blob/master/OrgAccounts][le fichier]] pertinent dans le dépôt de la DINSIC relatif à la Politique de Contribution Open Source de l'État.

Si votre compte est sur GitHub, vous pouvez aussi l'ajouter à la liste des comptes figurant sur [[https://government.github.com/community/][cette page]].

** Évolutions possibles

Il est prévu de faire évoluer la collecte de ces informations en l'automatisant, en stockant les données dans une base de données et en proposant une interface web pour les parcourir.

Pour les comptes d'organisation, voici les en-têtes du fichier =.csv= généré et, en regard, le propriétés du fichier =.json= récupérées via l'API de GitHub :

| Champ csv | Champ json | |-------------+---------------| | Nom | .login | | URL | .html_url | | Blog | .blog | | Email | .email | | Description | .bio | | # de dépôts | .public_repos | | # followers | .followers | | Créé | .created_at | | Mis à jour | .updated_at |

Voici le tableau équivalent pour les dépôts de code source :

| Champ csv | Champ json | |--------------+-------------------| | Nom | .name | | Organisation | .owner.html_url | | URL | .html_url | | Description | .description | | Fork? | .fork | | Créé | .created_at | | Mis à jour | .updated_at | | Homepage | .homepage | | # Stars | .stargazers_count | | # forks | .forks_count | | Licence | .license | | Issues | .open_issues | | Langages | .language |

** Prérequis

Avec une distribution [[https://www.debian.org/][Debian]] ou dérivée :

: ~$ sudo apt-get update : ~$ sudo apt-get install jq : ~$ sudo pip install yq

** Utilisation du script

Le script demande deux variables d'environnement:

Pour tester le script :

: ~$ git clone https://github.com/etalab/inventaire-codes-sources-organismes-publics.git : ~$ cd inventaire-codes-sources-organismes-publics/ : ~$ GITHUB_USER=xxx GITHUB_TOKEN=yyy ./generate_csv.sh

Le script va alors créer les répertoires =organisations= et =repositories= et y ajouter les fichiers utiles.

Vos contributions sont les bienvenues sous forme d'/issues/ ou de /pull request/ - quelques pistes :

2018 Direction interministérielle du numérique et du système d'information et de communication de l'État, Bastien Guerry

2018 Les autres contributeurs dans la liste est accessible via l'historique du dépôt.

Les contenus publiés dans ce dépôt sont publiés sous Licence Ouverte 2.0 -- voir le fichier =LO.md= dans ce répertoire. Vous êtes libre de réutiliser les contenus de ce dépôt sous les conditions précisées dans cette licence.