jopy 0.1.0__py3-none-any.whl

jopy/__init__.py

@@ -0,0 +1,167 @@
+"""jopy - a Python to Java transpiler.
+
+jopy parses Python source with a hand written lexer and recursive descent
+parser, infers Java types, and emits readable Java source that targets every
+release from Java 9 to Java 21.
+
+Quick start::
+
+    import jopy
+
+    result = jopy.translate("def add(a, b):\n    return a + b\n", filename="math_utils.py")
+    print(result.java)
+    for note in result.manual_fixes:
+        print("needs manual work:", note.message)
+
+Or from a shell::
+
+    jopy math_utils.py -o build/java --java-version 17 --compile
+
+Progress reporting adapts to the caller: an interactive terminal gets a bar,
+while a programmatic call with no terminal attached receives JSON lines that
+describe the same work.
+"""
+
+from __future__ import annotations
+
+from .api import (
+    RUNTIME_FILES,
+    SOURCE_SUFFIXES,
+    VERSION,
+    TranslateOptions,
+    TranslationResult,
+    Translator,
+    collect_sources,
+    compile_java,
+    convert,
+    convert_file,
+    find_javac,
+    javac_release_supported,
+    javac_version,
+    python_to_java,
+    runtime_directory,
+    runtime_source,
+    supported_versions,
+    to_java,
+    translate,
+    translate_directory,
+    translate_file,
+    translate_path,
+    write_runtime,
+)
+from .jdk import (
+    DEFAULT_VENDOR,
+    VENDORS,
+    JdkInfo,
+    default_jdk_root,
+    find_jdk,
+    install_jdk,
+    installed_jdks,
+    vendor_url,
+)
+from .ast_nodes import Module, ast_to_dict
+from .codegen import CodeGenerator, CodegenOptions, GeneratedFile
+from .errors import (
+    Diagnostic,
+    DiagnosticCollector,
+    JopyConfigError,
+    JopyError,
+    JopyGenerationError,
+    JopyJavaCompileError,
+    JopySyntaxError,
+    JopyTypeError,
+    JopyUnsupportedError,
+    SourceLocation,
+    format_diagnostics,
+)
+from .features import DEFAULT_VERSION, SUPPORTED_VERSIONS, JavaFeatures
+from .lexer import LexedSource, lex
+from .parser import Parser, parse, parse_expression_text
+from .progress import (
+    JsonProgress,
+    NullProgress,
+    ProgressEvent,
+    ProgressReporter,
+    TerminalProgress,
+    format_duration,
+    stage_plan,
+)
+
+__version__ = VERSION
+
+__all__ = [
+    "__version__",
+    # high level API
+    "translate",
+    "translate_file",
+    "translate_directory",
+    "translate_path",
+    "to_java",
+    "convert",
+    "convert_file",
+    "python_to_java",
+    "Translator",
+    "TranslateOptions",
+    "TranslationResult",
+    "collect_sources",
+    # front end
+    "lex",
+    "parse",
+    "parse_expression_text",
+    "Parser",
+    "LexedSource",
+    "Module",
+    "ast_to_dict",
+    # back end
+    "CodeGenerator",
+    "CodegenOptions",
+    "GeneratedFile",
+    "JavaFeatures",
+    "DEFAULT_VERSION",
+    "SUPPORTED_VERSIONS",
+    # progress
+    "ProgressReporter",
+    "ProgressEvent",
+    "TerminalProgress",
+    "JsonProgress",
+    "NullProgress",
+    "stage_plan",
+    "format_duration",
+    # runtime and verification
+    "runtime_source",
+    "runtime_directory",
+    "write_runtime",
+    "RUNTIME_FILES",
+    "SOURCE_SUFFIXES",
+    "compile_java",
+    "find_javac",
+    "javac_version",
+    "javac_release_supported",
+    "supported_versions",
+    # JDK provisioning
+    "install_jdk",
+    "find_jdk",
+    "installed_jdks",
+    "vendor_url",
+    "default_jdk_root",
+    "JdkInfo",
+    "DEFAULT_VENDOR",
+    "VENDORS",
+    # diagnostics
+    "JopyError",
+    "JopySyntaxError",
+    "JopyUnsupportedError",
+    "JopyTypeError",
+    "JopyGenerationError",
+    "JopyJavaCompileError",
+    "JopyConfigError",
+    "Diagnostic",
+    "DiagnosticCollector",
+    "SourceLocation",
+    "format_diagnostics",
+]
+
+
+def translate_source(source: str, filename: str = "<memory>", **kwargs) -> TranslationResult:
+    """Translate Python source text (alias of translate)."""
+    return translate(source, filename, **kwargs)

jopy/__main__.py

@@ -0,0 +1,10 @@
+"""Allow running the translator with python -m jopy."""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())