httpkit.stub — org.clojars.bigsy/httpkit-stub 0.0.1

*call-counts* clj

*expected-counts* clj

*in-isolation* clj

*stub-routes* clj

address-string-for clj

(address-string-for request-map)

Converts a request map into a URL string. Handles both keyword (:http) and string ('http') schemes. Returns a string in the format: scheme://server-name:port/uri?query-string where each component is optional.

create-detailed-error-message clj

(create-detailed-error-message request routes)

Creates a detailed error message for route matching failures.

create-response clj

(create-response response request)

Creates a response map with default values merged with the provided response. If response is a function, it will be called with the request as an argument. Returns a map with :status, :headers, and :body.

defaults-or-value clj

(defaults-or-value defaults value)

Given a set of default values and a value, returns either:

• a vector of all default values (reversed) if the value is in the defaults
• a vector containing just the value if it's not in the defaults

execute-with-validation clj

(execute-with-validation f)

Common execution logic for both stub-bindings and global-http-stub. Sets up the necessary state, executes the function, validates call counts, and handles exceptions consistently.

format-available-routes clj

(format-available-routes routes)

Formats the available routes in a human-readable way for error messages.

get-request-method clj

(get-request-method request)

Gets the request method from either http-kit (:method) or clj-http (:request-method) style requests

get-request-query-params clj

(get-request-query-params request)

Extracts and normalizes query parameters from a request. Handles both :query-params and :query-string formats.

methods-match? clj

(methods-match? expected-method request)

Checks if a request method matches an expected method. Handles :any as a wildcard method.

normalize-path clj

(normalize-path path)

Normalizes a URL path by ensuring it has a trailing slash if not empty.

normalize-query-params clj

(normalize-query-params params)

Normalizes query parameters to a consistent format. Handles both string and keyword keys, and converts all values to strings.

normalize-request clj

(normalize-request request)

normalize-url clj

(normalize-url url & [options])

Comprehensive URL normalization function that handles various aspects of URL normalization. Options is a map that can include:

• :remove-trailing-slash - removes trailing slashes (default: false)
• :normalize-path - ensures path has a trailing slash (default: true)
• :lowercase - converts the URL to lowercase (default: false)

normalize-url-for-matching clj

(normalize-url-for-matching url)

Normalizes a URL string by removing trailing slashes for consistent matching. This is a specialized version of normalize-url with specific options.

parse-query-string clj

(parse-query-string query-string)

Parses a query string into a map of normalized parameters. Returns empty map for nil or empty query string.

parse-url clj

(parse-url url)

Parse a URL string into a map containing :scheme, :server-name, :server-port, :uri, and :query-string. Uses the normalize-path function to ensure consistent URI formatting.

potential-alternatives-to clj

(potential-alternatives-to request uris-fn)

Given a request map and a function to generate potential URIs, returns a sequence of all possible alternative request maps by combining different schemes, server ports, URIs, and query strings. Each alternative preserves all other fields from the original request.

The uris-fn parameter should be a function that takes a request map and returns a sequence of potential URIs for that request.

Performance optimized to limit the number of combinations generated and to short-circuit when not needed.

potential-query-strings-for clj

(potential-query-strings-for request-map)

Given a request map, returns a vector of potential query strings. If the request has no query string or an empty one, returns ['', nil]. If it has a query string, returns all possible permutations of its parameters.

potential-schemes-for clj

(potential-schemes-for request-map)

Given a request map, returns a vector of potential schemes. Handles both string ('http') and keyword (:http) schemes. If the request's scheme is http/nil, returns [http nil], otherwise returns a vector with just the specified scheme.

potential-server-ports-for clj

(potential-server-ports-for request-map)

Given a request map, returns a vector of potential server ports. If the request's server-port is 80 or nil, returns [80 nil], otherwise returns a vector with just the specified port.

potential-uris-for clj

(potential-uris-for request-map)

Returns a set of potential URIs for a request. Uses defaults-or-value to handle common cases like '/', '', or nil.

query-params-match? clj

(query-params-match? expected-query-params request)

Checks if the actual query parameters in a request match the expected ones. Works with both query-string and query-params formats, and handles both httpkit and clj-http parameter styles.

RouteMatcher clj protocol

matches clj

(matches address method request)

validate-all-call-counts clj

(validate-all-call-counts)

with-global-http-stub clj macro

(with-global-http-stub routes & body)

with-global-http-stub-base clj

(with-global-http-stub-base routes f)

with-global-http-stub-in-isolation clj macro

(with-global-http-stub-in-isolation routes & body)

with-http-stub clj macro

(with-http-stub routes & body)

with-http-stub-in-isolation clj macro

(with-http-stub-in-isolation routes & body)

with-stub-bindings clj

(with-stub-bindings routes f)

wrap-request-with-stub clj

(wrap-request-with-stub client)