README.md

   1 # An algorithm library {#mainpage}
   2
   3 [![docs](https://github.com/tqfx/liba/actions/workflows/docs.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/docs.yml)
   4 [![conan](https://github.com/tqfx/liba/actions/workflows/conan.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/conan.yml)
   5 [![xmake](https://github.com/tqfx/liba/actions/workflows/xmake.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/xmake.yml)
   6 [![meson](https://github.com/tqfx/liba/actions/workflows/meson.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/meson.yml)
   7 [![msvc](https://github.com/tqfx/liba/actions/workflows/msvc.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/msvc.yml)
   8 [![linux](https://github.com/tqfx/liba/actions/workflows/linux.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/linux.yml)
   9 [![macos](https://github.com/tqfx/liba/actions/workflows/macos.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/macos.yml)
  10 [![mingw](https://github.com/tqfx/liba/actions/workflows/mingw.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/mingw.yml)
  11 [![msys2](https://github.com/tqfx/liba/actions/workflows/msys2.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/msys2.yml)
  12 [![freebsd](https://github.com/tqfx/liba/actions/workflows/freebsd.yml/badge.svg)](https://github.com/tqfx/liba/actions/workflows/freebsd.yml)
  13
  14 ## documentation
  15
  16 - [C/C++](https://tqfx.org/liba/)
  17 - [Lua](https://tqfx.org/liba/lua/)
  18 - [Java](https://tqfx.org/liba/java/)
  19 - [Rust](https://tqfx.org/liba/rust/liba/)
  20
  21 ## required tools
  22
  23 - C/C++ compiler: [tcc](https://bellard.org/tcc) or [gnu](https://gcc.gnu.org) or [llvm](https://clang.llvm.org) or [msvc](https://visualstudio.microsoft.com/visual-cpp-build-tools) etc
  24
  25 ## optional tools
  26
  27 - [lua](https://www.lua.org)
  28 - [java](https://www.oracle.com/java)
  29 - [rust](https://www.rust-lang.org)
  30 - [emsdk](https://emscripten.org)
  31 - [xmake](https://xmake.io)
  32 - [cmake](https://cmake.org)
  33 - [conan](https://conan.io)
  34 - [vcpkg](https://vcpkg.io)
  35 - [meson](https://mesonbuild.com)
  36 - [python](https://www.python.org)
  37 - [quickjs](https://github.com/bellard/quickjs)
  38
  39 ## build
  40
  41 ### xmake
  42
  43 ```bash
  44 xmake f
  45 xmake
  46 xmake i
  47 ```
  48
  49 ### cmake
  50
  51 ```bash
  52 cmake -S . -B build
  53 cmake --build build
  54 cmake --install build
  55 ```
  56
  57 ### meson
  58
  59 ```bash
  60 meson setup builddir
  61 meson install -C builddir
  62 ```
  63
  64 ### vcpkg
  65
  66 ```bash
  67 cmake -S . -B build -DLIBA_VCPKG=1
  68 ```
  69
  70 ```bash
  71 cp -r build/vcpkg/* $VCPKG_INSTALLATION_ROOT
  72 ```
  73
  74 ```pwsh
  75 cp -r -Force build/vcpkg/* $ENV:VCPKG_INSTALLATION_ROOT
  76 ```
  77
  78 ### conan
  79
  80 ```bash
  81 conan create .
  82 ```
  83
  84 ### cargo
  85
  86 ```bash
  87 cargo build --release
  88 ```
  89
  90 ### cython
  91
  92 ```bash
  93 python setup.py build_ext --inplace
  94 ```
  95
  96 ## usage
  97
  98 ### C/C++
  99
 100 #### xmake.lua
 101
 102 ```lua
 103 add_requires("alib") -- static
 104 add_requires("liba") -- shared
 105 ```
 106
 107 #### CMakeLists.txt
 108
 109 ```cmake
 110 find_package(liba CONFIG REQUIRED)
 111 target_link_libraries(<TARGET> PRIVATE alib) # static
 112 target_link_libraries(<TARGET> PRIVATE liba) # shared
 113 ```
 114
 115 #### conanfile.txt
 116
 117 ```txt
 118 [requires]
 119 liba/[~0.1]
 120 ```
 121
 122 ### Lua
 123
 124 ```bash
 125 luarocks install liba # release
 126 ```
 127
 128 ```bash
 129 luarocks install --server=https://luarocks.org/dev liba # latest
 130 ```
 131
 132 #### main.lua
 133
 134 ```lua
 135 local liba = require("liba")
 136 print("version", liba.VERSION)
 137 ```
 138
 139 ### Java
 140
 141 #### Main.java
 142
 143 ```java
 144 public class Main {
 145     public static void main(String[] args) {
 146         System.out.println("version " + liba.VERSION);
 147     }
 148 }
 149 ```
 150
 151 ### Rust
 152
 153 #### Cargo.toml
 154
 155 ```bash
 156 cargo add liba # release
 157 ```
 158
 159 ```bash
 160 cargo add --git https://github.com/tqfx/liba.git # latest
 161 ```
 162
 163 #### main.rs
 164
 165 ```rs
 166 use liba;
 167 fn main() {
 168     println!(
 169         "version {}.{}.{}+{}",
 170         liba::version::major(),
 171         liba::version::minor(),
 172         liba::version::patch(),
 173         liba::version::tweak()
 174     );
 175 }
 176 ```
 177
 178 ### Python
 179
 180 ```bash
 181 pip install liba # release
 182 ```
 183
 184 ```bash
 185 pip install git+https://github.com/tqfx/liba.git # latest
 186 ```
 187
 188 #### main.py
 189
 190 ```py
 191 import liba
 192 print("version", liba.VERSION)
 193 ```
 194
 195 ### JavaScript
 196
 197 ```bash
 198 npm i @tqfx/liba
 199 ```
 200
 201 #### index.js
 202
 203 ```js
 204 import liba from "@tqfx/liba";
 205 console.log("version", liba.VERSION);
 206 ```
 207
 208 ### QuickJS
 209
 210 #### main.js
 211
 212 ```js
 213 import * as liba from "liba.so";
 214 console.log("version", liba.VERSION);
 215 ```
 216
 217 ## Copyright {#copyright}
 218
 219 Copyright (C) 2020-present tqfx, All rights reserved.
 220
 221 This Source Code Form is subject to the terms of the Mozilla Public
 222 License, v. 2.0. If a copy of the MPL was not distributed with this
 223 file, You can obtain one at <https://mozilla.org/MPL/2.0/>.