Pre-release

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

TUnits - Fast Python Units

Continuous Integration

Implements unit of measurement arithmetic, where a number is associated with a product of powers of base units and values with compatible units can be added.

The library is written in Cython for speed. The library provides the ability to statically check dimensionality type (see below) and a limited protobuffer serialization support for select units (see below). Contributions to extend support for more units are welcome.

A precompiled wheel can be installed using pip install typedunits [--pre].

Example

>> import tunits
>> from tunits.units import meter, km, N, MHz

>> print(3*MHz)
Frequency(3, 'MHz')

>> print(5*meter + km)
Length(1005.0, 'm')

>> print(N/meter)
N/m

>> print((N/meter).in_base_units())
kg/s^2

>> print(2*km / tunits.Value(3, 's'))
0.666666666667 km/s

Static Type Check

TypedUnits provides the ability to statically check the dimensionality of variables and parameters. For example mypy would complain about incompatible types for the following code.

from tunits import Frequency, LengthArray
from tunits.units import meter, km, MHz

def frequency_fn(f: Frequency) -> Frequency:
    return 3*f

x = 2 * meter
x_arr = LengthArray([1, 2], km)
y = 3 * km
f = 7 * MHz

# okay
print(frequency_fn(f))
print(x + y)
print(x_arr - y)

# not okay
print(frequency_fn(x))
print(f + x)
print(x - f)
frequency_fn(x_arr)

$ mypy my_code.py
my_code.py:18: error: Argument 1 to "frequency_fn" has incompatible type "Length"; expected "Frequency"  [arg-type]
my_code.py:19: error: No overload variant of "__add__" of "Value" matches argument type "Length"  [operator]
my_code.py:19: note: Possible overload variants:
my_code.py:19: note:     def __add__(self, int | float | complex | number[Any], /) -> Frequency
my_code.py:19: note:     def __add__(self, ValueArray | list[Any] | tuple[Any] | ndarray[Any, dtype[Any]], /) -> ValueArray
my_code.py:19: note:     def __add__(self, Frequency, /) -> Frequency
my_code.py:20: error: No overload variant of "__sub__" of "Value" matches argument type "Frequency"  [operator]
my_code.py:20: note: Possible overload variants:
my_code.py:20: note:     def __sub__(self, int | float | complex | number[Any], /) -> Length
my_code.py:20: note:     def __sub__(self, list[Any] | tuple[Any] | ndarray[Any, dtype[Any]], /) -> ValueArray
my_code.py:20: note:     def __sub__(self, Length, /) -> Length
my_code.py:21: error: Argument 1 to "frequency_fn" has incompatible type "LengthArray"; expected "Frequency"  [arg-type]
Found 4 errors in 1 file (checked 1 source file)

Serialization support

TypedUnits provides protobuffer serialization support for selected units. Contributions are welcome to increase serialization coverage.

>> from tunits import Frequency
>> from tunits.units import MHz
>>
>> v = 3*MHz
>> msg = v.to_proto()
>> print(msg)
units {
  unit: HERTZ
  scale: MEGA
}
real_value: 3

>> Frequency.from_proto(msg)
Frequency(3.0, 'MHz')

Installation

To install a precompiled wheel (add --pre for prelease version)
```
pip install typedunits # [--pre] 
```

To locally build the latest version from the main branch

pip install git+https://github.com/quantumlib/TypedUnits

For a local editable copy

git clone https://github.com/quantumlib/TypedUnits
cd TypedUnits
pip install -e .

Development and Testing

Clone the repository.
```
git clone https://github.com/quantumlib/TypedUnits

cd TypedUnits
```
All future steps assume you are in the repository's directory.
Install dev environment dependencies.
```
pip install -r dev_tools/dev.env.txt
```
Install TUnits
```
pip install -e .
```
Test.
```
pytest
```

Formatting

dev_tools/format.sh  # to format
dev_tools/format.sh --check  # to verify format

Note: This is not an officially supported Google product

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

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.

