Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sonyarianto/imaginative-go
Status: Work in Progress - A beautiful open source website that created with Go. 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!
https://github.com/sonyarianto/imaginative-go
code-samples docker docker-compose dockerfile easy-to-use go go-by-example golang learning-by-doing learning-golang web-app
Last synced: about 1 month ago
JSON representation
Status: Work in Progress - A beautiful open source website that created with Go. 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!
- Host: GitHub
- URL: https://github.com/sonyarianto/imaginative-go
- Owner: sonyarianto
- License: mit
- Archived: true
- Created: 2018-10-31T10:25:46.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-12-04T15:21:38.000Z (about 5 years ago)
- Last Synced: 2024-08-02T20:46:11.460Z (4 months ago)
- Topics: code-samples, docker, docker-compose, dockerfile, easy-to-use, go, go-by-example, golang, learning-by-doing, learning-golang, web-app
- Language: Go
- Homepage:
- Size: 2.91 MB
- Stars: 5
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-indo-projects - Imaginative Go - Web to learn Go. (Go)
- awesome-indonesia-repo - Imaginative Go - Web to learn Go. (Go)
README
# Imaginative Go
[](https://travis-ci.org/sonyarianto/imaginative-go) [](https://goreportcard.com/report/github.com/sonyarianto/imaginative-go) [](https://codeclimate.com/github/sonyarianto/imaginative-go/maintainability) [](https://godoc.org/github.com/sonyarianto/imaginative-go) [](https://coveralls.io/github/sonyarianto/imaginative-go?branch=master) [](https://codecov.io/gh/sonyarianto/imaginative-go) [](https://www.codacy.com/app/sonyarianto/imaginative-go?utm_source=github.com&utm_medium=referral&utm_content=sonyarianto/imaginative-go&utm_campaign=Badge_Grade)
## Status
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.
> **NOTE**
> For those who need documentation of Docker installation, please refer to [Docker CE](https://store.docker.com/search?type=edition&offering=community) and [Docker Compose](https://docs.docker.com/compose/install/).
> **NOTE**
> `sudo` used 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.
> **NOTE**
> For user that using Windows 10 Home that run with Docker Toolbox, I think you should modify IP on `docker-compose.yml` from 127.0.0.1 to your Docker Machine IP. Docker Machine IP can be known by typing `docker-machine ip`.
```
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
```
http://localhost:9899
```
> **Note 1**
> 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 pull` on Imaginative Go repository.
>
> Above command will error if volume `imaginative-go_volume-mongodb-imaginative-go` doesn't exists. You can remove the delete volume part if you encounter that error
> **Note 2**
> 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
> ```
## Contributors
- [Sony Arianto Kurniawan](https://github.com/sonyarianto) - sony at sony-ak.com - original author, project maintainer
- [Prasetyama Hidayat](https://github.com/prasetyama) - prasetyama at gmail.com
- [Waladi Abdauh](https://github.com/dauhpublic) - 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.)
## Community/Contributing
Imaginative Go maintains a mailing list, [Imaginative Go][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][conduct].
[imaginative-go]: https://groups.google.com/forum/#!forum/imaginative-go
[conduct]: https://golang.org/conduct
## License
This project is licensed under the MIT License.
License can be found [here](https://github.com/sonyarianto/imaginative-go/blob/master/LICENSE).