crossplane-function-pythonic 0.1.4__py3-none-any.whl → 0.2.0__py3-none-any.whl

{crossplane_function_pythonic-0.1.4.dist-info → crossplane_function_pythonic-0.2.0.dist-info}/METADATA

@@ -1,25 +1,25 @@
 Metadata-Version: 2.4
 Name: crossplane-function-pythonic
-Version: 0.1.4
+Version: 0.2.0
 Summary: A Python centric Crossplane Function
-Project-URL: Documentation, https://github.com/fortra/function-pythonic#readme
-Project-URL: Issues, https://github.com/fortra/function-pythonic/issues
-Project-URL: Source, https://github.com/fortra/function-pythonic
+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-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.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: <3.14,>=3.11
-Requires-Dist: crossplane-function-sdk-python==0.9.0
-Requires-Dist: pyyaml==6.0.2
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=3.12
+Requires-Dist: crossplane-function-sdk-python==0.10.0
+Requires-Dist: pyyaml==6.0.3
 Provides-Extra: packages
-Requires-Dist: kopf==1.38.0; extra == 'packages'
+Requires-Dist: kopf==1.39.1; extra == 'packages'
 Provides-Extra: pip-install
-Requires-Dist: pip==25.2; extra == 'pip-install'
+Requires-Dist: pip==25.3; extra == 'pip-install'
 Description-Content-Type: text/markdown
 
 # function-pythonic
@@ -45,11 +45,11 @@ spec:
     kind: XR
   mode: Pipeline
   pipeline:
-  - step: 
+  - step:
     functionRef:
       name: function-pythonic
     input:
-      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      apiVersion: pythonic.fn.crossplane.io/v1alpha1
       kind: Composite
       composite: |
         class VpcComposite(BaseComposite):
@@ -81,7 +81,7 @@ kind: Function
 metadata:
   name: function-pythonic
 spec:
-  package: ghcr.io/fortra/function-pythonic:v0.1.3
+  package: xpkg.upbound.io/crossplane-contrib/function-pythonic:v0.2.0
 ```
 ## Composed Resource Dependencies
 
@@ -227,7 +227,7 @@ The BaseComposite class provides the following fields for manipulating the Compo
 | self.spec | Map | The composite observed spec |
 | self.status | Map | The composite desired and observed status, read from observed if not in desired |
 | self.conditions | Conditions | The composite desired and observed conditions, read from observed if not in desired |
-| self.events | Events | Returned events against the Composite and optionally on the Claim |
+| self.results | Results | Returned results applied to the Composite and optionally on the Claim |
 | self.connection | Connection | The composite desired and observed connection detials, read from observed if not in desired |
 | self.ready | Boolean | The composite desired ready state |
 
@@ -326,19 +326,19 @@ The fields are read only for `Resource.conditions` and `RequiredResource.conditi
 | Condition.lastTransitionTime | Timestamp | Last transition time, read only |
 | Condition.claim | Boolean | Also apply the condition the claim |
 
-### Events
+### Results
 
-The `BaseComposite.events` field is a list of events to apply to the Composite and
+The `BaseComposite.results` field is a list of results to apply to the Composite and
 optionally to the Claim.
 
 | Field | Type | Description |
 | ----- | ---- | ----------- |
-| Event.info | Boolean | Normal informational event |
-| Event.warning | Boolean | Warning level event |
-| Event.fatal | Boolean | Fatal events also terminate composing the Composite |
-| Event.reason | String | PascalCase, machine-readable reason for this event |
-| Event.message | String | Human-readable details about the event |
-| Event.claim | Boolean | Also apply the event to the claim |
+| Result.info | Boolean | Normal informational result |
+| Result.warning | Boolean | Warning level result |
+| Result.fatal | Boolean | Fatal results also terminate composing the Composite |
+| Result.reason | String | PascalCase, machine-readable reason for this result |
+| Result.message | String | Human-readable details about the result |
+| Result.claim | Boolean | Also apply the result to the claim |
 
 ## Single use Composites
 
