Skip to main content

Hyperp - hyper productive utility functions for Python

Hyperp is a small utility library designed to simplify everyday coding tasks.
It embraces safe defaults over exceptions — for example, read() returns a default value if the file can't be read, helping you gracefully handle edge cases without extra boilerplate.

Purpose

I run a software consultancy where we build products for clients and internal projects.
To stay Hyper Productive (hence "hyperp"), I created this library to streamline development and encourage safer patterns.
It also helps my team write more robust code with minimal effort.

Need simple, beautiful software frontend, backend or design? Checkout BaunIT.com

General Utility Functions

Documentation by example

from hyperp import *

# to_int: Convert to int, or return default on failure
to_int("42", 0)     # 42
to_int("x", 0)      # 0
to_int(None, -1)    # -1

# is_int: Check if input is an integer
is_int("123")       # True
is_int("abc")       # False

# is_float: Check if input is a float
is_float("3.14")    # True
is_float("hello")   # False

# is_ip4: Check if input is a valid IPv4 address
is_ip4("192.168.1.1")   # True
is_ip4("999.999.0.1")   # False

# mkdir: Create a directory and all parents if needed
mkdir("path/to/dir")

# mkdir_file: Create parent directories for a file path
mkdir_file("logs/output.log")  # Creates the 'logs' directory if missing

# write: Write string data to a file, creating dirs if needed
write("out/data.txt", "hello world")

# read: Read a file, return default on error
read("out/data.txt", "default")    # "hello world" or "default" if not found

# rmdir: Remove a directory and its contents, ignore errors
rmdir("path/to/remove")

# sanitize: Make filename safe for storage/use
sanitize("my*unsafe:file?.txt")    # "myunsafefile.txt"

# send_file: Upload file to a URL as multipart/form-data
send_file("https://example.com/upload", "report.pdf")  # Returns dict with msg and response

# download: Download file from URL to disk, streaming for efficiency
download("https://example.com/image.jpg", "images/photo.jpg")  # Returns "images/photo.jpg"
download("https://bad-url.com/file.pdf", "out.pdf", "")        # Returns "" on error

# throttle_call: Limit function execution to once per N seconds
def load_data():
    return fetch_from_api()

throttle_call(load_data, 5)  # Executes
throttle_call(load_data, 5)  # Returns None (too soon)
time.sleep(5)
throttle_call(load_data, 5)  # Executes again

# timer: Decorator to measure function execution time
@timer
def slow_function():
    time.sleep(1)
    return "done"

slow_function()  # Prints: "slow_function took 1.0001 seconds"

Django specific

Documentation by example

from hyperp.django import *

# cache: Shorthand for Django's cache_control with flexible time units
@cache(seconds=30, minutes=5, hours=1, days=1, public=False)
def my_view(request):
    ...

# get_csrf: Return CSRF token input element for forms
def form_view(request):
    csrf = get_csrf(request)
    return HttpResponse(f"<form>{csrf}<input name='x'></form>")

# get_ip: Extract client IP address from request headers
def log_request(request):
    ip = get_ip(request)
    # Use the IP (e.g., for logging, rate limiting, etc.)

Metadata

Release files for hyperp 1.0.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hyperp 1.0.14
File Size Uploaded
hyperp-1.0.14.tar.gz 8.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hyperp 1.0.14
File Interpreter ABI Platform
hyperp-1.0.14-py3-none-any.whl Python 3 none any Details

Total release size: 17.4 kB

Release files / hyperp-1.0.14.tar.gz

Download URL hyperp-1.0.14.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
71f8cb9c6302426cf9a51b5516448d415eec976e8fb7b05b6f0172c5d54f1be7
BLAKE2b-256 checksum
How to use checksums
81b71c75299cd236d3cd0d1ba35d637922d7bfaa1bccdc65a5ed08f2e97aa048
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release files / hyperp-1.0.14-py3-none-any.whl

Download URL hyperp-1.0.14-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dcb4b5a8ecfa96de97c8af34e6552592033ef66ed1b197d1a9085ddc90dd9b89
BLAKE2b-256 checksum
How to use checksums
4e1fe0ea2331664f78c806e4467e815d19c6a4710089481e99ef51e6ab45d53d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release history Release notifications | RSS feed

1.0.15

2 release files

This release

1.0.14 This release

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.7

2 release files

1.0.5

2 release files

1.0.4

2 release files

0.1.26

2 release files

0.1.25

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page