or-tools 0.1.0

Unofficial Rust wrappers to the C++ library Google OR-Tools, open source software for combinatorial optimization
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
83
84
85
86
87
88
89
90

# Google Or-Tools

[![Current Crates.io Version](https://img.shields.io/crates/v/or-tools.svg)](https://crates.io/crates/or-tools)

`or-tools` is a Rust library that binds to certain specific features of the [Google Or-Tools C++ library](https://github.com/google/or-tools).

This repository will dedicate itself to improve the library's content.

These include:

- TBD # TODO: to be implemented!

## Building

### Minimum Rust Version

Please udjust your Rust compiler to version `1.73` or higher.

### Supported Platforms

- Linux { aarch64, x86_64 }
  - Alpine Edge
  - [Arch Linux (AUR)](https://aur.archlinux.org/packages/or-tools)
  - CentOS 7 LTS
  - Debian 11
  - Fedora 37, 38
  - OpenSuse Leap
  - Ubuntu 20.04, 22.04, 23.04
- MacOS { aarch64, x86_64 }
  - macOS Intel
  - macOS M1
- Windows { x86_64 }
  - Visual Studio 2022

Your package manager may not support deployment on platforms marked as `Supported` above.

For better maintenance, please let us know whether the other platforms support it.
Besides, you may claim us whether the specific platform should support it through `Issues` .

### Dependencies

- C++20 Compiler (GCC 10 or above)
- `cmake >= 3.18`
- \[optional\] `Or-Tools C++`

#### Building Dependencies

- git

### Building Native library

`dlib-face-recognition` requires `Or-Tools` to be installed. You can either provide a existing system-wide installation, or build it with this library.

- To build it in compile-time:
  - ```sh
    cargo build --features build-native
    ```
- To use a system-wide dependency:
  - ```sh
    cargo build
    ```

The C++ library `Or-Tools` will be installed via `or-tools-sys` when the `build-native` feature flag is enabled.

For the build, this library uses `cmake`, so please make sure to have [ `cmake` ](https://cmake.org/install/) .

The `build-native` flag is **disabled by default**, offering increased build times.

### Building Rust package

`dlib-face-recognition` includes a `solver-all` feature flag **enabled by default**.

`solver-all` will enable all kinds of supported **open-source** solvers.
The latest information about the solvers can be found here: https://github.com/google/or-tools/blob/stable/cmake/README.md#solvers-supported

The `solver-all` flag can be disabled with `cargo build --no-default-features`.

#### GPL/Proprietary Solvers

`dlib-face-recognition` includes a `solver-all-nonfree` feature flag that can be used with `cargo build --features solver-all-nonfree` .

`solver-all` will enable all kinds of supported solvers including **GPL** and/or **proprietary** ones.
The latest information about the solvers can be found here: https://github.com/google/or-tools/blob/stable/cmake/README.md#solvers-supported

For detailed instructions on embedding proprietary solvers, please follow to the link below:

- CPLEX: https://github.com/google/or-tools/blob/stable/cmake/README.md#enabling-cplex-support
- XPRESS: https://github.com/google/or-tools/blob/stable/cmake/README.md#enabling-xpress-support

The `solver-all-nonfree` flag is disabled by default, offering increased build times.