Transfermarkt 数据集项目教程

1. 项目的目录结构及介绍

Transfermarkt 数据集项目的目录结构如下：

transfermarkt-datasets/
├── devcontainer/
├── dvc/
├── github/
├── streamlit/
├── data/
├── dbt/
├── infra/
├── logs/
├── notebooks/
├── resources/
├── scripts/
├── transfermarkt_datasets/
├── .dockerignore
├── .gitignore
├── .python-version
├── Dockerfile
├── LICENSE
├── Makefile
├── README.md
├── config.yml
├── fly.toml
├── poetry.lock
├── pyproject.toml

目录介绍

• devcontainer/: 开发容器配置文件。
• dvc/: 数据版本控制配置文件。
• github/: GitHub 相关配置文件。
• streamlit/: Streamlit 应用配置文件。
• data/: 数据存储目录。
• dbt/: 数据构建工具（dbt）配置文件。
• infra/: 基础设施配置文件。
• logs/: 日志文件存储目录。
• notebooks/: Jupyter 笔记本存储目录。
• resources/: 资源文件存储目录。
• scripts/: 脚本文件存储目录。
• transfermarkt_datasets/: 核心模块和资产定义。
• .dockerignore: Docker 忽略文件。
• .gitignore: Git 忽略文件。
• .python-version: Python 版本配置文件。
• Dockerfile: Docker 构建文件。
• LICENSE: 项目许可证。
• Makefile: 项目构建脚本。
• README.md: 项目说明文档。
• config.yml: 项目配置文件。
• fly.toml: Fly.io 配置文件。
• poetry.lock: Poetry 依赖锁定文件。
• pyproject.toml: Poetry 项目配置文件。

2. 项目的启动文件介绍

项目的启动文件主要是 Makefile 和 Dockerfile。

Makefile

Makefile 包含了项目的构建和运行命令，例如：

acquire_local:
    make acquire_local ACQUIRER=transfermarkt-api ARGS="--season 2023"

prepare_local:
    make prepare_local

Dockerfile

Dockerfile 用于构建 Docker 镜像，包含了项目的运行环境配置。

FROM python:3.8-slim
COPY . /app
WORKDIR /app
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

3. 项目的配置文件介绍

项目的配置文件主要包括 config.yml 和 pyproject.toml。

config.yml

config.yml 包含了项目的各种配置参数，例如数据源、日志级别等。

data_source: "transfermarkt"
log_level: "INFO"

pyproject.toml

pyproject.toml 是 Poetry 项目的配置文件，包含了项目的依赖、脚本等信息。

[tool.poetry]
name = "transfermarkt-datasets"
version = "0.1.0"
description = "Transfermarkt datasets"
authors = ["Your Name <[e-mail]>"]

[tool.poetry.dependencies]
python = "^3.8"
requests = "^2.25.1"
pandas = "^1.2.3"

[tool.poetry.dev-dependencies]
pytest = "^6.2.2"

[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"

以上是 Transfermarkt 数据集项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用该项目。