crossplane-function-pythonic 0.6.2__tar.gz → 0.7.0__tar.gz

{crossplane_function_pythonic-0.6.2 → crossplane_function_pythonic-0.7.0}/PKG-INFO

@@ -1,28 +1,23 @@
-Metadata-Version: 2.5
+Metadata-Version: 2.4
 Name: crossplane-function-pythonic
-Version: 0.6.2
+Version: 0.7.0
 Summary: A Python centric Crossplane Function
-Project-URL: Documentation, https://github.com/crossplane-contrib/function-pythonic#readme
-Project-URL: Issues, https://github.com/crossplane-contrib/function-pythonic/issues
-Project-URL: Source, https://github.com/crossplane-contrib/function-pythonic
+Author: Patrick J McNerthney
 Author-email: Patrick J McNerthney <pat@mcnerthney.com>
 License-Expression: Apache-2.0
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Python: <3.15,>=3.12
-Requires-Dist: grpcio==1.83.0
-Requires-Dist: inflect==7.5.0
+Requires-Dist: grpcio==1.85.1
+Requires-Dist: inflect==7.6.0
 Requires-Dist: kr8s==0.20.15
-Requires-Dist: protobuf==7.35.1
+Requires-Dist: protobuf==7.36.2
 Requires-Dist: pyyaml==6.0.3
+Requires-Dist: kopf==1.45.2 ; extra == 'packages'
+Requires-Dist: pip==26.2.2 ; extra == 'pip-install'
+Requires-Python: >=3.15, <3.16
+Project-URL: Documentation, https://github.com/crossplane-contrib/function-pythonic#readme
+Project-URL: Issues, https://github.com/crossplane-contrib/function-pythonic/issues
+Project-URL: Source, https://github.com/crossplane-contrib/function-pythonic
 Provides-Extra: packages
-Requires-Dist: kopf==1.44.6; extra == 'packages'
 Provides-Extra: pip-install
-Requires-Dist: pip==26.2.1; extra == 'pip-install'
 Description-Content-Type: text/markdown
 
 # function-pythonic
@@ -213,7 +208,7 @@ message contents. For example, the following examples obtain the same value
 from the RunFunctionRequest message:
 ```python
 region = request.observed.composite.resource.spec.region
-region = request['observed']['composite']['resource']['spec']['region']
+region = request["observed"]["composite"]["resource"]["spec"]["region"]
 ```
 Getting values from free form map and list values will not throw
 errors for keys that do not exist, but will return an unknown placeholder
@@ -232,13 +227,15 @@ When setting fields, all intermediary unknown placeholders will automatically
 be created. For example, this will create all items needed to set the
 region on the desired resource:
 ```python
-response.desired.resources.vpc.resource.spec.forProvider.region = 'us-east-1'
+response.desired.resources.vpc.resource.spec.forProvider.region = "us-east-1"
 ```
 Calling a message or map will clear it and will set any provided key word
 arguments. For example, this will either create or clear the resource
 and then set its apiVersion and kind:
 ```python
-response.desired.resources.vpc.resource(kind='VPC', apiVersion='ec2.aws.crossplane.io/v1beta1')
+response.desired.resources.vpc.resource(
+    kind="VPC", apiVersion="ec2.aws.crossplane.io/v1beta1"
+)
 ```
 The following functions are provided to create Protobuf structures:
 | Function | Description |
@@ -257,12 +254,12 @@ The following items are supported in all the Protobuf Message wrapper classes: `
 
 To convert a Protobuf message to a string value, use either `str` or `format`.
 ```python
-yaml  = str(request)                # get the request as yaml
-yaml  = format(request)             # also get the request as yaml
-yaml  = format(request, 'yaml')     # yet another get the request as yaml
-json  = format(request, 'json')     # get the request as json
-json  = format(request, 'jsonc')    # get the request as json compact
-proto = format(request, 'protobuf') # get the request as a protobuf string
+yaml = str(request)  # get the request as yaml
+yaml = format(request)  # also get the request as yaml
+yaml = format(request, "yaml")  # yet another get the request as yaml
+json = format(request, "json")  # get the request as json
+json = format(request, "jsonc")  # get the request as json compact
+proto = format(request, "protobuf")  # get the request as a protobuf string
 ```
 ## Composite Composition
 

{crossplane_function_pythonic-0.6.2 → crossplane_function_pythonic-0.7.0}/README.md

@@ -186,7 +186,7 @@ message contents. For example, the following examples obtain the same value
 from the RunFunctionRequest message:
 ```python
 region = request.observed.composite.resource.spec.region