typedunits-0.0.3.dev20260807192146-cp314-cp314t-win_amd64.whl (825.4 kB view details)

Uploaded Aug 7, 2026 CPython 3.14tWindows x86-64

typedunits-0.0.3.dev20260807192146-cp314-cp314t-win32.whl (756.9 kB view details)

Uploaded Aug 7, 2026 CPython 3.14tWindows x86

typedunits-0.0.3.dev20260807192146-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.6 MB view details)

Uploaded Aug 7, 2026 CPython 3.14tmanylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.6 MB view details)

Uploaded Aug 7, 2026 CPython 3.14tmanylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp314-cp314t-macosx_11_0_arm64.whl (812.6 kB view details)

Uploaded Aug 7, 2026 CPython 3.14tmacOS 11.0+ ARM64

typedunits-0.0.3.dev20260807192146-cp314-cp314-win_amd64.whl (774.3 kB view details)

Uploaded Aug 7, 2026 CPython 3.14Windows x86-64

typedunits-0.0.3.dev20260807192146-cp314-cp314-win32.whl (715.7 kB view details)

Uploaded Aug 7, 2026 CPython 3.14Windows x86

typedunits-0.0.3.dev20260807192146-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.7 MB view details)

Uploaded Aug 7, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.6 MB view details)

Uploaded Aug 7, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp314-cp314-macosx_11_0_arm64.whl (779.7 kB view details)

Uploaded Aug 7, 2026 CPython 3.14macOS 11.0+ ARM64

typedunits-0.0.3.dev20260807192146-cp313-cp313-win_amd64.whl (763.8 kB view details)

Uploaded Aug 7, 2026 CPython 3.13Windows x86-64

typedunits-0.0.3.dev20260807192146-cp313-cp313-win32.whl (708.4 kB view details)

Uploaded Aug 7, 2026 CPython 3.13Windows x86

typedunits-0.0.3.dev20260807192146-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.7 MB view details)

Uploaded Aug 7, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.5 MB view details)

Uploaded Aug 7, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp313-cp313-macosx_11_0_arm64.whl (766.5 kB view details)

Uploaded Aug 7, 2026 CPython 3.13macOS 11.0+ ARM64

typedunits-0.0.3.dev20260807192146-cp312-cp312-win_amd64.whl (760.0 kB view details)

Uploaded Aug 7, 2026 CPython 3.12Windows x86-64

typedunits-0.0.3.dev20260807192146-cp312-cp312-win32.whl (709.0 kB view details)

Uploaded Aug 7, 2026 CPython 3.12Windows x86

typedunits-0.0.3.dev20260807192146-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.8 MB view details)

Uploaded Aug 7, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.6 MB view details)

Uploaded Aug 7, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp312-cp312-macosx_11_0_arm64.whl (769.2 kB view details)

Uploaded Aug 7, 2026 CPython 3.12macOS 11.0+ ARM64

typedunits-0.0.3.dev20260807192146-cp311-cp311-win_amd64.whl (840.6 kB view details)

Uploaded Aug 7, 2026 CPython 3.11Windows x86-64

typedunits-0.0.3.dev20260807192146-cp311-cp311-win32.whl (773.9 kB view details)

Uploaded Aug 7, 2026 CPython 3.11Windows x86

typedunits-0.0.3.dev20260807192146-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.9 MB view details)

Uploaded Aug 7, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.7 MB view details)

Uploaded Aug 7, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp311-cp311-macosx_11_0_arm64.whl (792.8 kB view details)

Uploaded Aug 7, 2026 CPython 3.11macOS 11.0+ ARM64

typedunits-0.0.3.dev20260807192146-cp310-cp310-win_amd64.whl (840.5 kB view details)

Uploaded Aug 7, 2026 CPython 3.10Windows x86-64

typedunits-0.0.3.dev20260807192146-cp310-cp310-win32.whl (742.9 kB view details)

Uploaded Aug 7, 2026 CPython 3.10Windows x86

typedunits-0.0.3.dev20260807192146-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.7 MB view details)

Uploaded Aug 7, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

