git_filter

Filter structure used to register custom filters.

To associate extra data with a filter, allocate extra data and put the git_filter struct at the start of your data buffer, then cast the self pointer to your larger structure when your callback is invoked.

Members

Variables

apply
.git_filter_apply_fn apply;

Called to actually apply the filter to file contents. If this function returns git_error_code.GIT_PASSTHROUGH then the contents will be passed through unmodified.

attributes
const(char)* attributes;

A whitespace-separated list of attribute names to check for this filter (e.g. "eol crlf text"). If the attribute name is bare, it will be simply loaded and passed to the check callback. If it has a value (i.e. "name=value"), the attribute must match that value for the filter to be applied. The value may be a wildcard (eg, "name=*"), in which case the filter will be invoked for any value for the given attribute name. See the attribute parameter of the check callback for the attribute value that was specified.

check
.git_filter_check_fn check;

Called to determine whether the filter should be invoked for a given file. If this function returns git_error_code.GIT_PASSTHROUGH then the apply function will not be invoked and the contents will be passed through unmodified.

cleanup
.git_filter_cleanup_fn cleanup;

Called when the system is done filtering for a file.

initialize
.git_filter_init_fn initialize;

Called when the filter is first used for any file.

shutdown
.git_filter_shutdown_fn shutdown;

Called when the filter is removed or unregistered from the system.

stream
.git_filter_stream_fn stream;

Called to apply the filter in a streaming manner. If this is not specified then the system will call apply with the whole buffer.

version_
uint version_;

The version field should be set to GIT_FILTER_VERSION.

Meta