-region = request['observed']['composite']['resource']['spec']['region']
+region = request["observed"]["composite"]["resource"]["spec"]["region"]
 ```
 Getting values from free form map and list values will not throw
 errors for keys that do not exist, but will return an unknown placeholder
@@ -205,13 +205,15 @@ When setting fields, all intermediary unknown placeholders will automatically
 be created. For example, this will create all items needed to set the
 region on the desired resource:
 ```python
-response.desired.resources.vpc.resource.spec.forProvider.region = 'us-east-1'
+response.desired.resources.vpc.resource.spec.forProvider.region = "us-east-1"
 ```
 Calling a message or map will clear it and will set any provided key word
 arguments. For example, this will either create or clear the resource
 and then set its apiVersion and kind:
 ```python
-response.desired.resources.vpc.resource(kind='VPC', apiVersion='ec2.aws.crossplane.io/v1beta1')
+response.desired.resources.vpc.resource(
+    kind="VPC", apiVersion="ec2.aws.crossplane.io/v1beta1"
+)
 ```
 The following functions are provided to create Protobuf structures:
 | Function | Description |
@@ -230,12 +232,12 @@ The following items are supported in all the Protobuf Message wrapper classes: `
 
 To convert a Protobuf message to a string value, use either `str` or `format`.
 ```python
-yaml  = str(request)                # get the request as yaml
-yaml  = format(request)             # also get the request as yaml
-yaml  = format(request, 'yaml')     # yet another get the request as yaml
-json  = format(request, 'json')     # get the request as json
-json  = format(request, 'jsonc')    # get the request as json compact
-proto = format(request, 'protobuf') # get the request as a protobuf string
+yaml = str(request)  # get the request as yaml
+yaml = format(request)  # also get the request as yaml
+yaml = format(request, "yaml")  # yet another get the request as yaml
+json = format(request, "json")  # get the request as json
+json = format(request, "jsonc")  # get the request as json compact
+proto = format(request, "protobuf")  # get the request as a protobuf string
 ```
 ## Composite Composition
 

crossplane_function_pythonic-0.7.0/pyproject.toml

@@ -0,0 +1,65 @@
+[project]
+name = "crossplane-function-pythonic"
+version = "0.7.0"
+description = "A Python centric Crossplane Function"
+license = "Apache-2.0"
+readme = "README.md"
+requires-python = ">=3.15,<3.16"
+dependencies = [
+    "grpcio==1.85.1",
+    "inflect==7.6.0",
+    "kr8s==0.20.15",
+    "protobuf==7.36.2",
+    "pyyaml==6.0.3",
+]
+
+[[project.authors]]
+name = "Patrick J McNerthney"
+email = "pat@mcnerthney.com"
+
+[project.optional-dependencies]
+packages = ["kopf==1.45.2"]
+pip-install = ["pip==26.2.2"]
+
+[project.urls]
+Documentation = "https://github.com/crossplane-contrib/function-pythonic#readme"
+Issues = "https://github.com/crossplane-contrib/function-pythonic/issues"
+Source = "https://github.com/crossplane-contrib/function-pythonic"
+
+[project.scripts]
+function-pythonic = "crossplane.pythonic.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.23,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "grpcio-tools>=1.85.0",
+    "kopf==1.45.2",
+    "mypy-protobuf>=5.1.0",
+    "poethepoet>=0.48.0",
+    "pip==26.2.2",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.0",
+    "ty>=0.0.92",
+    "types-grpcio>=1.84.0.20261021",
+]
+
+[tool.uv.build-backend]
+module-name = "crossplane.pythonic"
+
+[tool.ty.src]
+exclude = ["tests/test_protobuf_messages.py"]
+
+[tool.poe.tasks]
+generate-protoc = "python -m grpc_tools.protoc --proto_path=src --python_out=src --mypy_out=src --grpc_python_out=src --mypy_grpc_out=src crossplane/pythonic/proto/v1/run_function.proto"
+test = "pytest tests -x --verbose --verbose --cov --cov-report=term --cov-report=html:reports"
+test-protobuf = "pytest tests/test_protobuf_*.py -x --verbose --verbose --cov --cov-report=term --cov-report=html:reports"
+test-ci = "pytest tests --verbose --verbose --junitxml=reports/pytest-junit.xml --cov --cov-report=term --cov-report=xml:reports/pytest-coverage.xml"
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+filterwarnings = ["ignore:'asyncio.iscoroutinefunction' is deprecated:DeprecationWarning:kr8s._vendored.asyncache"]

crossplane_function_pythonic-0.7.0/pyproject.toml.orig

