Forem: Abhishek Somani

Handle json from multiple sources using JsonHandlers

Abhishek Somani — Thu, 09 Mar 2023 09:38:10 +0000

Bored of handling json from multiple different sources like Files, Http requests or responses?

You no longer have to be! 🤩

JsonHandlers

Prerequisites

A go module where you want to integrate jsonhandlers. To create one, follow this guide.

Installation

go get github.com/abusomani/jsonhandlers

Usage

A very useful feature of Go’s import statement are aliases. A common use case for import aliases is to provide a shorter alternative to a library’s package name.

In this example, we save ourselves having to type jsonhandlers everytime we want to call one of the library’s functions, we just use jh instead.

import (
    jh "github.com/abusomani/jsonhandlers"
)

Options

Jsonhandlers package exposes multiple options while creating a new jsonhandler to be able to read/write json from sources like Files, Http Requests or Http responses.

WithFileHandler

You can use the WithFileHandler option to read/write Json from/to a file. For this, you need to create a new jsonhandler with the file handler option.

Example to understand WithFileHandler in more detail.

Sample Code

package operations

import (
    "fmt"

    "github.com/abusomani/jsonhandlers"
)

func GetStudentsFromFile() []student {
    return handleFile()
}

func handleFile() []student {
    jh := jsonhandlers.New(jsonhandlers.WithFileHandler(testFilePath))

    var sch school
    err := jh.Unmarshal(&sch)
    handleError("error in unmarshalling %s", err)
    fmt.Printf("School info is : %+v\n", sch)

    // add a new student to the school
    sch.Students = append(sch.Students[:2], student{
        Id:     3,
        Name:   "The new student",
        Branch: "AI",
    })

    err = jh.Marshal(sch)
    handleError("error in marshalling %s", err)
    fmt.Printf("Updated school info after admission of new student is : %+v\n", sch)

    // remove the new student as he was very mischievous
    sch.Students = sch.Students[:2]

    err = jh.Marshal(sch)
    handleError("error in marshalling %s", err)
    fmt.Printf("Updated school info after retaining all good students is : %+v\n", sch)
    return sch.Students
}

WithHTTPRequestHandler

You can use the WithHTTPRequestHandler option to read Json from a Http Request and to write Json to a Http ResponseWriter. For this, you need to create a new jsonhandler with the Http request handler option.

Example to understand WithHTTPRequestHandler in more detail.

Sample Code

package operations

import (
    "net/http"

    "github.com/abusomani/jsonhandlers"
)

type studentSearchRequest struct {
    Name string
}

type studentSearchResponse struct {
    Info student
}

func HandleHTTPRequest(students []student) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {

    jh := jsonhandlers.New(jsonhandlers.WithHTTPRequestHandler(w, r))

        var reqBody studentSearchRequest
        err := jh.Unmarshal(&reqBody)
        if err != nil {
            errPayload := struct {
                StatusCode int
                Message    string
            }{
                StatusCode: http.StatusBadRequest,
                Message:    err.Error(),
            }
            // request is bad
            jh.Marshal(errPayload)
            return
        }

        for _, student := range students {
            // student found
            if student.Name == reqBody.Name {
                // response has the right student info written
                jh.Marshal(studentSearchResponse{
                    Info: student,
                })
                return
            }
        }

        errPayload := struct {
            StatusCode int
            Message    string
        }{
            StatusCode: http.StatusInternalServerError,
            Message:    "something went wrong",
        }
        // student not found
        jh.Marshal(errPayload)
    })
}

/*
  Sample request to be hit on the localhost server to test WithHTTPRequestHandler functionality.
  curl http://localhost:8080/search -d '{"Name": "Abhishek Somani"}'
*/

WithHTTPResponseHandler

You can use the WithHTTPResponseHandler option to read/write Json from/to a Http Response. For this, you need to create a new jsonhandler with the Http response handler option.

Example to understand WithHTTPResponseHandler in more detail.

Sample Code

package operations

import (
    "fmt"
    "log"
    "net/http"

    "github.com/abusomani/jsonhandlers"
)

