Lessons learned from API client generation - 02 Enumerations

Oct 1, 2022 2 min.

First pattern of our series: enumerations. They are essential to any programing language to describe a discrete set of options. Consider the following examples: components: schemas: Model: type: object properties: enumString: type: string enum: - value1 - value2 enumInteger: type: integer enum: - 1 - 2 enumBoolean: type: boolean enum: - true - false EnumString describes two possible values, however it’s missing a lot of information: We can’t specify a different serialization value from the symbol.

Lessons learned from API client generation - 01 Introduction

Oct 1, 2022 2 min.

Over the last two years I’ve been working on a modern client generator for OpenAPI described APIs: project kiota. Kiota generates models and chained methods to allow developers to build requests for any REST API. The generated clients handle serialization, deserialization, authentication, retrying transient errors, following (or not) redirections and much more. Using a generated client saves developers from having to re-implement those aspects and enables them to focus on the core logic of the application.

Speaking at Caribbean Developer Conference 2022

Sep 18, 2022 1 min.

I’m honoured to announce that I’ve been selected to speak at the Caribbean Developer Conference 2022 happening in Punta Cana Nov 3-5th. This is the first time I’ll be speaking at this event, but I’ve heard lots of good things about it from people who previously spoke there. I’ll be presenting “Turbocharge your API integration with Microsoft Kiota” where I’ll be introducing through lots of demonstrations how you can generate a client generated for any OpenAPI described API using Microsoft Kiota and other tools.

Speaking at CollabDays Belgium 2022

Sep 11, 2022 1 min.

I’m honoured to announce that I’ve been selected to speak at the CollabDays Belgium 2022 (formerly SPS Events, aka SharePoint Saturday) happening in Brussels Saturday 15th of October. This event is dear to my heart as it’s one of the first international events I ever got to speak at, it always attracts a great crowd and brings together internationally regarded speakers. I’ll be presenting “Turbocharge your API integration with Microsoft Kiota” where I’ll be introducing through lots of demonstrations how you can generate a client generated for any OpenAPI described API using Microsoft Kiota and other tools.

Speaking at the API specification conference 2022

Sep 4, 2022 1 min.

I’m extremely pleased to announce I’ll be speaking at the API specification conference 2022 in San Francisco, Sept 19-21st. During “Lessons learned from client generation, gaps and suggestions to address them”, we’ll be reviewing my 2 years experience building an OpenAPI based client generator and trying to identify solutions to ease up code generation, leading to better clients. The API specification conference is the first in person event I’ll be presenting at in almost 3 years, I’m really excited and a bit nervous (do I even remember how to do this anymore?

One year as a Software Developer at Microsoft

Sep 6, 2021 3 min.

One year as a Software Developer at Microsoft Introduction Back in September 2020, I published a blog post about my experience as a Program Manager at Microsoft that was well received. It made me realize that the community was curious and interested about this role. In this post, I will share my insights as a developer. Before we begin, keep in mind this is my personal experience, which may differ a lot from team to team, product to product and depend on other circumstances (being remote, culture, etc…).

Revamping the Microsoft Graph Java SDK: a recipe to revive open-source repositories

May 24, 2021 5 min.

Introduction Back in August 2020 I became the main maintainer of the Microsoft Graph Java SDK. The team had to deprioritize this SDK in favor of other languages due to a lack of staff. About 100+ issues were open, as well as 15 pull requests from the community. Dependencies and tooling had not been updated, the Android story was unclear, no innovation had been done in a long time, the repository felt abandoned and caused a lot of frustrations…

Speaking at Microsoft 365 Saturday Ottawa 2020

Oct 4, 2020 1 min.

This year again I have the opportunity to speak at the Microsoft 365 (formerly SPS) Ottawa and I’ll be presenting “Introduction To The Microsoft Graph: Getting Started Quickly & Getting The Most Out Of It”. Together we will cover the basics of Microsoft Graph, the Microsoft Identity Platform, the value it provides to developers and how to get started. Because of the ongoing pandemic, the event will be digital only and held on Microsoft Teams.

My personal experience as a Program Manager and switching back to development

Sep 27, 2020 8 min.

Switching back to the light side of the force: becoming a developer again I recently transitioned from Program Manager on Microsoft Graph to Software Developer in the Microsoft Graph SDKs team. I’d like to thank my previous team for welcoming me these last 7 months and allowing me to experiment with the role of Program Manager. I thought I’d share with you some of my experience and learnings as a Program Manager.

GitHub Actions: Automatic conflicting pull request tagging and comment

Sep 13, 2020 4 min.

Open-source repositories enable tremendous productivity in software development. Growth in user base usually translates in growth in contributors, which in turns translates in a better solution bringing more users and so on… Maintaining large open-source repositories can be time-consuming as you spend more and more time reviewing contributions. Don’t take me wrong, that time spent reviewing pull requests is mostly well spent as it represents a factor of scale efficiency gain: for minutes spent reviewing any given pull request, the codebase benefits hours of development efforts invested by the contributor.