@@ -0,0 +1,66 @@
+[project]
+name = "crossplane-function-pythonic"
+version = "0.7.0"
+description = "A Python centric Crossplane Function"
+license = "Apache-2.0"
+readme = "README.md"
+authors = [
+  { name = "Patrick J McNerthney", email = "pat@mcnerthney.com" }
+]
+requires-python = ">=3.15,<3.16"
+dependencies = [
+  "grpcio==1.85.1",
+  "inflect==7.6.0",
+  "kr8s==0.20.15",
+  "protobuf==7.36.2",
+  "pyyaml==6.0.3",
+]
+
+[project.optional-dependencies]
+packages = ["kopf==1.45.2"]
+pip-install = ["pip==26.2.2"]
+
+[project.urls]
+Documentation = "https://github.com/crossplane-contrib/function-pythonic#readme"
+Issues = "https://github.com/crossplane-contrib/function-pythonic/issues"
+Source = "https://github.com/crossplane-contrib/function-pythonic"
+
+[project.scripts]
+function-pythonic = "crossplane.pythonic.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.23,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "grpcio-tools>=1.85.0",
+    "kopf==1.45.2",
+    "mypy-protobuf>=5.1.0",
+    "poethepoet>=0.48.0",
+    "pip==26.2.2",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.0",
+    "ty>=0.0.92",
+    "types-grpcio>=1.84.0.20261021",
+]
+
+[tool.uv.build-backend]
+module-name = "crossplane.pythonic"
+
+[tool.ty.src]
+exclude = ["tests/test_protobuf_messages.py"]
+
+[tool.poe.tasks]
+generate-protoc = "python -m grpc_tools.protoc --proto_path=src --python_out=src --mypy_out=src --grpc_python_out=src --mypy_grpc_out=src crossplane/pythonic/proto/v1/run_function.proto"
+test = "pytest tests -x --verbose --verbose --cov --cov-report=term --cov-report=html:reports"
+test-protobuf = "pytest tests/test_protobuf_*.py -x --verbose --verbose --cov --cov-report=term --cov-report=html:reports"
+test-ci = "pytest tests --verbose --verbose --junitxml=reports/pytest-junit.xml --cov --cov-report=term --cov-report=xml:reports/pytest-coverage.xml"
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+filterwarnings = [
+  "ignore:'asyncio.iscoroutinefunction' is deprecated:DeprecationWarning:kr8s._vendored.asyncache",
+]

crossplane_function_pythonic-0.7.0/src/crossplane/pythonic/__about__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("crossplane-function-pythonic")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

crossplane_function_pythonic-0.7.0/src/crossplane/pythonic/__init__.py

@@ -0,0 +1,25 @@
+from .composite import BaseComposite
+from .protobuf import (
+    B64Decode,
+    B64Encode,
+    Json,
+    List,
+    Map,
+    Unknown,
+    Yaml,
+    YamlAll,
+    append,
+)
+
+__all__ = [
+    "B64Decode",
+    "B64Encode",
+    "BaseComposite",
+    "Json",
+    "List",
+    "Map",
+    "Unknown",
+    "Yaml",
+    "YamlAll",
+    "append",
+]

{crossplane_function_pythonic-0.6.2 → crossplane_function_pythonic-0.7.0/src}/crossplane/pythonic/__main__.py

@@ -1,2 +1,3 @@
 from . import main
+
 main.main()

{crossplane_function_pythonic-0.6.2 → crossplane_function_pythonic-0.7.0/src}/crossplane/pythonic/auto_ready.py

@@ -1,14 +1,24 @@
+from typing import TYPE_CHECKING
 
-def resource_ready(resource):
+if TYPE_CHECKING:
+    from . import (
+        composite,
+        protobuf,
+    )
+
+
+def resource_ready(resource: composite.Resource) -> protobuf.Value | None:
     if not resource.observed:
         return None
-    return _checks.get((resource.observed.apiVersion, resource.observed.kind), _check_default).ready(resource)
+    return _checks.get(
+        (resource.observed.apiVersion, resource.observed.kind), _check_default
+    ).ready(resource)
 
 
 class ReadyCondition:
-    def ready(self, resource):
+    def ready(self, resource: composite.Resource) -> protobuf.Value | None:
         ready = resource.conditions.Ready
-        if not ready._find_condition():
+        if not ready._get_condition():
             return None
         if ready.status:
             return resource.observed.metadata.name
@@ -16,36 +26,43 @@ class ReadyCondition:
             return resource.status.notReadyCondition[ready.reason]
         return resource.status.notReadyCondition
 