@@ -348,7 +348,7 @@ just to run that Composition once in a single use or initialize task?
 function-pythonic installs a `Composite` CompositeResourceDefinition that enables
 creating such tasks using a single Composite resource:
 ```yaml
-apiVersion: pythonic.fortra.com/v1alpha1
+apiVersion: pythonic.fn.crossplane.io/v1alpha1
 kind: Composite
 metadata:
   name: composite-example
@@ -361,16 +361,62 @@ spec:
 
 ## Quick Start Development
 
-The following example demonstrates how to locally render function-python
-compositions. First, install the `crossplane-function-pythonic` python
-package into the python environment:
+function-pythonic includes a pure python implementation of the `crossplane render ...`
+command, which can be used to render Compositions that only use function-pythonic. This
+makes it very easy to test and debug using your IDE of choice. It is also blindingly
+fast compared to `crossplane render`. To use, install the `crossplane-function-pythonic`
+python package into the python environment.
 ```shell
 $ pip install crossplane-function-pythonic
 ```
-Next, create the following files:
+Then to render function-pythonic Compositions, use the `function-pythonic render ...`
+command.
+```shell
+$ function-pythonic render --help
+usage: Crossplane Function Pythonic render [-h] [--debug] [--log-name-width WIDTH] [--python-path DIRECTORY] [--render-unknowns]
+                                           [--allow-oversize-protos] [--context-files KEY=PATH] [--context-values KEY=VALUE]
+                                           [--observed-resources PATH] [--extra-resources PATH] [--required-resources PATH]
+                                           [--function-credentials PATH] [--include-full-xr] [--include-function-results] [--include-context]
+                                           PATH [PATH/CLASS]
+
+positional arguments:
+  PATH                  A YAML file containing the Composite resource to render.
+  PATH/CLASS            A YAML file containing the Composition resource or the complete path of a function=-pythonic BaseComposite subclass.
+
+options:
+  -h, --help            show this help message and exit
+  --debug, -d           Emit debug logs.
+  --log-name-width WIDTH
+                        Width of the logger name in the log output, default 40.
+  --python-path DIRECTORY
+                        Filing system directories to add to the python path.
+  --render-unknowns, -u
+                        Render resources with unknowns, useful during local development.
+  --allow-oversize-protos
+                        Allow oversized protobuf messages
+  --context-files KEY=PATH
+                        Context key-value pairs to pass to the Function pipeline. Values must be files containing YAML/JSON.
+  --context-values KEY=VALUE
+                        Context key-value pairs to pass to the Function pipeline. Values must be YAML/JSON. Keys take precedence over --context-files.
+  --observed-resources, -o PATH
+                        A YAML file or directory of YAML files specifying the observed state of composed resources.
+  --extra-resources PATH
+                        A YAML file or directory of YAML files specifying required resources (deprecated, use --required-resources).
+  --required-resources, -e PATH
+                        A YAML file or directory of YAML files specifying required resources to pass to the Function pipeline.
+  --function-credentials PATH
+                        A YAML file or directory of YAML files specifying credentials to use for Functions to render the XR.
+  --include-full-xr, -x
+                        Include a direct copy of the input XR's spedc and metadata fields in the rendered output.
+  --include-function-results, -r
+                        Include informational and warning messages from Functions in the rendered output as resources of kind: Result..
+  --include-context, -c
+                        Include the context in the rendered output as a resource of kind: Context.
+```
+The following example demonstrates how to locally render function-python compositions. First, create the following files:
 #### xr.yaml
 ```yaml
-apiVersion: pythonic.fortra.com/v1alpha1
+apiVersion: pythonic.fn.crossplane.io/v1alpha1
 kind: Hello
 metadata:
   name: world
@@ -382,10 +428,10 @@ spec:
 apiVersion: apiextensions.crossplane.io/v1
 kind: Composition
 metadata:
-  name: hellos.pythonic.fortra.com
+  name: hellos.pythonic.crossplane.io
 spec:
   compositeTypeRef:
