Merge remote-tracking branch 'upstream/master'

Author: guimarqu

.github/workflows/format_check.yml

@@ -0,0 +1,31 @@
+name: format-check
+on:
+  push:
+    branches:
+      - master
+      - release-*
+  pull_request:
+    types: [opened, synchronize, reopened]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: julia-actions/setup-julia@latest
+        with:
+          version: '1'
+      - uses: actions/checkout@v1
+      - name: Format check
+        shell: julia --color=yes {0}
+        run: |
+          using Pkg
+          Pkg.add(PackageSpec(name="JuliaFormatter", version="0.13.2"))
+          using JuliaFormatter
+          format("src", verbose=true)
+          format("test", verbose=true)
+          out = String(read(Cmd(`git diff`)))
+          if isempty(out)
+              exit(0)
+          end
+          @error "Some files have not been formatted !!!"
+          write(stdout, out)
+          exit(1)

CITATION.bib

@@ -0,0 +1,7 @@
+@article{MathOptInterface-2021,
+   title={MathOptInterface: a data structure for mathematical optimization problems},
+   author={Legat, Benoit and Dowson, Oscar and Garcia, Joaquim and Lubin, Miles},
+   journal={INFORMS Journal on Computing},
+   year={in press},
+   publisher={INFORMS}
+ }

NEWS.md

@@ -1,6 +1,23 @@
 MathOptInterface (MOI) release notes
 ====================================
 
+v0.9.20 (February 20, 2021)
+---------------------------
+
+For a detailed list of the closed issues and pull requests from this release,
+see the [tag notes](https://github.com/jump-dev/MathOptInterface.jl/releases/tag/v0.9.20).
+
+- Improved performance of `Utilities.ScalarFunctionIterator`
+- Added support for `compute_conflict` to MOI layers
+- Added test with zero off-diagonal quadratic term in objective
+- Fixed double deletion of nested bridged `SingleVariable`/`VectorOfVariables`
+  constraints
+- Fixed modification of un-set objective
+- Fixed function modification with duplicate terms
+- Made unit tests abort without failing if the problem class is not supported
+- Formatted code with JuliaFormatter
+- Clarified `BasisStatusCode`'s docstring
+
 v0.9.19 (December 1, 2020)
 ---------------------------
 

Project.toml

@@ -1,6 +1,6 @@
 name = "MathOptInterface"
 uuid = "b8f27783-ece8-5eb3-8dc8-9495eed66fee"
-version = "0.9.19"
+version = "0.9.20"
 
 [deps]
 BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
@@ -16,7 +16,7 @@ Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
 Unicode = "4ec0a83e-493e-50e2-b9ac-8f72acf5a8f5"
 
 [compat]
-BenchmarkTools = "0.4, 0.5"
+BenchmarkTools = "0.4, 0.5, 0.6"
 CodecBzip2 = "~0.6, 0.7"
 CodecZlib = "~0.6, 0.7"
 JSON = "~0.21"

README.md

@@ -19,3 +19,18 @@ An abstraction layer for mathematical optimization solvers. Replaces [MathProgBa
 [gitter-url]: https://gitter.im/JuliaOpt/JuMP-dev?utm_source=share-link&utm_medium=link&utm_campaign=share-link
 [gitter-img]: https://badges.gitter.im/JuliaOpt/JuMP-dev.svg
 [discourse-url]: https://discourse.julialang.org/c/domain/opt
+
+## Citing MathOptInterface
+
+If you find MathOptInterface useful in your work, we kindly request that you cite the
+following paper:
+```bibtex
+@article{MathOptInterface-2021,
+   title={MathOptInterface: a data structure for mathematical optimization problems},
+   author={Legat, Benoit and Dowson, Oscar and Garcia, Joaquim and Lubin, Miles},
+   journal={INFORMS Journal on Computing},
+   year={in press},
+   publisher={INFORMS}
+ }
+```
+A preprint of this paper is [freely available](https://arxiv.org/abs/2002.03447). 

docs/make.jl

@@ -19,20 +19,56 @@ makedocs(
     doctest = _FIX ? :fix : true,
     pages = [
         "Introduction" => "index.md",
+        "Background" => [
+            "background/motivation.md",
+            "background/duality.md",
+        ],
         "Manual" => [
-            "manual/basic_usage.md",
-            "manual/advanced_usage.md",
+            "manual/standard_form.md",
+            "manual/models.md",
+            "manual/variables.md",
+            "manual/constraints.md",
+            "manual/solutions.md",
+            "manual/modification.md",
+            "manual/example.md",
             "manual/implementing.md",
-            "manual/Benchmarks.md",
-            "manual/Bridges.md",
-            "manual/FileFormats.md",
-            "manual/Test.md",
-            "manual/Utilities.md",
         ],
-        "API Reference" => "apireference.md",
-    ]
+        "API Reference" => [
+            "reference/standard_form.md",
+            "reference/models.md",
+            "reference/variables.md",
+            "reference/constraints.md",
+            "reference/modification.md",
+            "reference/nonlinear.md",
+            "reference/callbacks.md",
+            "reference/errors.md",
+        ],
+        "Submodules" => [
+            "Benchmarks" => [
+                "Overview" => "submodules/Benchmarks/overview.md",
+                "API Reference" => "submodules/Benchmarks/reference.md",
+            ],
+            "Bridges" => [
+                "Overview" => "submodules/Bridges/overview.md",
+                "Implementation" => "submodules/Bridges/implementation.md",
+                "API Reference" => "submodules/Bridges/reference.md",
+            ],
+            "FileFormats" => [
+                "Overview" => "submodules/FileFormats/overview.md",
+                "API Reference" => "submodules/FileFormats/reference.md",
+            ],
+            "Utilities" => [
+                "Overview" => "submodules/Utilities/overview.md",
+                "API Reference" => "submodules/Utilities/reference.md",
+            ],
+            "Test" => [
+                "Overview" => "submodules/Test/overview.md",
+            ],
+        ],
+    ],
 )
 
 deploydocs(
-    repo   = "github.com/jump-dev/MathOptInterface.jl.git",
+    push_preview = true,
+    repo = "github.com/jump-dev/MathOptInterface.jl.git",
 )