onnx 1.13.1__cp310-cp310-macosx_10_12_universal2.whl → 1.14.0__cp310-cp310-macosx_10_12_universal2.whl

{onnx-1.13.1.dist-info → onnx-1.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: onnx
-Version: 1.13.1
+Version: 1.14.0
 Summary: Open Neural Network Exchange
 Home-page: https://github.com/onnx/onnx
 Author: ONNX
@@ -9,26 +9,28 @@ License: Apache License v2.0
 Classifier: Programming Language :: Python :: 3
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: numpy (>=1.16.6)
-Requires-Dist: protobuf (<4,>=3.20.2)
+Requires-Dist: numpy
+Requires-Dist: protobuf (>=3.20.2)
 Requires-Dist: typing-extensions (>=3.6.2.1)
 Provides-Extra: lint
-Requires-Dist: clang-format (==13.0.0) ; extra == 'lint'
-Requires-Dist: flake8 (>=5.0.2) ; extra == 'lint'
-Requires-Dist: mypy (>=0.971) ; extra == 'lint'
-Requires-Dist: types-protobuf (==3.18.4) ; extra == 'lint'
-Requires-Dist: black (>=22.3) ; extra == 'lint'
-Requires-Dist: isort[colors] (>=5.10) ; extra == 'lint'
+Requires-Dist: lintrunner (>=0.10.0) ; extra == 'lint'
+Requires-Dist: lintrunner-adapters (>=0.3) ; extra == 'lint'
+
+<!--
+Copyright (c) ONNX Project Contributors
+-->
 
 <!--- SPDX-License-Identifier: Apache-2.0 -->
 
 <p align="center"><img width="40%" src="https://github.com/onnx/onnx/raw/main/docs/onnx-horizontal-color.png" /></p>
 
-
-[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/Windows-CI?branchName=main)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=5&branchName=main)
-[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/Linux-CI?branchName=main)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=7&branchName=main)
-[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/MacOS-CI?branchName=main)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=6&branchName=main)
+[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/Windows-CI?branchName=main&label=Windows)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=5&branchName=main)
+[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/Linux-CI?branchName=main&label=Linux)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=7&branchName=main)
+[![Build Status](https://dev.azure.com/onnx-pipelines/onnx/_apis/build/status/MacOS-CI?branchName=main&label=MacOS)](https://dev.azure.com/onnx-pipelines/onnx/_build/latest?definitionId=6&branchName=main)
 [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/3313/badge)](https://bestpractices.coreinfrastructure.org/projects/3313)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/onnx/onnx/badge)](https://api.securityscorecards.dev/projects/github.com/onnx/onnx)
+[![REUSE compliant](https://api.reuse.software/badge/github.com/onnx/onnx)](https://api.reuse.software/info/github.com/onnx/onnx)
+
 
 [Open Neural Network Exchange (ONNX)](https://onnx.ai) is an open ecosystem that empowers AI developers
 to choose the right tools as their project evolves. ONNX provides an open source format for AI models, both deep learning and traditional ML. It defines an extensible computation graph model, as well as definitions of built-in operators and standard
@@ -37,11 +39,13 @@ data types. Currently we focus on the capabilities needed for inferencing (scori
 ONNX is [widely supported](http://onnx.ai/supported-tools) and can be found in many frameworks, tools, and hardware. Enabling interoperability between different frameworks and streamlining the path from research to production helps increase the speed of innovation in the AI community. We invite the community to join us and further evolve ONNX.
 
 # Use ONNX
+
 * [Documentation of ONNX Python Package](https://onnx.ai/onnx/)
-* [Tutorials for creating ONNX models](https://github.com/onnx/tutorials).
+* [Tutorials for creating ONNX models](https://github.com/onnx/tutorials)
 * [Pre-trained ONNX models](https://github.com/onnx/models)
 
 # Learn about the ONNX spec
+
 * [Overview](docs/Overview.md)
 * [ONNX intermediate representation spec](docs/IR.md)
 * [Versioning principles of the spec](docs/Versioning.md)
@@ -50,38 +54,61 @@ ONNX is [widely supported](http://onnx.ai/supported-tools) and can be found in m
 * [Python API Overview](docs/PythonAPIOverview.md)
 
 # Programming utilities for working with ONNX Graphs
+
 * [Shape and Type Inference](docs/ShapeInference.md)
 * [Graph Optimization](https://github.com/onnx/optimizer)
 * [Opset Version Conversion](docs/VersionConverter.md)
 
 # Contribute
-ONNX is a [community project](community/readme.md). We encourage you to join the effort and contribute feedback, ideas, and code. You can participate in the [Special Interest Groups](community/sigs.md) and [Working Groups](community/working-groups.md) to shape the future of ONNX.
+
+ONNX is a community project and the open governance model is described [here](community/readme.md). We encourage you to join the effort and contribute feedback, ideas, and code. You can participate in the [Special Interest Groups](community/sigs.md) and [Working Groups](community/working-groups.md) to shape the future of ONNX.
 
 Check out our [contribution guide](docs/CONTRIBUTING.md) to get started.
 
 If you think some operator should be added to ONNX specification, please read
 [this document](docs/AddNewOp.md).
 
+# Community meetings
+
+The schedules of the regular meetings of the Steering Committee, the working groups and the SIGs can be found [here](https://onnx.ai/calendar)
+
+Community Meetups are held at least once a year. Content from previous community meetups are at:
+
+* 2020.04.09 <https://wiki.lfaidata.foundation/display/DL/LF+AI+Day+-ONNX+Community+Virtual+Meetup+-+Silicon+Valley+-+April+9>
+* 2020.10.14 <https://wiki.lfaidata.foundation/display/DL/LF+AI+Day+-+ONNX+Community+Workshop+-+October+14>
+* 2021.03.24 <https://wiki.lfaidata.foundation/pages/viewpage.action?pageId=35160391>
+* 2021.10.21 <https://wiki.lfaidata.foundation/pages/viewpage.action?pageId=46989689>
+* 2022.06.24 <https://wiki.lfaidata.foundation/display/DL/ONNX+Community+Day+-+June+24>
+
 # Discuss
+
 We encourage you to open [Issues](https://github.com/onnx/onnx/issues), or use [Slack](https://lfaifoundation.slack.com/) (If you have not joined yet, please use this [link](https://join.slack.com/t/lfaifoundation/shared_invite/zt-o65errpw-gMTbwNr7FnNbVXNVFkmyNA) to join the group) for more real-time discussion.
 
 # Follow Us
+
 Stay up to date with the latest ONNX news. [[Facebook](https://www.facebook.com/onnxai/)] [[Twitter](https://twitter.com/onnxai)]
 
+# Roadmap
+
+A roadmap process takes place every year. More details can be found [here](https://github.com/onnx/steering-committee/tree/main/roadmap)
 
 # Installation
 
 ## Official Python packages
+
 ONNX released packages are published in PyPi.
-```
+
+```sh
 pip install onnx
 ```
 
-[Weekly packages](https://test.pypi.org/project/onnx-weekly/) are published in test pypi to enable experimentation and early testing.
+[ONNX weekly packages](https://pypi.org/project/onnx-weekly/) are published in PyPI to enable experimentation and early testing.
 
 ## vcpkg packages
+
 onnx is in the maintenance list of [vcpkg](https://github.com/microsoft/vcpkg), you can easily use vcpkg to build and install it.
-```
+
+```sh
 git clone https://github.com/microsoft/vcpkg.git
 cd vcpkg
 ./bootstrap-vcpkg.bat # For powershell
@@ -90,13 +117,15 @@ cd vcpkg
 ```
 
 ## Conda packages
+
 A binary build of ONNX is available from [Conda](https://conda.io), in [conda-forge](https://conda-forge.org/):
-```
+
+```sh
 conda install -c conda-forge onnx
 ```
 
-
 ## Build ONNX from Source
+
 Before building from source uninstall any existing versions of onnx `pip uninstall onnx`.
 
 c++17 or higher C++ compiler version is required to build ONNX from source on Windows. For other platforms, please use C++11 or higher versions.
@@ -104,23 +133,27 @@ c++17 or higher C++ compiler version is required to build ONNX from source on Wi
 Generally speaking, you need to install [protobuf C/C++ libraries and tools](https://github.com/protocolbuffers/protobuf) before proceeding forward. Then depending on how you installed protobuf, you need to set environment variable CMAKE_ARGS to "-DONNX_USE_PROTOBUF_SHARED_LIBS=ON" or "-DONNX_USE_PROTOBUF_SHARED_LIBS=OFF".  For example, you may need to run the following command:
 
 Linux:
-```bash
+
+```sh
 export CMAKE_ARGS="-DONNX_USE_PROTOBUF_SHARED_LIBS=ON"
 ```
+
 Windows:
+
 ```bat
 set CMAKE_ARGS="-DONNX_USE_PROTOBUF_SHARED_LIBS=ON"
 ```
 
 The ON/OFF depends on what kind of protobuf library you have. Shared libraries are files ending with \*.dll/\*.so/\*.dylib. Static libraries are files ending with \*.a/\*.lib. This option depends on how you get your protobuf library and how it was built. And it is default OFF. You don't need to run the commands above if you'd prefer to use a static protobuf library.
 
-
 ### Windows
+
 If you are building ONNX from source, it is recommended that you also build Protobuf locally as a static library. The version distributed with conda-forge is a DLL, but ONNX expects it to be a static library. Building protobuf locally also lets you control the version of protobuf. The tested and recommended version is 3.20.2.
 
 The instructions in this README assume you are using Visual Studio.  It is recommended that you run all the commands from a shell started from "x64 Native Tools Command Prompt for VS 2019" and keep the build system generator for cmake (e.g., cmake -G "Visual Studio 16 2019") consistent while building protobuf as well as ONNX.
 
 You can get protobuf by running the following commands:
+
 ```bat
 git clone https://github.com/protocolbuffers/protobuf.git
 cd protobuf
@@ -130,6 +163,7 @@ cmake -G "Visual Studio 16 2019" -A x64 -DCMAKE_INSTALL_PREFIX=<protobuf_install
 msbuild protobuf.sln /m /p:Configuration=Release
 msbuild INSTALL.vcxproj /p:Configuration=Release
 ```
+
 Then it will be built as a static library and installed to <protobuf_install_dir>. Please add the bin directory(which contains protoc.exe) to your PATH.
 
 ```bat
@@ -139,11 +173,13 @@ set PATH=<protobuf_install_dir>/bin;%PATH%
 Please note: if your protobuf_install_dir contains spaces, **do not** add quotation marks around it.
 
 Alternative: if you don't want to change your PATH, you can set ONNX_PROTOC_EXECUTABLE instead.
+
 ```bat
 set CMAKE_ARGS=-DONNX_PROTOC_EXECUTABLE=<full_path_to_protoc.exe>
 ```
 
 Then you can build ONNX as:
+
 ```
 git clone https://github.com/onnx/onnx.git
 cd onnx
@@ -155,12 +191,14 @@ pip install -e .
 
 ### Linux
 
-First, you need to install protobuf. The minimum Protobuf compiler (protoc) version required by ONNX is 3.0.0. Please note that old protoc versions might not work with `CMAKE_ARGS=-DONNX_USE_LITE_PROTO=ON`.
+First, you need to install protobuf. The minimum Protobuf compiler (protoc) version required by ONNX is 3.6.1. Please note that old protoc versions might not work with `CMAKE_ARGS=-DONNX_USE_LITE_PROTO=ON`.
+
+Ubuntu 20.04 (and newer) users may choose to install protobuf via
 
-Ubuntu 18.04 (and newer) users may choose to install protobuf via
-```bash
+```sh
 apt-get install python3-pip python3-dev libprotobuf-dev protobuf-compiler
 ```
+
 In this case, it is required to add `-DONNX_USE_PROTOBUF_SHARED_LIBS=ON` to CMAKE_ARGS in the ONNX build step.
 
 A more general way is to build and install it from source. See the instructions below for more details.
@@ -169,7 +207,8 @@ A more general way is to build and install it from source. See the instructions
   <summary> Installing Protobuf from source </summary>
 
   Debian/Ubuntu:
-  ```bash
+
+  ```sh
     git clone https://github.com/protocolbuffers/protobuf.git
     cd protobuf
     git checkout v3.20.2
@@ -181,7 +220,8 @@ A more general way is to build and install it from source. See the instructions
   ```
 
   CentOS/RHEL/Fedora:
-  ```bash
+
+  ```sh
     git clone https://github.com/protocolbuffers/protobuf.git
     cd protobuf
     git checkout v3.20.2
@@ -198,9 +238,9 @@ A more general way is to build and install it from source. See the instructions
 
 </details>
 
-
 Then you can build ONNX as:
-```
+
+```sh
 git clone https://github.com/onnx/onnx.git
 cd onnx
 git submodule update --init --recursive
@@ -211,7 +251,7 @@ pip install -e .
 
 ### Mac
 
-```
+```sh
 export NUM_CORES=`sysctl -n hw.ncpu`
 brew update
 brew install autoconf && brew install automake
@@ -227,7 +267,8 @@ make install
 Once build is successful, update PATH to include protobuf paths.
 
 Then you can build ONNX as:
-```
+
+```sh
 git clone --recursive https://github.com/onnx/onnx.git
 cd onnx
 # Optional: prefer lite proto
@@ -235,58 +276,61 @@ set CMAKE_ARGS=-DONNX_USE_LITE_PROTO=ON
 pip install -e .
 ```
 
-
 ## Verify Installation
+
 After installation, run
 
-```
+```sh
 python -c "import onnx"
 ```
 
 to verify it works.
 
-
 ## Common Build Options
+
 For full list refer to CMakeLists.txt
-**Environment variables**
+
+### Environment variables
+
 * `USE_MSVC_STATIC_RUNTIME` should be 1 or 0, not ON or OFF. When set to 1 onnx links statically to runtime library.
-**Default**: USE_MSVC_STATIC_RUNTIME=0
+**Default**: `USE_MSVC_STATIC_RUNTIME=0`
 
 * `DEBUG` should be 0 or 1. When set to 1 onnx is built in debug mode. or debug versions of the dependencies, you need to open the [CMakeLists file](CMakeLists.txt) and append a letter `d` at the end of the package name lines. For example, `NAMES protobuf-lite` would become `NAMES protobuf-lited`.
-**Default**: Debug=0
+**Default**: `Debug=0`
 
-**CMake variables**
-* `ONNX_USE_PROTOBUF_SHARED_LIBS` should be ON or OFF.
-**Default**: ONNX_USE_PROTOBUF_SHARED_LIBS=OFF USE_MSVC_STATIC_RUNTIME=0
-`ONNX_USE_PROTOBUF_SHARED_LIBS` determines how onnx links to protobuf libraries.
-    - When set to ON - onnx will dynamically link to protobuf shared libs, PROTOBUF_USE_DLLS will be defined as described [here](https://github.com/protocolbuffers/protobuf/blob/master/cmake/README.md#dlls-vs-static-linking), Protobuf_USE_STATIC_LIBS will be set to OFF and `USE_MSVC_STATIC_RUNTIME` must be 0.
-    - When set to OFF - onnx will link statically to protobuf, and Protobuf_USE_STATIC_LIBS will be set to ON (to force the use of the static libraries) and `USE_MSVC_STATIC_RUNTIME` can be 0 or 1.
+### CMake variables
 
-* `ONNX_USE_LITE_PROTO` should be ON or OFF. When set to ON onnx uses lite protobuf instead of full protobuf.
-**Default**: ONNX_USE_LITE_PROTO=OFF
+* `ONNX_USE_PROTOBUF_SHARED_LIBS` should be `ON` or `OFF`.
+**Default**: `ONNX_USE_PROTOBUF_SHARED_LIBS=OFF USE_MSVC_STATIC_RUNTIME=0`
+`ONNX_USE_PROTOBUF_SHARED_LIBS` determines how onnx links to protobuf libraries.
+  * When set to `ON` - onnx will dynamically link to protobuf shared libs, PROTOBUF_USE_DLLS will be defined as described [here](https://github.com/protocolbuffers/protobuf/blob/main/cmake/README.md#dlls-vs-static-linking), Protobuf_USE_STATIC_LIBS will be set to `OFF` and `USE_MSVC_STATIC_RUNTIME` must be 0.
+  * When set to `OFF` - onnx will link statically to protobuf, and Protobuf_USE_STATIC_LIBS will be set to `ON` (to force the use of the static libraries) and `USE_MSVC_STATIC_RUNTIME` can be `0` or `1`.
 
-* `ONNX_WERROR` should be ON or OFF. When set to ON warnings are treated as errors.
-**Default**: ONNX_WERROR=OFF in local builds, ON in CI and release pipelines.
+* `ONNX_USE_LITE_PROTO` should be `ON` or `OFF`. When set to `ON` onnx uses lite protobuf instead of full protobuf.
+**Default**: `ONNX_USE_LITE_PROTO=OFF`
 
+* `ONNX_WERROR` should be `ON` or `OFF`. When set to `ON` warnings are treated as errors.
+**Default**: `ONNX_WERROR=OFF` in local builds, `ON` in CI and release pipelines.
 
 ## Common Errors
+
 * Note: the `import onnx` command does not work from the source checkout directory; in this case you'll see `ModuleNotFoundError: No module named 'onnx.onnx_cpp2py_export'`. Change into another directory to fix this error.
 
 * If you run into any issues while building Protobuf as a static library, please ensure that shared Protobuf libraries, like libprotobuf, are not installed on your device or in the conda environment. If these shared libraries exist, either remove them to build Protobuf from source as a static library, or skip the Protobuf build from source to use the shared version directly.
 
-* If you run into any issues while building ONNX from source, and your error message reads, "Could not find pythonXX.lib", ensure that you have consistent Python versions for common commands, such as `python` and `pip`. Clean all existing build files and rebuild ONNX again.
+* If you run into any issues while building ONNX from source, and your error message reads, `Could not find pythonXX.lib`, ensure that you have consistent Python versions for common commands, such as `python` and `pip`. Clean all existing build files and rebuild ONNX again.
 
 # Testing
 
-ONNX uses [pytest](https://docs.pytest.org) as test driver. In order to run tests, you will first need to install pytest:
+ONNX uses [pytest](https://docs.pytest.org) as test driver. In order to run tests, you will first need to install `pytest`:
 
-```
+```sh
 pip install pytest nbval
 ```
 
 After installing pytest, use the following command to run tests.
 
-```
+```sh
 pytest
 ```