SOg#&SSKJr "SS\5rg))utilc\rSrSrSrSSjrSrSSjrSSjrSr S r S r S r S r SS jrSSjrSSjrSrSrSrSrSrg) FileManagera `FileManager` manages the file filter state and is responible for collecting filepaths from a set of directories and filtering the files through the filters. Without file filters, this class acts as a passthrough, collecting and returning every file in a given directory. `FileManager` can also optionally manage the plugin filepath state through the use of the add/get/set plugin filepaths methods. Note that plugin interface is not automatically set up this way, although it is relatively trivial to do. NcUc/nUc [5nUc [5n[R"U5Ul[RnU"U5UlU"U5Ulg)a `FileFilters` are callable filters. Each filter must take in a set of filepaths and return back a set of filepaths. Each filter is applied independently to the set of filepaths and added to the return set. `FileFilters` can be a single object or an iterable `plugin_filepaths` are known plugin filepaths that can be stored in `FileManager`. Note that filepaths stored in the plugin filepaths are NOT automatically added when calling the `collect_filepaths` method. Recommend using absolute paths. `plugin_filepaths` can be a single object or an interable. `blacklisted_filepaths` are plugin filepaths that are not to be included in the collected filepaths. Recommend using absolute paths. `blacklisted_filepaths` can be a single object or an iterable. N)setr return_list file_filtersto_absolute_pathsplugin_filepathsblacklisted_filepaths)selfr r r to_abs_pathss _/Users/admin/workspace/ai/Jarvis/env/lib/python3.13/site-packages/pluginmanager/file_manager.py__init__FileManager.__init__se.  L  #"u  ($'E ! ,,\:-- ,-= >%12G%H"c[5n[R"U5nUHDn[R"U5nUR U5nUR [U55 MF UR U5nU$)a2 Collects and returns every filepath from each directory in `directories` that is filtered through the `file_filters`. If no `file_filters` are present, passes every file in directory as a result. Always returns a `set` object `directories` can be a object or an iterable. Recommend using absolute paths. )rrr get_filepaths_from_dir_filter_filepathsupdate_remove_blacklisted)r directoriesr directory filepathss rcollect_filepathsFileManager.collect_filepaths5sr5,,[9 $I33I>I..y9I  # #C N 3%  334DErc[R"U5nU(a![R"UUR5nURR U5 g)a: Adds `filepaths` to the `self.plugin_filepaths`. Recommend passing in absolute filepaths. Method will attempt to convert to absolute paths if they are not already. `filepaths` can be a single object or an iterable If `except_blacklisted` is `True`, all `filepaths` that have been blacklisted will not be added. N)rr remove_from_setr r rrrexcept_blacklisteds radd_plugin_filepaths FileManager.add_plugin_filepathsKsI**95 ,,Y-1-G-GII $$Y/rc[R"U5nU(a![R"UUR5nXlg)a9 Sets `filepaths` to the `self.plugin_filepaths`. Recommend passing in absolute filepaths. Method will attempt to convert to absolute paths if they are not already. `filepaths` can be a single object or an iterable. If `except_blacklisted` is `True`, all `filepaths` that have been blacklisted will not be set. N)rr rr r r s rset_plugin_filepaths FileManager.set_plugin_filepaths]s;**95 ,,Y-1-G-GII!*rc|[R"U5n[R"URU5Ulg)z Removes `filepaths` from `self.plugin_filepaths`. Recommend passing in absolute filepaths. Method will attempt to convert to absolute paths if not passed in. `filepaths` can be a single object or an iterable. N)rr rr rrs rremove_plugin_filepaths#FileManager.remove_plugin_filepathsos3**95 $ 4 4T5J5J5>!@rcUR$)zD returns the plugin filepaths tracked internally as a `set` object. )r rs rget_plugin_filepaths FileManager.get_plugin_filepaths{s$$$rc<[R"U5nXlg)zu Sets internal file filters to `file_filters` by tossing old state. `file_filters` can be single object or iterable. N)rr r rr s rset_file_filtersFileManager.set_file_filterss '' 5 (rcf[R"U5nURRU5 g)zd Adds `file_filters` to the internal file filters. `file_filters` can be single object or iterable. N)rr r extendr0s radd_file_filtersFileManager.add_file_filterss( '' 5    .rcP[R"URU5Ulg)zk Removes the `file_filters` from the internal state. `file_filters` can be a single object or an iterable. N)rremove_from_listr r0s rremove_file_filtersFileManager.remove_file_filterss# !11$2C2C2>@rcDUc UR$U"UR5$)zo Gets the file filters. `filter_function`, can be a user defined filter. Should be callable and return a list. )r )rfilter_functions rget_file_filtersFileManager.get_file_filterss'  "$$ $"4#4#45 5rc[R"U5nURRU5 U(a'[R"UR U5Ulgg)a Add `filepaths` to blacklisted filepaths. If `remove_from_stored` is `True`, any `filepaths` in `plugin_filepaths` will be automatically removed. Recommend passing in absolute filepaths but method will attempt to convert to absolute filepaths based on current working directory. N)rr r rrr rrremove_from_storeds radd_blacklisted_filepaths%FileManager.add_blacklisted_filepathssO**95  "")))4 $($8$89N9N9B%DD ! rc[R"U5nXlU(a'[R"URU5Ulgg)a& Sets internal blacklisted filepaths to filepaths. If `remove_from_stored` is `True`, any `filepaths` in `self.plugin_filepaths` will be automatically removed. Recommend passing in absolute filepaths but method will attempt to convert to absolute filepaths based on current working directory. N)rr r rr r@s rset_blacklisted_filepaths%FileManager.set_blacklisted_filepathssA**95 %." $($8$89N9N9B%DD ! rct[R"U5nURn[R"X!5ng)z Removes `filepaths` from blacklisted filepaths Recommend passing in absolute filepaths but method will attempt to convert to absolute filepaths based on current working directory. N)rr r r)rr black_pathss rremove_blacklisted_filepaths(FileManager.remove_blacklisted_filepathss/**95 00 **;B rcUR$)z4 Returns the blacklisted filepaths as a set object. )r r,s rget_blacklisted_filepaths%FileManager.get_blacklisted_filepathss)))rcF[R"XR5nU$)zN internal helper method to remove the blacklisted filepaths from `filepaths`. )rrr r(s rrFileManager._remove_blacklisteds ((4N4NO rcUR(a8[5nURHnU"U5nURU5 M U$UnU$)zo helps iterate through all the file parsers each filter is applied individually to the same set of `filepaths` )r rr)rrr file_filter plugin_pathss rrFileManager._filter_filepathssS   "u #00 *95  '' 5 1   ) r)r r r )NNN)T)N)__name__ __module__ __qualname____firstlineno____doc__rrr"r%r)r-r1r5r9r=rBrErIrLrr__static_attributes__rrrrsi #"&'+#IJ ,0$*$ @% )/@ 6 D D C*  rrN) pluginmanagerrobjectrrZrrr]se &e r