Sign inSign up

wicken/goemojisgithubapiwebserver

By wicken

â€ĸUpdated over 4 years ago

🧮 ⚓ đŸĨˆ 🚡 đŸĨ‡ đŸ‡Ļ🇸 đŸĨ‘ âš—ī¸ 🉑 đŸĨ‰ âš•ī¸ 🧑‍🚀 đŸ‡ŗđŸ‡ˇ 🐙 🎠 đŸ› ī¸ 🗾 đŸ“Ŋī¸ đŸŽžī¸ 🇮🇴 🎰 â˜Ļī¸ 🇰đŸ‡ĩ 🇲đŸ‡ĩ 🩹 🚡 đŸ‘ļ âš”ī¸

Image
0

2.0K

wicken/goemojisgithubapiwebserver repository overview

⁠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 ?⁠
  7. How to deploy it ?⁠
  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...

⁠Conclusion

Coming soon...

Tag summary

Content type

Image

Digest

Size

331.3 MB

Last updated

over 4 years ago

docker pull wicken/goemojisgithubapiwebserver