DEV Community: Sahil Tiwari

IntelliJ Idea Integrated with Bitbucket Repository

Sahil Tiwari — Sun, 05 Jul 2020 17:46:34 +0000

By the end of this article, you will be able to create a Bitbucket repository and Integrate it with IntelliJ IDE. We’ll see the first time set up process and latter processes. So let’s dive into it.

What is a Repository?

In software development, a repository is a central file storage location. It is used by version control systems to store multiple versions of files. This may include multiple source code files, as well as other resources used by the program. Branches are used to store new versions of the program.

What is GIT?

Git is a free and open-source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. I have created a git repository and explained step by step in detail in my last post, you can check it out here — link

What is Bitbucket?

Bitbucket belongs to “Code Collaboration and Version Control” category, while Git can be primarily classified under “Version Control System”.
Bitbucket is a Git repository management solution designed for professional teams. It gives you a central place to manage git repositories, collaborate on your source code, and guide you through the development flow. It provides awesome features that include: Access control to restrict access to your source code.

Is Bitbucket free?

Yes! Bitbucket is free for individuals and small teams with up to 5 users, with unlimited public and private repositories. You also get 1 GB file storage for LFS and 50 build minutes to get started with Pipelines. You share build minutes and storage with all users in your workspace.

How to create a Bitbucket Repository?

Create a bitbucket repo. Go to https://bitbucket.org/ and create a repository by clicking on + symbol in the left pane of the Bitbucket home page.

Select the Repository under CREATE options.

Fill out the below details like Workspace, Project name, Repository Name, Access level, Description, Language, and then click on Create Repository.

Voila! You have created a bitbucket repository. Now copy the git clone URL and start putting your local code inside our new repository.

Here I’m assuming that you have your local code which you want to push on bitbucket so that others can also contribute to that code. I have written an article, where I have created the Rest assured framework in Eclipse from scratch and pushed it to GIT. You can copy that same framework if you don’t have a local code handy.
Here is that article:

Rest-Assured Framework from scratch including GIT Repository integration for Continous Integration

Sahil Tiwari ・ Jun 24 '20

#git #restassured #automation #api

Here is the repository: https://github.com/sahilTiwariQA/rest_AssuredFramework

In this article, I’m gonna be using IntelliJ for IDE. IntelliJ IDEA is a cross-platform IDE that provides consistent experience on the Windows, macOS, and Linux operating systems. IntelliJ IDEA is available in the following editions: Community Edition is free and open-source, licensed under Apache 2.0.
Eclipse falls short in providing good assistance for code completion despite supporting many plugins. The default code compilation in IntelliJ is much faster and better, especially if you’re a newbie programmer — IntelliJ can help you improve your code.
Open IntelliJ and import your local project from File->Open.
Once you have imported the project in local IDE, let’s enable version control Integration so that we will be able to Push and Pull changes seamlessly in that project.
Go to VCS -> Enable Version Control Integration

Select Git and click OK.

Now again go to VCS, this time around you will be able to see more options. Add your bitbucket repository by going to Git-> Remotes

Click on “+” symbol to add Bitbucket repo URL.

When you paste the URL, make sure to remove “git clone” command from start of the URL so that your URL starts with “https” and ends with “.git” :

Enter your Bitbucket credentials for Authentication.

Click OK to confirm.

Now that Bitbucket is connected it will show you a pop-up in Event Log. Click on View Files.

It will show you the whole project to add to Git. Click on Add.

Once you’ve added the project, let’s Commit and Push the code to Bitbucket. For that go to VCS->Commit. Since you have not committed any changes before it will open Commit window in the left pane. Give commit message and click on Commit.
Now go back to VCS->Git-> Push

Check your commit message and all the files and click on Push.

Go back to your Bitbucket repository and refresh it to see your Pushed changes in your repository.

Well, you have successfully created a bitbucket repository and pushed your local code into it.

All the above steps are a one-time process except to commit and push steps. Once you have connected IntelliJ to your repository (Bitbucket), you can make changes and commit and push directly from IDE itself. To demonstrate this let’s create a new java class and try to commit and push.

On the next step, it will ask for Push confirmation. Click on Push and check Bitbucket to confirm if the changes are pushed to the repository or not.

And there you have it! All files updated as expected.

How To Install And Use Git On Windows End to End

Sahil Tiwari — Sat, 27 Jun 2020 18:54:57 +0000

By the end of this article, you will be able to install and setup GIT SCM with your repository (GIT/Bitbucket) and will be able to Commit and Push the changes from local.

GIT:

Git is a distributed version control system for tracking changes in source code during software development. It is designed for coordinating work among programmers, but it can be used to track changes in any set of files. Its goals include speed, data integrity, and support for distributed, non-linear workflows.

GITHUB Installation

Install GIT SCM from here: https://git-scm.com/download/
Select all defaults until this point

Click Next and Select Start Folder, again Click Next. On Next Window select Git’s default window:

