Unity-Technologies · BadSingleton · Jun 30, 2022 · Jun 30, 2022 · Jun 28, 2022 · Jul 6, 2022
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -0,0 +1,40 @@
+name: Documentation
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - name: Doxygen Action
+      uses: mattnotmitt/doxygen-action@1.9.4
+      with:
+        working-directory: "doc/"
+
+    - name: Build Sphinx documentation
+      run: |
+        pip install -r doc/requirements.txt
+        sphinx-build doc/source/ ./doc/build/html/
+
+    - name: Upload artifact
+      # Automatically uploads an artifact from the './_site' directory by default
+      uses: actions/upload-pages-artifact@v1
+      with:
+        path: doc/build/html/
+
+  deploy:
+    if: github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -16,7 +16,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [windows, ubuntu, macos]
-        python: ["3.7", "3.8", "3.9", "3.10"]
+        python: ["3.7", "3.8", "3.9", "3.10", "3.11"]
         platform: [x64, x86]
         exclude:
           - os: ubuntu
@@ -54,15 +54,17 @@ jobs:
         run: |
           pip install -v .
 
-      - name: Set Python DLL path (non Windows)
+      - name: Set Python DLL path and PYTHONHOME (non Windows)
         if: ${{ matrix.os != 'windows' }}
         run: |
           echo PYTHONNET_PYDLL=$(python -m find_libpython) >> $GITHUB_ENV
+          echo PYTHONHOME=$(python -c 'import sys; print(sys.prefix)') >> $GITHUB_ENV
 
-      - name: Set Python DLL path (Windows)
+      - name: Set Python DLL path and PYTHONHOME (Windows)
         if: ${{ matrix.os == 'windows' }}
         run: |
           Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append -InputObject "PYTHONNET_PYDLL=$(python -m find_libpython)"
+          Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append -InputObject "PYTHONHOME=$(python -c 'import sys; print(sys.prefix)')"
 
       - name: Embedding tests
         run: dotnet test --runtime any-${{ matrix.platform }} --logger "console;verbosity=detailed" src/embed_tests/

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,31 @@ This document follows the conventions laid out in [Keep a CHANGELOG][].
 
 ### Added
 
+### Changed
+
+### Fixed
+
+## [3.0.1](https://github.com/pythonnet/pythonnet/releases/tag/v3.0.1) - 2022-11-03
+
+### Added
+
+-   Support for Python 3.11
+
+### Changed
+
+-   Allow decoders to override conversion of types derived from primitive types
+
+### Fixed
+
+-   Fixed objects leaking when Python attached event handlers to them even if they were later removed
+-   Fixed `PyInt` conversion to `BigInteger` and `System.String` produced incorrect result for values between 128 and 255.
+-   Fixed implementing a generic interface with a Python class
+
+
+## [3.0.0](https://github.com/pythonnet/pythonnet/releases/tag/v3.0.0) - 2022-09-29
+
+### Added
+
 -   Ability to instantiate new .NET arrays using `Array[T](dim1, dim2, ...)` syntax
 -   Python operator method will call C# operator method for supported binary and unary operators ([#1324][p1324]).
 -   Add GetPythonThreadID and Interrupt methods in PythonEngine
@@ -67,6 +92,9 @@ or the DLL must be loaded in advance. This must be done before calling any other
 -   BREAKING: disabled implicit conversion from C# enums to Python `int` and back.
 One must now either use enum members (e.g. `MyEnum.Option`), or use enum constructor
 (e.g. `MyEnum(42)` or `MyEnum(42, True)` when `MyEnum` does not have a member with value 42).
+-   BREAKING: disabled implicit conversion from Python objects implementing sequence protocol to
+.NET arrays when the target .NET type is `System.Object`. The conversion is still attempted when the
+target type is a `System.Array`.
 -   Sign Runtime DLL with a strong name
 -   Implement loading through `clr_loader` instead of the included `ClrModule`, enables
     support for .NET Core
