crossplane-function-pythonic 0.0.7a0__tar.gz → 0.0.7.post3__tar.gz

{crossplane_function_pythonic-0.0.7a0 → crossplane_function_pythonic-0.0.7.post3}/.gitignore

@@ -211,5 +211,6 @@ marimo/_lsp/
 __marimo__/
 
 # function-pythonic
-pythonic-packages/
 crossplane/pythonic/__version__.py
+pocs/
+pythonic-packages/

{crossplane_function_pythonic-0.0.7a0 → crossplane_function_pythonic-0.0.7.post3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crossplane-function-pythonic
-Version: 0.0.7a0
+Version: 0.0.7.post3
 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
@@ -80,7 +80,6 @@ metadata:
 spec:
   package: ghcr.io/fortra/function-pythonic:v0.0.7
 ```
-
 ## Composed Resource Dependencies
 
 function-pythonic automatically handles dependencies between composed resources.
@@ -322,6 +321,85 @@ spec:
         self.status.composite = 'Hello, World!'
 ```
 
+## 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:
+```shell
+$ pip install crossplane-function-pythonic
+```
+Then create the following files:
+#### xr.yaml
+```yaml
+apiVersion: pythonic.fortra.com/v1alpha1
+kind: Hello
+metadata:
+  name: world
+spec:
+  who: World
+```
+#### composition.yaml
+```yaml
+apiVersion: apiextensions.crossplane.io/v1
+kind: Composition
+metadata:
+  name: hellos.pythonic.fortra.com
+spec:
+  compositeTypeRef:
+    apiVersion: pythonic.fortra.com/v1alpha1
+    kind: Hello
+  mode: Pipeline
+  pipeline:
+  - step: pythonic
+    functionRef:
+      name: function-pythonic
+    input:
+      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      kind: Composite
+      composite: |
+        class Composite(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.0.7
+```
+In one terminal session, run function-pythonic:
+```shell
+$ function-pythonic --insecure --debug
+[2025-08-21 15:32:37.966] grpc._cython.cygrpc  [DEBUG   ] Using AsyncIOEngine.POLLER as I/O engine
+```
+In other terminal session, render the Composite:
+```shell
+$ crossplane render xr.yaml composition.yaml functions.yaml
+---
+apiVersion: pythonic.fortra.com/v1alpha1
+kind: Hello
+metadata:
+  name: world
+status:
+  conditions:
+  - lastTransitionTime: "2024-01-01T00:00:00Z"
+    reason: Available
+    status: "True"
+    type: Ready
+  - lastTransitionTime: "2024-01-01T00:00:00Z"
+    message: All resources are composed
+    reason: AllComposed
+    status: "True"
+    type: ResourcesComposed
+  greeting: Hello, World!
+```
+
 ## ConfigMap Packages
 
 ConfigMap based python packages are enable using the `--packages` and

{crossplane_function_pythonic-0.0.7a0 → crossplane_function_pythonic-0.0.7.post3}/README.md

@@ -59,7 +59,6 @@ metadata:
 spec:
   package: ghcr.io/fortra/function-pythonic:v0.0.7
 ```
-
 ## Composed Resource Dependencies
 
 function-pythonic automatically handles dependencies between composed resources.
@@ -301,6 +300,85 @@ spec:
         self.status.composite = 'Hello, World!'
 ```
 
+## 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:
+```shell
+$ pip install crossplane-function-pythonic
+```
+Then create the following files:
+#### xr.yaml
+```yaml
+apiVersion: pythonic.fortra.com/v1alpha1
+kind: Hello
+metadata:
+  name: world
+spec:
+  who: World
+```
+#### composition.yaml
+```yaml
+apiVersion: apiextensions.crossplane.io/v1
+kind: Composition
+metadata:
+  name: hellos.pythonic.fortra.com
+spec:
+  compositeTypeRef:
+    apiVersion: pythonic.fortra.com/v1alpha1
+    kind: Hello
+  mode: Pipeline
+  pipeline:
+  - step: pythonic
+    functionRef:
+      name: function-pythonic
+    input:
+      apiVersion: pythonic.fn.fortra.com/v1alpha1
+      kind: Composite
+      composite: |
+        class Composite(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.0.7
+```
+In one terminal session, run function-pythonic:
+```shell
+$ function-pythonic --insecure --debug
+[2025-08-21 15:32:37.966] grpc._cython.cygrpc  [DEBUG   ] Using AsyncIOEngine.POLLER as I/O engine
+```
+In other terminal session, render the Composite:
+```shell
+$ crossplane render xr.yaml composition.yaml functions.yaml
+---
+apiVersion: pythonic.fortra.com/v1alpha1
+kind: Hello
+metadata:
+  name: world
+status:
+  conditions:
+  - lastTransitionTime: "2024-01-01T00:00:00Z"
+    reason: Available
+    status: "True"
+    type: Ready
+  - lastTransitionTime: "2024-01-01T00:00:00Z"
+    message: All resources are composed
+    reason: AllComposed
+    status: "True"
+    type: ResourcesComposed
+  greeting: Hello, World!
+```
+
 ## ConfigMap Packages
 
 ConfigMap based python packages are enable using the `--packages` and

{crossplane_function_pythonic-0.0.7a0 → crossplane_function_pythonic-0.0.7.post3}/pyproject.toml

@@ -39,7 +39,13 @@ path = "crossplane/pythonic/__version__.py"
 validate-bump = false
 
 [tool.hatch.build.targets.wheel]
-packages = ["crossplane.pythonic"]
+only-include = ["crossplane"]
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+  "crossplane",
+  "examples",
+]
 
 [tool.hatch.envs.default]
 type = "virtual"