typedunits-0.0.3.dev20260807192146-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.6 MB view details)

Uploaded Aug 7, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

typedunits-0.0.3.dev20260807192146-cp310-cp310-macosx_11_0_arm64.whl (761.1 kB view details)

Uploaded Aug 7, 2026 CPython 3.10macOS 11.0+ ARM64

File details

Details for the file typedunits-0.0.3.dev20260807192146-cp314-cp314t-win_amd64.whl.

File metadata

Download URL: typedunits-0.0.3.dev20260807192146-cp314-cp314t-win_amd64.whl
Upload date: Aug 7, 2026
Size: 825.4 kB
Tags: CPython 3.14t, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for typedunits-0.0.3.dev20260807192146-cp314-cp314t-win_amd64.whl
Algorithm	Hash digest
SHA256	`86eaf1ce49b9180d76ba44cf11f7a2bbd1ffe973dd60850a8d880f9ed5319656`
MD5	`53f442ba3632d2e248cf329101feaa10`
BLAKE2b-256	`9a1093b5eeb0f7a6905485e97a0e290d23ac8cee4012ab39929a33830e598301`

Algorithm	Hash digest
SHA256	`9ab758c4a725486b946ed08bd830b0baf3b33cca099048ef6fb3a2c27e280b2d`
MD5	`eca2b4695025701854c338df1f5cc366`
BLAKE2b-256	`cfee82950f8b5aa72cd614e6002919f6176e010a3d17af22520aa9fe43684b81`

Algorithm	Hash digest
SHA256	`1fd003ec25ce469d3593bc84d5f5ea9602aba0d882765fd4cd6998cc202c2fe1`
MD5	`527b5ab4a8d7c0f258dd97517c4d38c5`
BLAKE2b-256	`80986b2c47587a8f7dffb67b40eb7ad397de318150413b5266abbe7a2fbb4c2d`

Algorithm	Hash digest
SHA256	`7a7506ac1693233e1ce78f4467d3319d25491146c212419b5dc0fd852bbc811a`
MD5	`9e2692e5276ffc229a446ad4caaa30ea`
BLAKE2b-256	`fa186baddda24cd95b4071cbaf40157a0d75508ff811d536036958a7c304c390`

Algorithm	Hash digest
SHA256	`0dfc7f7126d36179fdb6178ef7da6b2d94490b16a03f6b9b87ad8bef3d561ea4`
MD5	`247de06dffb493dda377f7b4d2b73071`
BLAKE2b-256	`1754f83ab6855cc17eeed5eda48dfcf8285c193b4a939f53bbd559ab763a4a68`

Algorithm	Hash digest
SHA256	`ff77d7f0422c60bdbacc8c31a4f8f8403180ea6757b19e0797f4f2cbe0ba9c22`
MD5	`6d25810df9e261ab28018b35a5e1f4a6`
BLAKE2b-256	`8ba4718ad72a68d78e39c6c6c9212601dfc45a08181c5476ead7dd7af2546a02`

Algorithm	Hash digest
SHA256	`63d4e8f685889dea7a69be33aaf61b81b9aea091d48d623930a35a3cea70f0d1`
MD5	`3cc92efa8ac062674e94895cb9cca4fe`
BLAKE2b-256	`81358df73c80510242c26f4d2eb4f718594a13b0cc7a163c17e878bdd3dddcfc`

Algorithm	Hash digest
SHA256	`6008ca07ee9c25513ba9ede2591ac8a690666ab16ab490dc7ee5a02eb63f8dc2`
MD5	`8ea309d6f51665dfc8312905f25b6b1c`
BLAKE2b-256	`463554efe9826a7dd258f98d7dc9bb720af813e3e6c91342e9a70871c2a308ee`

Algorithm	Hash digest
SHA256	`ca4ef93779b5dcc671f70f9888c5f310e7e10aabda0e42e05477ed813c3264da`
MD5	`c7b564f314f86f79a07c9c58a82dc510`
BLAKE2b-256	`e209defda74de15ba88fb2978851028828af7618dd1f23f69340d3bef2eea113`

