lazy-object-proxy

A fast and thorough lazy object proxy.

lazy-object-proxy Permissive license BSD-2-Clause Active ★ 262 v1.12.0 released 2025-08-22

Install

lazy-object-proxy on PyPI

pip

pip install lazy-object-proxy

uv

uv add lazy-object-proxy

poetry

poetry add lazy-object-proxy

Package facts

License	BSD-2-Clause (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	actively maintained — 356 days since the last release
Last repo commit	2026-02-22
First released	2014-12-09
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: lazy_object_proxy-1.12.0-pp39.pp310.pp311.graalpy311-none-any.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: Microsoft :: WindowsOperating System :: POSIXOperating System :: UnixProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Utilities

About lazy-object-proxy

from the package's own PyPI description — quoted content, verbatim

======== Overview ========

.. start-badges

.. list-table:: :stub-columns: 1

* - docs
  - |docs|
* - tests
  - |github-actions| |coveralls| |codecov|
* - package
  - |version| |wheel| |supported-versions| |supported-implementations| |commits-since|

.. |docs| image:: https://readthedocs.org/projects/python-lazy-object-proxy/badge/?style=flat :target: https://readthedocs.org/projects/python-lazy-object-proxy/ :alt: Documentation Status

.. |github-actions| image:: https://github.com/ionelmc/python-lazy-object-proxy/actions/workflows/github-actions.yml/badge.svg :alt: GitHub Actions Build Status :target: https://github.com/ionelmc/python-lazy-object-proxy/actions

.. |coveralls| image:: https://coveralls.io/repos/github/ionelmc/python-lazy-object-proxy/badge.svg?branch=master :alt: Coverage Status :target: https://coveralls.io/github/ionelmc/python-lazy-object-proxy?branch=master

.. |codecov| image:: https://codecov.io/gh/ionelmc/python-lazy-object-proxy/branch/master/graphs/badge.svg?branch=master :alt: Coverage Status :target: https://app.codecov.io/github/ionelmc/python-lazy-object-proxy

.. |version| image::...

Read as markdown · JSON record · Source repository · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides a fast lazy proxy object that defers expensive computation until the proxy is first accessed, calling a supplied function on first use rather than at instantiation.

Low friction: zero runtime dependencies, pure-Python wheels available for PyPy and CPython, and active maintenance with a recent commit in February 2026.

BSD-2-Clause is permissive; you may use, modify, and distribute this package freely in both open and proprietary projects provided you retain the license notice.

Usage

pip install lazy-object-proxy

import lazy_object_proxy

def expensive_func():
    return 10

obj = lazy_object_proxy.Proxy(expensive_func)
print(obj)  # expensive_func called on first access

Requires Python 3.9 or later.

Verdict: A stable, well-maintained utility for deferring expensive object initialization. Zero dependencies, permissive licensing, no known vulnerabilities, and broad Python version support make it a low-risk addition to any project needing lazy evaluation semantics.

Needs verification

Whether the C extension (if present) is optional or required for performance-critical workloads.
Performance characteristics compared to alternative lazy-loading patterns in real-world scenarios.

lazy initialization proxydeferred object creationlazy evaluation wrapperexpensive computation delayproxy object patternlazy loading pythonfunction call deferral