Metadata-Version: 1.2
Name: python-synology
Version: 0.5.0
Summary: Python API for communication with Synology DSM
Home-page: https://github.com/ProtoThis/python-synology
Author: FG van Zeelst (ProtoThis)
License: MIT
Download-URL: https://github.com/ProtoThis/python-synology/tarball/0.4.0
Description: ===========================
        Python API for Synology DSM
        ===========================
        
        .. image:: https://travis-ci.org/ProtoThis/python-synology.svg?branch=master
            :target: https://travis-ci.org/ProtoThis/python-synology
        
        .. image:: https://img.shields.io/pypi/v/python-synology.svg
            :alt: Library version
            :target: https://pypi.org/project/python-synology
        
        .. image:: https://img.shields.io/pypi/pyversions/python-synology.svg
            :alt: Supported versions
            :target: https://pypi.org/project/python-synology
        
        .. image:: https://pepy.tech/badge/python-synology
            :alt: Downloads
            :target: https://pypi.org/project/python-synology
        
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :alt: Formated with Black
            :target: https://github.com/psf/black
        
        Installation
        ============
        
        .. code-block:: bash
        
            [sudo] pip install python-synology
        
        
        Usage
        =====
        Constructor:
        
        .. code-block:: python
        
            SynologyDSM(
                dsm_ip,
                dsm_port,
                username,
                password,
                use_https=False,
                debugmode=False,
                dsm_version=6,
            )
        
        ``dsm_version = 5 will use old DSM API to gather volumes and disks informations (from DSM 5.x versions)``
        
        Module
        ------
        
        You can import the module as `synology_dsm`.
        
        .. code-block:: python
        
            from synology_dsm import SynologyDSM
        
            print("Creating Valid API")
            api = SynologyDSM("<SynologyIp>", "<SynologyPort>", "<Username>", "<Password>")
        
            print("=== Information ===")
            print("Model:           " + str(api.information.model))
            print("RAM:             " + str(api.information.ram) + " MB")
            print("Serial number:   " + str(api.information.serial))
            print("Temperature:     " + str(api.information.temperature) + " °C")
            print("Temp. warning:   " + str(api.information.temperature_warn))
            print("Uptime:          " + str(api.information.uptime))
            print("Full DSM version:" + str(api.information.version_string))
        
            print("=== Utilisation ===")
            print("CPU Load:        " + str(api.utilisation.cpu_total_load) + " %")
            print("Memory Use:      " + str(api.utilisation.memory_real_usage) + " %")
            print("Net Up:          " + str(api.utilisation.network_up()))
            print("Net Down:        " + str(api.utilisation.network_down()))
            
            print("=== Storage ===")
            for volume_id in api.storage.volumes_ids:
                print("ID:          " + str(volume_id))
                print("Status:      " + str(api.storage.volume_status(volume_id)))
                print("% Used:      " + str(api.storage.volume_percentage_used(volume_id)) + " %")
        
            for disk_id in api.storage.disks_ids:
                print("ID:          " + str(disk_id))
                print("Name:        " + str(api.storage.disk_name(disk_id)))
                print("S-Status:    " + str(api.storage.disk_smart_status(disk_id)))
                print("Status:      " + str(api.storage.disk_status(disk_id)))
                print("Temp:        " + str(api.storage.disk_temp(disk_id)))
              
        Credits / Special Thanks
        ========================
        - https://github.com/florianeinfalt
        - https://github.com/tchellomello
        - https://github.com/Quentame
        - https://github.com/aaska
        
        Found Synology API "documentation" on this repo : https://github.com/kwent/syno/tree/master/definitions
        
Keywords: synology-dsm,synology
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
