Nautilus.PropertiesModelProvider: nautilus-python Reference Manual

## Nautilus.PropertiesModelProvider Nautilus.PropertiesModelProvider — Nautilus.PropertiesModelProvider Reference |

## Synopsis

     Nautilus.PropertiesModelProvider {
      get_models(files);
    }

## Description

If subclassed, Nautilus will request a list of custom properties models that should appear when a user opens the Properties dialog for a file or folder.

Example 5. Nautilus.PropertiesModelProvider Example

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    import hashlib

    from urllib.parse import unquote
    from gi.repository import Nautilus, Gio, GObject
    from typing import List

    class MD5SumPropertiesModel(GObject.GObject, Nautilus.PropertiesModelProvider):
        def get_models(
            self,
            files: List[Nautilus.FileInfo],
        ) -> List[Nautilus.PropertiesModel]:
            if len(files) != 1:
                return []

            file = files[0]
            if file.get_uri_scheme() != "file":
                return []

            if file.is_directory():
                return []

            filename = unquote(file.get_uri()[7:]).encode("utf-8")

            section_model = Gio.ListStore.new(item_type=Nautilus.PropertiesItem)

            section_model.append(
                Nautilus.PropertiesItem(
                    name="MD5 sum of the filename",
                    value=hashlib.md5(filename).hexdigest(),
                )
            )

            return [
                Nautilus.PropertiesModel(
                    title="MD5Sum",
                    model=section_model,
                ),
            ]

## Passive Methods

### Nautilus.PropertiesModelProvider.get_models

    get_models(files);

`files` : | a list of `Nautilus.FileInfo` objects.
Returns : | a list of `Nautilus.PropertiesModel` objects

This function is called by Nautilus when it wants properties model items from the extension. It is called in the main thread before a properties model is shown, so it should return quickly.