add warnings about codegen

sam/channel.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `channel.go`, `channel.util.go` or `channel_test.go` to
+	implement your API calls, helper functions and tests. The file `channel.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/channel.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `channel.go`, `channel.util.go` or `channel_test.go` to
+	implement your API calls, helper functions and tests. The file `channel.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/channel.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `channel.go`, `channel.util.go` or `channel_test.go` to
+	implement your API calls, helper functions and tests. The file `channel.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/channel.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `channel.go`, `channel.util.go` or `channel_test.go` to
+	implement your API calls, helper functions and tests. The file `channel.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"time"
 )

sam/message.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `message.go`, `message.util.go` or `message_test.go` to
+	implement your API calls, helper functions and tests. The file `message.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/message.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `message.go`, `message.util.go` or `message_test.go` to
+	implement your API calls, helper functions and tests. The file `message.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/message.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `message.go`, `message.util.go` or `message_test.go` to
+	implement your API calls, helper functions and tests. The file `message.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/message.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `message.go`, `message.util.go` or `message_test.go` to
+	implement your API calls, helper functions and tests. The file `message.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 type (
 	// Messages
 	Message struct {

sam/organisation.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `organisation.go`, `organisation.util.go` or `organisation_test.go` to
+	implement your API calls, helper functions and tests. The file `organisation.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/organisation.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `organisation.go`, `organisation.util.go` or `organisation_test.go` to
+	implement your API calls, helper functions and tests. The file `organisation.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/organisation.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `organisation.go`, `organisation.util.go` or `organisation_test.go` to
+	implement your API calls, helper functions and tests. The file `organisation.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/organisation.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `organisation.go`, `organisation.util.go` or `organisation_test.go` to
+	implement your API calls, helper functions and tests. The file `organisation.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"time"
 )

sam/routes.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `.go`, `.util.go` or `_test.go` to
+	implement your API calls, helper functions and tests. The file `.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 )

sam/team.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `team.go`, `team.util.go` or `team_test.go` to
+	implement your API calls, helper functions and tests. The file `team.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/team.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `team.go`, `team.util.go` or `team_test.go` to
+	implement your API calls, helper functions and tests. The file `team.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/team.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `team.go`, `team.util.go` or `team_test.go` to
+	implement your API calls, helper functions and tests. The file `team.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/team.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `team.go`, `team.util.go` or `team_test.go` to
+	implement your API calls, helper functions and tests. The file `team.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"time"
 )

sam/templates/http_handlers.tpl

@@ -1,5 +1,7 @@
 package {package}
 
+{load warning.tpl}
+
 import (
 	"net/http"
 

sam/templates/http_interfaces.tpl

@@ -1,5 +1,7 @@
 package {package}
 
+{load warning.tpl}
+
 import (
 	"net/http"
 )

sam/templates/http_request.tpl

@@ -1,5 +1,7 @@
 package {package}
 
+{load warning.tpl}
+
 import (
 	"net/http"
 	"github.com/go-chi/chi"

sam/templates/http_routes.tpl

@@ -1,5 +1,7 @@
 package {package}
 
+{load warning.tpl}
+
 import (
 	"github.com/go-chi/chi"
 )

sam/templates/http_structs.tpl

@@ -1,5 +1,7 @@
 package {package}
 
+{load warning.tpl}
+
 {if !empty($imports)}
 import (
 {foreach ($imports as $import)}

sam/templates/warning.tpl

@@ -0,0 +1,14 @@
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `{name|strtolower}.go`, `{name|strtolower}.util.go` or `{name|strtolower}_test.go` to
+	implement your API calls, helper functions and tests. The file `{name|strtolower}.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/

sam/user.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `user.go`, `user.util.go` or `user_test.go` to
+	implement your API calls, helper functions and tests. The file `user.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/user.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `user.go`, `user.util.go` or `user_test.go` to
+	implement your API calls, helper functions and tests. The file `user.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/user.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `user.go`, `user.util.go` or `user_test.go` to
+	implement your API calls, helper functions and tests. The file `user.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/user.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `user.go`, `user.util.go` or `user_test.go` to
+	implement your API calls, helper functions and tests. The file `user.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"time"
 )

sam/websocket.handlers.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `websocket.go`, `websocket.util.go` or `websocket_test.go` to
+	implement your API calls, helper functions and tests. The file `websocket.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 

sam/websocket.interfaces.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `websocket.go`, `websocket.util.go` or `websocket_test.go` to
+	implement your API calls, helper functions and tests. The file `websocket.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"net/http"
 )

sam/websocket.request.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `websocket.go`, `websocket.util.go` or `websocket_test.go` to
+	implement your API calls, helper functions and tests. The file `websocket.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 import (
 	"github.com/go-chi/chi"
 	"net/http"

sam/websocket.structs.go

@@ -1,5 +1,20 @@
 package sam
 
+/*
+	Hello! This file is auto-generated from `docs/src/spec.json`.
+
+	For development:
+	In order to update the generated files, edit this file under the location,
+	add your struct fields, imports, API definitions and whatever you want, and:
+
+	1. run [spec](https://github.com/titpetric/spec) in the same folder,
+	2. run `./_gen.php` in this folder.
+
+	You may edit `websocket.go`, `websocket.util.go` or `websocket_test.go` to
+	implement your API calls, helper functions and tests. The file `websocket.go`
+	is only generated the first time, and will not be overwritten if it exists.
+*/
+
 type (
 	// Websocket
 	Websocket struct {