The next window allows you to change the PATH environment. The PATH is the default set of directories included when you run a command from the command line select Recommended settings and click Next

Most users should use the default. But if you’re working in an Active Directory environment, you may need to switch to Windows Store certificates. Click Next.

This step is for data formatting, leave it as default and click Next

Choose the Terminal you want to use, the default MinTTY is recommended for its features. Click Next.

This step allows you to decide which extra option you would like to enable. If you use symbolic links, which are like shortcuts for the command line, tick the box. Default is recommended then Click Next.

Depending on the version of Git you’re installing, it may offer to install experimental features. At the time this article was written, the option to include running native console programs like Node or Python in a GitBash window without using winpty was offered but it still had some bugs. Unless you are feeling adventurous, leave them unchecked and click Install.

After Installation, Launch GIT Bash

Git has two modes -

A Bash Scripting Shell (or command line) and a Graphical User Interface (GUI). To launch either of those you can search in the Windows start menu or you can right-click anywhere on the screen to see below options.

GIT Setup:

If you are in an organization, you have to install below trust certificates (if you setting up on personal machine you skip this part and can Jump to commands)
Download and double click to install — curlt-ca-bundle.crt in the path where GIT is installed.
For eg: C:\Users\sahil.tiwari\AppData\Local\Programs\Git\mingw64\ssl\certs
And the cacerts file into the Java folder For eg: \ProgramFiles(x86)\Java\jre1.8.0_121\lib\seccurity
with the admin’s permission.
Then open GIT Bash and run following commands, commands to be given in GIT Bash for initial configuration.

git config — global user.name “sahil.tiwari”
git config — gloabal user.email sahil@example.com
git config — global http.sslCAInfo C:\Users\sahil.tiwari
git config — list
git config — list — global
git config — global http.sslverify false

After the configurations open Git GUI and select Clone Existing Repository

Now give the Bitbucket/GIT path for your project in the source repository.
For example: https://bitbucket….
or
https://github.com/sahil…..
You can get source repository URL from bitbucket-> clone (Remove the username and @ from the URL) or if you are using GIT you can go to GIT and click on Clone and copy the path.

In GIT GUI, target repository is the local repository where you want the local copy (it will create a new folder where you select the path)

Then click on Clone

Now go to Branch and click on Create.
Now select the Branch Name as “Match Tracking Branch Name”
Then select the Starting Revision as “Tracking Branch” and select the branch in which you want to push the code and click on Create

After you create local repository all the files present in the cloud repository will come in the local folder

Then paste the files in the local repository that you want to add to the Global Repository.
Come back to GIT GUI and click on Rescan
You will find that the new files are present in the “Unstaged Changes” area. Click on the files to move them to “Staged Area”

Now give the Commit Message and click on Commit

Then click on PUSH to push the code to the global repository (it may ask GIT username and password for authentication)

Now go to your Bitbucket/GIT repository to check pushed changes are reflected or not.

Rest-Assured Framework from scratch including GIT Repository integration for Continous Integration

Sahil Tiwari — Wed, 24 Jun 2020 21:08:11 +0000

By the end of this article, you will be able to set up and understand Rest API, Eclipse with TestNG and create Rest Assured Framework from scratch. Also including GIT Repository integration for Continous Integration.

What is API?

Application Programming Interface (API)
In basic terms, APIs just allow applications to communicate with one another.

When people speak of “an API”, they sometimes generalize and actually mean “a publicly available web-based API that returns data, likely in JSON or XML”. The API is not the database or even the server, it is the code that governs the access point(s) for the server.

REST APIs:

Web services are purpose-built web servers that support the needs of a site or any other application. Client programs use application programming interfaces (APIs) to communicate with web services. Generally speaking, an API exposes a set of data and functions to facilitate interactions between computer programs and allow them to exchange information. Web API is the face of a web service, directly listening and responding to client requests.

The REST architectural style is commonly applied to the design of APIs for modern web services. A Web API conforming to the REST architectural style is a REST API. Having a REST API makes a web service “RESTful.” A REST API consists of an assembly of interlinked resources. This set of resources is known as the REST API’s resource model. Well-designed REST APIs can attract client developers to use web services. In today’s open market where rival web services are competing for attention, and aesthetically pleasing REST API design is a must-have feature.

I recommend this youtube video to understand the basics of API and REST API: https://www.youtube.com/watch?v=7YcW25PHnAA

Setting up Eclipse:

Install the latest version of the eclipse IDE from https://www.eclipse.org/, as the latest versions come with integrated Maven and GIT.

For detailed steps on eclipse installation, go to https://www.eclipse.org/downloads/packages/installer

Setting up TestNG:

Once Eclipse is installed,
Launch Eclipse.
On the menu bar, click Help.
Choose the "Install New Software…" option.

In the Eclipse Install dialog box
Enter "http://dl.bintray.com/testng-team/testng-eclipse-release/" in the Work with box
Click the Add button.

In Add repository dialog
Enter "TestNG" in Name Text Field
Click on Add button.