Algorithm	Hash digest
SHA256	`33cab102ff7e2a292bbef939b0e86434949694167de38aeeeac598ec4056e289`
MD5	`9992efaae34cb93f7962d5e6d1513807`
BLAKE2b-256	`891fdd94f9ea62e2e284df51cbb5bfddadd2fb95dcc4bce95dd263186ab6515f`

Algorithm	Hash digest
SHA256	`0887b5b4b8fee40451715ab9513d0000ca9206a2dd95ea29081d05bbe5294b84`
MD5	`cd5327075ab55ab1976c6e2e4ae32fd8`
BLAKE2b-256	`e794dcb6a2643bce77f5653c3d2de7df430c38a4d4602fe87cee4d2b0007f39e`

Algorithm	Hash digest
SHA256	`c0ab2cec663bc33a49dabb2f14d9344e2adf9ed1e5bef35ab528631b846e14ba`
MD5	`3ce27278e0da6abcc595af084a9c87f5`
BLAKE2b-256	`8c3f125e8ca1fea20283d8d17dd819d34335e38a9461e7c951a3cda27f72e9d8`

Algorithm	Hash digest
SHA256	`dc8d6f6d5e948d4caf63a198ac0b6111f38e61387f25c13aed18ae0e191867cc`
MD5	`e9686d25d8f53f1ade3cb4e2ad16236e`
BLAKE2b-256	`213dd51a9f5cc0f61194bf10bf4c24384e64ad2c531a8944d210a0329e3effbd`

Algorithm	Hash digest
SHA256	`31682c2f9941b251c88aa237c9f87351ebaa4bb85cbc056c2d94f9df693f4942`
MD5	`6b8f48c1997ff5c2080dbabaf8a94cf6`
BLAKE2b-256	`ef28202f88579bfb559a96e1f2ccb7a40fec01f5700bcf6debbae04850707db3`

Algorithm	Hash digest
SHA256	`2c2081d519f788f71a7e297bd30e783ed67f5d1d5f9f4e4b64f81bd427c2f43c`
MD5	`43b1220be38f966fcb0129146b82d983`
BLAKE2b-256	`d46fb2b7ce5edc541d26eda396b617a2a2fff117885192495e287d8b3c1c6c57`

Algorithm	Hash digest
SHA256	`733aa461e0b6ba48127ce4ceea4993a3e4b2dcb35d886d006b5acba7ebbffcda`
MD5	`4617493373a2cf6332b78dc2d0f494a1`
BLAKE2b-256	`90fddae2208de15c25ec41efe2ab566ea2f620a024656e8999641bd1aeb2ac90`

Algorithm	Hash digest
SHA256	`7bab1ec3972327862ae11d293f3f2e9285c44217bdf26fe96d06a8351f077b0d`
MD5	`4b1fef2386c36ed80b4474fcf255a066`
BLAKE2b-256	`95c5ce15b5f28834f3b9ea942cb1b83718995567d65c01d988e3272a362be433`

Algorithm	Hash digest
SHA256	`a9f4dc82a15b9226af7bbb55d013b832caf69538c0b8fc5adc74ddd0a50fdab9`
MD5	`9f3b39db5c1911457344d90243df1223`
BLAKE2b-256	`1e1e578713ee0138732d9a5b432e0e8aa70337d4dee0b0b59248540d9cc3582c`

Algorithm	Hash digest
SHA256	`da88cf7647c51729f46f1a0bcd17244305c550d5c1f56fc88eb43a8dc8fc22d8`
MD5	`957bcdf58c988624c9061019494b973f`
BLAKE2b-256	`ab532f8b23c3998b9a09b3cf1aff4f89c392844d75e32df70834ebe8bd978f95`

Algorithm	Hash digest
SHA256	`26e612254b8a636254b5cfe3c4738787710ddd985ddce045fd34e4069870f63d`
MD5	`6eb311f17755f3210e83baa5fcab1c17`
BLAKE2b-256	`3a0741c95365b4848395f28de02bf174dbcc88590f6542965b9880157ab072e5`

