Pre-release

This release is a pre-release and may not be stable for production use.

basedpython

a Python-like language that transpiles to pure Python

acknowledgements

basedpython is a fork of astral-sh/ruff. the transpiler reuses ruff's parser (ruff_python_parser), AST (ruff_python_ast), and fix-application machinery (ruff_diagnostics::Edit/Fix), and the type checker is built on ty. none of this would exist without the work of the astral team and the wider ruff community

installation

uv add --dev basedpython

usage

# run a module
by run main

# build all .by files to out/
by build

# low-level: transpile a single file to stdout
by transpile file.by
echo 'x[(a, b)]' | by transpile

options

# target a minimum Python version (default: 3.10)
by --min-version 3.11 run main
by --min-version 3.12 build

features

anonymous named tuple syntax

write a structural record inline, no separate class or NamedTuple import. identical shapes anywhere in the module collapse to a single hoisted typing.NamedTuple subclass, so structural equality is preserved at the type level:

def user(x: (name: str, age: int)) -> (name: str, age: int):
    return ("charlie", 36)

a = (name: str, age: int)

mixed positional/named shapes are allowed

mutable default argument via lazy evaluation

mutable default arguments are automatically rewritten to the sentinel pattern:

# input
def f(x=[], y={}):
    pass

# output
_MISSING = object()
def f(x=_MISSING, y=_MISSING):
    if x is _MISSING:
        x = []
    if y is _MISSING:
        y = {}
    pass

callable syntax

write callable types with arrow syntax. denotable shapes transpile to typing.Callable; non-denotable shapes (named params, / / * markers, variadics, kwargs) synthesize a hoisted typing.Protocol with __call__:

# input
f: (int, str) -> bool
g: () -> None
h: (a: int, *args: str) -> bool

# output
from typing import Callable, Protocol
f: Callable[[int, str], bool]
g: Callable[[], None]

class _Callable_abcde(Protocol):
    def __call__(self, a: int, /, *args: str) -> bool: ...

h: _Callable_abcde

identical non-denotable shapes anywhere in the module collapse to a single synthesized protocol. nested arrows ((int) -> (str) -> bool) nest the Callables

python version polyfills

basedpython lets you write code in modern python syntax and run it on older interpreters. when --min-version is below the version that first introduced a feature, the transpiler rewrites that feature into an equivalent shape that runs on the target interpreter — a "polyfill". if the target already has the feature natively, the polyfill is a no-op and the source survives unchanged

a few rules hold for every polyfill:

opt-in by target — only triggered when --min-version is below the feature's introduction version. raise the floor to drop the rewrite
shape-preserving — the rewritten code has the same runtime semantics and, where reasonable, the same static-typing behaviour as the original
no runtime dependency on basedpython — output is plain python; the generated code does not call back into a basedpython runtime

PEP 695 generics (3.12 → 3.10):

# input
class Stack[T]:
    items: list[T]

def identity[T](x: T) -> T:
    return x

type Vector = list[float]

# output
from typing import TypeVar, Generic, TypeAlias
_T = TypeVar("_T")
class Stack(Generic[_T]):
    items: list[_T]

_T = TypeVar("_T")
def identity(x: _T) -> _T:
    return x

Vector: TypeAlias = list[float]

typing import redirect — names not available in stdlib until a later version are automatically redirected to typing_extensions:

# input (targeting 3.10)
from typing import Self, Never, override

# output
from typing_extensions import Self, Never, override

expression rewrites (targeting < 3.11):

datetime.UTC          →  datetime.timezone.utc
sys.exception()       →  sys.exc_info()[1]
math.exp2(x)          →  2 ** (x)

multiline strings

triple-quoted strings opening with """\n and consistent leading indentation get their common indent stripped at compile time. no textwrap.dedent import, no runtime cost:

# input
text = """
    hello
        world
    """

# output
text = """\
hello
    world\
