python-patterns/patterns/structural/proxy.py at master · fredericlebel/python-patterns · GitHub

History

91 lines (64 loc) · 2.44 KB

Raw

"""

*What is this pattern about?

Proxy is used in places where you want to add functionality to a class without

changing its interface. The main class is called `Real Subject`. A client should

use the proxy or the real subject without any code change, so both must have the

same interface. Logging and controlling access to the real subject are some of

the proxy pattern usages.

*References:

https://refactoring.guru/design-patterns/proxy/python/example

https://python-3-patterns-idioms-test.readthedocs.io/en/latest/Fronting.html

*TL;DR

Add functionality or logic (e.g. logging, caching, authorization) to a resource

without changing its interface.

"""

from typing import Union

class Subject:

"""

As mentioned in the document, interfaces of both RealSubject and Proxy should

be the same, because the client should be able to use RealSubject or Proxy with

no code change.

Not all times this interface is necessary. The point is the client should be

able to use RealSubject or Proxy interchangeably with no change in code.

"""

def do_the_job(self, user: str) -> None:

raise NotImplementedError()

class RealSubject(Subject):

"""

This is the main job doer. External services like payment gateways can be a

good example.

"""

def do_the_job(self, user: str) -> None:

print(f"I am doing the job for {user}")

class Proxy(Subject):

def __init__(self) -> None:

self._real_subject = RealSubject()

def do_the_job(self, user: str) -> None:

"""

logging and controlling access are some examples of proxy usages.

"""

print(f"[log] Doing the job for {user} is requested.")

if user == "admin":

self._real_subject.do_the_job(user)

else:

print("[log] I can do the job just for `admins`.")

def client(job_doer: Union[RealSubject, Proxy], user: str) -> None:

job_doer.do_the_job(user)

def main():

"""

>>> proxy = Proxy()

>>> real_subject = RealSubject()

>>> client(proxy, 'admin')

[log] Doing the job for admin is requested.

I am doing the job for admin

>>> client(proxy, 'anonymous')

[log] Doing the job for anonymous is requested.

[log] I can do the job just for `admins`.

>>> client(real_subject, 'admin')

I am doing the job for admin

>>> client(real_subject, 'anonymous')

I am doing the job for anonymous

"""

if __name__ == "__main__":

import doctest

doctest.testmod()

python-patterns/patterns/structural/proxy.py at master · fredericlebel/python-patterns · GitHub

Expand file tree

Breadcrumbs

proxy.py

Latest commit

History

Breadcrumbs

proxy.py

File metadata and controls