ballerina-platform / ballerina-library

The Ballerina Library
https://ballerina.io/learn/api-docs/ballerina/
Apache License 2.0
136 stars 64 forks source link

Introduce a Ballerina connector for Tableau REST API #7043

Open NipunaRanasinghe opened 1 month ago

NipunaRanasinghe commented 1 month ago

We are planning to introduce a new Ballerina connector for the latest Tableau REST API, generated using it's OpenAPI specification.

Related links:

This includes the following tasks:

  1. Create a new repository under 'ballerina-platform' organization.
  2. Review and sanitize the OpenAPI specification.
  3. Generate the connector client.
  4. Implement a test suite covering the core functionalities.
  5. Write documentation with examples.
ovindu-a commented 1 month ago

Hi @NipunaRanasinghe , I would like to work on this

MohamedSabthar commented 1 month ago

๐Ÿ‘‹ Welcome, @ovindu-a! ๐Ÿš€

We're thrilled to have you join the Ballerina Hacktoberfest community! The issue has been assigned to you, and weโ€™re excited to see your contributions.

To help you get started, here are a few essential resources:

  1. Connector Contributor Guide: Make sure to go through our Ballerina Hacktoberfest connector contributor guidelines and follow the exact steps, to contribute effectively.
  2. Learn Ballerina: Whether you're new to Ballerina or looking to enhance your skills, check out our official learning resources.
  3. Community & Support: If you have technical questions, feel free to ask on Stack Overflow with the Ballerina tag, or join us on Discord to connect with other community members.

No contribution is too small, and your feedback is always welcome! Donโ€™t hesitate to ask questions, propose new ideas, or report issues.

We are currently in the process of creating a GitHub repository for this connector module and will update you once itโ€™s available. In the meantime, please go through the relevant resources and documentation related to the connector.

Happy coding and welcome aboard! ๐ŸŽ‰

ovindu-a commented 1 month ago

Thank you @MohamedSabthar, I'm currently going through these. I noticed that the Tableau repository has not yet been created. It says the repository will be setup by the ballerina team.

Just saw the message on discord, will work on my own repository till the repo is made.

ovindu-a commented 1 month ago

@MohamedSabthar I have generated the client code in this repository. Please let me know if there is anything that I must change.

Since they have asked us to make separate pull requests for each stage, should I wait until the repo is initialized to start on the tests or shall I start on them now?

MohamedSabthar commented 1 month ago

@ovindu-a, you can continue your work in your own repository, possibly in a separate branch. We will create the repository with an initial template and share it with you soon.

daneshk commented 4 weeks ago

Hi @ovindu-a,

I'll be mentoring your project, and we have created the repository for your connector project with the initial project template. You can start working in this repository: .

Please refer to the contribution process section for guidelines on raising a PR: https://ballerina.io/hacktoberfest/connector-contributor-guide/#contribution-process.

Happy coding! ๐ŸŽ‰

ovindu-a commented 4 weeks ago

Hi @daneshk , I was done with the initial steps of it. What was left was the documentation. But I think I will have to make a few more changes to the generated connector before it is ready. I will make a PR to the repo and start working on it

daneshk commented 4 weeks ago

Great. Thanks for the update.

daneshk commented 1 week ago

Hi @ovindu-a,

I hope you are making progress on adding test cases for the connector. To complete the task, we also need to include documentation and examples. Could you please provide an update on your current progress? Thank you!

ovindu-a commented 1 week ago

Hi @daneshk I'm working on the examples. I'm facing some difficulty with configuring the authentication for their APIs. I'll update you when I make a PR with regards to this.