Work in Progress
What it is?
A beautiful open source website that created with Go language. It contains many Go working samples code that useful for web and non-web application. It mainly demonstrate what Go can achieve. You can contribute!
In this imaginative (but real) project, we implement our knowledge during learning Go and we want to share with the community. We don't use any Go framework and forgive us if the code still not efficient or optimal, since we are still learning too in Go language. Any suggestions are welcomed.
Why Imaginative Go?
- Ideas about achieve something with Go language
- Plenty of working code samples (awwww, currently still not plenty, relaxxx mann, we will add more regularly)
- Easy to run in your local machine (with Docker)
- You can contribute
How to run this web on your local machine?
You need Docker to run on local machine. First install Docker and Docker Compose on your local machine.
sudoused throughout this doc, since mainly we use Linux/MacOS during the development. We test running on Windows 10 as well with Docker for Windows and Docker Toolbox.
For user that using Windows 10 Home that run with Docker Toolbox, I think you should modify IP on
docker-compose.ymlfrom 127.0.0.1 to your Docker Machine IP. Docker Machine IP can be known by typing
git clone https://github.com/sonyarianto/imaginative-go.git cd imaginative-go sudo docker-compose up -d
After that, go to your browser and type
To clean containers (stop and remove), remove volume, clean network (remove), pull, build (with no cache) and bring up all containers you can type like below
sudo docker-compose down && sudo docker volume rm imaginative-go_volume-mongodb-imaginative-go && sudo docker-compose pull && sudo docker-compose build && sudo docker-compose up -d --build --force-recreate
Above command will make sure you will create and run fresh all containers needed to run Imaginative Go web project. This is usualy useful after you are doing
git pullon Imaginative Go repository.
Above command will error if volume
imaginative-go_volume-mongodb-imaginative-godoesn't exists. You can remove the delete volume part if you encounter that error
MongoDB expose random port to host machine. You can see it by typing this after all containers are running.
sudo docker ps -f "name=mongodb-imaginative-go"
Sample output is like below
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES f0c2c2166487 imaginative-go_mongodb "docker-entrypoint.s…" About an hour ago Up About an hour 0.0.0.0:32782->27017/tcp mongodb-imaginative-go
- Sony Arianto Kurniawan - sony at sony-ak.com - original author, project maintainer
- Prasetyama Hidayat - prasetyama at gmail.com
- Waladi Abdauh - waladi.abdauh at gmail.com
Do you want to contribute? Just fork this repository and contribute anything you can (e.g. fix typo, bug fix, add new sample etc.)
Imaginative Go maintains a mailing list, Imaginative Go, where you should feel welcome to ask questions about the project (no matter how simple!) or to talk about Imaginative Go more generally. Imaginative Go's author (Sony Arianto Kurniawan) also loves to hear from users directly at his personal email address, which is available on his GitHub profile page.
Contributions to Imaginative Go are welcome.
All interactions in the Imaginative Go community will be held to the high standard of the broader Go community's Code of Conduct.
This project is licensed under the MIT License.
License can be found here.