Server Test Python

rev. 1d902e1fdfff69f8aafe42b2306fa317ef96d562

Files changed:

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/error/init.pyi

@@ -1,0 +28,0 @@

 import typing
 import unique_items.model
--
 class InternalServerError(Exception):
     message: str
--
     def __init__(self, message: str) -> None:
         ...
--
--
 class ValidationException(Exception):
     """
     A standard error for input validation failures. This should be thrown by services when a member of the input structure falls outside of the modeled or documented constraints.
     """
--
     field_list: typing.Optional[typing.List[unique_items.model.ValidationExceptionField]]
     """
     A list of specific failures encountered while validating the input. A member can appear in this list more than once if it failed to satisfy multiple constraints.
     """
--
     message: str
     """
     A summary of the validation failure.
     """
--
     def __init__(self, message: str, field_list: typing.Optional[typing.List[unique_items.model.ValidationExceptionField]] = ...) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/input/init.pyi

@@ -1,0 +11,0 @@

 import typing
 import unique_items.model
--
 class MalformedUniqueItemsInput:
     complex_set: typing.Optional[typing.List[unique_items.model.ComplexSetStruct]]
--
     set: typing.Optional[typing.List[str]]
--
     def __init__(self, set: typing.Optional[typing.List[str]] = ..., complex_set: typing.Optional[typing.List[unique_items.model.ComplexSetStruct]] = ...) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/logging/init.pyi

@@ -1,0 +26,0 @@

 import pathlib
 import typing
--
 class TracingHandler:
     """
     Modifies the Python `logging` module to deliver its log messages using [tracing::Subscriber] events.
--
     To achieve this goal, the following changes are made to the module:
     - A new builtin function `logging.py_tracing_event` transcodes `logging.LogRecord`s to `tracing::Event`s. This function
       is not exported in `logging.__all__`, as it is not intended to be called directly.
     - A new class `logging.TracingHandler` provides a `logging.Handler` that delivers all records to `python_tracing`.
     """
--
     def handler(self) -> typing.Any:
         ...
--
--
     def __init__(self, level: typing.Optional[int] = ..., logfile: typing.Optional[pathlib.Path] = ..., format: typing.Optional[typing.Literal['compact', 'pretty', 'json']] = ...) -> None:
         ...
--
--
 def py_tracing_event() -> None:
     """
     Consumes a Python `logging.LogRecord` and emits a Rust [tracing::Event] instead.
     """
     ...

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/middleware/init.pyi

@@ -1,0 +78,0 @@

 import typing
--
 class MiddlewareException(Exception):
     """
     Exception that can be thrown from a Python middleware.
--
     It allows to specify a message and HTTP status code and implementing protocol specific capabilities
     to build a [aws_smithy_http_server::response::Response] from it.
     """
--
     message: str
--
     status_code: int
--
     def __init__(self, message: str, status_code: typing.Optional[int] = ...) -> None:
         ...
--
--
 class Request:
     """
     Python-compatible [Request] object.
     """
--
     body: typing.Awaitable[bytes]
     """
     Return the HTTP body of this request.
     Note that this is a costly operation because the whole request body is cloned.
     """
--
     headers: typing.MutableMapping[str, str]
     """
     Return the HTTP headers of this request.
     """
--
     method: str
     """
     Return the HTTP method of this request.
     """
--
     uri: str
     """
     Return the URI of this request.
     """
--
     version: str
     """
     Return the HTTP version of this request.
     """
--
 class Response:
     """
     Python-compatible [Response] object.
     """
--
     body: typing.Awaitable[bytes]
     """
     Return the HTTP body of this response.
     Note that this is a costly operation because the whole response body is cloned.
     """
--
     headers: typing.MutableMapping[str, str]
     """
     Return the HTTP headers of this response.
     """
--
     status: int
     """
     Return the HTTP status of this response.
     """
--
     version: str
     """
     Return the HTTP version of this response.
     """
--
     def __init__(self, status: int, headers: typing.Optional[typing.Dict[str, str]] = ..., body: typing.Optional[bytes] = ...) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/model/init.pyi

@@ -1,0 +30,0 @@

 import typing
 import unique_items.types
--
 class ComplexSetStruct:
     blob: typing.Optional[unique_items.types.Blob]
--
     foo: typing.Optional[bool]
--
     def __init__(self, foo: typing.Optional[bool] = ..., blob: typing.Optional[unique_items.types.Blob] = ...) -> None:
         ...
--
--
 class ValidationExceptionField:
     """
     Describes one specific validation failure for an input member.
     """
--
     message: str
     """
     A detailed description of the validation failure.
     """
--
     path: str
     """
     A JSONPointer expression to the structure member whose value failed to satisfy the modeled constraints.
     """
--
     def __init__(self, path: str, message: str) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/output/init.pyi

@@ -1,0 +6,0 @@

--
--
 class MalformedUniqueItemsOutput:
     def __init__(self) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/socket/init.pyi

@@ -1,0 +27,0 @@

 import typing
--
 class PySocket:
     """
     Socket implementation that can be shared between multiple Python processes.
--
     Python cannot handle true multi-threaded applications due to the [GIL],
     often resulting in reduced performance and only one core used by the application.
     To work around this, Python web applications usually create a socket with
     SO_REUSEADDR and SO_REUSEPORT enabled that can be shared between multiple
     Python processes, allowing you to maximize performance and use all available
     computing capacity of the host.
--
     [GIL]: https://wiki.python.org/moin/GlobalInterpreterLock
     """
--
     def try_clone(self) -> PySocket:
         """
         Clone the inner socket allowing it to be shared between multiple
         Python processes.
         """
         ...
