First template run

Author: InfernoJJ

.github/workflows/go.yml

@@ -0,0 +1,35 @@
+name: Go
+
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+
+  build:
+    name: Build
+    runs-on: self-hosted
+    steps:
+
+    - name: Set up Go 1.x
+      uses: actions/setup-go@v2
+      with:
+        go-version: ^1.13
+      id: go
+
+    - name: Check out code into the Go module directory
+      uses: actions/checkout@v2
+
+    - name: Get dependencies
+      run: |
+        go get -v -t -d ./...
+        if [ -f Gopkg.toml ]; then
+            curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
+            dep ensure
+        fi
+    
+    - name: Install
+      run: make install
+
+    - name: Check
+      run: make check

.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish Release
+
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+
+  build:
+    name: Build
+    runs-on: self-hosted
+    steps:
+
+    - name: Set up Go 1.x
+      uses: actions/setup-go@v2
+      with:
+        go-version: ^1.13
+      id: go
+
+    - name: Check out code into the Go module directory
+      uses: actions/checkout@v2
+
+    - name: Get dependencies
+      run: |
+        go get -v -t -d ./...
+        if [ -f Gopkg.toml ]; then
+            curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
+            dep ensure
+        fi
+    
+    - name: Install
+      run: make install
+
+    - name: Check
+      run: make check
+    
+    - name: Docker
+      run: make docker
+
+    - name: Docker push
+      run: docker push moov/irs

.gitignore

@@ -1 +1,35 @@
-.DS_Store
+# Compiled Object files, Static and Dynamic libs (Shared Objects)
+*.o
+*.a
+*.so
+
+# Folders
+_obj
+_test
+
+# Architecture specific extensions/prefixes
+*.[568vq]
+[568vq].out
+
+*.cgo1.go
+*.cgo2.c
+_cgo_defun.c
+_cgo_gotypes.go
+_cgo_export.*
+
+_testmain.go
+
+*.exe
+*.test
+*.prof
+bin/
+*.db
+
+/lint-project.sh
+misspell*
+staticcheck*
+coverage.txt
+
+pkger*
+pkged.go
+cover.out

.openapi-generator/VERSION

@@ -0,0 +1 @@
+5.0.0-SNAPSHOT

.openapi-generator/client-generator-config.yml

@@ -0,0 +1,9 @@
+inputSpec: /local/api/api.yml
+outputDir: /local/pkg/client
+generatorName: go
+artifactId: "irs-client"
+gitUserId: moov-io
+gitRepoId: "irs"
+additionalProperties:
+  isGoSubmodule: true
+  packageName: client

Dockerfile

