add files structure

README.md

@@ -1 +1,41 @@
-# foreman
+# Foreman
+It is a [foreman](https://github.com/ddollar/foreman) implementation in GO.
+
+## Description
+Foreman is a manager for [Procfile-based](https://en.wikipedia.org/wiki/Procfs) applications. Its aim is to abstract away the details of the Procfile format, and allow you to run your services directly.
+
+## Features
+- Run procfile-backed apps.
+- Able to run with dependency resolution.
+
+## Procfile
+Procfile is simply `key: value` format like:
+```yaml
+app1:
+    cmd: ping -c 1 google.com 
+    run_once: false 
+    checks:
+        cmd: ps aux | grep google
+    deps: 
+        - redis
+app2:
+    cmd: ping -c 5 yahoo.com
+    checks:
+        cmd: ps aux | grep yahoo
+
+redis:
+    cmd: redis-server --port 6010
+    checks:
+        cmd: redis-cli -p 6010 ping
+        tcp_ports: [6010]
+```
+**Here** we defined three services `app1`, `app2` and `redis` with check commands and dependency matrix
+
+## How to use
+**First:** modify the procfile with processes or services you want to run.
+
+**second**: Simply run with command: 
+```sh
+$ ./foreman
+```
+

cmd/foreman/main.go

@@ -0,0 +1 @@
+package main

foreman.go

@@ -0,0 +1 @@
+package foreman 

foreman_test.go

@@ -0,0 +1,2 @@
+package foreman 
+

internal/depgraph/depgraph.go

@@ -0,0 +1 @@
+package depgraph

internal/procparser/procfile_parser.go

@@ -0,0 +1 @@
+package procparser 

test-procfiles/Procfile

@@ -0,0 +1,19 @@
+service_ping:
+  cmd: ping -c 2 google.com | grep google
+  checks:
+    cmd: ls
+  deps: 
+      - service_redis
+
+service_sleep:
+  cmd: sleep 5
+  checks:
+    cmd: ls
+  deps: 
+      - service_ping
+
+service_redis:
+  cmd: redis-server --port 6010
+  run_once: true
+  checks:
+    cmd: redis-cli -p 6010 ping

test-procfiles/Procfile-bad-test

@@ -0,0 +1 @@
+this is invalid Procfile syntax, Procfile must be yaml file.

test-procfiles/Procfile-cyclic-test

@@ -0,0 +1,15 @@
+sleeper:
+    run_once: true
+    cmd: sleep infinity
+    checks:
+        cmd: ls
+        tcp_ports: [4759, 1865]
+        udp_ports: [4500, 3957]
+    deps:
+        - hello
+
+hello:
+    run_once: true
+    cmd: echo "hello"
+    deps:
+        - sleeper

test-procfiles/Procfile-test

@@ -0,0 +1,13 @@
+sleeper:
+    run_once: true
+    cmd: sleep infinity
+    checks:
+        cmd: ls
+        tcp_ports: [4759, 1865]
+        udp_ports: [4500, 3957]
+    deps:
+        - hello
+
+hello:
+    run_once: true
+    cmd: echo "hello"