Package: milestonexprotectrestPython
Milestone XProtect REST Services Python3 LibraryOverviewThis API provides Python programmers the ability to retrieve various configuration information for Milestone Systems XProtect Video Manegement Systems (VMS) products.
It utilizes the Milestone Systems XProtect VMS API Gateway addon product REST services to retrieve the information.
More information on Milestone XProtect products can be found on theMilestone
XProtect Products page.What this APICANDoThis API provides an easy way to retrieve XProtect configuration details:  Cameras, Microphones, Speakers, Product License Information, Site information, etc.  Check out
themilestonexprotectrestpython.xprrestservice.XPRRestServiceclass help documentation for more details.What this APICANNOTDo (yet anyway)This API does not provide any functionality to ADD, UPDATE, or DELETE XProtect configurations.  The underlying XProtect REST services DO support these operations, but this API does not.Requirements and DependenciesThe following XProtect requirements must be met in order to utilize this API:Milestone Systems XProtect Management Server 2023 R2, Version 23.2a+.The XProtect Management Server provides web-services for various commands and configuration.
The XProtect software products can be downloaded from the:Milestone XProtect Products download page.Milestone Systems XProtect VMS API Gateway.The XProtect API Gateway Addon provides RESTful services for various commands and configuration management.
The XProtect software products can be downloaded from theMilestone XProtect API Gateway download page.Installation of the XProtect API Gateway requires XProtect VMS 2022 R1 or later.The following Python-related requirements must be met in order to utilize this API:Python 3.4 or greater (not tested with Python 2).smartinspectPython package (>= 3.0.20) - for diagnostics and logging support.requests package (>= 2.0).requests-ntlm package (>= 1.2.0).DocumentationDocumentation is located in the package library under the 'docs' folder; use the index.html as your starting point.Quick-Start Sample CodeThe following code snippet will get you started with establishing a connection to the XProtect REST API Gateway and retrieving a list of all Camera devices.Check out themilestonexprotectrestpython.xprrestservice.XPRRestServiceclass methods for more sample code.Get All Camera Devices# package imports.frommilestonexprotectrestpython.xprcollectionimportXPRCollectionfrommilestonexprotectrestpython.xprfilteroperatorimportXPRFilterOperatorfrommilestonexprotectrestpython.xprlogininfoimportXPRLoginInfofrommilestonexprotectrestpython.xprrestserviceimportXPRRestService# create XPRRestService instance and set server prefixes for our environment.xsvc:XPRRestService=XPRRestService()xsvc.ApiGatewayUrlPrefix="https://myapigateway.example.com"xsvc.IsSslVerifyEnabled=False# authenticate using xprotect basic auth credentials.loginInfo:XPRLoginInfo=xsvc.LoginBasicUser("xpsampleadmin","MyPassword@1")print("** Login Details:\n{0}\n".format(loginInfo))# get camera devices, both enabled and disabled.cams:XPRCollection=xsvc.GetCameras(True)print("** Cameras (Enabled and Disabled):\n{0}\n".format(cams))LicensingThis project is licensed under the terms of the MIT End-User License Agreement (EULA) license.Logging / Tracing SupportThe SmartInspectPython package (installed with this package) can be used to easily debug your applications that utilize this API.The following topics and code samples will get you started on how to enable logging support.Note that logging support can be turned on and off without changing code or restarting the application.Click on the topics below to expand the section and reveal more information.Configure Logging Support Settings FileAdd the following lines to a new file (e.g. "smartinspect.cfg") in your application startup / test directory.  
  Note the file name can be whatever you like, just specify it on the call to `SiAuto.Si.LoadConfiguration()` when initializing the logger.; smartinspect.cfg; SmartInspect Logging Configuration General settings.; - "Enabled" parameter to turn logging on (True) or off (False).; - "Level" parameter to control the logging level (Debug|Verbose|Message|Warning|Error).; - "AppName" parameter to control the application name.Enabled=FalseLevel=VerboseDefaultLevel=DebugAppName=My Application Name; SmartInspect Logging Configuration Output settings.; - Log to SmartInspect Console Viewer running on the specified network address.Connections=tcp(host=192.168.1.1,port=4228,timeout=5000,reconnect=true,reconnect.interval=10s,async.enabled=true); - Log to a file, keeping 14 days worth of logs.;Connections = "file(filename=\"./tests/logfiles/logfile.log\", rotate=daily, maxparts=14, append=true)"; - Log to an encrypted file, keeping 14 days worth of logs.;Connections = "file(filename=\"./tests/logfiles/logfileEncrypted.sil\", encrypt=true, key=""1234567890123456"", rotate=daily, maxparts=14, append=true)"; set defaults for new sessions; note that session defaults do not apply to the SiAuto.Main session, since; this session was already added before a configuration file can be loaded.; session defaults only apply to newly added sessions and do not affect existing sessions.SessionDefaults.Active=TrueSessionDefaults.Level=MessageSessionDefaults.ColorBG=0xFFFFFF; configure some individual session properties.; note that this does not add the session to the sessionmanager; it simply; sets the property values IF the session name already exists.Session.Main.Active=TrueSession.Main.ColorBG=0xFFFFFFInitialize Logging Support, MAIN moduleAdd the following lines to your program startup module.  
  This will import the necessary package modules, and initialize logging support.  
  NOTE - This code should only be executed one time!# load SmartInspect settings from a configuration settings file.fromsmartinspectpython.siautoimport*siConfigPath:str="./tests/smartinspect.cfg"SIAuto.Si.LoadConfiguration(siConfigPath)# start monitoring the configuration file for changes, and reload it when it changes.# this will check the file for changes every 60 seconds.siConfig:SIConfigurationTimer=SIConfigurationTimer(SIAuto.Si,siConfigPath,60)# get smartinspect logger reference._logsi:SISession=SIAuto.Main# log system environment and application startup parameters._logsi.LogSeparator(SILevel.Fatal)_logsi.LogAppDomain(SILevel.Verbose)_logsi.LogSystem(SILevel.Verbose)Initialize Logging Support, CLASS or sub-modulesAdd the following lines to your program supporting modules.  
  This will import the necessary package modules, and initialize the shared logging session.# get smartinspect logger reference.fromsmartinspectpython.siautoimport*_logsi:SISession=SIAuto.MainMore Information on SmartInspectYou can use SmartInspectPython by itself to create log files for your own applications.  
  Use the following PIP command to install the SmartInspectPython package from PyPi.org:  
  `pip install smartinspectpython`The SmarrtInspect Redistributable Console Viewer (free) is required to view SmartInspect Log (.sil) formatted log files, as well capture packets via the TcpProtocol 
  or PipeProtocol connections.  The Redistributable Console Viewer can be downloaded from theCode-Partners Software Downloads Page. Note that the "Redistributable Console Viewer" is a free product, while the "SmartInspect Full Setup" is 
  the Professional level viewer that adds a few more bells and whistles for a fee.  Also note that a Console Viewer is NOT required to view plain text (non .sil) formatted 
  log files.