1- # Python for .NET
1+ # Python.NET
22
3- Python for .NET (` pythonnet ` ) is a package that gives Python programmers
3+ Python.NET (` pythonnet ` ) is a package that gives Python programmers
44nearly seamless integration with the .NET 4.0+ Common Language Runtime
5- (CLR) on Windows and Mono runtime on Linux and OSX. Python for .NET
5+ (CLR) on Windows and Mono runtime on Linux and OSX. Python.NET
66provides a powerful application scripting tool for .NET developers.
77Using this package you can script .NET applications or build entire
88applications in Python, using .NET services and components written in
@@ -17,22 +17,22 @@ speeds for Python code. If you are interested in a pure managed-code
1717implementation of the Python language, you should check out the
1818[ IronPython] [ 1 ] project, which is in active development.
1919
20- Python for .NET is currently compatible and tested with Python releases
21- 2.7 and 3.5-3.7 .
22- Current releases are available at the [ Python for .NET website] [ 2 ] .
23- To subscribe to the [ Python for .NET mailing list] [ 3 ] or read the
20+ Python.NET is currently compatible and tested with Python releases
21+ 2.7 and 3.5-3.8 .
22+ Current releases are available at the [ Python.NET website] [ 2 ] .
23+ To subscribe to the [ Python.NET mailing list] [ 3 ] or read the
2424[ online archives] [ 4 ] of the list, see the [ mailing list information] [ 3 ]
25- page. Use the [ Python for .NET issue tracker] [ 55 ] to report issues.
25+ page. Use the [ Python.NET issue tracker] [ 55 ] to report issues.
2626
27- - This page provides a detailed overview of Python for .NET,
27+ - This page provides a detailed overview of Python.NET,
2828 as well as some basic usage examples. Many other examples can be
2929 found in the demos and unit tests for the package.
3030- Checkout the [ PythonNet] [ 77 ] code from github.
3131- [ Download releases] [ 6 ] for various versions of Python and CLR.
3232
3333## Installation
3434
35- Python for .NET is available as a source release on [ GitHub] [ 5 ] and as a
35+ Python.NET is available as a source release on [ GitHub] [ 5 ] and as a
3636binary wheel distribution for all supported versions of Python and the
3737common language runtime from the [ Python Package Index] [ 6 ] .
3838
@@ -53,12 +53,12 @@ may be problems.
5353
5454## Getting Started
5555
56- A key goal for this project has been that Python for .NET should
56+ A key goal for this project has been that Python.NET should
5757"work just the way you'd expect in Python", except for cases that are
5858.NET specific (in which case the goal is to work "just the way
5959you'd expect in C#"). In addition, with the IronPython project having
6060established a community, it is my goal that code written for IronPython
61- run without modification under Python for .NET.
61+ run without modification under Python.NET.
6262
6363If you already know Python, you can probably finish this readme and then
6464refer to .NET docs to figure out anything you need to do. Conversely if
@@ -73,7 +73,7 @@ source directory of the distribution that can be helpful as examples.
7373
7474## Importing Modules
7575
76- Python for .NET allows CLR namespaces to be treated essentially as
76+ Python.NET allows CLR namespaces to be treated essentially as
7777Python packages.
7878
7979``` python
@@ -90,20 +90,20 @@ clr.AddReference("System.Windows.Forms")
9090from System.Windows.Forms import Form
9191```
9292
93- ** Note** Earlier releases of Python for .NET relied on "implicit loading"
93+ ** Note** Earlier releases of Python.NET relied on "implicit loading"
9494to support automatic loading of assemblies whose names corresponded to an
9595imported namespace. Implicit loading still works for backward compatibility,
9696but will be removed in a future release so it is recommended to use
9797the ` clr.AddReference ` method.
9898
99- Python for .NET uses the PYTHONPATH (sys.path) to look for assemblies
99+ Python.NET uses the PYTHONPATH (sys.path) to look for assemblies
100100to load, in addition to the usual application base and the GAC. To ensure
101101that you can implicitly import an assembly, put the directory containing
102102the assembly in ` sys.path ` .
103103
104104## Using Classes
105105
106- Python for .NET allows you to use any non-private classes, structs,
106+ Python.NET allows you to use any non-private classes, structs,
107107interfaces, enums or delegates from Python. To create an instance of a
108108managed class, you use the standard instantiation syntax, passing a set
109109of arguments that match one of its public constructors:
@@ -114,7 +114,7 @@ from System.Drawing import Point
114114p = Point(5 , 5 )
115115```
116116
117- In most cases, Python for .NET can determine the correct constructor to
117+ In most cases, Python.NET can determine the correct constructor to
118118call automatically based on the arguments. In some cases, it may be necessary
119119to call a particular overloaded constructor, which is supported by a special
120120` __overloads__ ` attribute, which will soon be deprecated in favor of
@@ -229,7 +229,7 @@ help(Environment)
229229
230230## Overloaded and Generic Methods
231231
232- While Python for .NET will generally be able to figure out the right
232+ While Python.NET will generally be able to figure out the right
233233version of an overloaded method to call automatically, there are cases
234234where it is desirable to select a particular method overload explicitly.
235235
@@ -384,7 +384,7 @@ the PythonNet assembly directory or on the PYTHONPATH in order to load them.
384384
385385## Type Conversion
386386
387- Type conversion under Python for .NET is fairly straightforward - most
387+ Type conversion under Python.NET is fairly straightforward - most
388388elemental Python types (string, int, long, etc.) convert automatically to
389389compatible managed equivalents (String, Int32, etc.) and vice-versa.
390390Note that all strings returned from the CLR are returned as unicode.
@@ -402,7 +402,7 @@ value type object to be created on the heap, which then has reference
402402type semantics.
403403
404404Understanding boxing and the distinction between value types and reference
405- types can be important when using Python for .NET because the Python
405+ types can be important when using Python.NET because the Python
406406language has no value type semantics or syntax - in Python
407407"everything is a reference".
408408
@@ -468,7 +468,7 @@ differences between value types and reference types.
468468
469469## Embedding Python
470470
471- ** Note:** because Python code running under Python for .NET is inherently
471+ ** Note:** because Python code running under Python.NET is inherently
472472unverifiable, it runs totally under the radar of the security infrastructure
473473of the CLR so you should restrict use of the Python assembly to trusted code.
474474
@@ -494,7 +494,7 @@ call objects in a module you import.
494494
495495For general-purpose information on embedding Python in applications,
496496use www.python.org or Google to find (C) examples. Because
497- Python for .NET is so closely integrated with the managed environment,
497+ Python.NET is so closely integrated with the managed environment,
498498you will generally be better off importing a module and deferring to
499499Python code as early as possible rather than writing a lot of managed
500500embedding code.
@@ -582,20 +582,24 @@ using (Py.GIL())
582582
583583## License
584584
585- Python for .NET is released under the open source MIT License.
585+ Python.NET is released under the open source MIT License.
586586A copy of the license is included in the distribution,
587587or you can find a copy of the [ license online] [ 9 ] .
588588
589589Some distributions of this package include a copy of the C Python dlls and
590590standard library, which are covered by the [ Python license] [ 10 ] .
591591
592+ ## .NET Foundation
593+
594+ This project is supported by the [ .NET Foundation] ( https://dotnetfoundation.org ) .
595+
592596[ 1 ] : http://www.ironpython.com
593597
594598[ 2 ] : http://pythonnet.github.io/
595599
596- [ 3 ] : http ://mail.python.org/mailman/listinfo/pythondotnet
600+ [ 3 ] : https ://mail.python.org/mailman3/lists/pythonnet.python.org/
597601
598- [ 4 ] : http ://mail.python.org/pipermail/pythondotnet /
602+ [ 4 ] :
https ://mail.python.org/archives/list/[email protected] /599603
600604[ 5 ] : https://github.com/pythonnet/pythonnet/releases
601605
0 commit comments