-_checks = {}
+
+_checks: dict[tuple, Check] = {}
 _check_default = ReadyCondition()
 
+
 class Check:
     @classmethod
     def __init_subclass__(cls, **kwargs):
         super().__init_subclass__(**kwargs)
-        if hasattr(cls, 'apiVersion'):
+        if hasattr(cls, "apiVersion"):
             _checks[(cls.apiVersion, cls.__name__)] = cls()
 
-    def ready(self, resource):
+    def ready(self, resource: composite.Resource) -> protobuf.Value | None:
         raise NotImplementedError()
 
+
 class AlwaysReady(Check):
-    def ready(self, resource):
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         return resource.observed.metadata.name
 
 
 class ClusterRole(AlwaysReady):
-    apiVersion = 'rbac.authorization.k8s.io/v1'
+    apiVersion = "rbac.authorization.k8s.io/v1"
+
 
 class ClusterRoleBinding(AlwaysReady):
-    apiVersion = 'rbac.authorization.k8s.io/v1'
+    apiVersion = "rbac.authorization.k8s.io/v1"
+
 
 class ConfigMap(AlwaysReady):
-    apiVersion = 'v1'
+    apiVersion = "v1"
+
 
 class CronJob(Check):
-    apiVersion = 'batch/v1'
-    def ready(self, resource):
+    apiVersion = "batch/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         if resource.observed.spec.suspend and len(resource.observed.spec.suspend):
             return resource.observed.metadata.name
         if not resource.status.lastScheduleTime:
@@ -54,17 +71,21 @@ class CronJob(Check):
             return resource.observed.metadata.name
         if not resource.status.lastSuccessfulTime:
             return resource.status.lastSuccessfulTime
-        if str(resource.status.lastSuccessfulTime) < str(resource.status.lastScheduleTime):
+        if str(resource.status.lastSuccessfulTime) < str(
+            resource.status.lastScheduleTime
+        ):
             return resource.status.successfulBeforeSchedule
         return resource.observed.metadata.name
 
+
 class DaemonSet(Check):
-    apiVersion = 'apps/v1'
-    def ready(self, resource):
+    apiVersion = "apps/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         scheduled = resource.status.desiredNumberScheduled
         if not scheduled:
             return scheduled
-        for field in ('numberReady', 'updatedNumberScheduled', 'numberAvailable'):
+        for field in ("numberReady", "updatedNumberScheduled", "numberAvailable"):
             value = resource.status[field]
             if not value:
                 return value
@@ -72,16 +93,18 @@ class DaemonSet(Check):
                 return resource.status[f"{field}NotScheduled"]
         return resource.observed.metadata.name
 
+
 class Deployment(Check):
-    apiVersion = 'apps/v1'
-    def ready(self, resource):
+    apiVersion = "apps/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         replicas = resource.observed.spec.replicas or 1
-        for field in ('updatedReplicas', 'availableReplicas'):
+        for field in ("updatedReplicas", "availableReplicas"):
             value = resource.status[field]
             if not value:
                 return value
             if replicas != value:
-                return resource.status[F"{field}NotReplicas"]
+                return resource.status[f"{field}NotReplicas"]
         available = resource.conditions.Available
         if not available:
             return resource.status.notAvailable
@@ -91,28 +114,39 @@ class Deployment(Check):
             return resource.status.notAvailable
         return resource.observed.metadata.name
 
+
 class HorizontalPodAutoscaler(Check):
-    apiVersion = 'autoscaling/v2'
-    def ready(self, resource):
-        for type in ('FailedGetScale', 'FailedUpdateScale', 'FailedGetResourceMetric', 'InvalidSelector'):
+    apiVersion = "autoscaling/v2"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        for type in (
+            "FailedGetScale",
+            "FailedUpdateScale",
+            "FailedGetResourceMetric",
+            "InvalidSelector",
+        ):
             if resource.conditions[type].status:
                 return resource.status[f"is{type}"]
-        for type in ('ScalingActive', 'ScalingLimited'):
+        for type in ("ScalingActive", "ScalingLimited"):
             if resource.conditions[type].status:
                 return resource.observed.metadata.name
-        return resource.status.notScalingActiveOrLimiited
+        return resource.status.notScalingActiveOrLimited
+
 
 class Ingress(Check):
-    apiVersion = 'networking.k8s.io/v1'
-    def ready(self, resource):
+    apiVersion = "networking.k8s.io/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         if not len(resource.status.loadBalancer.ingress):
-            return resource.status.noLoadBalanceIngresses
+            return resource.status.noLoadBalancerIngresses
         return resource.observed.metadata.name
 
