Metadata-Version: 2.1
Name: pywinos
Version: 1.0.0rc1
Summary: The cross-platform tool to execute PowerShell and command line remotely.
Home-page: https://github.com/agegemon/PyWinOS
Author: Andrey Komissarov
Author-email: a.komisssarov@gmail.com
License: MIT
Description: # PyWinOS
        The cross-platform tool to work with remote Windows OS.
        
        PyWinOS uses the Windows Remote Manager (WinRM) service. It can establish connection to a remote server based on Windows OS and execute commands:
        - PowerShell
        - Command line
        - WMI.
        
        For more information on WinRM, please visit [Microsoft’s WinRM site](https://docs.microsoft.com/en-us/windows/win32/winrm/portal?redirectedfrom=MSDN)
        It based on [pywinrm](https://pypi.org/project/pywinrm/).
        
        PyWinOS returns object with exit code, sent command, stdout/sdtderr response.
        
        ## Installation
        For most users, the recommended method to install is via pip:
        ```cmd
        pip install PyWinOS
        ```
        ## Import
        ```python
        from pywinos import WinOSClient
        ```
        ---
        ## Usage
        #### PowerShell:
        ```python
        from pywinos import WinOSClient
        
        tool = WinOSClient('172.16.0.126', 'administrator', 'P@ssw0rd')
        response = tool.run_cmd('$PSVersionTable.PSVersion')
        
        print(response)  
        # ResponseParser(response=(0, 'Major  Minor  Build  Revision\r\n-----  -----  -----  --------\r\n5      1      17763  592', None, '$PSVersionTable.PSVersion'))
        print(response.exited)  # 0
        print(response.stdout)
        # Major  Minor  Build  Revision
        # -----  -----  -----  --------
        # 5      1      17763  592
        print(response.stderr)  # None
        print(response.ok)  # True
        ```
        
        #### Command line:
        ```python
        from pywinos import WinOSClient
        
        tool = WinOSClient('172.16.0.126', 'administrator', 'P@ssw0rd')
        response = tool.run_cmd('whoami')
        
        print(response)  # ResponseParser(response=(0, 'test-vm1\\administrator', None, 'whoami'))
        print(response.exited)  # 0
        print(response.stdout)  # test-vm1\administrator
        print(response.stderr)  # None
        print(response.ok)  # True
        
        ```
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
