Add automatic version change of readme examples; Update changelog

Author: flonix8

Makefile

@@ -1,8 +1,8 @@
 VERSION := $(shell cat VERSION)
 
-.PHONY: all python java
+.PHONY: all python java readme
 
-all: clean python java
+all: clean python java readme
 
 clean:
 	rm -f python/visionapi/visionapi/*pb2.py*
@@ -14,4 +14,8 @@ python:
 
 java:
 	protoc -I=. --java_out=java/visionapi/src/main/java/ visionapi/*.proto
-	(cd java/visionapi && mvn versions:set -DgenerateBackupPoms=false -DnewVersion=$(VERSION))
+	(cd java/visionapi && mvn versions:set -DgenerateBackupPoms=false -DnewVersion=$(VERSION))
+
+readme:
+	sed -E 's|tag = "[0-9\.]+"|tag = "$(VERSION)"|' -i Readme.md
+	sed -E 's|<version>[0-9\.]+</version>|<version>$(VERSION)</version>|' -i Readme.md

Readme.md

@@ -3,7 +3,20 @@
 This repo contains the main data model for the Starwit Awareness Engine (SAE). See umbrella repo here: https://github.com/starwit/starwit-awareness-engine
 
 ## How-To Use
+
+### Python / Poetry
+- Add the following to your `pyproject.toml` dependencies section\
+    `visionapi = { git = "https://github.com/starwit/vision-api.git", subdirectory = "python/visionapi", tag = "3.2.0" }`
+    
 ### Java / Maven
+- Add dependency to your project:
+    ```xml
+    <dependency>
+      <groupId>de.starwit</groupId>
+      <artifactId>vision-api</artifactId>
+      <version>3.2.0</version>
+    </dependency>
+    ```
 - Add maven repository to your `~/.m2/settings.xml` (adapt example / your config as necessary):
     ```xml
     <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
@@ -44,20 +57,13 @@ This repo contains the main data model for the Starwit Awareness Engine (SAE). S
     </settings>
 
     ```
-- Add dependency to your project:
-    ```xml
-    <dependency>
-      <groupId>de.starwit</groupId>
-      <artifactId>vision-api</artifactId>
-      <version>3.1.0</version>
-    </dependency>
-    ```
 
 ## How-To Update
 1. Make desired changes in `./visionapi`
 2. Increase version in `./VERSION`
 3. Run `make`
 4. Make sure that there are no old leftover files in the generated projects
+5. Describe change in changelog section below
 5. Commit, tag with version and push
     ```
     // Commit stuff, like git add, git commit and such
@@ -71,6 +77,11 @@ ProtoBuf compiler can be downloaded here:
 https://github.com/protocolbuffers/protobuf/releases
 
 ## Changelog
+### 3.2.0
+- Add `source_id` to messages (to distinguish which source the messages are generated from)
+    - Add `IncidentMessage.source_id`
+    - Add `AnomalyMessage.source_id`
+
 ### 3.1.0
 - Add camera location field to all messages (as type `GeoCoordinate`)
     - Add `SaeMessage.frame.camera_location`