type user struct {
    Id        int
    FirstName string
    LastName  string
    Age       int
    Gender    string
    Email     string
}

type getUsersResponse struct {
    Users []user
}

func HandleHTTPResponse() {
    resp, err := http.Get("https://dummyjson.com/users")
    if err != nil {
        log.Fatalf("unable to make the get request %s", err.Error())
    }
    jh := jsonhandlers.New(jsonhandlers.WithHTTPResponseHandler(resp))

    var userResp getUsersResponse
    jh.Unmarshal(&userResp)
    fmt.Printf("response is %+v\n", userResp)
}

Run examples

To run the examples present in the example folder you need to first checkout this package by doing a git clone. Once you have checked out this package, then you can run the main.go using the following command to see all the examples in action:

go run example/main.go

Hope you enjoyed! ❤️

Style your terminals using Go-Palette 🎨

Abhishek Somani — Sun, 05 Mar 2023 18:58:37 +0000

Go-Palette provides elegant and convenient style definitions using ANSI colors.
It is fully compatible and wraps the fmt library for nice terminal layouts.

Example written using Go-palette package

Supported Colors & Formats

Standard colors

The following colors are supported to be used by their names for both foreground and background as shown in Example using color names

Color Name	Color Code
Black	0
Red	1
Green	2
Yellow	3
Blue	4
Magenta	5
Cyan	6
White	7
BrightBlack	8
BrightRed	9
BrightGreen	10
BrightYellow	11
BrightBlue	12
BrightMagenta	13
BrightCyan	14
BrightWhite	15

Standard colors used as foreground as well as background

Supported Foreground Palette

The following palette is supported as foreground/text colors. The numbers represent the color-codes which can be used as shown in Example using color codes.

Supported Background Palette

The following palette is supported as background colors. The numbers represent the color-codes which can be used as shown in Example using color codes.

Supported Text Formats

The following text formats are supported.

Reset
Bold
Dim
Italic
Underline
SlowBlink
Hidden
Strikethrough

Installation

go get github.com/abusomani/go-palette

Usage

After installing the go-palette package, we start using it the following way.

Import

A very useful feature of Go’s import statement are aliases. A common use case for import aliases is to provide a shorter alternative to a library’s package name.

In this example, we save ourselves having to type palette everytime we want to call one of the library’s functions, we just use pal instead.

import (
    pal "github.com/abusomani/go-palette/palette"
)

Example using Color names

package main

import (
    pal "github.com/abusomani/go-palette/palette"
)

func main() {
    p := pal.New()
    p.Println("This text is going to be in default color.")
    p.SetOptions(pal.WithBackground(pal.Color(pal.BrightYellow)), pal.WithForeground(pal.Black))
    p.Println("This text is going to be in black color with a yellow background.")
}

Output

Example using Color codes

package main

import (
    pal "github.com/abusomani/go-palette/palette"
)

func main() {
    p := pal.New()
    p.Println("This text is going to be in default color.")
    // We can use color codes from the palette to set as foreground and background colors
    p.SetOptions(pal.WithBackground(pal.Color(11)), pal.WithForeground(0))
    p.Println("This text is going to be in black color with a yellow background.")
}

Output

Example using Special effects

package main

import (
    pal "github.com/abusomani/go-palette/palette"
)

func main() {
    p := pal.New(pal.WithSpecialEffects([]pal.Special{pal.Bold}))
    p.Println("Bold")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.Dim}))
    p.Println("Dim")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.Italic}))
    p.Println("Italic")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.Underline}))
    p.Println("Underline")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.SlowBlink}))
    p.Println("SlowBlink")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.Hidden}))
    p.Print("Hidden")
    p.SetOptions(pal.WithDefaults())
    p.Println("<-Hidden")
    p.SetOptions(pal.WithSpecialEffects([]pal.Special{pal.Strikethrough}))
    p.Println("Strikethrough")
}

Flush

Flush resets the Palette options with default values and disables the Palette.

package main

import (
    pal "github.com/abusomani/go-palette/palette"
)

