Oct 16, 2021 · Oct 15, 2021
diff --git a/src/runtime/Python.Runtime.csproj b/src/runtime/Python.Runtime.csproj
    <PackageIcon>python-clear.png</PackageIcon>
    <PackageIconUrl>https://raw.githubusercontent.com/pythonnet/pythonnet/master/src/console/python-clear.ico</PackageIconUrl>
    <PackageProjectUrl>https://pythonnet.github.io/</PackageProjectUrl>
    <PackageReadmeFile>README.md</PackageReadmeFile>
    <PublishRepositoryUrl>true</PublishRepositoryUrl>
    <Description>Python and CLR (.NET and Mono) cross-platform language interop</Description>


  <ItemGroup>
    <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
    <None Include="README.md" Pack="true" PackagePath="" />
    <None Include="..\..\src\console\python-clear.png" Pack="true" PackagePath="" />
  </ItemGroup>

diff --git a/src/runtime/README.md b/src/runtime/README.md
 `pythonnet` is a package that gives .NET programmers ability to
 integrate Python engine and use Python libraries.

 ## Embedding Python in .NET

 -  You must set `Runtime.PythonDLL` property or `PYTHONNET_PYDLL` environment variable,
   otherwise you will receive `BadPythonDllException`
   (internal, derived from `MissingMethodException`) upon calling `Initialize`.
   Typical values are `python38.dll` (Windows), `libpython3.8.dylib` (Mac),
   `libpython3.8.so` (most other *nix). Full path may be required.
 -  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
   you can call functions as normal, eg `mod.func(args)`.
   You can also access Python objects via `PyObject` and dervied types
   instead of using `dynamic`.
 -  Use `mod.func(args, Py.kw("keywordargname", keywordargvalue))` or
   `mod.func(args, keywordargname: keywordargvalue)` to apply keyword
   arguments.
 -  Mathematical operations involving python and literal/managed types
   must have the python object first, eg. `np.pi * 2` works,
   `2 * np.pi` doesn't.

 ## Example

 ```csharp
 using var _ = Py.GIL();

 dynamic np = Py.Import("numpy");
 Console.WriteLine(np.cos(np.pi * 2));

 dynamic sin = np.sin;
 Console.WriteLine(sin(5));

 double c = (double)(np.cos(5) + sin(5));
 Console.WriteLine(c);

 dynamic a = np.array(new List<float> { 1, 2, 3 });
 Console.WriteLine(a.dtype);

 dynamic b = np.array(new List<float> { 6, 5, 4 }, dtype: np.int32);
 Console.WriteLine(b.dtype);

 Console.WriteLine(a * b);
 Console.ReadKey();
 ```

 Output:

 ```
 1.0
 -0.958924274663
 -0.6752620892
 float64
 int32
 [  6.  10.  12.]
 ```



 ## Resources

 Information on installation, FAQ, troubleshooting, debugging, and
 projects using pythonnet can be found in the Wiki:

 https://github.com/pythonnet/pythonnet/wiki

 Mailing list
    https://mail.python.org/mailman/listinfo/pythondotnet
 Chat
    https://gitter.im/pythonnet/pythonnet

 ### .NET Foundation

 This project is supported by the [.NET Foundation](https://dotnetfoundation.org).
Original file line number	Diff line number	Diff line change
Expand Up		@@ -14,6 +14,7 @@
		<PackageIcon>python-clear.png</PackageIcon>
		<PackageIconUrl>https://raw.githubusercontent.com/pythonnet/pythonnet/master/src/console/python-clear.ico</PackageIconUrl>
		<PackageProjectUrl>https://pythonnet.github.io/</PackageProjectUrl>
		<PackageReadmeFile>README.md</PackageReadmeFile>
		<PublishRepositoryUrl>true</PublishRepositoryUrl>
		<Description>Python and CLR (.NET and Mono) cross-platform language interop</Description>

Expand All		@@ -37,6 +38,7 @@

		<ItemGroup>
		<None Include="..\..\LICENSE" Pack="true" PackagePath="" />
		<None Include="README.md" Pack="true" PackagePath="" />
		<None Include="..\..\src\console\python-clear.png" Pack="true" PackagePath="" />
		</ItemGroup>

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,75 @@
		`pythonnet` is a package that gives .NET programmers ability to
		integrate Python engine and use Python libraries.

		## Embedding Python in .NET

		- You must set `Runtime.PythonDLL` property or `PYTHONNET_PYDLL` environment variable,
		otherwise you will receive `BadPythonDllException`
		(internal, derived from `MissingMethodException`) upon calling `Initialize`.
		Typical values are `python38.dll` (Windows), `libpython3.8.dylib` (Mac),
		`libpython3.8.so` (most other *nix). Full path may be required.
		- 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
		you can call functions as normal, eg `mod.func(args)`.
		You can also access Python objects via `PyObject` and dervied types
		instead of using `dynamic`.
		- Use `mod.func(args, Py.kw("keywordargname", keywordargvalue))` or
		`mod.func(args, keywordargname: keywordargvalue)` to apply keyword
		arguments.
		- Mathematical operations involving python and literal/managed types
		must have the python object first, eg. `np.pi * 2` works,
		`2 * np.pi` doesn't.

		## Example

		```csharp
		using var _ = Py.GIL();

		dynamic np = Py.Import("numpy");
		Console.WriteLine(np.cos(np.pi * 2));

		dynamic sin = np.sin;
		Console.WriteLine(sin(5));

		double c = (double)(np.cos(5) + sin(5));
		Console.WriteLine(c);

		dynamic a = np.array(new List<float> { 1, 2, 3 });
		Console.WriteLine(a.dtype);

		dynamic b = np.array(new List<float> { 6, 5, 4 }, dtype: np.int32);
		Console.WriteLine(b.dtype);

		Console.WriteLine(a * b);
		Console.ReadKey();
		```

		Output:

		```
		1.0
		-0.958924274663
		-0.6752620892
		float64
		int32
		[ 6. 10. 12.]
		```



		## Resources

		Information on installation, FAQ, troubleshooting, debugging, and
		projects using pythonnet can be found in the Wiki:

		https://github.com/pythonnet/pythonnet/wiki

		Mailing list
		https://mail.python.org/mailman/listinfo/pythondotnet
		Chat
		https://gitter.im/pythonnet/pythonnet

		### .NET Foundation

		This project is supported by the [.NET Foundation](https://dotnetfoundation.org).