goEmojisGitHubAPIWebServer 🧮 ⚓ 🥈 🚡 🥇 🇦🇸 🥑 ⚗️ 🉑 🥉 ⚕️ 🧑‍🚀 🇳🇷 🐙 🎠 🛠️ 🗾 📽️ 🎞️ 🇮🇴 🎰 ☦️ 🇰🇵 🇲🇵 🩹 🚡 👶 ⚔️ 🥖 🇦🇲 ⏰ 🐱 😽 💕 🇦🇱 🇦🇽 💪 🥄 🇧🇸 ♒ 🚑 🐤 👽 🇦🇸 🏺 💢 👼 🏀 🚲 👙 🎱 🔋 🇨🇺 🎹 🎵 🐜 📆 🌇 🍎 🇦🇶 💔 👾 🧬 🪕 🇯🇪 🦠 🤖 ☄️ 🌃 ♾️ ℹ️ 🤿

Web application written in Go to collect and display all the emojis 🧮 ⚓ 🥈 🚡 🥇 🇦🇸 🥑 ⚗️ 🉑 🥉 ⚕️ 🧑‍🚀 🇳🇷 🐙 🎠 🛠️ 🗾 📽️ 🎞️ 🇮🇴 🎰 ☦️ 🇰🇵 🇲🇵 🩹 🚡 👶 ⚔️ 🥖 🇦🇲 ⏰ 🐱 😽 💕 🇦🇱 🇦🇽 💪 🥄 🇧🇸 ♒ 🚑 🐤 👽 🇦🇸 🏺 💢 👼 🏀 🚲 👙 🎱 🔋 🇨🇺 🎹 🎵 🐜 📆 🌇 🍎 🇦🇶 💔 👾 🧬 🪕 🇯🇪 🦠 🤖 ☄️ 🌃 ♾️ ℹ️ 🤿 used in GitHub via its API...

Contents

1. Introduction
2. Presentation
3. Project's structure
4. How was this project developed ?
5. How does this project work ?
6. How to use it ?
   • By source code
   • By Docker
     • By Dockerfile
     • By Docker Hub
7. How to deploy it ?
   • From source code
   • From Docker
     • From Dockerfile
     • From Docker Hub
   • With Balena
8. Where to use it ?
9. Useful links
10. Conclusion

Introduction

This is a web application which collect and display all the emojis used in GitHub via its API. This web application was developed when my contract at IMERIR ended successfully. My interest in emojis then grew and so I started to develop projects on emojis. This is the first of a long list putting emojis front and center.

Presentation

Coming soon...

Project's structure

What is this project and this web application made of ? Here are all of the elements... Therefore:

• The Go file goEmojisGitHubAPIWebServer.go, which is the main file, the executable file, of this web application,
• The assets folder
• The tmpl folder
• The Dockerfile file,
• The README.md file, which is a markdown file, which presents the current project, the web application and serves as a manual for the latter,
• The LICENSE file is the software license which this web application is under, so the 'MIT' one in this present case,
• The .gitattributes file
• The .gitignore file

How was this project developed ?

Coming soon...

How does this project work ?

Coming soon...

How to use it ?

There are 2 ways to use the goEmojisGitHubAPIWebServer web application: through source code and through Docker. Here they are:

By source code...

It will be first discuss the installation, deployment and use of this web application by its source code.

First of all, you must clone the project goEmojisGitHubAPIWebServer from GitHub using this command:

git clone https://github.com/Vicken-Ghoubiguian/goEmojisGitHubAPIWebServer

In a second time, you must go to the directory of the cloned project using the following command:

cd goEmojisGitHubAPIWebServer

In a third time,

export GOPATH=${PWD}

Finaly, it's time to run this web app by executing this command bellow:

go run goEmojisGitHubAPIWebServer.go

Now the web app is working completely fine. To see this, please click here.

By Docker...

By Dockerfile...

git clone https://github.com/Vicken-Ghoubiguian/goEmojisGitHubAPIWebServer

cd goEmojisGitHubAPIWebServer

docker image build -t goemojisgithubapiwebserver:latest .

clarification: the character . specified at the end of the command refers to the current directory.

docker image ls

docker image history goemojisgithubapiwebserver:latest

docker container run -d --name goemojisgithubapiwebserver -p 80:80 goemojisgithubapiwebserver:latest

<container_s_IP_address>:80

docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' goemojisgithubapiwebserver

By Docker Hub...

And you can also deploy this web application using Docker and without the associated Dockerfile. The web application goEmojisGitHubAPIWebServer 🧮 ⚓ 🥈 🚡 🥇 🇦🇸 🥑 ⚗️ 🉑 🥉 ⚕️ 🧑‍🚀 🇳🇷 🐙 🎠 🛠️ 🗾 📽️ 🎞️ 🇮🇴 🎰 ☦️ 🇰🇵 🇲🇵 🩹 🚡 👶 ⚔️ 🥖 🇦🇲 ⏰ 🐱 😽 💕 🇦🇱 🇦🇽 💪 🥄 🇧🇸 ♒ 🚑 🐤 👽 🇦🇸 🏺 💢 👼 🏀 🚲 👙 🎱 🔋 🇨🇺 🎹 🎵 🐜 📆 🌇 🍎 🇦🇶 💔 👾 🧬 🪕 🇯🇪 🦠 🤖 ☄️ 🌃 ♾️ ℹ️ 🤿 has an official image on Docker Hub. So please run the following command:

docker pull wicken/goemojisgithubapiwebserver:latest

Now it's time to create the Docker container and get it working as discussed above.

How to deploy it ?

From source code

Like see in this section above,

git clone https://github.com/Vicken-Ghoubiguian/goEmojisGitHubAPIWebServer

cd goEmojisGitHubAPIWebServer

export GOPATH=${PWD}

go run goEmojisGitHubAPIWebServer.go

Now ! It's your turn to play...

From Docker

It will be now discuss the installation, deployment and use of this web application by Docker.

From Dockerfile

First of all, you must clone the project goEmojisGitHubAPIWebServer from GitHub using this command:

git clone https://github.com/Vicken-Ghoubiguian/goEmojisGitHubAPIWebServer

Now, it is time for you to position yourself in the goEmojisGitHubAPIWebServer repository, using this bellow command:

cd goEmojisGitHubAPIWebServer

Then, you'll build the Docker image following the bellow command:

docker image build -t goemojisgithubapiwebserver:latest .

clarification: the character . specified at the end of the command refers to the current directory.

If you want to list all Docker images on your system, you must follow the next command:

docker image ls

docker image history goemojisgithubapiwebserver:latest

docker container run -d --name goemojisgithubapiwebserver -p 80:80 goemojisgithubapiwebserver:latest

To access to the web application from your browser, you must type the Docker container's IP adress following the colon (':') character and the port number (here '80'). It is show in the following command:

<container_s_IP_address>:80

To get the Docker container's IP adress, just execute the the following command:

docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' goemojisgithubapiwebserver

From Docker Hub

docker pull wicken/goemojisgithubapiwebserver:latest

With Balena

Where to use it ?

You can use this web application in many cases. You can use it, for example, in an educational case: to teach the Go language and web APIs to schoolchildren and students through an exciting and rewarding project. This web application could also be used for computer enthusiasts, to also learn the Go language and development with APIs. Of course, this web application can be used for other types of audiences and other ideas can be found... It's now your turn to play...

Useful links

• Emojis - GitHub Docs,
• Emojis from GitHub API - link,
• Experimenting with JSON (structured and unstructured data) and Go - Henry S. Coelho,
• jQuery UI - official website,
• jQuery UI's ThemeRoller - official website

Conclusion

Coming soon...