crossplane-function-pythonic 0.1.4__tar.gz → 0.2.0__tar.gz

crossplane_function_pythonic-0.1.4/README.md → crossplane_function_pythonic-0.2.0/PKG-INFO

@@ -1,3 +1,27 @@
+Metadata-Version: 2.4
+Name: crossplane-function-pythonic
+Version: 0.2.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-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: crossplane-function-sdk-python==0.10.0
+Requires-Dist: pyyaml==6.0.3
+Provides-Extra: packages
+Requires-Dist: kopf==1.39.1; extra == 'packages'
+Provides-Extra: pip-install
+Requires-Dist: pip==25.3; extra == 'pip-install'
+Description-Content-Type: text/markdown
+
 # function-pythonic
 
 ## Introduction
@@ -21,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):
@@ -57,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
 
@@ -203,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 |
 
@@ -302,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
 
@@ -324,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
@@ -337,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
@@ -358,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:
@@ -369,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
 
@@ -441,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
@@ -473,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
     ...
@@ -487,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
 ---
@@ -580,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.1.4/PKG-INFO → crossplane_function_pythonic-0.2.0/README.md

@@ -1,27 +1,3 @@
-Metadata-Version: 2.4
-Name: crossplane-function-pythonic
-Version: 0.1.4
-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
-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
-Provides-Extra: packages
-Requires-Dist: kopf==1.38.0; extra == 'packages'
-Provides-Extra: pip-install
-Requires-Dist: pip==25.2; extra == 'pip-install'
-Description-Content-Type: text/markdown
-
 # function-pythonic
 
 ## Introduction
@@ -45,11 +21,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 +57,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 +203,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 +302,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 +324,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 +337,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 +404,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 +415,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 +475,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 +507,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 +521,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 +614,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/crossplane/pythonic/__about__.py

@@ -0,0 +1,2 @@
+# This is set at build time, using "hatch version"
+__version__ = "0.2.0"

crossplane_function_pythonic-0.2.0/crossplane/pythonic/__main__.py

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

crossplane_function_pythonic-0.2.0/crossplane/pythonic/command.py

@@ -0,0 +1,102 @@
+
+import logging
+import pathlib
+import sys
+
+
+class Command:
+    name = None
+    command = None
+    description = None
+
+    @classmethod
+    def create(cls, subparsers):
+        parser = subparsers.add_parser(cls.name, help=cls.help, description=cls.description)
+        parser.set_defaults(command=cls)
+        cls.add_parser_arguments(parser)
+
+    @classmethod
+    def add_parser_arguments(cls, parser):
+        pass
+
+    @classmethod
+    def add_function_arguments(cls, parser):
+        parser.add_argument(
+            '--debug', '-d',
+            action='store_true',
+            help='Emit debug logs.',
+        )
+        parser.add_argument(
+            '--log-name-width',
+            type=int,
+            default=40,
+            metavar='WIDTH',
+            help='Width of the logger name in the log output, default 40.',
+        )
+        parser.add_argument(
+            '--python-path',
+            action='append',
+            default=[],
+            metavar='DIRECTORY',
+            help='Filing system directories to add to the python path.',
+        )
+        parser.add_argument(
+            '--render-unknowns', '-u',
+            action='store_true',
+            help='Render resources with unknowns, useful during local development.'
+        )
+        parser.add_argument(
+            '--allow-oversize-protos',
+            action='store_true',
+            help='Allow oversized protobuf messages',
+        )
+
+    def __init__(self, args):
+        self.args = args
+        self.initialize()
+
+    def initialize(self):
+        pass
+
+    def initialize_function(self):
+        formatter = Formatter(self.args.log_name_width)
+        handler = logging.StreamHandler(sys.stdout)
+        handler.setFormatter(formatter)
+        logger = logging.getLogger()
+        logger.handlers = [handler]
+        logger.setLevel(logging.DEBUG if self.args.debug else logging.INFO)
+
+        for path in reversed(self.args.python_path):
+            sys.path.insert(0, str(pathlib.Path(path).expanduser().resolve()))
+
+        if self.args.allow_oversize_protos:
+            from google.protobuf.internal import api_implementation
+            if api_implementation._c_module:
+                api_implementation._c_module.SetAllowOversizeProtos(True)
+
+    async def run(self):
+        raise NotImplementedError()
+
+
+class Formatter(logging.Formatter):
+    def __init__(self, name_width):
+        super(Formatter, self).__init__(
+            f"[{{asctime}}.{{msecs:03.0f}}] {{sname:{name_width}.{name_width}}} [{{levelname:8.8}}] {{message}}",
+            '%Y-%m-%d %H:%M:%S',
+            '{',
+        )
+        self.name_width = name_width
+
+    def format(self, record):
+        record.sname = record.name
+        extra = len(record.sname) - self.name_width
+        if extra > 0:
+            names = record.sname.split('.')
+            for ix, name in enumerate(names):
+                if len(name) > extra:
+                    names[ix] = name[extra:]
+                    break
+                names[ix] = name[:1]
+                extra -= len(name) - 1
+            record.sname = '.'.join(names)
+        return super(Formatter, self).format(record)