Return module sequence discovered from ``self.package_name`` Parameters ---------- None Returns ------- mods : sequence Sequence of module names within ``self.package_name`` Examples -------- >>> dw = ApiDocWrit
(self)
| 348 | return True |
| 349 | |
| 350 | def discover_modules(self): |
| 351 | ''' Return module sequence discovered from ``self.package_name`` |
| 352 | |
| 353 | |
| 354 | Parameters |
| 355 | ---------- |
| 356 | None |
| 357 | |
| 358 | Returns |
| 359 | ------- |
| 360 | mods : sequence |
| 361 | Sequence of module names within ``self.package_name`` |
| 362 | |
| 363 | Examples |
| 364 | -------- |
| 365 | >>> dw = ApiDocWriter('sphinx') |
| 366 | >>> mods = dw.discover_modules() |
| 367 | >>> 'sphinx.util' in mods |
| 368 | True |
| 369 | >>> dw.package_skip_patterns.append('\\.util$') |
| 370 | >>> 'sphinx.util' in dw.discover_modules() |
| 371 | False |
| 372 | >>> |
| 373 | ''' |
| 374 | modules = [self.package_name] |
| 375 | # raw directory parsing |
| 376 | for dirpath, dirnames, filenames in os.walk(self.root_path): |
| 377 | # Check directory names for packages |
| 378 | root_uri = self._path2uri(os.path.join(self.root_path, |
| 379 | dirpath)) |
| 380 | for dirname in dirnames[:]: # copy list - we modify inplace |
| 381 | package_uri = '.'.join((root_uri, dirname)) |
| 382 | if (self._uri2path(package_uri) and |
| 383 | self._survives_exclude(package_uri, 'package')): |
| 384 | modules.append(package_uri) |
| 385 | else: |
| 386 | dirnames.remove(dirname) |
| 387 | # Check filenames for modules |
| 388 | for filename in filenames: |
| 389 | module_name = filename[:-3] |
| 390 | module_uri = '.'.join((root_uri, module_name)) |
| 391 | if (self._uri2path(module_uri) and |
| 392 | self._survives_exclude(module_uri, 'module')): |
| 393 | modules.append(module_uri) |
| 394 | return sorted(modules) |
| 395 | |
| 396 | def write_modules_api(self, modules,outdir): |
| 397 | # write the list |
no test coverage detected