+
 class Job(Check):
-    apiVersion = 'batch/v1'
-    def ready(self, resource):
-        for type in ('Failed', 'Suspended'):
+    apiVersion = "batch/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        for type in ("Failed", "Suspended"):
             if resource.conditions[type].status:
                 return resource.status[f"is{type}"]
         complete = resource.conditions.Complete
@@ -124,71 +158,94 @@ class Job(Check):
             return resource.status.notComplete
         return resource.observed.metadata.name
 
+
 class Namespace(AlwaysReady):
-    apiVersion = 'v1'
+    apiVersion = "v1"
+
 
 class PersistentVolumeClaim(Check):
-    apiVersion = 'v1'
-    def ready(self, resource):
-        if resource.status.phase != 'Bound':
+    apiVersion = "v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        if resource.status.phase != "Bound":
             return resource.status.phaseNotBound
         return resource.observed.metadata.name
 
+
 class Pod(Check):
-    apiVersion = 'v1'
-    def ready(self, resource):
-        if resource.status.phase == 'Succeeded':
+    apiVersion = "v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        if resource.status.phase == "Succeeded":
+            return resource.observed.metadata.name
+        if (
+            resource.status.phase == "Running"
+            and resource.observed.spec.restartPolicy == "Always"
+            and resource.conditions.Ready.status
+        ):
             return resource.observed.metadata.name
-        if resource.status.phase == 'Running':
-            if resource.observed.spec.restartPolicy == 'Always':
-                if resource.conditions.Ready.status:
-                    return resource.observed.metadata.name
         return resource.status.notSucceededOrRunning
 
+
 class ReplicaSet(Check):
-    apiVersion = 'v1'
-    def ready(self, resource):
-        if int(resource.status.observedGeneration) < int(resource.observed.metadata.generation):
+    apiVersion = "apps/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        if int(resource.status.observedGeneration) < int(
+            resource.observed.metadata.generation
+        ):
             return resource.status.priorObservedGeneration
         if resource.conditions.ReplicaFailure.status:
             if resource.conditions.ReplicaFailure.reason:
-                return resource.status.isReplicaFailure[resource.conditions.ReplicaFailure.reason]
+                return resource.status.isReplicaFailure[
+                    resource.conditions.ReplicaFailure.reason
+                ]
             return resource.status.isReplicaFailure
-        if int(resource.status.availableReplicas) < int(resource.observed.spec.replicas or 1):
-            return resource.status.tooFewavailableReplicas
+        if int(resource.status.availableReplicas) < int(
+            resource.observed.spec.replicas or 1
+        ):
+            return resource.status.tooFewAvailableReplicas
         return resource.observed.metadata.name
 
+
 class Role(AlwaysReady):
-    apiVersion = 'rbac.authorization.k8s.io/v1'
+    apiVersion = "rbac.authorization.k8s.io/v1"
+
 
 class RoleBinding(AlwaysReady):
-    apiVersion = 'rbac.authorization.k8s.io/v1'
+    apiVersion = "rbac.authorization.k8s.io/v1"
+
 
 class Secret(AlwaysReady):
-    apiVersion = 'v1'
+    apiVersion = "v1"
+
 
 class Service(Check):
-    apiVersion = 'v1'
-    def ready(self, resource):
-        if resource.observed.spec.type != 'LoadBalancer':
+    apiVersion = "v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
+        if resource.observed.spec.type != "LoadBalancer":
             return resource.observed.metadata.name
         if not len(resource.status.loadBalancer.ingress):
             return resource.status.noLoadBalancerIngresses
         return resource.observed.metadata.name
 
+
 class ServiceAccount(AlwaysReady):
-    apiVersion = 'v1'
+    apiVersion = "v1"
+
 
 class StatefulSet(Check):
-    apiVersion = 'apps/v1'
-    def ready(self, resource):
+    apiVersion = "apps/v1"
+
+    def ready(self, resource: composite.Resource) -> protobuf.Value:
         replicas = resource.observed.spec.replicas or 1
-        for field in ('readyReplicas', 'currentReplicas'):
+        for field in ("readyReplicas", "currentReplicas"):
             value = resource.status[field]
             if not value:
                 return value
             if replicas != value:
-                return resource.status[F"{field}NotReplicas"]
+                return resource.status[f"{field}NotReplicas"]
         if resource.status.currentRevision != resource.status.updateRevision:
-            return resource.status.currentRevisionNotUpdateReivsion
+            return resource.status.currentRevisionNotUpdateRevision
         return resource.observed.metadata.name