RegardsCitoyenPS

BuildStatus

Type	Status
Overall
Master

Pour rapporter un bug, ou pour suggérer une fonctionnalité, merci de créer une nouvelle issue sur Github Issues

Introduction

RegardsCitoyensPS est un projet qui permet de fournir à tout citoyen, la possibilité de rechercher des données de la vie politique Française en utilisant Windows PowerShell par le biais de l'API RegardsCitoyen.

(Ce projet est une initiative personnelle, et n'engage en rien RegardsCitoyens.)

Installation

l'installation est simple et rapide. Il suffit d'ouvrir une fenêtre powershell en tant qu'administrateur et d'executer la commande suivante:

Install-Module RegardsCitoyenPS -Force

L'installation devrait pas prendre plus de quelques secondes.

Actions de base

Lister toutes les commandes disponible du module

C:\WINDOWS\system32 > get-command -Module RegardsCitoyenPS

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Get-RCDepute                                       0.6.2.0    RegardsCitoyenPS
Function        Get-RCDocument                                     0.6.2.0    RegardsCitoyenPS
Function        Get-RCDossier                                      0.6.2.0    RegardsCitoyenPS
Function        Get-RCGroupePolitique                              0.6.2.0    RegardsCitoyenPS
Function        Get-RCIntervention                                 0.6.2.0    RegardsCitoyenPS
Function        Get-RCOrganismeExtraParlementaire                  0.6.2.0    RegardsCitoyenPS
Function        Get-RCOrganismeParlementaire                       0.6.2.0    RegardsCitoyenPS
Function        Get-RCSeance                                       0.6.2.0    RegardsCitoyenPS
Function        Get-RCSynthese                                     0.6.2.0    RegardsCitoyenPS
Function        Invoke-RCRecherche                                 0.6.2.0    RegardsCitoyenPS

Comme vous povez le voir, toutes les commandes (appelées Cmdlets) sont des préfixes des lettres "RC", qui est l'abréviation de "RegardsCitoyens".

Trouver de l'aide sur une commande en particulier:

Get-Help <Nom-de-commande>

Par exemple, afin d'obtenir de l'aide sur le fonctionnement de Get-RCDepute, il suffit de taper:

Get-Help Get-RCDepute

Il est possible d'avoir des exemples d'utilisation en utilisant le paramètre -Examples

Get-Help Get-RCDepute -Examples

Ou bien encore l'aide en détail d'une commande avec le paramètre -Detailed

Get-Help Get-RCDepute -Examples

Découverte du module RegardsCitoyensPS

Lister tous les députés actuellement en mandat

Get-RCDepute

Cette commande donnera un résultat similaire à ceci:

        id                 : 1
        Nom                : Roussel
        Prenom             : Cédric
        Sexe               : H
        DateNaissance      : 10/10/1972 12:00:00 AM
        LieuNaissance      : Brest (Finistère)
        Groupe             : LREM
        NomCirconscription : Alpes-Maritimes
        numcirco           : 3
        PlaceHemicylce     : 309
        DebutDeMandat      : 6/21/2017 12:00:00 AM
        Profession         : Conseiller en gestion de patrimoine indépendant
        Twitter            : CedricRoussel06
        NombreDeMandats    : 1
        partirattfinancier : En marche !
        autresmandats      : {}
        Collaborateurs     : {Mme Tiffany Palanque, Mme Camilia M'Hamed-Said, Mme Morgane Reclus}
        Emails             : {cedric.roussel@assemblee-nationale.fr, 6circo03@en-marche.fr}

        id                 : 2
        Nom                : Hai
        Prenom             : Nadia
        Sexe               : F
        DateNaissance      : 3/8/1980 12:00:00 AM
        LieuNaissance      : Trappes (Yvelines)
        Groupe             : LREM
        NomCirconscription : Yvelines
        numcirco           : 11
        PlaceHemicylce     : 349
        DebutDeMandat      : 6/21/2017 12:00:00 AM
        Profession         : Autre cadre (secteur privé)
        Twitter            : NadiaHai78
        NombreDeMandats    : 1
        partirattfinancier : En marche !
        autresmandats      : {}
        Collaborateurs     : {Mme Nelly Guého, M. Moussa Ouarouss, Mme Feriel Herlaut, Mme Moufida Goucha}
        Emails             : {nadia.hai@en-marche.fr, nadia.hai@assemblee-nationale.fr}

        (...)

Avoir la liste de tous les groupes politiques Français

Get-RCGroupPolitique

Avoir la liste de tous les députés membre d'un groupe politique Français bien précis

Get-RCGroupPolitique -Acronyme LR -ListMembres

(Retourne tous les députés membres du groupe 'les républicains')

Avoir la liste de tous les dossiers qui sont actuellement discuté à l'assemblée nationale

Get-RCDossier

Afin de faciliter la visualisation, il est conseillé d'utiliser 'Format-Table'

Get-RCDossier | Format-Table

Obtenir le détail d'un dossier en particulier (par ID)

Par exmemple, ID 167 qui reference le dossier "Confiance dans la vie politique".

    Get-RCDossier -id 167

A des fins d'optimisation, pas toutes les données sont directement renvoyées. Pour avoir accès a toutes les données, il faut utiliser le parametre "-Full"

    Get-RCDossier -id 167 -Full

En fonction du dossier, ceci peut durer plus ou moins longtemps. Comme le dossier concernant "la confiance dans la vie politique" à été très discuté, il y a eu beaucoup de documents / interventions produits, venant de beacoup d'intervenants (députés) differents. Donc il sera un peu long à charger.

Liens

Site	Description
PowerShellDistrict.com	Blog de l'auteur (Stéphane van Gulick) contenant des details techniques sur le projet RegardsCitoyensPS
Assemblee-Nationale.fr	Site officiel de l'assemblée Nationale
Senat.fr	Site officiel de du sénat
RegardsCitoyens.Org	Site officiel de Regards Citoyens
Nosdeputes.fr	Site officiel de "nosdéputes.fr"
Page Github de Nos députes	Page github expliquant le fonctionnement de l'API de RegardsCitoyens
.org

Tâches

• Migrer la liste des tâches à faire dans Github Issues
• Get-RCDepute
  • Parametre 'Nom'
  • Paramtre 'Prenom'
  • Recherche par 'Id'
  • Parametre Circonscription
  • Parametre NumDepartement
  • Parametre NomDepartement
• Get-RCGroupePolitique
  • Parametre 'ListMembre'
  • Parametre 'Nom'
• Get-RCOrganismeParlementaire
  • Ecrire Pester Test Get-RCOrganismeParlementaire.Tests.ps1
  • Creer Class Organisme
  • Methode [Depute] GetMembres()
  • Methode [Depute] GetPresident() --> CEci va nécessiter la création d'une classe 'Membre' qui hériterai de [Depute] avec les propriétés supp suivants: --> fonction --> Debut fonction
• Get-RCOrganismeExtraParlementaire
  • Methode [Depute] GetMembres()
  • Methode [Depute] GetPresident()
  • Create Pester Test
• Get-RCEtudesEtAmities
  • Methode [Depute] GetMembres()
  • Methode [Depute] GetPresident()
• Get-RCSenateur
• Get-RCSynthese
  • Créer Class [Synthese]
  • Fournir le possibilité de recupérer les données de synthèse pour un mois et une année en particulier
• Invoke-RCRecherche
  • Implemente Query (Text Libre)
  • Implementation de query aidé (Via Params)
  • Pester Tests
• Get-RCDossier -> http://www.assemblee-nationale.fr/15/documents/index-dossier.asp
  • Parametre ID
  • Parametre Full (Recuperation des données Documents, Intervenants,Seance, sousSections via ID/slug)
  • Class Dossier
    • _LoadSceances
    • LoadDocuments
    • _LoadIntervenants()
      • GetInterventions() Retourne les interventions d'un député en mémoire. (Trop complexe?)
• Get-RCDocument
  • ID
  • No Param (List tous les Documents) -> Depends sur Get-RCRecherche
  • Class Document
• Get-RCSceance
  • Class Sceance (Array d'interventions)
• Class Intervention
• Class Mandat
• Analyse pour Cmdlet GetRCRecherche
• Class Intervenant (Hérite de Depute)
  • Update toutes les cmdlets suivants:
    • Get-RCDossier
• Improve Error handling
• Documentation
  • about_RegardsCitoyenPs
  • Get-RCDepute
  • Get-RCDocument
  • Get-RCDossier
  • Get-RCGroupePolitique
  • Get-RCSeance
  • Get-RCSynthese
  • Invoke-RCRecherche