crossplane_function_pythonic-0.0.7a0/.coveragerc

@@ -1,2 +0,0 @@
-[run]
-omit = tests/*

crossplane_function_pythonic-0.0.7a0/.devcontainer/devcontainer.json

@@ -1,17 +0,0 @@
-{
-    "name": "function-pythonic-devcontainer",
-    "image": "mcr.microsoft.com/devcontainers/python:3.12-bookworm",
-    "features": {
-        "ghcr.io/devcontainers-extra/features/hatch:2": {},
-        "ghcr.io/devcontainers/features/docker-in-docker:2": {
-            "version": "latest",
-            "enableNonRootDocker": "true",
-            "moby": "false"
-        },
-        "ghcr.io/joebowbeer/devcontainers-features/crossplane:1": {
-            "channel": "stable",
-            "version": "current"
-        }
-    },
-    "postCreateCommand": "hatch env create"
-}

crossplane_function_pythonic-0.0.7a0/.github/workflows/ci.yaml

@@ -1,269 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-    - main
-    - release-*
-  pull_request: {}
-  workflow_dispatch:
-    inputs:
-      version:
-        description: Package version (e.g. v0.1.0)
-        required: false
-
-env:
-  # Common versions
-  PYTHON_VERSION: '3.13.7' # TODO: Used?
-  HATCH_VERSION: '1.12.0'
-  DOCKER_BUILDX_VERSION: 'v0.26.1'
-
-  # These environment variables are important to the Crossplane CLI install.sh
-  # script. They determine what version it installs.
-  XP_CHANNEL: stable
-  XP_VERSION: current
-
-  # This CI job will automatically push new builds to xpkg.upbound.io if the
-  # XPKG_ACCESS_ID and XPKG_TOKEN secrets are set in the GitHub respository (or
-  # organization) settings. Create a token at https://accounts.upbound.io.
-  # XPKG_ACCESS_ID: ${{ secrets.XPKG_ACCESS_ID }}
-
-  # The package to push, without a version tag. The default matches GitHub. For
-  # example xpkg.upbound.io/crossplane/function-template-go.
-  # XPKG: xpkg.upbound.io/${{ github.repository}}
-  CROSSPLANE_REGORG: ghcr.io/${{ github.repository}}
-
-  # The PyPi project version to push. The default is v0.0.0+gitdate-gitsha.
-  PYPI_VERSION: ${{ inputs.version }}
-
-  # The package version to push. The default is 0.0.0-gitsha.
-  XPKG_VERSION: ${{ inputs.version }}
-
-jobs:
-  # lint:
-  #   runs-on: ubuntu-24.04
-  #   steps:
-  #     - name: Checkout
-  #       uses: actions/checkout@v4
-
-  #     - name: Setup Python
-  #       uses: actions/setup-python@v5
-  #       with:
-  #         python-version: ${{ env.PYTHON_VERSION }}
-
-  #     - name: Setup Hatch
-  #       run: pipx install hatch==1.14.1
-
-  #     - name: Lint
-  #       run: hatch run lint:check
-
-  test:
-    runs-on: ubuntu-24.04
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v4
-
-    - name: Setup Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ env.PYTHON_VERSION }}
-
-    - name: Setup Hatch
-      run: pipx install hatch==1.14.1
-
-    - name: Run Unit Tests
-      run: hatch run test:ci
-
-    #- name: Pytest coverage comment
-    #  uses: MishaKav/pytest-coverage-comment@v1.1.54
-    #  with:
-    #    badge-title: Coverage
-    #    title: Coverage Report
-    #    pytest-xml-coverage-path: reports/pytest-coverage.xml
-    #    junitxml-title: Unit Tests
-    #    junitxml-path: reports/pytest-junit.xml
-        #hide-badge: false
-        #hide-report: false
-        #create-new-comment: false
-        #hide-comment: false
-        #report-only-changed-files: false
-        #remove-link-from-badge: false
-        #unique-id-for-comment: python3.8
-
-  build-pypi:
-    runs-on: ubuntu-24.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ env.PYTHON_VERSION }}
-
-      - name: Setup Hatch
-        run: pipx install hatch==${{ env.HATCH_VERSION }}
-
-      # If a version wasn't explicitly passed as a workflow_dispatch input we
-      # default to version v0.0.0+<git-commit-date>-<git-short-sha>, for example
-      # v0.0.0+20231101115142-1091066df799. This is a simple implementation of
-      # Go's pseudo-versions: https://go.dev/ref/mod#pseudo-versions.
-      - name: Set Default PyPI Project Version
-        if: env.PYPI_VERSION == ''
-        run: echo "PYPI_VERSION=v0.0.0+$(date -d@$(git show -s --format=%ct) +%Y%m%d%H%M%S)-$(git rev-parse --short=12 HEAD)" >> $GITHUB_ENV
-
-      - name: Set PyPI Project Version
-        run: hatch version ${{ env.PYPI_VERSION }}
-
-      - name: Build Sdist and Wheel
-        run: hatch build
-
-      - name: Upload Sdist and Wheel to GitHub
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: "dist/*"
-          if-no-files-found: error
-          retention-days: 1
-
-  # We want to build most packages for the amd64 and arm64 architectures. To
-  # speed this up we build single-platform packages in parallel. We then upload
-  # those packages to GitHub as a build artifact. The push job downloads those
-  # artifacts and pushes them as a single multi-platform package. 
-  build-xpkg:
-    needs:
-      - build-pypi
-    runs-on: ubuntu-24.04
-    strategy:
-      fail-fast: true
-      matrix:
-        arch:
-          - amd64
-          - arm64
-    steps:
-      - name: Setup QEMU
-        uses: docker/setup-qemu-action@v3
-        with:
-          platforms: all
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v3
-        with:
-          version: ${{ env.DOCKER_BUILDX_VERSION }}
-          install: true
-
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Download Wheel from GitHub
-        uses: actions/download-artifact@v5
-        with:
-          name: dist
-          pattern: '*.whl'
-          path: dist
-
-      # We ask Docker to use GitHub Action's native caching support to speed up
-      # the build, per https://docs.docker.com/build/cache/backends/gha/.
-      - name: Build Runtime
-        id: image
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          platforms: linux/${{ matrix.arch }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-          target: image
-          build-args:
-            PYTHON_VERSION=${{ env.PYTHON_VERSION }}
-          outputs: type=docker,dest=runtime-${{ matrix.arch }}.tar
-
-      - name: Setup the Crossplane CLI
-        run: "mkdir bin && cd bin && curl -sL https://raw.githubusercontent.com/crossplane/crossplane/master/install.sh | sh"
-
-      - name: Build Package
-        run: bin/crossplane xpkg build --package-file=${{ matrix.arch }}.xpkg --package-root=package/ --embed-runtime-image-tarball=runtime-${{ matrix.arch }}.tar
-
-      - name: Upload Single-Platform Package
-        uses: actions/upload-artifact@v4
-        with:
-          name: package-${{ matrix.arch }}
-          path: "*.xpkg"
-          if-no-files-found: error
-          retention-days: 1
-
-  publish-pypi:
-    # Don't publish unless we were run with an explicit version.
-    if: ${{ inputs.version != '' }}
-    needs:
-      - build-xpkg # only publish if xpkg builds succeeds
-    runs-on: ubuntu-24.04
-    steps:
-      - name: Download Sdist and Wheel from GitHub
-        uses: actions/download-artifact@v5
-        with:
-          name: dist
-          path: dist
-
-      - name: Setup Hatch
-        run: pipx install hatch==${{ env.HATCH_VERSION }}
-
-      - name: Publish to PyPI
-        env:
-          HATCH_INDEX_USER: __token__
-          HATCH_INDEX_AUTH: ${{ secrets.PYPI_API_TOKEN }}
-        run: hatch publish --no-prompt
-
-  # This job downloads the single-platform packages built by the build job, and
-  # pushes them as a multi-platform package. We only push the package it the
-  # XPKG_ACCESS_ID and XPKG_TOKEN secrets were provided.
-  push-xpkg:
-    needs:
-      - build-xpkg
-    runs-on: ubuntu-24.04
-    permissions:
-      contents: read
-      packages: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Download Single-Platform Packages
-        uses: actions/download-artifact@v4
-        with:
-          # See https://github.com/docker/build-push-action/blob/263435/README.md#summaries
-          pattern: "!*.dockerbuild"
-          path: .
-          merge-multiple: true
-
-      - name: Setup the Crossplane CLI
-        run: "mkdir bin && cd bin && curl -sL https://raw.githubusercontent.com/crossplane/crossplane/master/install.sh | sh"
-
-      # If a version wasn't explicitly passed as a workflow_dispatch input we
-      # default to version v0.0.0-<git-commit-date>-<git-short-sha>, for example
-      # v0.0.0-20231101115142-1091066df799. This is a simple implementation of
-      # Go's pseudo-versions: https://go.dev/ref/mod#pseudo-versions.
-      - name: Set Default Multi-Platform Package Version
-        if: env.XPKG_VERSION == ''
-        run: echo "XPKG_VERSION=v0.0.0-$(date -d@$(git show -s --format=%ct) +%Y%m%d%H%M%S)-$(git rev-parse --short=12 HEAD)" >> $GITHUB_ENV
-
-      # - name: Login to Upbound
-      #   uses: docker/login-action@v3
-      #   if: env.XPKG_ACCESS_ID != ''
-      #   with:
-      #     registry: xpkg.upbound.io
-      #     username: ${{ secrets.XPKG_ACCESS_ID }}
-      #     password: ${{ secrets.XPKG_TOKEN }}
-
-      # - name: Push Multi-Platform Package to Upbound
-      #   if: env.XPKG_ACCESS_ID != ''
-      #   run: "bin/crossplane --verbose xpkg push --package-files $(echo *.xpkg|tr ' ' ,) ${{ env.XPKG }}:${{ env.XPKG_VERSION }}"
-
-      - name: Login to GHCR
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.repository_owner }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Push Multi-Platform Package to GHCR
-        run: "bin/crossplane --verbose xpkg push --package-files $(echo *.xpkg|tr ' ' ,) ${{ env.CROSSPLANE_REGORG }}:${{ env.XPKG_VERSION }}"

crossplane_function_pythonic-0.0.7a0/.venv-default/.gitignore

@@ -1,2 +0,0 @@
-# created by virtualenv automatically
-*

crossplane_function_pythonic-0.0.7a0/.venv-default/CACHEDIR.TAG

@@ -1,4 +0,0 @@
-Signature: 8a477f597d28d172789f06886806bc55
-# This file is a cache directory tag created by Python virtualenv.
-# For information about cache directory tags, see:
-#   https://bford.info/cachedir/

crossplane_function_pythonic-0.0.7a0/.venv-default/bin/activate

@@ -1,87 +0,0 @@
-# This file must be used with "source bin/activate" *from bash*
-# you cannot run it directly
-
-
-if [ "${BASH_SOURCE-}" = "$0" ]; then
-    echo "You must source this script: \$ source $0" >&2
-    exit 33
-fi
-
-deactivate () {
-    unset -f pydoc >/dev/null 2>&1 || true
-
-    # reset old environment variables
-    # ! [ -z ${VAR+_} ] returns true if VAR is declared at all
-    if ! [ -z "${_OLD_VIRTUAL_PATH:+_}" ] ; then
-        PATH="$_OLD_VIRTUAL_PATH"
-        export PATH
-        unset _OLD_VIRTUAL_PATH
-    fi
-    if ! [ -z "${_OLD_VIRTUAL_PYTHONHOME+_}" ] ; then
-        PYTHONHOME="$_OLD_VIRTUAL_PYTHONHOME"
-        export PYTHONHOME
-        unset _OLD_VIRTUAL_PYTHONHOME
-    fi
-
-    # The hash command must be called to get it to forget past
-    # commands. Without forgetting past commands the $PATH changes
-    # we made may not be respected
-    hash -r 2>/dev/null
-
-    if ! [ -z "${_OLD_VIRTUAL_PS1+_}" ] ; then
-        PS1="$_OLD_VIRTUAL_PS1"
-        export PS1
-        unset _OLD_VIRTUAL_PS1
-    fi
-
-    unset VIRTUAL_ENV
-    unset VIRTUAL_ENV_PROMPT
-    if [ ! "${1-}" = "nondestructive" ] ; then
-    # Self destruct!
-        unset -f deactivate
-    fi
-}
-
-# unset irrelevant variables
-deactivate nondestructive
-
-VIRTUAL_ENV=/Users/pmcnerthney/src/iciclespider/function-pythonic/.venv-default
-if ([ "$OSTYPE" = "cygwin" ] || [ "$OSTYPE" = "msys" ]) && $(command -v cygpath &> /dev/null) ; then
-    VIRTUAL_ENV=$(cygpath -u "$VIRTUAL_ENV")
-fi
-export VIRTUAL_ENV
-
-_OLD_VIRTUAL_PATH="$PATH"
-PATH="$VIRTUAL_ENV/"bin":$PATH"
-export PATH
-
-if [ "x"'' != x ] ; then
-    VIRTUAL_ENV_PROMPT=''
-else
-    VIRTUAL_ENV_PROMPT=$(basename "$VIRTUAL_ENV")
-fi
-export VIRTUAL_ENV_PROMPT
-
-# unset PYTHONHOME if set
-if ! [ -z "${PYTHONHOME+_}" ] ; then
-    _OLD_VIRTUAL_PYTHONHOME="$PYTHONHOME"
-    unset PYTHONHOME
-fi
-
-if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT-}" ] ; then
-    _OLD_VIRTUAL_PS1="${PS1-}"
-    PS1="(${VIRTUAL_ENV_PROMPT}) ${PS1-}"
-    export PS1
-fi
-
-# Make sure to unalias pydoc if it's already there
-alias pydoc 2>/dev/null >/dev/null && unalias pydoc || true
-
-pydoc () {
-    python -m pydoc "$@"
-}
-
-# The hash command must be called to get it to forget past
-# commands. Without forgetting past commands the $PATH changes
-# we made may not be respected
-hash -r 2>/dev/null || true

crossplane_function_pythonic-0.0.7a0/.venv-default/bin/activate.csh

@@ -1,55 +0,0 @@
-# This file must be used with "source bin/activate.csh" *from csh*.
-# You cannot run it directly.
-# Created by Davide Di Blasi <davidedb@gmail.com>.
-
-set newline='\
-'
-
-alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH:q" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT:q" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; unsetenv VIRTUAL_ENV_PROMPT; test "\!:*" != "nondestructive" && unalias deactivate && unalias pydoc'
-
-# Unset irrelevant variables.
-deactivate nondestructive
-
-setenv VIRTUAL_ENV /Users/pmcnerthney/src/iciclespider/function-pythonic/.venv-default
-
-set _OLD_VIRTUAL_PATH="$PATH:q"
-setenv PATH "$VIRTUAL_ENV:q/"bin":$PATH:q"
-
-
-
-if ('' != "") then
-    setenv VIRTUAL_ENV_PROMPT ''
-else
-    setenv VIRTUAL_ENV_PROMPT "$VIRTUAL_ENV:t:q"
-endif
-
-if ( $?VIRTUAL_ENV_DISABLE_PROMPT ) then
-    if ( $VIRTUAL_ENV_DISABLE_PROMPT == "" ) then
-        set do_prompt = "1"
-    else
-        set do_prompt = "0"
-    endif
-else
-    set do_prompt = "1"
-endif
-
-if ( $do_prompt == "1" ) then
-    # Could be in a non-interactive environment,
-    # in which case, $prompt is undefined and we wouldn't
-    # care about the prompt anyway.
-    if ( $?prompt ) then
-        set _OLD_VIRTUAL_PROMPT="$prompt:q"
-        if ( "$prompt:q" =~ *"$newline:q"* ) then
-            :
-        else
-            set prompt = '('"$VIRTUAL_ENV_PROMPT:q"') '"$prompt:q"
-        endif
-    endif
-endif
-
-unset env_name
-unset do_prompt
-
-alias pydoc python -m pydoc
-
-rehash