func main() {
    p := pal.New()
    p.Println("This text is going to be in default color.")
    // We can use color codes from the palette to set as foreground and background colors
    p.SetOptions(pal.WithBackground(pal.BrightMagenta), pal.WithForeground(pal.Black))
    p.Println("This text is going to be in black color with a bright magenta background.")
    p.Flush()
    p.Println("This text is going to be in default color.")
}

Output

Limitations

Windows

Go-Palette provides ANSI colors only. Windows does not support ANSI out of the box. To toggle the ANSI color support follow the steps listed in this superuser thread.

Different behaviours in special effects

Go-Palette provides styled support using ANSI Color codes through escape sequences. This varies between different Terminals based on its setting. Refer ANSI Escape Codes for more details.

More details

Package Documentation

Thank You ❤️

Becoming a star using the STAR technique

Abhishek Somani — Sat, 04 Mar 2023 13:22:10 +0000

STAR stands for Situation, Task, Action, Result. A strategy that is significantly helpful in response to Behavioural aka Competency aka Leadership questions, which typically start with phrases such as, "Describe a time when..." and "Tell me an example where....". Let’s understand each of these concepts in a brief manner.

Situation:

Spend few moments and think of a situation similar to what the interviewer is asking you which had a successful outcome. If there was not a successful outcome, never hesitate to talk about failures. Remember that the interviewer wants you to succeed. They are people who understand that journey is not just successful outcomes but also intermittent failures.
Candidates usually make a mistake of either jumping on the question immediately without putting enough thoughts which results in either the candidate missing on strong situations that could have been concrete examples to the given question or the interviewer feeling that the candidate does not put enough thoughts before answering.
Remember to always include the important aspects of who, what, where, when and how so that the interviewer can easily visualise and understand your situation.

Task:

Explain the task you were assigned and how you took ownership in that situation. Throw some light on your responsibilities in that situation. Pin point the task that you were directly responsible for. Convey the details to the interviewer and at the same time have a look on the clock.
Remember to walk your interview through some critical aspects like : What was the task assigned to you for the given situation? Secondly, was it you who identified this task? What was the expected result of this task and did it meet the expectations?
Keep it specific yet concise. Always look out on the clock. Time is a critical component during such rounds where you don't want to narrate long stories.
Make sure you highlight the constraints, challenges and obstacles you faced while achieving this task.

Action:

This is the opportunity where you can dive deep on exactly what you did. How did you accomplish the assigned tasks? These imbibe the steps and procedures that you followed to lead the task to its final outcome.
Think about all the items that you vested your time in and how you personally ensured that the task was achieved on time. Always highlight what you did and not others.
Be sure to highlight the good qualities you showed in taking those specific actions but never hesitate to mention the misses and learnings you got while accomplishing the task. This helps interviewers understand that you are not afraid of failures and treat them as a learning for future.
Demonstrate your best traits to the interviewer in the Action phase. If your actions showed strong leadership, amazing communication skills and great dedication, make sure that you let this information flow to your interviewer. Focus on highlighting the abilities that an interviewer would find desirable. Don’t make it explicit by speaking the above traits out. Explain your role and the interactions honestly. Interviewers are smart to pick up hints about traits.
Candidates usually make a mistake of explicitly talking about how collaborative they are, their dedication levels. Usually interviewers will counter that by asking questions like “Tell me about a time when you had conflict with some teammates/ manager”, “Give me an example where you were not interested in the work given and how did you go about it?”.

Result:

Be introspective here. The result portion of the STAR method is where you demonstrate your achievements and final outcomes.
Share what the result of the situation was and how you and your actions contributed to that final result.
What did you achieve? What were the learnings? What were the outcomes of your actions? What were the actions you took? How was the engagement to this outcome? How successful the feature and delivery was?
If the work is in progress mention its future roadmap and how it would help you create an impact and what status the actions are at.

DONT's for STAR Interview Questions:

1. Making up answers or being dishonest

There are many a times when for the given situation you cannot think of a single success story, in those situations please let the interview know about it! Interviewer would like an honest person than someone who is bluffing around.

This doesn't mean that you ask the interviewer to skip the question. You can be pro-active and take the question on yourself by stating your actions had you been in that situation.