--
--
     def __init__(self, address: str, port: int, backlog: typing.Optional[int] = ...) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/tls/init.pyi

@@ -1,0 +10,0 @@

 import pathlib
--
 class TlsConfig:
     """
     PyTlsConfig represents TLS configuration created from Python.
     """
--
     def __init__(self, key_path: pathlib.Path, cert_path: pathlib.Path, reload_secs: int = ...) -> None:
         ...
--

tmp-codegen-diff/codegen-server-test-python/unique_items/rust-server-codegen-python/python/unique_items/types/init.pyi

@@ -1,0 +209,0 @@

 import typing
--
 class Blob:
     """
     Python Wrapper for [aws_smithy_types::Blob].
     """
--
     data: bytes
     """
     Python getter for the `Blob` byte array.
     """
--
     def __init__(self, input: bytes) -> None:
         ...
--
--
 class ByteStream:
     """
     Python Wrapper for [aws_smithy_types::byte_stream::ByteStream].
--
     ByteStream provides misuse-resistant primitives to make it easier to handle common patterns with streaming data.
--
     On the Rust side, The Python implementation wraps the original [ByteStream](aws_smithy_types::byte_stream::ByteStream)
     in a clonable structure and implements the [Stream](futures::stream::Stream) trait for it to
     allow Rust to handle the type transparently.
--
     On the Python side both sync and async iterators are exposed by implementing `__iter__()` and `__aiter__()` magic methods,
     which allows to just loop over the stream chunks.
--
     ### Example of async streaming:
--
     ```python
         stream = await ByteStream.from_path("/tmp/music.mp3")
         async for chunk in stream:
             print(chunk)
     ```
--
     ### Example of sync streaming:
--
     ```python
         stream = ByteStream.from_stream_blocking("/tmp/music.mp3")
         for chunk in stream:
             print(chunk)
     ```
--
     The main difference between the two implementations is that the async one is scheduling the Python coroutines as Rust futures,
     effectively maintaining the asyncronous behavior that Rust exposes, while the sync one is blocking the Tokio runtime to be able
     to await one chunk at a time.
--
     The original Rust [ByteStream](aws_smithy_types::byte_stream::ByteStream) is wrapped inside a `Arc<Mutex>` to allow the type to be
     [Clone] (required by PyO3) and to allow internal mutability, required to fetch the next chunk of data.
     """
--
     @staticmethod
     def from_path(path: str) -> typing.Awaitable[ByteStream]:
         """
         Create a new [ByteStream](aws_smithy_types::byte_stream::ByteStream) from a path, forcing
         Python to await this coroutine.
         """
         ...
--
--
     @staticmethod
     def from_path_blocking(path: str) -> ByteStream:
         """
         Create a new [ByteStream](aws_smithy_types::byte_stream::ByteStream) from a path, without
         requiring Python to await this method.
--
         **NOTE:** This method will block the Rust event loop when it is running.
         """
         ...
--
--
     def __init__(self, input: bytes) -> None:
         ...
--
--
 class DateTime:
     """
     Python Wrapper for [aws_smithy_types::date_time::DateTime].
     """
--
     def as_nanos(self) -> int:
         """
         Returns the number of nanoseconds since the Unix epoch that this `DateTime` represents.
         """
         ...
--
--
     def as_secs_f64(self) -> float:
         """
         Returns the `DateTime` value as an `f64` representing the seconds since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_fractional_secs(epoch_seconds: int, fraction: float) -> DateTime:
         """
         Creates a `DateTime` from a number of seconds and a fractional second since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_millis(epoch_millis: int) -> DateTime:
         """
         Creates a `DateTime` from a number of milliseconds since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_nanos(epoch_nanos: int) -> DateTime:
         """
         Creates a `DateTime` from a number of nanoseconds since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_secs(epoch_seconds: int) -> DateTime:
         """
         Creates a `DateTime` from a number of seconds since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_secs_and_nanos(seconds: int, subsecond_nanos: int) -> DateTime:
         """
         Creates a `DateTime` from a number of seconds and sub-second nanos since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_secs_f64(epoch_seconds: float) -> DateTime:
         """
         Creates a `DateTime` from an `f64` representing the number of seconds since the Unix epoch.
         """
         ...
--
--
     @staticmethod
     def from_str(s: str, format: Format) -> DateTime:
         """
         Parses a `DateTime` from a string using the given `format`.
         """
         ...
--
--
     def has_subsec_nanos(self) -> bool:
         """
         Returns true if sub-second nanos is greater than zero.
         """
         ...
--
--
     @staticmethod
     def read(format: Format, delim: str) -> typing.Tuple[DateTime, str]:
         """
         Read 1 date of `format` from `s`, expecting either `delim` or EOF.
--
         TODO(PythonTyping): How do we represent `char` in Python?
         """
         ...
--
--
     def secs(self) -> int:
         """
         Returns the epoch seconds component of the `DateTime`.
         """
         ...
--
--
     def subsec_nanos(self) -> int:
         """
         Returns the sub-second nanos component of the `DateTime`.
         """
         ...
--
--
     def to_millis(self) -> int:
         """
         Converts the `DateTime` to the number of milliseconds since the Unix epoch.
         """
         ...
--
--
 class Format:
     """
     Formats for representing a `DateTime` in the Smithy protocols.
     """
--
     DateTime: Format
     """
     Formats for representing a `DateTime` in the Smithy protocols.
     """
--
     EpochSeconds: Format
     """
     Formats for representing a `DateTime` in the Smithy protocols.
     """
--
     HttpDate: Format
     """
     Formats for representing a `DateTime` in the Smithy protocols.
     """

Pages: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17