请参阅测试以获取更多信息
for all directives - 这里
和
for include - 这里
for if/endif/else - 这里

用法

为库外观创建和设置配置

let mut configuration = Configuration::default();

// Sets urls for filters indices.
configuration.metadata_url = "https://filters.adtidy.org/extension/safari/filters.json".to_string();
configuration.metadata_locales_url = "https://filters.adtidy.org/extension/safari/filters_i18n.json".to_string();

// Sets locale. Will be used for returning localized strings for filters,
// groups, and tags, where applicable.
configuration.locale = "pt_PT".to_string();

// Creates facade instance
let flm = FilterListManagerImpl::new(configuration);

如何创建和填充标准过滤器数据库

// Creates and configures the database. Populates the database with information
// from the filter indexes (filters metadata), the paths to which are specified
// in the configuration.
flm.pull_metadata();

// Then, downloads the contents of the filters.
flm.update_filters(true, 0, true);

[!NOTE] 默认情况下，应用程序使用当前工作目录（cwd）中的数据库运行，数据库文件名基于格式 agflm_{configuration.filter_list_type.to_string()} 生成。对于标准过滤器，文件路径将是 $CWD/agflm_standard.db。

对自定义过滤器的操作

库将所有过滤器分为三类

1. 索引过滤器 - 通过解析索引（注册表）创建的过滤器。
2. 自定义过滤器 - 通过使用库的方法添加（并编辑）的用户过滤器。
3. 特殊过滤器 - 由库的脚本预配置的自定义过滤器。

您可以通过参考数据库常量文件来检查特殊和自定义过滤器的指标。

// Installs a custom filter.
let custom_filter = flm.install_custom_filter_list(
    String::from("https://example.com/custom_filter.txt"),
    true, // The filter list is marked as trusted.
    String::from("Custom title"),
    String::from("Custom description")
);

// Edit metadata.
flm.update_custom_filter_metadata(
    custom_filter.id,
    String::from("new title"),
    false // The filter list is marked as not trusted.
);

// Turn on this filter.
flm.enable_filter_lists(vec![custom_filter.id], true);

// Remove this filter.
flm.delete_custom_filter_lists(vec![custom_filter.id]);

直接从字符串安装自定义过滤器，而不是下载。

let string_contents = String::from(r"
! Checksum: ecbiyIyplBZKLeNzi64pGA
...
! JS API START
#%#var AG_onLoad=function(func){if(document.readyState==="complete"||document.readyState==="interactive")func();else
... 
");
flm.install_custom_filter_from_string(
    1719505304i64, // last_download_time value. Explanation: Can we update filter? Answer: (filter.last_download_time + filter.expires < now()) 
    true, // Enabled
    true, // Trusted
    string_contents,
    None,
    None
);

自定义过滤器规则的操作

// Saves the structure containing the filter rules.
flm.save_custom_filter_rules(rules_for_new_local_custom_filter);

// You can save only disabled rules for the filter list 
flm.save_disabled_rules(filter.id, disabled_rules_list);

获取操作

// Retrieves all filters from the database.
// Returns Vec<FullFilterList>.
flm.get_full_filter_lists();

// Retrieves a filter by its ID from the database.
// Returns Optional<FullFilterList>.
flm.get_full_filter_list_by_id(id);

FullFilterList参考

其他（所有）操作

外观接口