Coverage for gws-app/gws/plugin/select_tool/__init__.py: 100%

1"""Feature selection tool. 

2 

3This plugin provides the ``select`` action and the client tools for 

4selecting features on the map, by a click or by a drawn polygon. Selected 

5features are listed in a sidebar tab, where the selection can be cleared, 

6saved and loaded again. 

7 

8Submodules 

9---------- 

10 

11- ``action`` - the ``select`` action. It passes the click ``tolerance`` to 

12 the client and, if a ``storage`` is configured, handles the requests for 

13 saving and loading selections (category ``Select``). 

14 

15The selection itself runs in the client and uses the regular search; the 

16client elements are ``Sidebar.Select``, ``Toolbar.Select`` and 

17``Toolbar.Select.Draw``. 

18 

19Example:: 

20 

21 actions+ { 

22 type "select" 

23 tolerance "10px" 

24 storage { 

25 permissions { 

26 read "allow all" 

27 write "allow all" 

28 create "allow all" 

29 } 

30 } 

31 } 

32 

33 client.addElements+ { tag "Sidebar.Select" } 

34 client.addElements+ { tag "Toolbar.Select" } 

35 client.addElements+ { tag "Toolbar.Select.Draw" } 

36"""