summaryrefslogtreecommitdiffstats
path: root/color.h
blob: 8ba397de25ebab6e0186336e4b5b4266284e9e64 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
/*********************************************************************
 * bfs                                                               *
 * Copyright (C) 2015-2016 Tavian Barnes <tavianator@tavianator.com> *
 *                                                                   *
 * This program is free software. It comes without any warranty, to  *
 * the extent permitted by applicable law. You can redistribute it   *
 * and/or modify it under the terms of the Do What The Fuck You Want *
 * To Public License, Version 2, as published by Sam Hocevar. See    *
 * the COPYING file or http://www.wtfpl.net/ for more details.       *
 *********************************************************************/

#ifndef BFS_COLOR_H
#define BFS_COLOR_H

#include "bftw.h"

/**
 * A lookup table for colors.
 */
struct colors;

/**
 * Parse a color table.
 *
 * @param ls_color
 *         A color table in the LS_COLORS environment variable format.
 * @return The parsed color table.
 */
struct colors *parse_colors(const char *ls_colors);

/**
 * Pretty-print a file path.
 *
 * @param colors
 *         The color table to use.
 * @param ftwbuf
 *         The bftw() data for the current path.
 * @return 0 on success, -1 on failure.
 */
int pretty_print(const struct colors *colors, const struct BFTW *ftwbuf);

#if __GNUC__
#	define BFS_PRINTF_ATTRIBUTE(f, v) __attribute__((format(printf, f, v)))
#else
#	define BFS_PRINTF_ATTRIBUTE(f, v)
#endif

/**
 * Pretty-print a warning message.
 *
 * @param colors
 *         The color table to use.
 * @param format
 *         The format string.
 * @param ...
 *         The format string's arguments.
 * @return 0 on success, -1 on failure.
 */
int pretty_warning(const struct colors *colors, const char *format, ...) BFS_PRINTF_ATTRIBUTE(2, 3);

/**
 * Pretty-print an error message.
 *
 * @param colors
 *         The color table to use.
 * @param format
 *         The format string.
 * @param ...
 *         The format string's arguments.
 * @return 0 on success, -1 on failure.
 */
int pretty_error(const struct colors *colors, const char *format, ...) BFS_PRINTF_ATTRIBUTE(2, 3);

/**
 * Free a color table.
 *
 * @param colors
 *         The color table to free.
 */
void free_colors(struct colors *colors);

#endif // BFS_COLOR_H