Libgen-API 技术文档

Libgen-API 技术文档

libgen-api Library Genesis search library for Python 项目地址: https://gitcode.com/gh_mirrors/li/libgen-api

安装指南

系统要求

• Python 3.6 或更高版本
• pip 包管理工具

安装步骤

1. 打开终端或命令行工具。
2. 运行以下命令安装 libgen-api 包：

   pip install libgen-api
   

项目使用说明

基本搜索

libgen-api 允许你通过书名或作者名在 Library Genesis 上进行搜索。以下是基本搜索的示例：

按书名搜索

from libgen_api import LibgenSearch

s = LibgenSearch()
results = s.search_title("Pride and Prejudice")
print(results)

按作者搜索

from libgen_api import LibgenSearch

s = LibgenSearch()
results = s.search_author("Jane Austen")
print(results)

过滤搜索

你可以通过设置过滤条件来筛选搜索结果。默认情况下，过滤是精确匹配的（区分大小写），但可以通过设置 exact_match=False 来调整。

按书名过滤搜索

from libgen_api import LibgenSearch

tf = LibgenSearch()
title_filters = {"Year": "2007", "Extension": "epub"}
titles = tf.search_title_filtered("Pride and Prejudice", title_filters, exact_match=True)
print(titles)

按作者过滤搜索

from libgen_api import LibgenSearch

af = LibgenSearch()
author_filters = {"Language": "German", "Year": "2009"}
titles = af.search_author_filtered("Agatha Christie", author_filters, exact_match=True)
print(titles)

非精确过滤搜索

from libgen_api import LibgenSearch

ne_af = LibgenSearch()
partial_filters = {"Year": "200"}
titles = ne_af.search_author_filtered("Agatha Christie", partial_filters, exact_match=False)
print(titles)

过滤字段

你可以根据 Library Genesis 的列名进行过滤。列名包括：

col_names = [
    "ID",
    "Author",
    "Title",
    "Publisher",
    "Year",
    "Pages",
    "Language",
    "Size",
    "Extension",
    "Mirror_1",
    "Mirror_2",
    "Mirror_3",
    "Mirror_4",
    "Mirror_5",
    "Edit",
]

项目API使用文档

搜索API

• search_title(title: str) -> List[Dict]
  • 按书名搜索，返回结果列表。
• search_author(author: str) -> List[Dict]
  • 按作者名搜索，返回结果列表。
• search_title_filtered(title: str, filters: Dict, exact_match: bool = True) -> List[Dict]
  • 按书名和过滤条件搜索，返回结果列表。
• search_author_filtered(author: str, filters: Dict, exact_match: bool = True) -> List[Dict]
  • 按作者名和过滤条件搜索，返回结果列表。

下载链接解析API

• resolve_download_links(item: Dict) -> Dict
  • 解析搜索结果中的镜像链接，返回直接下载链接。

项目安装方式

通过 pip 安装

pip install libgen-api

从源码安装

1. 克隆项目仓库：

   git clone https://github.com/harrison-broadbent/libgen-api.git
   cd libgen-api
   

2. 安装依赖：

   pip install .
   

3. 运行测试：

   pytest
   

通过以上步骤，你可以轻松安装并使用 libgen-api 进行 Library Genesis 的编程化搜索和下载链接解析。

libgen-api Library Genesis search library for Python 项目地址: https://gitcode.com/gh_mirrors/li/libgen-api