ImgProxy -- Python library to build ImgProxy URLs
Tests Status PYPI Version Python Versions
- python >= 3.7
imgproxy should be installed using pip:
$ pip install imgproxy
from imgproxy import ImgProxy # Create ImgProxy object with required params img_url = ImgProxy('https://picsum.photos/1000', proxy_host='https://imgproxy.com', width=800, height=400) # Convert the obj to string to get imgproxy URL cover: str = str(img_url) # or just call it to get imgproxy URL cover: str = img_url() assert cover == 'https://imgproxy.com/insecure/g:ce/rs:auto:800:400:0/aHR0cHM6Ly9waWNzdW0ucGhvdG9zLzEwMDA' # Call the object with different params to customize the url cover_small: str = img_url(width=400, height=200, resizing_type='fill') assert cover_small == 'https://imgproxy.com/insecure/g:ce/rs:fill:400:200:0/aHR0cHM6Ly9waWNzdW0ucGhvdG9zLzEwMDA' # Call it with advanced params to get an URL cover_with_border = img_url('pd:10:10:10:10', 'bg:F00') assert cover_with_border == 'https://imgproxy.com/insecure/pd:10:10:10:10/bg:F00/g:ce/rs:auto:0:0:0/aHR0cHM6Ly9waWNzdW0ucGhvdG9zLzEwMDA'
Basic options (default values):
width: int = 0- images widthheight: int = 0- images heightgravity: str = 'ce'- images gravityenlarge: bool = False- enlarge an imageextension: str = ''- images extensionresizing_type: str = 'auto'- resizing type
from imgproxy import ImgProxy img_url = ImgProxy('https://picsum.photos/1000', proxy_host='https://imgproxy.com') thumbmail = img_url(width=100, height=100, gravity='no', extension='jpg', enlarge=True, resizing_type='fit')
Any other options are also supported when you call an imageproxy instance:
from imgproxy import ImgProxy img_url = ImgProxy('https://picsum.photos/1000', proxy_host='https://imgproxy.com') # Get rotated and blured image blured_rotated = img_url('blur:0.5', 'rotate:30')
Imgproxy allows you to sign your URLs with key and salt, so an attacker won’t be able to cause a denial-of-service attack by requesting multiple different image resizes.
from imgproxy import ImgProxy url = ImgProxy('https://picsum.photos/1000', proxy_host='https://imgproxy.com', key="aa396160c50ea766910eab53", salt="b3fb8f215827bda5d0e7313d") assert str(url) == 'https://imgproxy.com/FrH21u_5bXmv-OJ0APMayxZ0F3982xx437gCpqcQ0BM/g:ce/rs:auto:600:0:0/aHR0cHM6Ly9waWNzdW0ucGhvdG9zLzEwMDA'
If you need a random key/salt pair real fast, you can quickly generate it using, for example, the following snippet:
echo $(xxd -g 2 -l 64 -p /dev/random | tr -d '\n')
Usually imgproxy host and signature params are common for a project. The library supports a method to generate a factory with predefined params:
from imgproxy import ImgProxy img_factory = ImgProxy.factory(proxy_host='https://imgproxy.com', key="aa396160c50ea766910eab53", salt="b3fb8f215827bda5d0e7313d") # ... # Generate image URL url = img_factory('https://picsum.photos/1000', width=600) assert str(url) == 'https://imgproxy.com/qcKAFfBJwpiKZ6xt-NT6GXGOGizkeq4sgyfoQ4h-080/g:ce/rs:auto:600:0:0/aHR0cHM6Ly9waWNzdW0ucGhvdG9zLzEwMDA'
Users able to predifine any basic params:
thumbnail_factory = ImgProxy.factory(proxy_host='https://imgproxy.com', width=300, height=200) preview_factory = ImgProxy.factory(proxy_host='https://imgproxy.com', width=500, resizing_type='fit') # and etc
Advanced params are also supported:
thumbnail_factory = ImgProxy.factory('bg:F00', 'pd:10:10:10:10', proxy_host='https://imgproxy.com', width=300, height=200)
-
2021年11月08日: [1.0.0]
- Support python 3.10
- Support advanced options in factories
-
2021年09月14日: [0.4.0]
- Support python 3.7
- Basic format has been removed (it's depricated in ImgProxy)
-
2021年04月02日: [0.2.3] Stable release
If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/imgproxy/issues
Development of the project happens at: https://github.com/klen/imgproxy
Licensed under a MIT License