2. Going underprepared

Since I have already outlined what each concept mean. Coming up with a story on the spot will lead to lot of mistakes that can pile up and you ending up on critical situations or losing interviewer's interest.

Be pro-active in doing your homework. Prepare for most of the common questions. Always prepare for both success and failure stories. Keep them simple, concise and pin pointing to the given situation.

I always recommend preparing for 2-3 success stories and 1-2 failure stories that would enable you to demonstrate a wide variety of traits that an interviewer would be looking for.

3. Being over-prepared

Lot of candidates do this mistake. They want their story to seem flawless. Review your answers before you attend the interview, but don’t rehearse them more. Make it like a discussion rather than a narrative. Always remember to not under fit or over fit your brain’s machine learning model with any scenario!

4. Negative stories?

Many candidates have this perspective of impressing the interviewers and hence their mental model is: “Why would I tell a story where I had failed miserably and learnt absolutely nothing from the experience?”. Remember that there is a difference between telling success story, failure story and a story where there was absolutely no positive outcome or the lessons learned were negligible.

Candidates also think: “I would not tell a story that makes me look bad.”. If the interviewer decides to probe into your story and do a dive deep, it's more likely that he/she would reveal something you did not intend to and might make a negative data point.

5. Story unrelated to the question asked

Telling a story that is unrelated to the question would demonstrate that you lack focus and attention to detail. This would lead to interviewer considering you as a poor candidate in terms of leadership abilities.

6. Heroic stories?

Don't narrate stories where you were the sole hero. Nobody is absolutely perfect and telling a story where you heroically managing everything is impossible, it would be considered as fiction by the interviewer and might lead to negative data points.

Common STAR Interview Questions

Sense of Direction and Judgement : These questions help in understanding candidate's quality of judgment, sense of direction and their decision making ability under complicated circumstances.

Give me an example about a difficult decision you've made in recent times.
Describe a time when you had multiple important deliverables and features to finish and how you prioritised them.
Do you recall an experience where you received conflicting or constructive pieces of feedback on a feature or deliverable? Was it positive or negative? How did you address this feedback?
Tell me about a time when there was conflict with your team member or team itself, and how you explained this situation to your manager.

Pressure-Handling: These questions reveal how well a candidate performs under various types of pressure and situations.

Describe a decision you made that was not too mainstream and how you implemented it or got it implemented.
Tell me about a time when you had to undergo a stressful situation at work and how you handled it.
Describe a recent situation in which you had to deal with a very upset client. Client can be your customers as well.
Throw some light on a situation where you disagreed with a superior and how this disagreement was settled.
Tell me about a time you had to learn something you weren't familiar with and still delivered quickly.

Leadership Abilities: These questions reveal a candidate's leadership potential, confidence, long term vision and willingness to take the initiative on projects when they have little or no direction to start with.

Tell me about an experience in which you used your leadership abilities.
Describe a time when you delegated a project to others effectively and got the work done.
Can you recall a time where you had to give negative feedback to a colleague. How did you express this feedback to him/her?
Do you have an example when you showed initiative and took the lead.
Tell me about a time you had a direct report or managed a team that was being recruited to work on other projects without your consent.

Self-Awareness: These questions give data points about how self aware a candidate is about his/her's strengths and weaknesses.

Describe a time you were able to successfully deliver with a co-worker who might not have personally liked you or the other way round.
Give me an example of a time when you tried to accomplish something and failed.
Was there any time you were reprimanded or criticised for your performance.
Tell me about a project that wasn't going to meet its deadline and how you minimised the consequences of its blast radius.
Tell me about a time you felt you weren't being listened to or left alone, and how you made you presence or opinion known to your teammates.

Summary:

I have seen lot of candidates making the common mistakes mentioned above. Avoid those during the interviews and always prepare well for Behavioral interviews using the set of questions provided. They are as important as the technical rounds because they help leaders gather data points regarding how fit you are for the company and what is your growth potential in the long term success. Personally I believe images are better conveyer of information than text. So here is an image from "The Muse" summarising STAR.

References:

Original Post on Linkedin