@@ -0,0 +1,15 @@
+FROM debian:buster AS runtime
+WORKDIR /
+
+RUN apt-get update && apt-get install -y ca-certificates \
+	&& rm -rf /var/lib/apt/lists/*
+
+COPY bin/.docker/irs /app/irs
+VOLUME [ "/data", "/configs" ]
+
+EXPOSE 8208/tcp
+EXPOSE 8209/tcp
+
+VOLUME [ "/data", "/configs" ]
+
+ENTRYPOINT ["/app/irs"]

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2020 Moov, LLC
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

Makefile

@@ -0,0 +1,60 @@
+PLATFORM=$(shell uname -s | tr '[:upper:]' '[:lower:]')
+VERSION := $(shell grep -Eo '(v[0-9]+[\.][0-9]+[\.][0-9]+(-[a-zA-Z0-9]*)?)' version.go)
+
+USERID := $(shell id -u $$USER)
+GROUPID:= $(shell id -g $$USER)
+
+build: irs
+
+irs:
+	pkger
+	go build -o ${PWD}/bin/irs cmd/irs/*
+
+run: irs
+	./bin/irs
+
+test: services build
+	go test -cover ./...
+
+services:
+	-docker-compose up -d --force-recreate
+
+install:
+	go get github.com/markbates/pkger/cmd/pkger
+	git checkout LICENSE
+
+.PHONY: check
+check: build services
+ifeq ($(OS),Windows_NT)
+	@echo "Skipping checks on Windows, currently unsupported."
+else
+	@wget -O lint-project.sh https://raw.githubusercontent.com/moov-io/infra/master/go/lint-project.sh
+	@chmod +x ./lint-project.sh
+	./lint-project.sh
+endif
+
+docker: install
+	pkger
+	GOOS=linux GOARCH=amd64 CGO_ENABLED=1 go build -o ${PWD}/bin/.docker/irs cmd/irs/*
+	docker build --pull -t moov/irs:$(VERSION) -f Dockerfile .
+	docker tag moov/irs:$(VERSION) moov/irs:latest
+	
+docker-run:
+	docker run -v ${PWD}/data:/data -v ${PWD}/configs:/configs --env APP_CONFIG="/configs/config.yml" -it --rm moov/irs:$(VERSION)
+
+clean:
+	rm ./data/*
+
+# Generate the go code from the public and internal api's
+openapitools:
+	docker run --rm \
+		-u $(USERID):$(GROUPID) \
+		-e OPENAPI_GENERATOR_VERSION='4.2.0' \
+		-v ${PWD}:/local openapitools/openapi-generator-cli batch -- /local/.openapi-generator/client-generator-config.yml
+
+# From https://github.com/genuinetools/img
+.PHONY: AUTHORS
+AUTHORS:
+	@$(file >$@,# This file lists all individuals having contributed content to the repository.)
+	@$(file >>$@,# For how it is generated, see `make AUTHORS`.)
+	@echo "$(shell git log --format='\n%aN <%aE>' | LC_ALL=C.UTF-8 sort -uf)" >> $@

README.md

@@ -1,24 +1,54 @@
-# irs
-Package `github.com/moov-io/irs` implements a file reader and writer written in Go along with a HTTP API and CLI for creating, parsing, validating, and transforming IRS electronic Filing Information Returns Electronically (FIRE). FIRE operates on a byte(ASCII) level making it difficult to interface with JSON and CSV/TEXT file formats.
+moov-io/irs
+===
 
-| Input      | Output     |
-|------------|------------|
-| JSON       | JSON       |
-| ASCII FIRE | ASCII FIRE |
-|            | PDF Form   |
-|            | SQL        |
+[![GoDoc](https://godoc.org/github.com/moov-io/irs?status.svg)](https://godoc.org/github.com/moov-io/irs)
+[![Build Status](https://travis-ci.com/moov-io/irs.svg?branch=master)](https://travis-ci.com/moov-io/irs)
+[![Coverage Status](https://codecov.io/gh/moov-io/irs/branch/master/graph/badge.svg)](https://codecov.io/gh/moov-io/irs)
+[![Go Report Card](https://goreportcard.com/badge/github.com/moov-io/irs)](https://goreportcard.com/report/github.com/moov-io/irs)
+[![Apache 2 licensed](https://img.shields.io/badge/license-Apache2-blue.svg)](https://raw.githubusercontent.com/moov-io/irs/master/LICENSE)
 
+Package github.com/moov-io/irs implements a file reader and writer written in Go along with a HTTP API and 
+CLI for creating, parsing, validating, and transforming IRS electronic Filing Information Returns 
+Electronically (FIRE). FIRE operates on a byte(ASCII) level making it difficult to interface with JSON and 
+CSV/TEXT file formats.
 
-- [Filing Information Returns Electronically (FIRE)](https://www.irs.gov/e-file-providers/filing-information-returns-electronically-fire)
-- File formats are defined by Part C of [IRS Publication 1220](https://www.irs.gov/pub/irs-pdf/p1220.pdf)
 
-# Project Status
+Docs: [docs](docs/README.md) | [open api specification](api/api.yml)
 
-We are just getting started! 
+## Project Status
 
-- [ ] 1099-MISC [About Form 1099-MISC](https://www.irs.gov/forms-pubs/about-form-1099-misc)
-- [ ] 1099-NEC [About Form 1099-NEC](https://www.irs.gov/forms-pubs/about-form-1099-nec)  
+This project is currently under development and could introduce breaking changes to reach a stable status. We are looking for community feedback so please try out our code or give us feedback!
 
+## Getting Started
 
+Read through the [project docs](docs/README.md) over here to get an understanding of the purpose of this project and how to run it. 
 
-... more to come 
+## Getting Help
+
+ channel | info
+ ------- | -------
+ [Project Documentation](https://docs.moov.io/) | Our project documentation available online.
+ Google Group [moov-users](https://groups.google.com/forum/#!forum/moov-users)| The Moov users Google group is for contributors other people contributing to the Moov project. You can join them without a google account by sending an email to [[email protected]](mailto:[email protected]). After receiving the join-request message, you can simply reply to that to confirm the subscription.
+Twitter [@moov_io](https://twitter.com/moov_io)	| You can follow Moov.IO's Twitter feed to get updates on our project(s). You can also tweet us questions or just share blogs or stories.
+[GitHub Issue](https://github.com/moov-io) | If you are able to reproduce a problem please open a GitHub Issue under the specific project that caused the error.
+[moov-io slack](https://slack.moov.io/) | Join our slack channel to have an interactive discussion about the development of the project.
+
+## Supported and Tested Platforms
+
+- 64-bit Linux (Ubuntu, Debian), macOS, and Windows
+
+## Contributing
+
+Yes please! Please review our [Contributing guide](CONTRIBUTING.md) and [Code of Conduct](https://github.com/moov-io/ach/blob/master/CODE_OF_CONDUCT.md) to get started! Checkout our [issues for first time contributors](https://github.com/moov-io/irs/contribute) for something to help out with.
+
+This project uses [Go Modules](https://github.com/golang/go/wiki/Modules) and uses Go 1.14 or higher. See [Golang's install instructions](https://golang.org/doc/install) for help setting up Go. You can download the source code and we offer [tagged and released versions](https://github.com/moov-io/irs/releases/latest) as well. We highly recommend you use a tagged release for production.
+
+### Test Coverage
+
+Improving test coverage is a good candidate for new contributors while also allowing the project to move more quickly by reducing regressions issues that might not be caught before a release is pushed out to our users. One great way to improve coverage is by adding edge cases and different inputs to functions (or [contributing and running fuzzers](https://github.com/dvyukov/go-fuzz)).
+
+Tests can run processes (like sqlite databases), but should only do so locally.
+
+## License
+
+Apache License 2.0 See [LICENSE](LICENSE) for details.