@@ -131,7 +159,24 @@ There is no need to specify it.
 -   support for .NET Framework 4.0-4.6; Mono before 5.4. Python.NET now requires .NET Standard 2.0
 (see [the matrix](https://docs.microsoft.com/en-us/dotnet/standard/net-standard#net-implementation-support))
 
-## [2.5.0][] - 2020-06-14
+## [2.5.2](https://github.com/pythonnet/pythonnet/releases/tag/v2.5.2) - 2021-02-05
+
+Bugfix release.
+
+### Fixed
+-   Fix `object[]` parameters taking precedence when should not in overload resolution
+-   Empty parameter names (as can be generated from F#) do not cause crashes
+
+## [2.5.1](https://github.com/pythonnet/pythonnet/releases/tag/v2.5.1) - 2020-06-18
+
+Bugfix release.
+
+### Fixed
+
+-    Fix incorrect dereference of wrapper object in `tp_repr`, which may result in a program crash
+-    Fix incorrect dereference in params array handling
+
+## [2.5.0](https://github.com/pythonnet/pythonnet/releases/tag/v2.5.0) - 2020-06-14
 
 This version improves performance on benchmarks significantly compared to 2.3.
 

diff --git a/Directory.Build.props b/Directory.Build.props
@@ -6,7 +6,7 @@
     <AssemblyProduct>Python.NET</AssemblyProduct>
     <LangVersion>10.0</LangVersion>
     <IsPackable>false</IsPackable>
-    <FullVersion>$([System.IO.File]::ReadAllText($(MSBuildThisFileDirectory)version.txt))</FullVersion>
+    <FullVersion>$([System.IO.File]::ReadAllText("$(MSBuildThisFileDirectory)version.txt").Trim())</FullVersion>
     <VersionPrefix>$(FullVersion.Split('-', 2)[0])</VersionPrefix>
     <VersionSuffix Condition="$(FullVersion.Contains('-'))">$(FullVersion.Split('-', 2)[1])</VersionSuffix>
   </PropertyGroup>

diff --git a/MANIFEST.in b/MANIFEST.in
@@ -1,6 +1,7 @@
 graft src/runtime
 prune src/runtime/obj
 prune src/runtime/bin
+include src/pythonnet.snk
 include Directory.Build.*
 include pythonnet.sln
 include version.txt
diff --git a/README.rst b/README.rst
@@ -17,11 +17,6 @@ provides a powerful application scripting tool for .NET developers. It
 allows Python code to interact with the CLR, and may also be used to
 embed Python into a .NET application.
 
-.. note::
-   The master branch of this repository tracks the ongoing development of version 3.0.
-   Backports of patches to 2.5 are tracked in the
-   `backports-2.5 branch <https://github.com/pythonnet/pythonnet/tree/backports-2.5>`_.
-
 Calling .NET code from Python
 -----------------------------
 
@@ -42,6 +37,25 @@ module:
    clr.AddReference("System.Windows.Forms")
    from System.Windows.Forms import Form
 
+By default, Mono will be used on Linux and macOS, .NET Framework on Windows. For
+details on the loading of different runtimes, please refer to the documentation.
+
+.NET Core
+~~~~~~~~~
+
+If .NET Core is installed in a default location or the ``dotnet`` CLI tool is on
+the ``PATH``, loading it instead of the default (Mono/.NET Framework) runtime
+just requires setting either the environment variable
+``PYTHONNET_RUNTIME=coreclr`` or calling ``pythonnet.load`` explicitly:
+
+.. code-block:: python
+
+   from pythonnet import load
+   load("coreclr")
+
+   import clr
+
+
 Embedding Python in .NET
 ------------------------
 
@@ -50,6 +64,8 @@ Embedding Python in .NET
    (internal, derived from ``MissingMethodException``) upon calling ``Initialize``.
    Typical values are ``python38.dll`` (Windows), ``libpython3.8.dylib`` (Mac),
    ``libpython3.8.so`` (most other Unix-like operating systems).
+-  Then call ``PythonEngine.Initialize()``. If you plan to use Python objects from
+   multiple threads, also call ``PythonEngine.BeginAllowThreads()``.
 -  All calls to python should be inside a
    ``using (Py.GIL()) {/* Your code here */}`` block.
 -  Import python modules using ``dynamic mod = Py.Import("mod")``, then

diff --git a/doc/.gitignore b/doc/.gitignore
@@ -0,0 +1,2 @@
+doxygen_xml/
+build/