It will search for the entered software.
Select the "TestNG" checkbox
Click on the "Next" button.

It will give you a review of Items to be installed. Click on Next.
Select the radio button "I accept the terms of the license agreement"
Click on Finish.
It will take time depending on your Internet speed.
If you encounter a Security warning, just click "Install Anyway".

Wait for the installation to finish. When Eclipse prompts you for a restart, click "Restart now."
After the restart, verify if TestNG was successfully installed. Click Window > Show View > Other.Then open the Java directory and see if TestNG is included.

Once we are done with eclipse and TestNG Setup, we can start creating our Rest Assured Framework.

Rest Assured Framework:

Rest-Assured is an open-source Java Domain-Specific Language (DSL).
Using Rest Assured we can eliminate large amounts of code to test complex API response and output.
It supports both XML and JSON format.
Rest-Assured supports many requests like

GET
POST
PUT
DELETE
PATCH
HEAD

The precondition for Rest Assured Framework:

Java
Maven
TestNG

Now head to eclipse and start creating a project.
Go to File>New>Other

Select Maven>Maven Project

Select “Create a simple project” and click on next

Now give logical names to “Group Id” and “Artifact Id” and click on Finish

Congrats! You have created a Maven project successfully.

Now let’s add the rest-assured dependency to POM.xml. In your project open POM.xml and add below dependency:

Now your POM.xml should look like this:

Once you have added this dependency you will be able to see Maven Dependencies added into your project. It will add all the related JARs to your project, but be sure to check these JARs as they are the most important ones:

httpclient: It is the base JAR which Rest-Assured internally uses
hamcrest-core: It will be used to see the patterns in the code and put assertions into the code.
json-path: If we get the data in JSON format, this JAR helps in formatting the data.
xml-path: If we get the data in XML format, this JAR helps in formatting the data.

Once you are done with dependencies, its time to hit the service URL.

I am going to use Postman as a manual tool which you can get from Chrome web store (go to Chrome Web Store and search for Postman, from there you can download the lite version of Postman) or full-fledged Postman application from their official Website https://www.postman.com/

For Rest Services Endpoint URL, you can go to https://openweathermap.org/api and browse many API service URL’s which is free. There are few paid ones too, you can check out on their website.

Open Postman and hit Send to below GET URL:

http://samples.openweathermap.org/data/2.5/weather?q=London,uk&appid=439d4b804bc8187953eb36d2a8c26a02

Once you hit the Send button, Response Status should be 200OK and you will receive the weather information of London in JSON Format.

Now that you have a perfectly working GET request, let’s automate the service using the Rest-Assured framework in Eclipse.

Go to your project and create a package under src/test/java. Right-click on src/test/java folder and create a package named “serviceRequest”. Under that create a Java class called “getData”.

Now write the code in Rest-Assured Project to get the same data we got in Postman and assert the Status:

Your class should look like this:

Right-click anywhere on Java class and Run as> TestNG Test

You should be able to see same response in the console which you received in Postman. Moreover, we have performed an assertion on the Status Code.

Congrats! You have created a Rest Assured framework from scratch and automated a GET service.

Now let’s create a GIT Repository and include our project into that. It is the most commonly used version control system. Git tracks the changes you make to files, so you have a record of what has been done, and you can revert to specific versions should you ever need to. Git also makes collaboration easier, allowing changes by multiple people to all be merged into one source

GIT:

Creating a GIT Repository:
Go to https://github.com/ and create an account
Once the account is created GIT will ask you to create a New Repository (Start a Project).
Create a repository by giving it a Name, Description, and Type of Repository you want (Public or Private) and hit ‘Create Repository’.

Your Repository will be created, copy your Git Repo URL:

Go to eclipse:
Click on the Top Left Search button also called “Access commands and other items” (Ctrl+3) and search for Git Repositories.

Once you have selected GIT Repositories, enter your GIT Repository URL. Other fields will automatically populate, enter your git username and password in the Authentication section, and click on Next.

On Branch Selection window click on Next.

On the next window (Local Destination) select your local directory where you want to store your Git Project and click on Finish.

Your Git Repository will be added to the Eclipse-Git Repositories window.

Now, right-click on your project and go to Team> Share Project

Select your repository from Repository dropdown and click Finish

Commit and Push the project to the GIT repo:

Select all Unstaged Changes and drag it to Staged Changes and give Commit Message

Push Branch in Remote window will show you details like Source and Destination of your GIT Branch. Click Next

It will ask for Push Confirmation. Click Finish.

You have successfully pushed the local code to GIT. Go to your GIT Repository and refresh it. You should be able to see all local code into your repository.

I have kept this repository public, you can copy my project from here:

https://github.com/sahilTiwariQA/rest_AssuredFramework

References:
Rest API Design Rulebook - O’Reilly
https://www.eclipse.org/
https://www.guru99.com/
https://mvnrepository.com/
http://rest-assured.io/
https://openweathermap.org/api