fmt: black->ruff. format run by ruff.

Author: Gunther Klessinger

justfile

@@ -28,18 +28,18 @@ test-cov:
     uv run coverage combine
     uv run coverage report --precision=2
 
-# Format code with black
+# Format code with ruff
 format:
-    uv run black src tests
-    uv run isort src tests
+    uv run ruff format src tests
+    uv run ruff check --fix src tests
 
 # Run type checking
 typecheck:
     uv run mypy src
 
 # Lint code
 lint:
-    uv run flake8 src tests
+    uv run ruff check src tests
 
 # Run all quality checks (format, lint, typecheck)
 check: format lint typecheck

src/lcdoc/__init__.py

@@ -3,7 +3,9 @@
 
 Documentation tools for lc projects
 """
-import os, sys
+
+import os
+import sys
 
 # for apps on gevent we must patch early => Set that env variable:
 # (see docs lp tips.md)

src/lcdoc/call_flows/auto_docs.py

@@ -1,4 +1,7 @@
-import os, sys, socket, time
+import os
+import sys
+import socket
+import time
 import inspect
 from lcdoc.call_flows import markdown as MD
 from lcdoc.tools import write_file, read_file, exists
@@ -7,7 +10,7 @@
 h = lambda level, s: '#' * level + ' ' + s
 source = inspect.getsource
 
-auto_gen_cmt = '''
+auto_gen_cmt = """
 <!-- AUTOMATICALLY GENERATED FILE - DO NOT DIRECTLY EDIT!
 
 Direct edits will be gone after next CI build.
@@ -16,7 +19,7 @@
 
     %s
 -->
-'''
+"""
 
 
 def mark_auto_created(fn):
@@ -119,7 +122,6 @@ def filt(f):
 
 
 def mod_doc(mod, dest='auto'):
-
     from lcdoc.call_flows.call_flow_logging import autodoc_dir
 
     d = autodoc_dir(mod, dest)

src/lcdoc/call_flows/call_flow_charting.py

@@ -111,7 +111,7 @@ def href(s, tooltip, nr, typ, viz=viz, max_tooltip_len=3000):
         if inp:
             if t0 > time_:
                 # r_add('d <-> t: %s' viz.req('d', 't', what=str(round(time_, rnd))))
-                #% (last_thread[0], round(time_, rnd))
+                # % (last_thread[0], round(time_, rnd))
                 r_add('[-[#888888]-> MainThread: %s' % round(time_, rnd))
                 time_ += dt
             n_with_url = href(n, str(inp), nr, 'req')

src/lcdoc/call_flows/call_flow_logging.py

@@ -1,6 +1,10 @@
-import os, json, sys, time
+import os
+import json
+import sys
+import time
 from lcdoc.tools import exists, project, write_file, read_file, to_list
-import inspect, shutil
+import inspect
+import shutil
 from functools import partial, wraps
 from lcdoc.call_flows.call_flow_charting import make_call_flow_chart
 
@@ -17,7 +21,7 @@
     # *IF* we are in a project based on devapps, we can build call flow logs also
     # from pytest, not just from docs/lp. Requirements are these imports:
     from devapp.tools import FLG, exists, project
-    from devapp.tools import define_flags, project, to_list
+    from devapp.tools import define_flags, to_list
     from absl.flags._exceptions import UnparsedFlagAccessError
 except:
     pass
@@ -141,7 +145,7 @@ def response(frame, arg):
 
     def tracer(frame, event, arg, counter=0):
         """The settrace function. You can't pdb here!"""
-        if not frame.f_code in ILS.traced:
+        if frame.f_code not in ILS.traced:
             return
         if event == 'call':
             SetTrace.request(frame)
@@ -265,10 +269,6 @@ def set_flags(flags, unset=False):
     return [setattr(FLG, k, v) for k, v in M.items()]
 
 
-import os
-from functools import partial
-
-
 def pytest_plot_dest(dest):
     cur_test = lambda: os.environ['PYTEST_CURRENT_TEST']
     # if os.path.isfile(dest):
@@ -402,7 +402,7 @@ def use_case_(*args, _dest=dest, _fmt=fmt, **kwargs):
                 min_header_level = 5
                 section, n = n.rsplit('.', 1)
                 have = written_sect_headers.setdefault(n_mod, {})
-                if not section in have:
+                if section not in have:
                     doc += '\n\n#### ' + section
                     have[section] = True
 
@@ -492,7 +492,7 @@ def use_case_(*args, _dest=dest, _fmt=fmt, **kwargs):
 
 
 def strip_no_ad(s, sep='# /--'):
-    if not sep in s:
+    if sep not in s:
         return s
     r, add, lines = [], True, s.splitlines()
     while lines:
@@ -510,15 +510,14 @@ def strip_no_ad(s, sep='# /--'):
 
 
 def import_mod(test_mod_file):
-    """
-    """
-    if not 'pytest' in sys.argv[0]:
+    """ """
+    if 'pytest' not in sys.argv[0]:
         return
 
-    if not '/' in test_mod_file:
+    if '/' not in test_mod_file:
         test_mod_file = os.getcwd() + '/' + test_mod_file
     d, fn = test_mod_file.rsplit('/', 1)
-    sys.path.insert(0, d) if not d in sys.path else 0
+    sys.path.insert(0, d) if d not in sys.path else 0
     mod = import_module(fn.rsplit('.py', 1)[0])
 
     fn_md = mod_doc(mod, dest='auto')

src/lcdoc/call_flows/markdown.py

@@ -2,7 +2,7 @@
 
 
 class Mkdocs:
-    details = '''
+    details = """
 
 <details>
     <summary>%s</summary>
@@ -11,29 +11,29 @@ class Mkdocs:
 
 </details>
 
-'''
-    code_ = '''
+"""
+    code_ = """
 
 ```_code_
 %s
 ```
 
-    '''
-    admon_ = '''
+    """
+    admon_ = """
 
 !!! %s "%s"
 
 %s 
 
-    '''
+    """
     admon_closed_ = admon_.replace('!!!', '???')
     admon_clsabl_ = admon_.replace('!!!', '???+')
-    tab_ = '''
+    tab_ = """
 === "%s"
 
 %s
 
-    '''
+    """
     js = code_.replace('_code_', 'js')
     py = code_.replace('_code_', 'python')
 
@@ -113,7 +113,7 @@ def extract_docstr_head(docstr):
     """
     Finding Docstrings
 
-    Example: The one of this func would be 'Finding Docstrings'  
+    Example: The one of this func would be 'Finding Docstrings'
     """
     s, rest = docstr.strip(), ''
     if not s:

src/lcdoc/call_flows/viz_sequence.py

@@ -1,21 +1,21 @@
 from functools import partial
 
 # fmt:off
-code = lambda typ, body: '''
+code = lambda typ, body: """
 
 ```%s
 %s
 ```
 
-''' % (typ, body)
+""" % (typ, body)
 
-call_seq_diag = '''
+call_seq_diag = """
 
 
 [![](.%(f)s.svg)](%(l)scall_sequence.html?src=%(f)s)
 
 
-'''
+"""
 # fmt:on