Release 5.3.0

.github/ISSUE_TEMPLATE/BUG_REPORT.yml

@@ -12,7 +12,9 @@ body:
         Please make a little effort, do your research and [ask questions the smart way](http://www.catb.org/~esr/faqs/smart-questions.html#beprecise).
         **If you didn't fill the form properly or lie about the pre-flight checks, the issue could be closed without any explanation!** 
         ## 🚧🚧 Revit 2025 🚧🚧
-        pyRevit 4.8.x is not compatible with Revit 2025. If you really need it, you can try (**at your own risk!**) the WIP version that you can find at [this page](https://www.pyrevitlabs.io/)
+        pyRevit 4.8.x is not compatible with Revit 2025. 
+        Use pyRevit 5.0.0+, it is backwards compatible.
+        Latest WIP version can be found at [this page](https://www.pyrevitlabs.io/)
         ## 🚧 SentinelOne 🚧
         If you have SentinelOne installed as an antivirus, **look no further**.
         **You will need to create exceptions for Revit and pyRevit**, both on the software and the %appdata% folders. ask your IT guy to do that.

.github/copilot-instructions.md

@@ -0,0 +1,87 @@
+# Repository organization
+The pyRevit repository is organized in the following folders:
+
+- bin contains the binaries (dll and other support files) for pyRevit; usually a source repository doesn't have these, but it was made like this to be able to switch pyRevit versions using clones. This may change in the future and we could get rid of most content of this folder. Note that in this folder there also are the python envrionments (for example the CPython dlls and core packages).
+- dev is where the c# code resides.
+- docs is for the automatic generation of the documentation website
+- extensions holds the various pyRevit extensions; the pyRevitCore.extension is the one that build the pyRevit ribbon tab, the others can be enabled via the Extension button inside pyRevit itself. pyRevitDevTools is quite handy to run tests and check if pyRevit (and the modifications you'll do) is running fine.
+- extras are… extra files that can come in handy (icons and the dark mode generator are there to this date).
+- licenses contains all the licenses of the included third party projects.
+- pyrevitlib contains pyRevit and other related project's python libraries. It is usually the library that gets imported in the user scripts to ease the Revit API development.
+- release contains static assets needed to build the final product (pyrevit and pyrevit cli installers).
+- site-packages is the collection of third-party python packaces that are made available by pyRevit to the user. Given that the main python engine is IronPython 2.7.12, packages in that folder needs to be compatible with it.
+- static are assets for the website, youtube channels and so on, you can ignore it.
+
+# Understanding pyRevit Architecture
+This guide provides an overview of pyRevit’s architecture to help new contributors understand how the software works.
+Whether you want to create tools, troubleshoot issues, or contribute code, understanding these components will help you navigate the project.
+Components of pyRevit
+1. pyRevit Add-In (pyRevitLoader)
+    ◦ A small piece of C# code that starts pyRevit inside Revit.
+    ◦ It loads a Python script using the IronPython engine, which handles the rest of pyRevit’s functionality.
+2. pyRevit python Libraries (pyrevitlibs)
+    ◦ Python packages that simplify working with the .NET Revit API.
+    ◦ Provide tools to create ribbon buttons, run scripts, and more.
+3. Extensions
+    ◦ These are the tools and features users see inside Revit.
+    ◦ They are mostly written in python, but can also be C#/VB.NET scripts, dynamo projects, and so on
+    ◦ Bundled extensions appear in the "pyRevit" tab, offering many tools.
+    ◦ Users can add extensions by:
+        ▪ Enabling listed extensions in dev/extensions/extensions.json via the “Extensions” button in pyRevit.
+        ▪ Creating custom extensions and adding their paths to the configuration.
+4. pyRevit Command-Line Interface (CLI)
+    ◦ A tool for managing configurations, running scripts in bulk, and troubleshooting.
+    ◦ Useful for corporate setups and advanced users.
+5. Telemetry Server
+    ◦ A small server (written in Go) that tracks usage data of pyRevit tools.
+    ◦ Stores data in MongoDB or PostgreSQL for business intelligence.
+How pyRevit Loads in Revit
+TL;DR:
+• Revit reads the .addin manifest in the Addins folders
+• The .addin manifest points to pyRevitLoader.dll
+• pyRevitLoader.dll launches pyrevitloader.py inside an IronPython environment
+• pyrevitloader.py calls functions from the pyrevit python package to build the UI and the buttons commands.
+.addin Manifest
+• The installer creates a file with .addin extension, called manifest, in the Revit Addins folder, instructing Revit to load pyRevit when it starts.
+• The Addins folder can be located in one of these paths, depending on pyRevit installation:
+    ◦ C:\ProgramData\Autodesk\Revit\Addins (for all users)
+    ◦ %APPDATA%\Autodesk\Revit\Addins (for the current user only)
+• The manifest points to pyRevitLoader.dll, which acts as the entry point for pyRevit.
+pyRevitLoader.dll
+The pyRevitLoader.dll file is a small C# program that:
+• Ensures required .NET assemblies are loaded.
+• Loads the IronPython engine and runs pyRevit’s Python startup script (pyrevitloader.py).Info
+the source code is in PyRevitLoaderApplication.cs and it is an implementation of the Revit API IExternalApplication interface (the standard way to create a plugin for Revit).
+There are multiple versions of pyRevitLoader.dll to support:
+• different Revit versions:
+    ◦ One for Revit 2025 and newer, built with .NET 8.
+    ◦ Another for older Revit versions, built with the .NET Framework.
+• different IronPython versions; to this date:
+    ◦ version 2.7.12, the default one
+    ◦ version 3.4.0, more recent but not fully tested.
+They share the same source code, but are compiled against the different .net runtimes and IronPython versions.
+Note
+Since we cannot have multiple IronPython engines running at the same time, if the user switches the engine in the configuration, pyRevit will change the .addin manifest mentioned above to point to the correct dll path. It may be that sometimes the addin is not created correctly or points to the wrong path, and this is why most of the times the pyrevit attach command solves the installation issues.
+Startup Script: pyrevitloader.py
+This Python script is the first code executed by pyRevit inside Revit. It:
+• Sets up environment variables.
+• Initializes the logging system and prepares the script console
+• Checks for updates if enabled, pulling changes for pyRevit and extensions.
+• Loads extensions and creates UI elements like ribbons and buttons (see below).
+• Activates hooks, which enable features like event-driven scripts.
+• Initializes API routes and Telemetry, if enabledInfo
+pyrevitloader.py is a small script that just calls the pyrevit.loader.sessionmgr.load_session function. That function is responsible to do all the things mentioned above.
+Extensions discovery
+• pyRevit scans known paths and user defined folders to find extensions.
+• For each extension, it builds a .net assembly to create buttons, tabs, and other UI elements.Info
+Extensions directories are detected by pyrevit.userconfig.PyRevitConfig.get_ext_root_dirs. Extension components discovery is performed by pyrevit.extensions.extensionmgr.get_installed_ui_extensions. Assemblies are generated by pyrevit.loader.asmmaker with types from pyrevit.runtime.create_type.
+How pyRevit Commands run
+TL;DR:
+Command execution is handled by the c# project pyRevitLabs.Pyrevit.Runtime
+Each button generated by the Extension discovery is bound to a command derived by the ScriptCommand.cs source code.
+This code deals with:
+• detecting the modifier keys hold while clicking the button, and change the behavior accordingly
+• calling ScriptExcecutor.ExcecuteScript passing the python script (or any other supportesd script) for the commandInfo
+The ScriptCommand class implements Revit’s IExternalCommand interface. The Execute method is the one called when you click the Ribbon button.
+In turn, the code in ScriptExecutor.cs calls the appropriate script engine based on the type of (IronPython, CPython, .NET, and so on).Info
+You can find the code of the engines in the files that end Engine.cs. 

.github/workflows/docs.yml

@@ -25,10 +25,10 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Prepare Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.10'
 

.github/workflows/main.yml

@@ -46,13 +46,13 @@ jobs:
           echo "commit: ${{ github.sha }}"
 
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           submodules: recursive
 
       - name: Prepare Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.10'
 
@@ -63,12 +63,12 @@ jobs:
 
       # needed for MahApps XamlColorSchemeGenerator
       - name: Prepare .NET 3.1
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: 3.1.x
 
       - name: Prepare .NET 8.0
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: 8.0.x
 
@@ -78,7 +78,7 @@ jobs:
       - name: Prepare git
         if: (github.repository == env.MainRepo)
         uses: fregante/setup-git-user@v2
-
+      
       - name: Check Build Environment
         if: (github.repository == env.MainRepo)
         run: pipenv run pyrevit check
@@ -88,16 +88,6 @@ jobs:
         run: |
           pipenv run pyrevit set year
 
-      # - name: Update Certificate
-      #   if: (github.repository == env.MainRepo)
-      #   env:
-      #     CERTIFICATE: ${{ secrets.CERTIFICATE }}
-      #     CERTIFICATEPASSWORD: ${{ secrets.PASSWORD }}
-      #     CERTIFICATESHA1: "${{ secrets.CERTIFICATESHA1 }}"
-      #     CERTIFICATENAME: "${{ secrets.CERTIFICATENAME }}"
-      #   run: |
-      #     pipenv run pyrevit sign addcert
-
       # WIP only
       - name: Update Build Info (WIP)
         if: (github.base_ref != env.ReleaseBranch && github.repository == env.MainRepo)
@@ -131,33 +121,10 @@ jobs:
         uses: juliangruber/read-file-action@v1
         with:
           path: release/version
-
-      # - name: Sign Products
-      #   if: (github.repository == env.MainRepo)
-      #   env:
-      #     CERTIFICATE: ${{ secrets.CERTIFICATE }}
-      #     CERTIFICATEPASSWORD: ${{ secrets.PASSWORD }}
-      #     CERTIFICATESHA1: "${{ secrets.CERTIFICATESHA1 }}"
-      #     CERTIFICATENAME: "${{ secrets.CERTIFICATENAME }}"
-      #   run: |
-      #     pipenv run pyrevit sign products
-
-      # - name: Sign Installers
-      #   if: (github.repository == env.MainRepo)
-      #   env:
-      #     CERTIFICATE: ${{ secrets.CERTIFICATE }}
-      #     CERTIFICATEPASSWORD: ${{ secrets.PASSWORD }}
-      #     CERTIFICATESHA1: "${{ secrets.CERTIFICATESHA1 }}"
-      #     CERTIFICATENAME: "${{ secrets.CERTIFICATENAME }}"
-      #   run: |
-      #     pipenv run pyrevit sign installers
-
-      # default retention period is 90 days
-      # https://github.com/marketplace/actions/upload-a-build-artifact#retention-period
 
       - name: Sign files with Trusted Signing (DLLs and EXEs)
         if: (github.repository == env.MainRepo)
-        uses: azure/trusted-signing-action@v0.5.1
+        uses: azure/trusted-signing-action@v0.5.10
         with:
           azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
           azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
@@ -179,7 +146,7 @@ jobs:
 
       - name: Sign files with Trusted Signing (installers)
         if: (github.repository == env.MainRepo)
-        uses: azure/trusted-signing-action@v0.5.1
+        uses: azure/trusted-signing-action@v0.5.10
         with:
           azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
           azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
@@ -196,7 +163,7 @@ jobs:
           timestamp-digest: SHA256
 
       - name: Upload Installers
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: pyrevit-installers
           path: |

.github/workflows/stale-issues.yml

@@ -10,7 +10,7 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v10
         with:
           days-before-issue-stale: 60
           days-before-issue-close: 14

Pipfile

@@ -5,7 +5,7 @@ verify_ssl = true
 
 [dev-packages]
 mypy = "*"
-pylint = "==3.3.7"
+pylint = "==4.0.2"
 
 [packages]
 docopt = "*"