1Data::Password::zxcvbn:U:sMeartcCho:n:tSrpiabtuitaeldD(a3Pt)ear:l:PDaoscsuwmoerndt:a:tzixocnvbn::Match::Spatial(3)
2
3
4

NAME

6       Data::Password::zxcvbn::Match::Spatial - match class for sequences of
7       nearby keys
8

VERSION

10       version 1.1.2
11

DESCRIPTION

13       This class represents the guess that a certain substring of a password
14       can be obtained by moving a finger in a continuous line on a keyboard.
15

ATTRIBUTES

17   "graph_name"
18       The name of the keyboard / adjacency graph used for this match
19
20   "graph_meta"
21       Hashref, spatial information about the graph:
22
23       •   "starting_positions"
24
25           the number of keys in the keyboard, or starting nodes in the graph
26
27       •   "average_degree"
28
29           the average number of neighbouring keys, or average out-degree of
30           the graph
31
32   "shifted_count"
33       How many of the keys need to be "shifted" to produce the token
34
35   "turns"
36       How many times the finger must have changed direction to produce the
37       token
38

METHODS

40   "estimate_guesses"
41       The number of guesses grows super-linearly with the length of the
42       pattern, the number of "turns", and the amount of shifted keys.
43
44   "make"
45         my @matches = @{ Data::Password::zxcvbn::Match::Spatial->make(
46           $password,
47           { # this is the default
48             graphs => \%Data::Password::zxcvbn::AdjacencyGraph::graphs,
49           },
50         ) };
51
52       Scans the $password for substrings that can be produced by typing on
53       the keyboards described by the "graphs".
54
55       The data structure needed for "graphs" is a bit complicated; look at
56       the "build-keyboard-adjacency-graphs" script in the distribution's
57       repository <https://bitbucket.org/broadbean/p5-data-password-
58       zxcvbn/src/master/maint/build-keyboard-adjacency-graphs>.
59
60   "feedback_warning"
61   "feedback_suggestions"
62       This class suggests that short keyboard patterns are easy to guess, and
63       to use longer and less straight ones.
64
65   "fields_for_json"
66       The JSON serialisation for matches of this class will contain "token i
67       j guesses guesses_log10 graph_name shifted_count turns".
68

AUTHOR

70       Gianni Ceccarelli <gianni.ceccarelli@broadbean.com>
71

73       This software is copyright (c) 2022 by BroadBean UK, a CareerBuilder
74       Company.
75
76       This is free software; you can redistribute it and/or modify it under
77       the same terms as the Perl 5 programming language system itself.
78
79
80
81perl v5.36.1                      2023D-a0t9a-:1:3Password::zxcvbn::Match::Spatial(3)
Impressum