On Demand Academy Go Bootcamp

Introduction

Thank you for participating in the Golang Bootcamp course! Here, you'll find instructions for completing your certification.

The Challenge

The purpose of the challenge is for you to demonstrate your Golang skills. This is your chance to show off everything you've learned during the course!!

You will build and deliver a whole Golang project on your own. We don't want to limit you by providing some fill-in-the-blank exercises, but instead, request you to make it from scratch. We hope you find this exercise challenging and engaging.

The goal is to build a REST API that must include the following:

• An endpoint for reading from an external API
  • Write the information in a CSV file
• An endpoint for reading the CSV
  • Display the information as a JSON
• An endpoint for reading the CSV concurrently with some criteria (details below)
• Unit testing for the principal logic
• Follow conventions, best practices
• Clean architecture
• Go routines usage

Requirements

These are the main requirements we will evaluate:

• Use all that you've learned in the course:
  • Best practices
  • Go basics
  • HTTP handlers
  • Error handling
  • Structs and interfaces
  • Clean architecture
  • Unit testing
  • CSV file fetching
  • Concurrency

Getting Started

To get started, follow these steps:

1. Fork this project
2. Commit periodically
3. Apply changes according to the reviewer's comments
4. Have fun!

Deliverables

If you are interested in filing the Go Bootcamp in your WizelineOS profile, don't hesitate to contact Academy to assign a mentor who can review your compliance with your capstone project.

We provide the delivery dates so you can plan accordingly; please take this challenge seriously and try to make progress constantly.

For the final deliverable, we will provide some feedback. Contact your mentors and peers to get timely help if you are struggling with something. Feel free to use the slack channel available.

First Deliverable

Based on the self-study material and mentorship covered until this deliverable, we suggest you perform the following:

• Create an API
• Add an endpoint to read from a CSV file
• The CSV should have any information, for example:

1,bulbasaur
2,ivysaur
3,venusaur

• The items in the CSV must have an ID element (int value)
• The endpoint should get information from the CSV by some field (example: ID)
• The result should be displayed as a response
• Clean architecture proposal
• Use best practices
• Handle the Errors (CSV not valid, error connection, etc)

Note: what’s listed in this deliverable is just for guidance and to help you distribute your workload; you can deliver more or fewer items if necessary. However, if you provide fewer items at this point, you have to cover the remaining tasks in the following deliverable.

Second Deliverable

Based on the self-study material and mentorship covered until this deliverable, we suggest you perform the following:

• Create a client to consume an external API
• Add an endpoint to consume the external API client
• The information obtained should be stored in the CSV file
• Add unit testing
• Update the endpoint made in the first deliverable to display the result as a JSON
• Refactor if needed

Note: what’s listed in this deliverable is just for guidance and to help you distribute your workload; you can deliver more or fewer items if necessary. However, if you provide fewer items at this point, you have to cover the remaining tasks in the following deliverable.

Final Deliverable

• Add a new endpoint
• The endpoint must read items from the CSV concurrently using a worker pool
• The endpoint must support the following query params:

type: Only support "odd" or "even"
items: Is an Int and is the number of valid things you need to display as a response
items_per_workers: Is an Int and is the number of valid items the worker should append to the response

• Reject the values according to the query param type (you could use an ID column)

• Instruct the workers to shut down according to the query param items_per_workers collected

• The result should be displayed as a response

• The response should be displayed when:

  • The workers reached the limit
  • EOF
  • Valid items completed

Important: this is the final deliverable, so all the requirements must be included.

Submitting the deliverables

To submit your work, you should follow these steps:

1. Create a pull request with your code, targeting the master branch of your fork.
2. Fill this form including the PR’s url
3. Stay tuned for feedback
4. Do the changes according to the reviewer's comments

Documentation

Must learn

• Go Tour
• Go basics
• Git
• Tool to practice Git online
• Effective Go
• How to write code
• Go by example
• Go cheatsheet
• Any talk by Rob Pike
• The Go Playground

Self-Study Material

• Golang Docs
• Constants
• Variables
• Types
• For Loops
• Conditional statements: If
• Multiple options conditional: Switch
• Arrays and Slices
• Clean Architecture
• Maps
• Functions
• Error Handling
• Structures
• Structs and Functions
• Pointers
• Methods
• Interfaces
• Interfaces
• Packages
• Failed requests handling
• Modules
  • Part 1 and 2
• Unit testing
• Go tools
• More Go tools
• Functions as values
• Concurrency (goroutines, channels, workers)
  • Concurrency Part 2