remove useless comments

ThirVondukr · Sep 13, 2024 · 8c34109 · 8c34109
1 parent 807ef3d
commit 8c34109
Show file tree

Hide file tree

Showing 79 changed files with 6 additions and 2,890 deletions.
diff --git a/admin/bench_pbkdf2.py b/admin/bench_pbkdf2.py
@@ -7,9 +7,6 @@
 from timeit import Timer
 
 
-# =============================================================================
-# imports
-# =============================================================================
 # core
 
 try:
@@ -24,9 +21,6 @@
 # local
 
 
-# =============================================================================
-# main
-# =============================================================================
 def main():
     # --------------------------------------------------------------
     # config
@@ -146,7 +140,3 @@ def na(name):
 
 if __name__ == "__main__":
     sys.exit(main(*sys.argv[1:]))
-
-# =============================================================================
-# eoc
-# =============================================================================
diff --git a/admin/benchmarks.py b/admin/benchmarks.py
@@ -19,9 +19,6 @@
 root = os.path.join(os.path.dirname(__file__), os.path.pardir)
 
 
-# =============================================================================
-# benchmarking support
-# =============================================================================
 class benchmark:
     """class to hold various benchmarking helpers"""
 
@@ -78,9 +75,6 @@ def pptime(secs, precision=3):
         return "%.*g sec" % (precision, sec)
 
 
-# =============================================================================
-# utils
-# =============================================================================
 sample_config_1p = os.path.join(root, "passlib", "tests", "sample_config_1s.cfg")
 
 
@@ -118,9 +112,6 @@ class AnotherHandler(BlankHandler):
 OTHER = "setecastronomy"
 
 
-# =============================================================================
-# CryptContext benchmarks
-# =============================================================================
 @benchmark.constructor()
 def test_context_from_path():
     """test speed of CryptContext.from_path()"""
@@ -191,9 +182,6 @@ def helper():
     return helper
 
 
-# =============================================================================
-# handler benchmarks
-# =============================================================================
 @benchmark.constructor()
 def test_bcrypt_builtin():
     "test bcrypt 'builtin' backend"
@@ -285,9 +273,6 @@ def helper():
     return helper
 
 
-# =============================================================================
-# crypto utils
-# =============================================================================
 @benchmark.constructor()
 def test_pbkdf2_sha1():
     from passlib.crypto.digest import pbkdf2_hmac
@@ -312,9 +297,6 @@ def helper():
     return helper
 
 
-# =============================================================================
-# entropy estimates
-# =============================================================================
 @benchmark.constructor()
 def test_average_entropy():
     from passlib.pwd import _self_info_rate
@@ -330,9 +312,6 @@ def helper():
     return helper
 
 
-# =============================================================================
-# main
-# =============================================================================
 def main(*args):
     source = globals()
     if args:
@@ -349,7 +328,3 @@ def main(*args):
     import sys
 
     main(*sys.argv[1:])
-
-# =============================================================================
-# eof
-# =============================================================================
diff --git a/admin/regen.py b/admin/regen.py
@@ -2,9 +2,6 @@
 helper script which rebuilds all autogenerated bits of code w/in passlib.
 """
 
-# =============================================================================
-# imports
-# =============================================================================
 # core
 import datetime
 import re
@@ -16,9 +13,6 @@
     "replace_section",
 ]
 
-# =============================================================================
-# helpers
-# =============================================================================
 
 now = datetime.datetime.now().strftime("%Y-%m-%d")
 
@@ -109,7 +103,3 @@ def main():
 
 if __name__ == "__main__":
     main()
-
-# =============================================================================
-# eof
-# =============================================================================
diff --git a/choose_rounds.py b/choose_rounds.py
@@ -188,7 +188,3 @@ def helper():
 
 if __name__ == "__main__":
     sys.exit(main(*sys.argv[1:]))
-
-# =============================================================================
-# eof
-# =============================================================================
diff --git a/docs/conf.py b/docs/conf.py
@@ -13,9 +13,6 @@
 
 """
 
-# =============================================================================
-# environment setup
-# =============================================================================
 import sys
 import os
 from passlib import __version__ as release
@@ -35,9 +32,6 @@
 
 warnings.filterwarnings("ignore", category=DeprecationWarning, module="passlib[.].*")
 
-# =============================================================================
-# imports
-# =============================================================================
 
 
 # read env var for tags, needed since "python setup.py build_sphinx"
@@ -49,9 +43,6 @@
 # which contains some sphinx extensions used by Passlib.
 # (https://foss.heptapod.net/doc-utils/cloud_sptheme)
 
-# =============================================================================
-# General configuration
-# =============================================================================
 
 # If your documentation needs a minimal Sphinx version, state it here.
 needs_sphinx = "1.6"
@@ -166,16 +157,10 @@
     "python": ("https://docs.python.org/3", None),
 }
 
-# =============================================================================
-# Options for all output
-# =============================================================================
 todo_include_todos = True
 keep_warnings = True
 issue_tracker_url = "https://foss.heptapod.net/python-libs/passlib/issues/{issue}"
 
-# =============================================================================
-# Options for HTML output
-# =============================================================================
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
@@ -280,9 +265,6 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = project + "Doc"
 
-# =============================================================================
-# site-specific html output
-# =============================================================================
 if tags.has("for-pypi"):  # noqa: F821
     extensions.append("cloud_sptheme.ext.auto_redirect")
     auto_redirect_domain_url = "https://passlib.readthedocs.io"
@@ -294,9 +276,6 @@
             googleanalytics_path="/passlib/",
         )
 
-# =============================================================================
-# Options for LaTeX output
-# =============================================================================
 
 # The paper size ('letter' or 'a4').
 ##latex_paper_size = 'letter'
@@ -333,14 +312,7 @@
 # If false, no module index is generated.
 ##latex_domain_indices = True
 
-# =============================================================================
-# Options for manual page output
-# =============================================================================
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [(master_doc, project, project + " Documentation", [author], 1)]
-
-# =============================================================================
-# EOF
-# =============================================================================
diff --git a/passlib/_setup/stamp.py b/passlib/_setup/stamp.py
@@ -1,8 +1,5 @@
 """update version string during build"""
 
-# =============================================================================
-# imports
-# =============================================================================
 # core
 import datetime
 from distutils.dist import Distribution
@@ -21,9 +18,6 @@
 ]
 
 
-# =============================================================================
-# helpers
-# =============================================================================
 def get_command_class(opts, name):
     return opts["cmdclass"].get(name) or Distribution().get_command_class(name)
 
@@ -152,8 +146,3 @@ def finalize_options(self):
                     target.remove(package)
 
     opts["cmdclass"]["build_py"] = build_py
-
-
-# =============================================================================
-# eof
-# =============================================================================