"""

None operators

`?.` — optional attribute access

a?.b short-circuits to None when a is None. chains use a walrus to avoid evaluating compound prefixes twice:

# input
x = user?.profile?.name

# output
x = None if user is None else None if (_t := user.profile) is None else _t.name

`??` — None-coalesce

a ?? b returns a when non-None, otherwise b:

# input
x = a ?? b

# output
x = a if a is not None else b

composes with ?. — the expanded chain is shared via a walrus so the prefix runs once:

# input
y = a?.a.b ?? 1

# output
y = _t if (_t := None if a is None else a.a.b) is not None else 1

modifier keywords

basedpython exposes the common decorator-driven idioms as bare keywords so declarations stay readable. each keyword lowers to the equivalent decorator, base class, or annotation and the matching import is added automatically:

keyword (input)	output
`final class A`	`@final` on `class A`
`final def f()`	`@final` on `def f()`
`override def f()`	`@override` on `def f()`
`abstract def f()`	`@abstractmethod` on `def f()`
`static def f()`	`@staticmethod` on `def f()`
`class def f()`	`@classmethod` on `def f()`
`data class A`	`@dataclass(slots=True)` on `A`
`frozen data class A`	`@dataclass(frozen=True, slots=True)` on `A`
`enum class B`	`class B(Enum)`
`protocol Foo`	`class Foo(Protocol)`
`let x = 5`	`x: Final = 5`
`class a = 1` (class body)	`a: ClassVar = 1`
`newtype MyInt = int`	`MyInt = NewType("MyInt", int)`

modifiers stack — final data class A and override final def f() both work. example:

# input
final data class A:
    let x = 1
    class y = 2

    override def render(self): ...
    class def from_str(cls, s): ...
    static def helper(): ...

protocol Drawable:
    def draw(self): ...

enum class Color:
    RED = 1
    GREEN = 2

newtype UserId = int

# output
from abc import abstractmethod
from dataclasses import dataclass
from enum import Enum
from typing import ClassVar, Final, NewType, Protocol, final

@final
@dataclass(slots=True)
class A:
    x: Final = 1
    y: ClassVar = 2

    @override
    def render(self): ...
    @classmethod
    def from_str(cls, s): ...
    @staticmethod
    def helper(): ...

class Drawable(Protocol):
    def draw(self): ...

class Color(Enum):
    RED = 1
    GREEN = 2

UserId = NewType("UserId", int)

visibility modifiers

public and private mark def and class declarations. behaviour depends on whether the declaration is at module scope or inside a class body:

# input
public def api(): ...
private def helper(): ...
def untouched(): ...

# output
def api(): ...
def _helper(): ...
def untouched(): ...
__all__ = ["api"]

public at module scope — modifier stripped, name appended to an auto-generated __all__
private at module scope — modifier stripped, declaration renamed with a leading _ (the conventional python "internal" marker)
private inside a class body — declaration renamed with a leading __ so python's name-mangling hides it from subclass scope
public inside a class body — modifier stripped, no rename, no __all__ impact

api lock file

by generate-api-file walks every module and emits a deterministic, line-oriented summary of the project's public type-level surface to api.lock

the file is meant to be diffed, not parsed. any meaningful change to a public symbol — a new parameter, a widened return type, a renamed class, a removed attribute — surfaces as a line-level diff in code review

usage:

# write api.lock at the project root
by generate-api-file

# pick a path
by generate-api-file -o public.lock

# print to stdout (useful in CI to compare against committed lockfile)
by generate-api-file --stdout

commit api.lock and treat any unexpected diff in a PR as a public-api breakage signal

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

basedpython-0.0.1a3.tar.gz (9.3 MB view details)

Uploaded Jul 13, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

basedpython-0.0.1a3-py3-none-win_arm64.whl (24.3 MB view details)

Uploaded Jul 13, 2026 Python 3Windows ARM64

basedpython-0.0.1a3-py3-none-win_amd64.whl (25.6 MB view details)

Uploaded Jul 13, 2026 Python 3Windows x86-64

basedpython-0.0.1a3-py3-none-win32.whl (23.3 MB view details)

Uploaded Jul 13, 2026 Python 3Windows x86

basedpython-0.0.1a3-py3-none-musllinux_1_2_x86_64.whl (25.8 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ x86-64

basedpython-0.0.1a3-py3-none-musllinux_1_2_i686.whl (25.6 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ i686

basedpython-0.0.1a3-py3-none-musllinux_1_2_armv7l.whl (23.3 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ ARMv7l

basedpython-0.0.1a3-py3-none-musllinux_1_2_aarch64.whl (24.0 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ ARM64

basedpython-0.0.1a3-py3-none-manylinux_2_31_riscv64.whl (25.6 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.31+ riscv64

basedpython-0.0.1a3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (25.6 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ x86-64

basedpython-0.0.1a3-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (25.0 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ s390x

basedpython-0.0.1a3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (28.0 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ ppc64le

basedpython-0.0.1a3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (27.2 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ i686

basedpython-0.0.1a3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (23.3 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ ARMv7l

basedpython-0.0.1a3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (24.3 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.17+ ARM64

basedpython-0.0.1a3-py3-none-macosx_11_0_arm64.whl (23.4 MB view details)

Uploaded Jul 13, 2026 Python 3macOS 11.0+ ARM64

basedpython-0.0.1a3-py3-none-macosx_10_12_x86_64.whl (24.1 MB view details)

Uploaded Jul 13, 2026 Python 3macOS 10.12+ x86-64

basedpython-0.0.1a3-py3-none-linux_armv6l.whl (23.6 MB view details)

Uploaded Jul 13, 2026 Python 3

File details

Details for the file basedpython-0.0.1a3.tar.gz.

File metadata

Download URL: basedpython-0.0.1a3.tar.gz
Upload date: Jul 13, 2026
Size: 9.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for basedpython-0.0.1a3.tar.gz
Algorithm	Hash digest
SHA256	`0d1be6340493673ac69de951e6ada62f3d72693ae327f827f6fc9f9ac61b0f2d`
MD5	`8b46c4ba88a3dccb8d7188d683ab997c`
BLAKE2b-256	`9550efb8ebd6f1fce5c28191eff2d7a64c350b6dd9931ee01a01c4c41eb2418b`

Algorithm	Hash digest
SHA256	`428d2856e52419d4f5adb4123e2da5afb469f135f20039322cce8675bc3bade3`
MD5	`af36e39ffa6b7c00161b543fb6b52610`
BLAKE2b-256	`0be95419ccf6f9df15f1a121746162294f4842d74f5eba1d49a428a736069be6`

Algorithm	Hash digest
SHA256	`64ebb85f2c4cf5b6fb9c6e04bb6507fe1a6323f487dc6f7c07675e0df8f58d84`
MD5	`77a58b334e56a995acb2bf392a67855d`
BLAKE2b-256	`05c08d809342c2dce07741f18c45ac35c7100919d7b85f089232ca0f287b0467`

Algorithm	Hash digest
SHA256	`27fc572c86908aa96f8bfed258262588f916cd35382b2f88f3d67c158a2cf81d`
MD5	`abead5ae9298c5df3d6f94b3e250f2f6`
BLAKE2b-256	`33d61ae66056fce5364a47f7563503c082581a06c4a70e0f52cff17fd4b53d0f`

Algorithm	Hash digest
SHA256	`5bb7deecfd981f51546033ec82e7f530a5cd4b89adf910c475756d12ea7aef7e`
MD5	`48b5add92ffa87c23fdcbbfc577bf182`
BLAKE2b-256	`bbbbd3fbbba74605cf60729345e4be1791ca2574757b39c46f3eb6a4946990f5`

Algorithm	Hash digest
SHA256	`7a6309ec26fa0ba1b9191fb226407c3b85f10d643a08f91a80c2c98cf9eb8d7f`
MD5	`278ff022b1bcc62e62fdd459957fdd6c`
BLAKE2b-256	`0d02c019e68d805d4b97c8008e079e8179c84e30ff031cd63406c09d7b7383e9`

Algorithm	Hash digest
SHA256	`da556830db8dd357513719bd62375e81d87c4452a012f57b25fe12f37e2a2ae8`
MD5	`b51aec26f205f8b5ba5787f03ae0a251`
BLAKE2b-256	`9e03a665256cb87b27326c1001c9075f20e93d7ce0758b870b056e6e7cb3390c`

Algorithm	Hash digest
SHA256	`ae5266e45d931bfbc84acba2f7245f30cc87134174c4057ca6fb98d288e42445`
MD5	`4472945b5b24f6f58012582d29244122`
BLAKE2b-256	`ad4f4add706bf944db9ff9984549c155ff9251a8c4c6e01106addf04f9593186`

Algorithm	Hash digest
SHA256	`a5f60bed4e21731b9400ed946603fc9b2ededfd6b404feb1a0c355a23caecd08`
MD5	`56596ec854e7108fea94480dd15e6bc7`
BLAKE2b-256	`c48394527313923599a9f21e82875d9afcc4d59d5318d0c1c6b0befa59292b03`

Algorithm	Hash digest
SHA256	`881ed18ae33f7853ef914a62f5c4559a1aa117e45031979bdc46fdec7d40b402`
MD5	`5772aca35619d60c28d5524543d9ae9b`
BLAKE2b-256	`dc12822415824946b2038b46926aeafc2676d8d484a0f60aa6a9df0a87b56b98`

Algorithm	Hash digest
SHA256	`66514160a3d6386a19d6e0508050d48ad7f33271f8fdc6c8595bf5f7c8e096ff`
MD5	`9f6ddabc205e4e342f8aead9974a59a2`
BLAKE2b-256	`7e3a10acfcf22f2e45eea7ef4161b0b6e888a39b6acaa36402aecee0426cec84`

Algorithm	Hash digest
SHA256	`c654e299a521bef5a9b8cb910757f69779d36b7fe6988f37dcbcc3a5439daca8`
MD5	`3f825caf301c36f30ef4044930720283`
BLAKE2b-256	`0ee2f6304afbca77a6b697cc1b189e14c632356b293b145073bd2e3fc6e98fe8`

Algorithm	Hash digest
SHA256	`566fb6c40afb51fc0a07298a5805c3916f97e1c3b0f55a86ea0ef900f321400f`
MD5	`e44ad2da67486caefbe0bb10902113df`
BLAKE2b-256	`032be8c82a9851709bc9a3a790583db289f41cc5a0e1890251e93359edf4ba5d`

Algorithm	Hash digest
SHA256	`e91e6127f48a4b6475bfdd9b28cc5698d6a5a0cc1e38d50082599aba57405fe0`
MD5	`e239116280c835c3b2746ed742f6a976`
BLAKE2b-256	`23a81d1e1da38c1091708fa4fbdbfd846fb78804847b58df76f538cddc2d30ae`

Algorithm	Hash digest
SHA256	`ff55ce9f937a7f42a5a1bdeaf4cc09d519d5b5806e99052a759035b0622ff406`
MD5	`8771035e7fe3b4c216ef8eaff0f4a023`
BLAKE2b-256	`7e41d420e4a2f840e3a4c75e4af360dfd6ce32c63c4762763b796dbdca927065`

Algorithm	Hash digest
SHA256	`ad9ddd57b488dfeb574be1929dc4ff9c718b3a41859f4794e277a049b6fdab9e`
MD5	`cee100b915e6737a70dc080bb2e9ffdf`
BLAKE2b-256	`40d4cf20b69f01ba82f14f050b121421e6bc2605f8647d294484add8ef3c33e9`

Algorithm	Hash digest
SHA256	`c65c6f0671fac912bbb5ea4528ee4c1930096164088fd7f4bfd5d93670aaea8e`
MD5	`3a563621788d9c615eaeec5ceb2c3f3a`
BLAKE2b-256	`d2aa95613474df46533ead130b5621285ffeb48a6be88a7b7bbc49f1bf511824`

Algorithm	Hash digest
SHA256	`459eb136243490581c2a4f73f2e7457a8f5601e8d0c3e67798b980d1e56cbbb3`
MD5	`0028ce9361482cc12fcdc03a59a63e59`
BLAKE2b-256	`1f6b5274a5f2f4d1e869e15e0dfd23fb681673e597fe4339c026d3775b014bc4`

basedpython 0.0.1a3

basedpython

acknowledgements

installation

usage

options

features

anonymous named tuple syntax

mutable default argument via lazy evaluation

callable syntax

python version polyfills

multiline strings

None operators

?. — optional attribute access

?? — None-coalesce

modifier keywords

visibility modifiers

api lock file

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

`?.` — optional attribute access

`??` — None-coalesce