docspec

import docspec from io import StringIO # Example of a docspec-conformant JSON payload for a simple module # In a real-world scenario, this might come from a file or from docspec-python. example_json_input = ''' { "name": "example_module", "location": {"filename": "example_module.py", "lineno": 1}, "docstring": "A module demonstrating docspec structure.", "members": [ { "name": "my_function", "type": "function", "location": {"filename": "example_module.py", "lineno": 3}, "docstring": "This is a sample function.", "args": [], "returns": null, "decorations": [], "is_async": false } ] } ''' # Load module(s) from a JSON string (simulating file input) modules = docspec.load_modules(StringIO(example_json_input)) # Iterate and process loaded modules for module in modules: print(f"\nProcessing Module: {module.name}") print(f" Module Docstring: {module.docstring}") # Example: Filter members to only include those with docstrings original_members_count = len(module.members) module.members = [member for member in module.members if member.docstring] print(f" Original member count: {original_members_count}") print(f" Members with docstrings after filtering: {[m.name for m in module.members]}") # To dump the modified module back to JSON (e.g., to stdout or a file): # from sys import stdout # for module in modules: # Assuming 'modules' might have multiple # docspec.dump_module(stdout, module)