1

#ifndef LIB_URL_H

     2

#define LIB_URL_H

     3

     4

/*

     5

 * A trivial parser for simple URLs

     6

 *

     7

 * [ <scheme> [ "+" <scheme> [ ... ] ] "://" ] [ <username> [ ":" <password> ] "@" ] [ <hostname> ] [ ":" <service> ] [ "/" <path> ] [ "?" [ <key> [ "=" <value> ] ] [ "&" [ <key> [ "="     <value> ] ] [ ... ] ]

     8

 *

     9

 *  example.com

    10

 *  tcp://example.com:7348/

    11

 *  psql://postgres@localhost/test_db?charset=utf8

    12

 *  

    13

 */

    14

    17

/*

    18

 * The schema

    19

 */

    20

struct url_schema {

    21

    size_t count;

    22

    const char **list;

    23

};

    24

    25

/*

    26

 * The options at the end

    27

 */

    28

struct url_opts {

    29

    size_t count;

    30

    struct url_opt {

    31

        const char *key;

    32

        const char *value;

    34

};

    35

    36

/*

    37

 * A parsed URL

    38

 */

    39

struct url {

    40

    struct url_schema *schema;

    41

    const char *username;

    42

    const char *password;

    43

    const char *hostname;

    44

    const char *service;

    45

    const char *path;

    46

    struct url_opts *opts;

    47

};

    48

    49

/*

    50

 * Parse the given `text` as an URL, returning the result in `url`. Optional fields that are missing in the text will

    51

 * cause those values to be returned unmodified.

    52

 *

    53

 * Returns zero if the url was valid and was parsed, nonzero if it was invalid.

    54

 */

    55

int url_parse (struct url *url, const char *text);

    56

    57

#endif /* LIB_URL_H */