Feat: add python sdk for Agones game server

build/build-sdk-images/python/Dockerfile

@@ -0,0 +1,23 @@
+# Copyright Contributors to Agones a Series of LF Projects, LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+ARG BASE_IMAGE=agones-build-sdk-base:latest
+FROM $BASE_IMAGE
+
+RUN apt-get --allow-releaseinfo-change update && \
+    apt-get install -y python3 python3-pip python3-venv && \
+    apt-get clean
+
+# code generation scripts
+COPY *.sh /root/
+RUN chmod +x /root/*.sh

build/build-sdk-images/python/gen.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Copyright Contributors to Agones a Series of LF Projects, LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -ex
+cd /go/src/agones.dev/agones/sdks/python
+python3 -m venv .venv
+.venv/bin/pip install grpcio-tools
+PATH="$(pwd)/.venv/bin:$PATH" bash generate.sh

build/build-sdk-images/python/sdktest.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Copyright Contributors to Agones a Series of LF Projects, LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -ex
+cd /go/src/agones.dev/agones/sdks/python
+python3 -m venv .venv
+.venv/bin/pip install grpcio protobuf
+.venv/bin/python /go/src/agones.dev/agones/test/sdk/python/testSDKClient.py

build/build-sdk-images/python/test.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Copyright Contributors to Agones a Series of LF Projects, LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -ex
+cd /go/src/agones.dev/agones/sdks/python
+python3 -m venv .venv
+.venv/bin/pip install grpcio protobuf pytest
+.venv/bin/python -m pytest tests/

build/includes/sdk.mk

@@ -66,7 +66,7 @@ gen-sdk-grpc: COMMAND := gen
 gen-sdk-grpc: run-sdk-command
 
 # Runs a command on all supported languages, use COMMAND variable to select which command.
-run-all-sdk-command: run-sdk-command-go run-sdk-command-rust run-sdk-command-cpp run-sdk-command-node run-sdk-command-restapi run-sdk-command-csharp
+run-all-sdk-command: run-sdk-command-go run-sdk-command-rust run-sdk-command-cpp run-sdk-command-node run-sdk-command-restapi run-sdk-command-csharp run-sdk-command-python
 
 run-sdk-command-node:
 	$(MAKE) run-sdk-command COMMAND=$(COMMAND) SDK_FOLDER=node
@@ -86,6 +86,9 @@ run-sdk-command-restapi:
 run-sdk-command-csharp:
 	$(MAKE) run-sdk-command COMMAND=$(COMMAND) SDK_FOLDER=csharp
 
+run-sdk-command-python:
+	$(MAKE) run-sdk-command COMMAND=$(COMMAND) SDK_FOLDER=python
+
 # Runs a command for a specific SDK if it exists.
 run-sdk-command:
 	@cd $(sdk_build_folder); \
@@ -201,8 +204,14 @@ run-sdk-conformance-test-rest:
 
 	$(MAKE) run-sdk-command COMMAND=clean SDK_FOLDER=restapi
 
+run-sdk-conformance-test-python:
+	# run with Beta feature flags enabled
+	$(MAKE) run-sdk-conformance-test SDK_FOLDER=python GRPC_PORT=9006 HTTP_PORT=9106 FEATURE_GATES=$(BETA_FEATURE_GATES) TESTS=$(DEFAULT_CONFORMANCE_TESTS),$(COUNTS_AND_LISTS_TESTS)
+	# run with Alpha feature flags enabled
+	$(MAKE) run-sdk-conformance-test SDK_FOLDER=python GRPC_PORT=9006 HTTP_PORT=9106 FEATURE_GATES=$(ALPHA_FEATURE_GATES) TESTS=$(DEFAULT_CONFORMANCE_TESTS),$(ALPHA_CONFORMANCE_TESTS)
+
 # Run a conformance test for all SDKs supported
-run-sdk-conformance-tests: run-sdk-conformance-test-node run-sdk-conformance-test-go run-sdk-conformance-test-rust run-sdk-conformance-test-rest run-sdk-conformance-test-cpp run-sdk-conformance-test-csharp
+run-sdk-conformance-tests: run-sdk-conformance-test-node run-sdk-conformance-test-go run-sdk-conformance-test-rust run-sdk-conformance-test-rest run-sdk-conformance-test-cpp run-sdk-conformance-test-csharp run-sdk-conformance-test-python
 
 # Clean package directories and binary files left
 # after building conformance tests for all SDKs supported

build/scripts/sdk-update-version/main.go

@@ -56,6 +56,7 @@ func main() {
 		"sdks/csharp/sdk/AgonesSDK.nuspec",
 		"sdks/csharp/sdk/csharp-sdk.csproj",
 		"sdks/rust/Cargo.toml",
+		"sdks/python/pyproject.toml",
 	}
 
 	for _, filename := range files {

sdks/README.md

@@ -9,6 +9,7 @@ For detailed instruction on how to develop each client library please refer to r
 * Agones Go Client SDK (todo)
 * [Agones NodeJS Client SDK](nodejs/README.md)
 * [Agones Rust Client SDK](rust/README.md)
+* [Agones Python Client SDK](python/README.md)
 * OpenAPI/Swagger Definitions (todo)
 * [Agones Unity Client SDK](unity/README.md)
 * Agones Unreal Client SDK (todo)

sdks/python/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.pytest_cache/

sdks/python/README.md

@@ -0,0 +1,7 @@
+# Python Game Server Client SDK
+
+This is the Python version of the Agones Game Server Client SDK.
+
+See the [Python SDK Documentation](https://agones.dev/site/docs/guides/client-sdks/python/) for details
+
+The [Client SDK Documentation](https://agones.dev/site/docs/guides/client-sdks/) has details on each of the SDK functions and how to run the SDK locally.

sdks/python/agones/__init__.py

@@ -0,0 +1,17 @@
+# Copyright Contributors to Agones a Series of LF Projects, LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from agones.sdk import AgonesSDK
+
+__all__ = ["AgonesSDK"]