first commit

Author: sebandgo

.gitignore

@@ -0,0 +1,2 @@
+.vscode/
+config.yaml

CONTRIBUTING.md

@@ -0,0 +1,85 @@
+# Contributing to Corridor
+
+Thank you for your interest in contributing to Corridor! We welcome contributions of all kinds, including bug reports, feature requests, code, and documentation improvements.
+
+---
+
+## How to Contribute
+
+### 1. Fork the Repository
+
+Click the "Fork" button at the top right of the [Corridor GitHub page](https://github.com/cloudresty/corridor) to create your own copy of the repository.
+
+### 2. Clone Your Fork
+
+```bash
+git clone https://github.com/your-username/corridor.git
+cd corridor
+```
+
+### 3. Create a Branch
+
+Create a new branch for your changes:
+
+```bash
+git checkout -b my-feature-or-bugfix
+```
+
+### 4. Make Your Changes
+
+- Follow the existing code style and conventions.
+- Add or update tests as appropriate.
+- Update documentation if your changes affect usage or configuration.
+
+### 5. Run Tests
+
+Before submitting your changes, make sure all tests pass:
+
+```bash
+go test ./...
+```
+
+### 6. Commit and Push
+
+Commit your changes with a clear message:
+
+```bash
+git add .
+git commit -m "Describe your change"
+git push origin my-feature-or-bugfix
+```
+
+### 7. Open a Pull Request
+
+Go to your fork on GitHub and open a pull request (PR) against the `main` branch of the upstream repository. Please include a clear description of your changes and reference any related issues.
+
+---
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/0/code_of_conduct/).
+
+---
+
+## Reporting Issues
+
+If you find a bug or have a feature request, please [open an issue](https://github.com/cloudresty/Corridor/issues) and provide as much detail as possible.
+
+---
+
+## Style Guide
+
+- Use `gofmt` to format your code.
+- Write clear, concise commit messages.
+- Document exported functions and types.
+- Add or update unit tests for new features or bug fixes.
+
+---
+
+## Questions
+
+If you have questions or need help, feel free to open an issue or start a discussion.
+
+---
+
+Thank you for helping make Corridor better!

LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cloudresty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,41 @@
+BASE = cloudresty
+NAME = $$(awk -F'/' '{print $$(NF-0)}' <<< $$PWD)
+DOCKER_REPO = ${BASE}/${NAME}
+DOCKER_TAG = test
+
+.PHONY: build run shell clean
+
+help: ## Show list of make targets and their description.
+	@grep -E '^[%a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
+		| awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+
+build: ## Build a docker image locally. Requires /build/.netrc to be present.
+	@docker build \
+		--platform linux/amd64 \
+		--pull \
+		--force-rm \
+		--tag ${DOCKER_REPO}:${DOCKER_TAG} \
+		--file build/Dockerfile .
+
+run: ## Run docker image locally.
+	@docker run \
+		--platform linux/amd64 \
+		--rm \
+		--name ${NAME} \
+		--hostname ${NAME}-${DOCKER_TAG} \
+		${DOCKER_REPO}:${DOCKER_TAG}
+
+shell: ## Run docker image in a shell locally.
+	@docker run \
+		--platform linux/amd64 \
+		--rm \
+		--name ${NAME} \
+		--hostname ${NAME}-${DOCKER_TAG} \
+		--interactive \
+		--tty \
+		--volume $$(pwd)/app/config.yaml:/corridor/config.yaml \
+		--entrypoint /bin/bash \
+		${DOCKER_REPO}:${DOCKER_TAG}
+
+clean: ## Remove all local docker images for the application.
+	@if [[ $$(docker images --format '{{.Repository}}:{{.Tag}}' | grep ${DOCKER_REPO}) ]]; then docker rmi $$(docker images --format '{{.Repository}}:{{.Tag}}' | grep ${DOCKER_REPO}); else echo "INFO: No images found for '${DOCKER_REPO}'"; fi