-    apiVersion: pythonic.fortra.com/v1alpha1
+    apiVersion: pythonic.crossplane.io/v1alpha1
     kind: Hello
   mode: Pipeline
   pipeline:
@@ -393,50 +439,38 @@ spec:
     functionRef:
       name: function-pythonic
     input:
-      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      apiVersion: pythonic.fn.crossplane.io/v1alpha1
       kind: Composite
       composite: |
         class GreetingComposite(BaseComposite):
           def compose(self):
             self.status.greeting = f"Hello, {self.spec.who}!"
 ```
-#### functions.yaml
-```yaml
-apiVersion: pkg.crossplane.io/v1beta1
-kind: Function
-metadata:
-  name: function-pythonic
-  annotations:
-    render.crossplane.io/runtime: Development
-spec:
-  package: ghcr.io/fortra/function-pythonic:v0.1.3
-```
-In one terminal session, run function-pythonic:
-```shell
-$ function-pythonic --insecure --debug --render-unknowns
-[2025-08-21 15:32:37.966] grpc._cython.cygrpc  [DEBUG   ] Using AsyncIOEngine.POLLER as I/O engine
-```
-In another terminal session, render the Composite:
+Then, to render the above composite and composition, run:
 ```shell
-$ crossplane render xr.yaml composition.yaml functions.yaml
+$ function-pythonic render --debug --render-unknowns xr.yaml composition.yaml
+[2025-12-29 09:44:57.949] io.crossplane.fn.pythonic.Hello.world    [DEBUG   ] Starting compose, 1st step, 1st pass
+[2025-12-29 09:44:57.949] io.crossplane.fn.pythonic.Hello.world    [INFO    ] Completed compose
 ---
-apiVersion: pythonic.fortra.com/v1alpha1
+apiVersion: pythonic.fn.crossplane.io/v1alpha1
 kind: Hello
 metadata:
   name: world
 status:
   conditions:
-  - lastTransitionTime: "2024-01-01T00:00:00Z"
+  - lastTransitionTime: '2026-01-01T00:00:00Z'
     reason: Available
-    status: "True"
+    status: 'True'
     type: Ready
-  - lastTransitionTime: "2024-01-01T00:00:00Z"
+  - lastTransitionTime: '2026-01-01T00:00:00Z'
     message: All resources are composed
     reason: AllComposed
