Add Github handle endpoint and missing fields

Relates to #4 (closed)

Resolves #17 (closed)

Decided to include the work from this MR as well.

spec/openapi.yaml

@@ -8,11 +8,11 @@ info:
     url: https://www.eclipse.org/legal/epl-2.0/
 
 servers:
-  - url: https://api.eclipse.org/v2/account/profile
+  - url: https://api.eclipse.org/v2/
     description: Production endpoints for Eclipse Foundation profile data
 
 paths:
-  /{name}:
+  /account/profile/{name}:
     get:
       tags:
         - User Profiles
@@ -45,15 +45,20 @@ paths:
               example:
                 uid: 9
                 name: cguindon
+                mail: chris.guindon@eclipse-foundation.org
+                picture: https://secure.gravatar.com/avatar/fbbbb03860062596a5cf11105dcc7d47.jpg?d=mm&s=185&r=G
                 eca:
                   signed: true
+                  can_contribute_spec_project: true
                 is_committer: true
                 friends:
                   friend_id: 6104
                 first_name: Christopher
                 last_name: Guindon
+                github_handle: chrisguindon
                 twitter_handle: chrisguindon
                 org: Eclipse Foundation
+                org_id: null
                 job_title: Lead Web Application Developper
                 website: http://www.chrisguindon.com/
                 country:
@@ -66,6 +71,91 @@ paths:
                   - php
                   - javascript
                   - Drums
+                working_groups_interests:
+                  - adoptium
+                  - oniro
+                forums_url: "https://api.eclipse.org/account/profile/chrisguindon/forum"
+                projects_url: "https://api.eclipse.org/account/profile/chrisguindon/projects"
+                gerrit_url: "https://api.eclipse.org/account/profile/chrisguindon/gerrit"
+                mailinglist_url: "https://api.eclipse.org/account/profile/chrisguindon/mailing-list"
+                mpc_favorites_url: "https://api.eclipse.org/marketplace/favorites/?name=chrisguindon"
+        404:
+          description: User not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        500:
+          description: Error while retrieving data.
+      deprecated: false
+  
+  /github/profile/{handle}:
+    get:
+      tags:
+        - User Profiles
+      summary: Retrieve user
+      description: Retrieve profile information about a specified user.
+      operationId: RetrieveUser
+      parameters:
+        - name: handle
+          in: path
+          description: A valid Github handle.
+          required: true
+          style: simple
+          explode: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          headers:
+            X-Rate-Limit-Limit:
+              $ref: "#/components/headers/X-RateLimit-Limit"
+            X-Rate-Limit-Remaining:
+              $ref: "#/components/headers/X-RateLimit-Remaining"
+            X-Rate-Limit-Reset:
+              $ref: "#/components/headers/X-RateLimit-Reset"
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/EfUser"
+              example:
+                uid: 9
+                name: cguindon
+                mail: chris.guindon@eclipse-foundation.org
+                picture: https://secure.gravatar.com/avatar/fbbbb03860062596a5cf11105dcc7d47.jpg?d=mm&s=185&r=G
+                eca:
+                  signed: true
+                  can_contribute_spec_project: true
+                is_committer: true
+                friends:
+                  friend_id: 6104
+                first_name: Christopher
+                last_name: Guindon
+                github_handle: chrisguindon
+                twitter_handle: chrisguindon
+                org: Eclipse Foundation
+                org_id: null
+                job_title: Lead Web Application Developper
+                website: http://www.chrisguindon.com/
+                country:
+                  code: CA
+                  name: Canada
+                bio: Hello world! When I am not at a computer, which is rare, I spend my time playing the drums, watching hockey or at the top of a hill snowboarding. I am also very passionate about music and live concerts!
+                interests:
+                  - Snowboarding
+                  - webdev
+                  - php
+                  - javascript
+                  - Drums
+                working_groups_interests:
+                  - adoptium
+                  - oniro
+                forums_url: "https://api.eclipse.org/account/profile/chrisguindon/forum"
+                projects_url: "https://api.eclipse.org/account/profile/chrisguindon/projects"
+                gerrit_url: "https://api.eclipse.org/account/profile/chrisguindon/gerrit"
+                mailinglist_url: "https://api.eclipse.org/account/profile/chrisguindon/mailing-list"
+                mpc_favorites_url: "https://api.eclipse.org/marketplace/favorites/?name=chrisguindon"
         404:
           description: User not found
           content:
@@ -101,6 +191,9 @@ components:
         name:
           type: string
           description: The user's ef username name.
+        picture:
+          type: string
+          description: URL of the user's picture.
         mail:
           oneOf:
             - type: string
@@ -125,12 +218,26 @@ components:
         last_name:
           type: string
           description: The user's last name.
+        publisher_agreements:
+          type: object
+          propertyNames:
+            description: The publisher agreement name.
+          additionalProperties:
+            $ref: "#/components/schemas/PublisherAgreement"
+        github_handle:
+          type: string
+          description: The user's Github handle.
         twitter_handle:
           type: string
           description: The user's Twitter handle.
         org:
           type: string
           description: The user's organization.
+        org_id:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's organization id.
         job_title:
           type: string
           description: The user's job title at the organization.
@@ -149,19 +256,53 @@ components:
           items:
             type: string
           description: A list of the user's interests.
+        working_groups_interests:
+          type: array
+          items:
+            type: string
+          description: A list of the user's working group interests.
+        forums_url:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's forum URL.
+        gerrit_url:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's Gerrit URL.
+        projects_url:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's projects URL.
+        mailinglist_url:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's mailing list URL.
+        mpc_favorites_url:
+          oneOf:
+            - type: string
+            - type: "null"
+          description: The user's Marketplace favorites URL.
       example:
         uid: 9
         name: cguindon
         mail: chris.guindon@eclipse-foundation.org
+        picture: https://secure.gravatar.com/avatar/fbbbb03860062596a5cf11105dcc7d47.jpg?d=mm&s=185&r=G
         eca:
           signed: true
+          can_contribute_spec_project: true
         is_committer: true
         friends:
           friend_id: 6104
         first_name: Christopher
         last_name: Guindon
+        github_handle: chrisguindon
         twitter_handle: chrisguindon
         org: Eclipse Foundation
+        org_id: null
         job_title: Lead Web Application Developper
         website: http://www.chrisguindon.com/
         country:
@@ -174,6 +315,14 @@ components:
           - php
           - javascript
           - Drums
+        working_groups_interests:
+          - adoptium
+          - oniro
+        forums_url: "https://api.eclipse.org/account/profile/chrisguindon/forum"
+        projects_url: "https://api.eclipse.org/account/profile/chrisguindon/projects"
+        gerrit_url: "https://api.eclipse.org/account/profile/chrisguindon/gerrit"
+        mailinglist_url: "https://api.eclipse.org/account/profile/chrisguindon/mailing-list"
+        mpc_favorites_url: "https://api.eclipse.org/marketplace/favorites/?name=chrisguindon"
 
     Eca:
       type: object
@@ -181,8 +330,12 @@ components:
         signed:
           type: boolean
           description: Flag determining whether user has signed ECA.
+        can_contribute_spec_project:
+          type: boolean
+          description: Flag determining whether users can contribute to a spec project.
       example:
         signed: true
+        can_contribute_spec_project: true
 
     Friends:
       type: object
@@ -206,6 +359,13 @@ components:
         code: CA
         name: Canada
 
+    PublisherAgreement:
+      type: object
+      properties:
+        version:
+          type: string
+          description: the agreement document version.
+
     Error:
       type: object
       properties: