From 1920f1b489a54e8ab97a3e24b1bab64831e32b53 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 26 Apr 2019 17:57:49 +0200 Subject: New upstream version 0.9.2 --- README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..afbf87b --- /dev/null +++ b/README.md @@ -0,0 +1,70 @@ +[![Travis CI Build Status](https://travis-ci.org/uriparser/uriparser.svg?branch=master)](https://travis-ci.org/uriparser/uriparser) +[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/uriparseradmin/uriparser?svg=true)](https://ci.appveyor.com/project/uriparseradmin/uriparser) + + +# uriparser + +uriparser is a +strictly [RFC 3986](http://tools.ietf.org/html/rfc3986) compliant +URI parsing and handling library +written in C89 ("ANSI C"). +uriparser is cross-platform, +fast, +supports Unicode, and +is licensed under the [New BSD license](https://github.com/uriparser/uriparser/blob/master/COPYING). + +To learn more about uriparser, +please check out [https://uriparser.github.io/](https://uriparser.github.io/). + + +# Example use from an existing CMake project +```cmake +project(hello VERSION 1.0) + +find_package(uriparser 0.9.2 CONFIG REQUIRED char wchar_t) + +add_executable(hello + hello.c +) + +target_link_libraries(hello PUBLIC uriparser::uriparser) +``` + + +# Compilation + +## Compilation (standalone, GNU make, Linux) +```console +# mkdir build +# cd build +# cmake -DCMAKE_BUILD_TYPE=Release .. # see CMakeLists.txt for options +# make +# make test +# make install +``` + +## Available CMake options (and defaults) +```console +# rm -f CMakeCache.txt ; cmake -LAH | grep -B1 'URIPARSER_\|BUILD_SHARED_LIBS' +[..] +// Build shared libraries (rather than static ones) +BUILD_SHARED_LIBS:BOOL=ON +-- +// Build code supporting data type 'char' +URIPARSER_BUILD_CHAR:BOOL=ON +-- +// Build API documentation (requires Doxygen, Graphviz, and (optional) Qt's qhelpgenerator) +URIPARSER_BUILD_DOCS:BOOL=ON +-- +// Build test suite (requires GTest >=1.8.1) +URIPARSER_BUILD_TESTS:BOOL=ON +-- +// Build tools (e.g. CLI "uriparse") +URIPARSER_BUILD_TOOLS:BOOL=ON +-- +// Build code supporting data type 'wchar_t' +URIPARSER_BUILD_WCHAR_T:BOOL=ON +-- +// Use of specific runtime library (/MT /MTd /MD /MDd) with MSVC +URIPARSER_MSVC_RUNTIME:STRING= +``` -- cgit v1.2.3