Hammock

Warnings

• gotcha The `hammock` library is unmaintained and effectively abandoned. Its last commit and release date back to 2017. This means it receives no updates, bug fixes, or security patches, and may not be compatible with newer Python versions or evolving API standards.
  Fix: It is strongly recommended to use actively maintained HTTP client libraries such as `requests`, `httpx`, or more modern API client generators for robust and secure applications. Consider this library for historical reference or very limited, non-production use cases only.
• breaking Hammock was primarily developed with Python 2 in mind. While it might function with some Python 3 versions, it is not officially tested or supported for modern Python 3.x environments. This can lead to unexpected behavior, deprecated syntax, or runtime errors.
  Fix: If considering its use, thoroughly test all functionality on your target Python 3 version. However, for any new project, choosing a Python 3 native and actively maintained library is a far more reliable approach.
• gotcha As a lightweight and older library, Hammock lacks many advanced features common in modern HTTP clients, such as automatic request retries, robust connection pooling, asynchronous support, or sophisticated error handling mechanisms. This can make building resilient applications challenging without significant custom wrappers.
  Fix: Implement custom retry logic, error handling, and timeout mechanisms manually, or opt for a modern HTTP client library that includes these features out-of-the-box.

Install

• pip install hammock Install stable version

Imports

• Hammock

  from hammock import Hammock

Quickstart

Demonstrates initializing Hammock and performing a basic GET request against the GitHub API to fetch user details. The response data is accessible via dot notation.

import os
from hammock import Hammock

# Hammock provides a Pythonic way to interact with REST APIs.
# For this public GitHub API endpoint, no authentication is strictly needed.
# For APIs requiring auth, you would typically pass headers or auth parameters
# during Hammock initialization or within specific HTTP method calls.
# For example: auth_token = os.environ.get("GITHUB_TOKEN", "")

github = Hammock("https://api.github.com")

# Perform a GET request to retrieve information about the 'octocat' user.
# Hammock allows chaining attributes for URL segments (e.g., .users('octocat')).
user_data = github.users('octocat').GET()

# The response data can be accessed like attributes or dictionary keys.
print(f"Octocat's name: {user_data.name}")
print(f"Octocat's public repositories: {user_data.public_repos}")
print(f"Octocat's followers: {user_data.followers}")