From bc6eabe97d49cd2c12a1f7da399c04b0d4e7111b Mon Sep 17 00:00:00 2001 From: Xelus22 <17491233+Xelus22@users.noreply.github.com> Date: Mon, 1 May 2023 13:57:25 +1000 Subject: [PATCH 1/2] Update Notes-on-Packaging.md --- docs/Notes-on-Packaging.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/Notes-on-Packaging.md b/docs/Notes-on-Packaging.md index d4f6c54..3e2f32d 100644 --- a/docs/Notes-on-Packaging.md +++ b/docs/Notes-on-Packaging.md @@ -21,6 +21,9 @@ * setup.py describes the packaging configuration. (tested with with python==3.8.13, setuptools==63.4.1) * to build and install the package locally, run `python setup.py install` * to build wheel, run `python setup.py bdist_wheel [--plat-name=manylinux1_x86_64]` +* Installing with windows: + * Requires latest Visual Studio install. + * Run the above steps with python installed on target system while working from CMD or Powershell for VS 2022 ## Notes on working with recurse-submodules @@ -289,4 +292,4 @@ in [Running setuptools commands](https://setuptools.pypa.io/en/latest/deprecated ## Useful Resource * [Setup Tools Doc](https://setuptools.pypa.io/en/latest/) -* [wheel Doc](https://wheel.readthedocs.io/en/stable/index.html) \ No newline at end of file +* [wheel Doc](https://wheel.readthedocs.io/en/stable/index.html) From c468be9c9942dde36f71a6239a799dc3930bbfdd Mon Sep 17 00:00:00 2001 From: Xelus22 <17491233+Xelus22@users.noreply.github.com> Date: Mon, 1 May 2023 15:21:22 +1000 Subject: [PATCH 2/2] Update Notes-on-Packaging.md --- docs/Notes-on-Packaging.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/docs/Notes-on-Packaging.md b/docs/Notes-on-Packaging.md index 3e2f32d..d98a414 100644 --- a/docs/Notes-on-Packaging.md +++ b/docs/Notes-on-Packaging.md @@ -21,9 +21,6 @@ * setup.py describes the packaging configuration. (tested with with python==3.8.13, setuptools==63.4.1) * to build and install the package locally, run `python setup.py install` * to build wheel, run `python setup.py bdist_wheel [--plat-name=manylinux1_x86_64]` -* Installing with windows: - * Requires latest Visual Studio install. - * Run the above steps with python installed on target system while working from CMD or Powershell for VS 2022 ## Notes on working with recurse-submodules @@ -283,6 +280,23 @@ adding 'dnp3_python-0.2.3b2.dist-info/RECORD' removing build/bdist.linux-x86_64/wheel ``` +### Building on windows systems +To get started install the following programs: +* Latest Visual Studio (2022 at the time of writing) + * Desktop development with C++ - Workload + * Git for Windows - Individual components +* Local python install + * install python package `wheel` with `py -m pip install wheel` + +#### Compiling +* Open up powershell from within VS2022 - Tools -> Command Line -> Developer Powershell +* run a `git clone --recurse-submodules https://github.com/VOLTTRON/dnp3-python.git` to obtain the latest version +* `cd dnp3-python` +* `python setup.py install` +* `python setup.py bdist_wheel` +* the `whl` file should now be in the `dist` folder + + More information about [building wheels](https://wheel.readthedocs.io/en/stable/user_guide.html?highlight=bdist_wheel#building-wheels), [The Story of Wheel](https://wheel.readthedocs.io/en/stable/story.html?highlight=bdist_wheel#the-story-of-wheel),