annotate cutils/genpwd.py @ 251:14bb7423445d

genpwd: module description
author Franz Glasner <fzglas.hg@dom66.de>
date Sat, 08 Feb 2025 13:38:33 +0100
parents 48f89d312309
children 0a2a162c5ad7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 # -*- coding: utf-8 -*-
230
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
2 # :-
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
3 # :Copyright: (c) 2018 Franz Glasner
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
4 # :Copyright: (c) 2025 Franz Glasner
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
5 # :License: BSD-3-Clause
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
6 # :-
251
14bb7423445d genpwd: module description
Franz Glasner <fzglas.hg@dom66.de>
parents: 250
diff changeset
7 r"""Generate random passwords.
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
251
14bb7423445d genpwd: module description
Franz Glasner <fzglas.hg@dom66.de>
parents: 250
diff changeset
9 Use :command:`genpwd.py --help' for a detailed help message.
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11 """
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13 from __future__ import (division, absolute_import, print_function)
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
15 import argparse
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
16 import base64
241
d4501acb0a7c Implement a "bin-hex" password selection/repertoire
Franz Glasner <fzglas.hg@dom66.de>
parents: 240
diff changeset
17 import binascii
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
18 import os
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19 import sys
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
20
230
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
21 from . import (__version__, __revision__)
ccbb6905914e Change copyright and note genpwd in the READNE and make an official script
Franz Glasner <fzglas.hg@dom66.de>
parents: 229
diff changeset
22
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23
244
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
24 #
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
25 # Unreserved characters according to RFC 1738 (URL) **and** RFC 3986 (URI)
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
26 # No general delimiters and no sub-delimiters.
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
27 #
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
28 WEB_CHARS = (b"ABCDEFGHIJKLMNOPQRSTUVWYXZabcdefghijklmnopqrstuvwxyz"
244
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
29 b"0123456789-._")
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
30 # WEB_CHARS without visually similar characters (0O, 1lI)
244
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
31 SAFE_WEB_CHARS = (b"ABCDEFGHJKLMNPQRSTUVWYXZabcdefghijkmnopqrstuvwxyz"
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
32 b"23456789-._")
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
33 # SAFE_WEB_CHARS with preference to punctuation
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
34 SAFE_WEB_CHARS_2 = b".-_" + SAFE_WEB_CHARS
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
35 # Unreserved characters from URI but with sub-delims allowed
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
36 URI_CHARS = WEB_CHARS + b"~" + b"!$&'()*+,;="
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
37 # URI_CHARS without visually similar characters
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
38 SAFE_URI_CHARS = SAFE_WEB_CHARS + b"~" + b"!$&'()*+,;="
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
39 # Just like SAFE_URI_CHARS but prefers punctuation characters
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
40 SAFE_URI_CHARS_2 = (b"~" + b"!$&'()*+,;=" + SAFE_WEB_CHARS
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
41 + b"~" + b"!$&'()*+,;=")
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
42 # All visible characters from ASCII character set but no space
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
43 FULL_ASCII = (b"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
44 b"abcdefghijklmnopqrstuvwxyz!#$%&/()*+-.,:;<=>?@^_`[\\]{|}'\"~")
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
45 #
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
46 # A safer variant of FULL_ASCII:
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
47 # - no characters that are visually similar (0O, 1lI)
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
48 # - no characters with dead keys on german keyboards
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
49 # - no backslash (too easily interpret as escape character
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
50 # - no single or double quotes
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
51 SAFE_ASCII = (b"23456789ABCDEFGHJKLMNPQRSTUVWXYZ"
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
52 b"abcdefghijkmnopqrstuvwxyz!#$%&/()*+-.,:;<=>?@_[]{|}~")
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
53 # just numeric and alphabetic
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
54 ALNUM = b"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
55 # safer alpha-numberic without visually similar characters
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
56 SAFE_ALNUM = b"23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
57
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
58
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
59 PY2 = sys.version_info[0] <= 2
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
60
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
61
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
62 def main(argv=None):
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
63 aparser = argparse.ArgumentParser(
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
64 description="A simple password generator for password of a given"
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
65 " length within a character repertoire",
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
66 fromfile_prefix_chars='@')
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
67 aparser.add_argument(
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
68 "--version", "-v", action="version",
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
69 version="%s (rv:%s)" % (__version__, __revision__))
249
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
70 group = aparser.add_mutually_exclusive_group()
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
71 group.add_argument(
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
72 "--algorithm", "-a",
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
73 choices=("web", "safe-web", "safe-web-2",
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
74 "uri", "safe-uri", "safe-uri-2",
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
75 "ascii", "safe-ascii",
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
76 "alnum", "safe-alnum",
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
77 "bin-base64", "bin-urlsafe-base64", "bin-base32", "bin-hex",
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
78 "bin-ascii85",),
245
35c06dcca856 genpwd: make the default "safe-ascii"
Franz Glasner <fzglas.hg@dom66.de>
parents: 244
diff changeset
79 default="safe-ascii",
242
ae9bc3006efc Enhanced help message: describe the "bin-" prefix
Franz Glasner <fzglas.hg@dom66.de>
parents: 241
diff changeset
80 help="""
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
81 Select an algorithm and (implicitly) a character repertoire.
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
82 All repertoires that start with `bin-' just encode the output of
242
ae9bc3006efc Enhanced help message: describe the "bin-" prefix
Franz Glasner <fzglas.hg@dom66.de>
parents: 241
diff changeset
83 "os.urandom()" with the selected encoder.
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
84 All repertoires that end with `-safe' or `safe-2' do not contain visually
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
85 similar characters (currently `0O' or `Il1').
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
86 All repertoires that end with `-2' are variants with a bias to punctuation
249
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
87 characters.
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
88 This is incompatible with option `--repertoire'.
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
89 Default: safe-ascii""")
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
90 group.add_argument(
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
91 "--repertoire", "-r",
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
92 action="store", metavar="REPERTOIRE",
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
93 help="""
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
94 Select from given character repertoire.
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
95 The repertoire must be characters from the ISO-8859-15 character set.
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
96 An empty REPERTOIRE selects implicitly the default algorithm.
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
97 This is incompatible with option `--algorithm'.""")
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
98 aparser.add_argument(
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
99 "-E", dest="use_bin_length", action="store_true",
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
100 help="For some repertoires make OUTPUT-LENGTH the number of bytes"
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
101 " that is to be read from random sources instead of output bytes")
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
102 aparser.add_argument(
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
103 "req_length", metavar="OUTPUT-LENGTH", type=int,
237
d65a4d861dad Enhance help message
Franz Glasner <fzglas.hg@dom66.de>
parents: 236
diff changeset
104 help="The required length of the generated output")
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
105
231
6d8443878a00 Use argparse in genpwd.py now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 230
diff changeset
106 opts = aparser.parse_args(args=argv)
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
107
249
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
108 if opts.repertoire:
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
109 try:
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
110 repertoire = (opts.repertoire
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
111 if PY2
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
112 else opts.repertoire.encode("iso-8859-15"))
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
113 except UnicodeError:
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
114 raise ValueError("non ISO-8859-15 character in given repertoire")
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
115 pwd = gen_from_repertoire(opts.req_length, repertoire)
f161448d673e genpwd: allow with "--repertoire REPERTOIRE" to select from given character REPERTOIRE
Franz Glasner <fzglas.hg@dom66.de>
parents: 248
diff changeset
116 elif opts.algorithm == "web":
239
1eae57292c7c genpwd: rename "gen_web()" to "gen_from_repertoire()"
Franz Glasner <fzglas.hg@dom66.de>
parents: 238
diff changeset
117 pwd = gen_from_repertoire(opts.req_length, WEB_CHARS)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
118 elif opts.algorithm == "safe-web":
244
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
119 pwd = gen_from_repertoire(opts.req_length, SAFE_WEB_CHARS)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
120 elif opts.algorithm == "safe-web-2":
244
42f7ecd70ec1 genpwd: Renamed algorithms and changed restricted the WEB character repertoire to not use delims and sub-delims from URLs and URIs
Franz Glasner <fzglas.hg@dom66.de>
parents: 243
diff changeset
121 pwd = gen_from_repertoire(opts.req_length, SAFE_WEB_CHARS_2)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
122 elif opts.algorithm == "uri":
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
123 pwd = gen_from_repertoire(opts.req_length, URI_CHARS)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
124 elif opts.algorithm == "safe-uri":
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
125 pwd = gen_from_repertoire(opts.req_length, SAFE_URI_CHARS)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
126 elif opts.algorithm == "safe-uri-2":
246
c29266444003 genpwd: Implement "uri"
Franz Glasner <fzglas.hg@dom66.de>
parents: 245
diff changeset
127 pwd = gen_from_repertoire(opts.req_length, SAFE_URI_CHARS_2)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
128 elif opts.algorithm == "ascii":
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
129 pwd = gen_from_repertoire(opts.req_length, FULL_ASCII)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
130 elif opts.algorithm == "safe-ascii":
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
131 pwd = gen_from_repertoire(opts.req_length, SAFE_ASCII)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
132 elif opts.algorithm == "alnum":
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
133 pwd = gen_from_repertoire(opts.req_length, ALNUM)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
134 elif opts.algorithm == "safe-alnum":
243
86417af99561 genpwd: Implement ascii and alnum and their safe variants
Franz Glasner <fzglas.hg@dom66.de>
parents: 242
diff changeset
135 pwd = gen_from_repertoire(opts.req_length, SAFE_ALNUM)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
136 elif opts.algorithm == "bin-base64":
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
137 encoder = base64.b64encode
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
138 pwd = gen_bin(opts.req_length, opts.use_bin_length, encoder,
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
139 rstrip_chars=b"=")
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
140 elif opts.algorithm == "bin-urlsafe-base64":
232
7ac8a2537bc9 Implement the urlsafe base64 character repertoire
Franz Glasner <fzglas.hg@dom66.de>
parents: 231
diff changeset
141 encoder = base64.urlsafe_b64encode
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
142 pwd = gen_bin(opts.req_length, opts.use_bin_length, encoder,
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
143 rstrip_chars=b"=")
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
144 elif opts.algorithm == "bin-base32":
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
145 encoder = base64.b32encode
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
146 pwd = gen_bin(opts.req_length, opts.use_bin_length, encoder,
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
147 rstrip_chars=b"=")
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
148 elif opts.algorithm == "bin-ascii85":
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
149 encoder = base64.a85encode
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
150 pwd = gen_bin(opts.req_length, opts.use_bin_length, encoder)
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
151 elif opts.algorithm == "bin-hex":
241
d4501acb0a7c Implement a "bin-hex" password selection/repertoire
Franz Glasner <fzglas.hg@dom66.de>
parents: 240
diff changeset
152 encoder = binascii.hexlify
d4501acb0a7c Implement a "bin-hex" password selection/repertoire
Franz Glasner <fzglas.hg@dom66.de>
parents: 240
diff changeset
153 pwd = gen_bin(opts.req_length, opts.use_bin_length, encoder)
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
154 else:
248
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
155 raise NotImplementedError("algorithm not yet implemented: %s"
4796e5da04ee genpwd: Rename "--repertoire" to "--algorithm"
Franz Glasner <fzglas.hg@dom66.de>
parents: 247
diff changeset
156 % opts.algorithm)
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
157 if opts.use_bin_length:
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
158 if len(pwd) < opts.req_length:
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
159 raise AssertionError("internal length mismatch")
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
160 else:
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
161 if len(pwd) != opts.req_length:
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
162 raise AssertionError("internal length mismatch")
250
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
163 if PY2:
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
164 print(pwd)
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
165 sys.stdout.flush()
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
166 else:
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
167 sys.stdout.buffer.write(pwd)
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
168 sys.stdout.buffer.write(b'\n')
48f89d312309 genpwd: use binary output on Python3 to prevent double encoding
Franz Glasner <fzglas.hg@dom66.de>
parents: 249
diff changeset
169 sys.stdout.buffer.flush()
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
170
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
171
239
1eae57292c7c genpwd: rename "gen_web()" to "gen_from_repertoire()"
Franz Glasner <fzglas.hg@dom66.de>
parents: 238
diff changeset
172 def gen_from_repertoire(length, repertoire):
240
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
173 """Select `length` characters randomly from given character repertoire
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
174 `repertoire`.
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
175
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
176 """
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
177 assert len(repertoire) <= 256
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
178 pwd = []
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
179 while len(pwd) < length:
238
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
180 rndbytes = os.urandom(16)
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
181 for c in rndbytes:
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
182 if PY2:
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
183 c = ord(c)
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
184 if c < len(repertoire):
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
185 pwd.append(repertoire[c])
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
186 if len(pwd) >= length:
ff13b2a863ba Make selection from a character repertoire more evenly distributed
Franz Glasner <fzglas.hg@dom66.de>
parents: 237
diff changeset
187 break
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
188 if PY2:
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
189 pwd = b''.join(pwd)
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
190 else:
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
191 pwd = bytes(pwd)
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
192 return pwd
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
193
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
194
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
195 def gen_bin(length, use_bin_length, encoder, rstrip_chars=None):
240
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
196 """Generate from :func:`os.urandom` and just encode with given `encoder`.
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
197
32616df2732e Renamed algorithms/repertoire selection: use a "bin-" prefix when just the output of os.urandom() is encoded
Franz Glasner <fzglas.hg@dom66.de>
parents: 239
diff changeset
198 """
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
199 pwd = encoder(os.urandom(length))
235
11819361ea39 Implement option "-e" for genpwd to require a binary length instead of the output length.
Franz Glasner <fzglas.hg@dom66.de>
parents: 234
diff changeset
200 return pwd.rstrip(rstrip_chars) if use_bin_length else pwd[:length]
227
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
201
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
202
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
203 if __name__ == "__main__":
4bb2d0975cfe imports: import genpwd,py from fmgbackup4.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
204 main()