Algorithm	Hash digest
SHA256	`3b24da3d8f128c78043c568d1efb66b316f5f389ab1ae5de7b1137da00d93c1c`
MD5	`92834c6dc3d5042a34c2f58204e14513`
BLAKE2b-256	`717b78bdb89d8fc0a08fef8f85b4ded0fcacc8ae6ffe3fbe3cda67975ed2b2c5`

typedunits 0.0.3.dev20260807192146

TUnits - Fast Python Units

Example

Static Type Check

Serialization support

Installation

Development and Testing

Formatting

Project links

Key dates

1 maintainer

Credits

License

Requires

Download files

Source Distributions

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

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

Algorithm	Hash digest
SHA256	`4fa20859355149248a8c843d8048771b8788a4f2757c0069111203bcc79a62d9`
MD5	`e08eff2039c89dc0fa5298e9b9641bac`
BLAKE2b-256	`d5e005a72b5ade855f21a69f2a27b06062bddbceef517fde4e4938888141f708`

Algorithm	Hash digest
SHA256	`39e12767d44e2c73a316c72b72ac71201a01421c4db5c7a2894b1e19d6a0b32e`
MD5	`6e71687205de25e09e3c83cc97b221db`
BLAKE2b-256	`1ab92ba68feb2f17e37329af3eac4ec517a01eb80cfb86ef9588a8d7c055b503`

Algorithm	Hash digest
SHA256	`00118d5054eb25c4c94be9edf33e9696c32f26352fe5a5acfb4ef86f48068715`
MD5	`65eda0c338a1a846bbb16adac67e67ee`
BLAKE2b-256	`2d77a94d1f4942674587ddd15d7b1ed5aff92f718a04e2b08148c9c545ba6e58`

Algorithm	Hash digest
SHA256	`5bdfef17b64b9fde5a818a95e195e89cde9d8a98d51cf88a3bfb6db030c607c0`
MD5	`9f6f5b07f49627f6c02f2afbde73bade`
BLAKE2b-256	`1c4158758a26620e7c0ae900f5302c71e5aa8a951fea5fdb3e74eb71fdc358c7`

Algorithm	Hash digest
SHA256	`0b94cd34749212d1690add7856ac7ae970075a10736defbbcef72cd1a6bdd5d2`
MD5	`1084ccf35d5d043898ae0f67d7e96e1d`
BLAKE2b-256	`08f856bc8fd2a0ba2d3f99635c06549705f1fc4e07b54812f9775e3a7de4455e`

Algorithm	Hash digest
SHA256	`8d25e8856308eba8151ddd60f74dbff22cd64998edd189f9477be2096706954f`
MD5	`2eb339ab60450e705fd3abb31ae37bea`
BLAKE2b-256	`62c014ec0b0b419b46e2dc6931d2e0f7d7dbb53cabf397b060c0098f356916a3`

Algorithm	Hash digest
SHA256	`4ae0493149461c762720c152df5b71ffb0cc5422b10851020f834bb8f0d7839f`
MD5	`418a5d5e29e61de82d6d68e1eda7cd11`
BLAKE2b-256	`749886716fd3ba93ed7ce1ac483ac6f5abe29fbe500eaa5f4a1618abd67cbaaa`

Algorithm	Hash digest
SHA256	`4e0259b7aea5887282928793f4c4eb88013e3110d267a0eb8ce8b0f9b7c8b058`
MD5	`ab5cfdd588084d53ea7b0fd429386f56`
BLAKE2b-256	`528e316f8ab100a6ea7fc40fcce8b52ace9e39a3c92da110184bbe6dbc87794a`

Algorithm	Hash digest
SHA256	`53038bc4c68ca785720624c6bd7ae94dfb6680e0c6e1e107adc2a3af7f518648`
MD5	`16fc07eec7f2c69c529840ca995a6982`
BLAKE2b-256	`3196e928ad1799833340e2b4732f150edb2665935a7ac523b70c78d5ae8cf414`