31a16fbb40
### What changes were proposed in this pull request? This PR proposes migration of [`pyspark-stubs`](https://github.com/zero323/pyspark-stubs) into Spark codebase. ### Why are the changes needed? ### Does this PR introduce _any_ user-facing change? Yes. This PR adds type annotations directly to Spark source. This can impact interaction with development tools for users, which haven't used `pyspark-stubs`. ### How was this patch tested? - [x] MyPy tests of the PySpark source ``` mypy --no-incremental --config python/mypy.ini python/pyspark ``` - [x] MyPy tests of Spark examples ``` MYPYPATH=python/ mypy --no-incremental --config python/mypy.ini examples/src/main/python/ml examples/src/main/python/sql examples/src/main/python/sql/streaming ``` - [x] Existing Flake8 linter - [x] Existing unit tests Tested against: - `mypy==0.790+dev.e959952d9001e9713d329a2f9b196705b028f894` - `mypy==0.782` Closes #29591 from zero323/SPARK-32681. Authored-by: zero323 <mszymkiewicz@gmail.com> Signed-off-by: HyukjinKwon <gurwls223@apache.org>
58 lines
1.8 KiB
Python
58 lines
1.8 KiB
Python
#
|
|
# Licensed to the Apache Software Foundation (ASF) under one
|
|
# or more contributor license agreements. See the NOTICE file
|
|
# distributed with this work for additional information
|
|
# regarding copyright ownership. The ASF licenses this file
|
|
# to you under the Apache License, Version 2.0 (the
|
|
# "License"); you may not use this file except in compliance
|
|
# with the License. You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing,
|
|
# software distributed under the License is distributed on an
|
|
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
# KIND, either express or implied. See the License for the
|
|
# specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
from typing import (
|
|
Any,
|
|
List,
|
|
Optional,
|
|
Tuple,
|
|
TypeVar,
|
|
Union,
|
|
)
|
|
from typing_extensions import Protocol
|
|
|
|
import datetime
|
|
import decimal
|
|
|
|
from pyspark._typing import PrimitiveType
|
|
import pyspark.sql.column
|
|
import pyspark.sql.types
|
|
from pyspark.sql.column import Column
|
|
|
|
ColumnOrName = Union[pyspark.sql.column.Column, str]
|
|
DecimalLiteral = decimal.Decimal
|
|
DateTimeLiteral = Union[datetime.datetime, datetime.date]
|
|
LiteralType = PrimitiveType
|
|
AtomicDataTypeOrString = Union[pyspark.sql.types.AtomicType, str]
|
|
DataTypeOrString = Union[pyspark.sql.types.DataType, str]
|
|
OptionalPrimitiveType = Optional[PrimitiveType]
|
|
|
|
RowLike = TypeVar("RowLike", List[Any], Tuple[Any, ...], pyspark.sql.types.Row)
|
|
|
|
class SupportsOpen(Protocol):
|
|
def open(self, partition_id: int, epoch_id: int) -> bool: ...
|
|
|
|
class SupportsProcess(Protocol):
|
|
def process(self, row: pyspark.sql.types.Row) -> None: ...
|
|
|
|
class SupportsClose(Protocol):
|
|
def close(self, error: Exception) -> None: ...
|
|
|
|
class UserDefinedFunctionLike(Protocol):
|
|
def __call__(self, *_: ColumnOrName) -> Column: ...
|