-    status: "True"
+    status: 'True'
     type: ResourcesComposed
   greeting: Hello, World!
 ```
+Most of the examples contain a `render.sh` command which uses `function-pythonic render` to
+render the example.
 
 ## ConfigMap Packages
 
@@ -465,7 +499,7 @@ Then, in your Composition:
     functionRef:
       name: function-pythonic
     input:
-      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      apiVersion: pythonic.fn.crossplane.io/v1alpha1
       kind: Composite
       composite: |
         from example.pythonic import features
@@ -497,7 +531,7 @@ data:
     functionRef:
       name: function-pythonic
     input:
-      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      apiVersion: pythonic.fn.crossplane.io/v1alpha1
       kind: Composite
       composite: example.pythonic.features.FeatureOneComposite
     ...
@@ -511,7 +545,7 @@ kind: Function
 metadata:
   name: function-pythonic
 spec:
-  package: ghcr.io/fortra/function-pythonic:v0.1.3
+  package: xpkg.upbound.io/crossplane-contrib/function-pythonic:v0.2.0
   runtimeConfigRef:
     name: function-pythonic
 ---
@@ -604,7 +638,7 @@ data:
     functionRef:
       name: function-pythonic
     input:
-      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      apiVersion: pythonic.fn.crossplane.io/v1alpha1
       kind: Composite
       parameters:
         who: World

crossplane_function_pythonic-0.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+crossplane/pythonic/__about__.py,sha256=gXUN1UoV7TWafLuqL_UsLD_UlnDY6JmtTV7bvwphX6Q,73
+crossplane/pythonic/__init__.py,sha256=A9U4-azc4DjSsOnOnjQxCkoTzsZMRBb_AvqzR_Bd95A,268
+crossplane/pythonic/__main__.py,sha256=6vYRlYDJtqFgLyiTamnl3htiNOtz8QlDl5WlIP98I8o,31
+crossplane/pythonic/command.py,sha256=s69oOVCgbm39gowvTy7ieaE-Vosckf24vcznJ6fO0Q4,3146
+crossplane/pythonic/composite.py,sha256=SVgyhyg4MDNm_rGSrHUi81bd9Zqgnv3zaMKnaCMKB2s,21967
+crossplane/pythonic/function.py,sha256=ShHhSJYblTB9BRx7NEtHgiyOconax7Lro0tLzzRyZdY,16564
+crossplane/pythonic/grpc.py,sha256=Ts_-JywIr4Xzjjf_hr2uOlPK0O8A1SNN6ZaEjRckjL8,4318
+crossplane/pythonic/main.py,sha256=ujUa_FYElQSGqnhZ-0NJrD3kSyYjfRbIp79FV2Yl7hs,599
+crossplane/pythonic/packages.py,sha256=4TxyT6V79R0m4tJbC8R1gwU_vgHGLXKSBzeTTKd8xGo,5120
+crossplane/pythonic/protobuf.py,sha256=Wf2VJteKR_0S8l96JKLoOI78yrcH258DVj03re_epFI,48163
+crossplane/pythonic/render.py,sha256=4mq-slOSGoGbSPJiioeepWbdImSyVbas_hIEnJO_p5s,21069
+crossplane/pythonic/version.py,sha256=jUi8Wk7malaNDdW3FemkcsqlSGygQCrRFvgWB3Sve8M,214
+crossplane_function_pythonic-0.2.0.dist-info/METADATA,sha256=w5BMWBdP1wvuPR-zeE28frxeBi-S8f9UfDE2gcj2OHk,28576
+crossplane_function_pythonic-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+crossplane_function_pythonic-0.2.0.dist-info/entry_points.txt,sha256=jJ4baywFDviB9WyAhyhNYF2VOCb6XtbRSjKf7bnBwhg,68
+crossplane_function_pythonic-0.2.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+crossplane_function_pythonic-0.2.0.dist-info/RECORD,,

{crossplane_function_pythonic-0.1.4.dist-info → crossplane_function_pythonic-0.2.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

crossplane_function_pythonic-0.1.4.dist-info/RECORD

@@ -1,11 +0,0 @@
-crossplane/pythonic/__init__.py,sha256=A9U4-azc4DjSsOnOnjQxCkoTzsZMRBb_AvqzR_Bd95A,268
-crossplane/pythonic/composite.py,sha256=w6ts1Qy-Gp_EIjX3i-JRO3DGUDv-55T9EHnyEptsooo,21083
-crossplane/pythonic/function.py,sha256=XwswHXaOr0PbrapQ9bvU0zMmHMvg_TOAOFXwdRqp1w8,16395
-crossplane/pythonic/main.py,sha256=fkMk2WDdPpRQQe-wFcI-2P3f64ddsftzx91cHaT5rII,6894
-crossplane/pythonic/packages.py,sha256=4TxyT6V79R0m4tJbC8R1gwU_vgHGLXKSBzeTTKd8xGo,5120
-crossplane/pythonic/protobuf.py,sha256=t6Ozkdb4GlpUjwCYP7d2uCvCBxvN3rjHfBaz3IOvL0Y,47995
-crossplane_function_pythonic-0.1.4.dist-info/METADATA,sha256=yjUWvs_AS4h-jJ05JOJ8EbfcT1stjNgxQGWK3F3yS14,25386
-crossplane_function_pythonic-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-crossplane_function_pythonic-0.1.4.dist-info/entry_points.txt,sha256=jJ4baywFDviB9WyAhyhNYF2VOCb6XtbRSjKf7bnBwhg,68
-crossplane_function_pythonic-0.1.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-crossplane_function_pythonic-0.1.4.dist-info/RECORD,,