Sep 29, 2022 · Jun 27, 2022 · Jun 30, 2022 · Jun 28, 2022 · Jul 5, 2022 · Jul 6, 2022
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
 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/release'
    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/CHANGELOG.md b/CHANGELOG.md
     able to access members that are part of the implementation class, but not the
     interface.  Use the new `__implementation__` or `__raw_implementation__` properties to
     if you need to "downcast" to the implementation class.
 -   BREAKING: `==` and `!=` operators on `PyObject` instances now use Python comparison
     (previously was equivalent to `object.ReferenceEquals(,)`)
 -   BREAKING: Parameters marked with `ParameterAttributes.Out` are no longer returned in addition
     to the regular method return value (unless they are passed with `ref` or `out` keyword).
 -   BREAKING: Drop support for the long-deprecated CLR.* prefix.
 -   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
diff --git a/Directory.Build.props b/Directory.Build.props
    <AssemblyProduct>Python.NET</AssemblyProduct>
    <LangVersion>10.0</LangVersion>
    <IsPackable>false</IsPackable>
    <FullVersion>$([System.IO.File]::ReadAllText("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
 recursive-include src/ *
 graft src/runtime
 prune src/runtime/obj
 prune src/runtime/bin
 include src/pythonnet.snk
 include Directory.Build.*
 include pythonnet.sln
 include version.txt
 global-exclude **/obj/* **/bin/*
diff --git a/README.rst b/README.rst
 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
 -----------------------------

   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
 ------------------------

   (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
 doxygen_xml/
 build/
Original file line number	Diff line number	Diff line change
		@@ -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/release'
		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
Original file line number	Diff line number	Diff line change
Expand Up		@@ -45,6 +45,8 @@ details about the cause of the failure
		able to access members that are part of the implementation class, but not the
		interface. Use the new `__implementation__` or `__raw_implementation__` properties to
		if you need to "downcast" to the implementation class.
		- BREAKING: `==` and `!=` operators on `PyObject` instances now use Python comparison
		(previously was equivalent to `object.ReferenceEquals(,)`)
		- BREAKING: Parameters marked with `ParameterAttributes.Out` are no longer returned in addition
		to the regular method return value (unless they are passed with `ref` or `out` keyword).
		- BREAKING: Drop support for the long-deprecated CLR.* prefix.
Expand All		@@ -65,6 +67,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
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,7 +6,7 @@
		<AssemblyProduct>Python.NET</AssemblyProduct>
		<LangVersion>10.0</LangVersion>
		<IsPackable>false</IsPackable>
		<FullVersion>$([System.IO.File]::ReadAllText("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>
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,5 +1,7 @@
		recursive-include src/ *
		graft src/runtime
		prune src/runtime/obj
		prune src/runtime/bin
		include src/pythonnet.snk
		include Directory.Build.*
		include pythonnet.sln
		include version.txt
		global-exclude */obj/ */bin/
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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
		-----------------------------

Expand All		@@ -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
		------------------------

Expand All		@@ -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
Expand Down