# fungoogle

**Repository Path**: farfarfun/fungoogle

## Basic Information

- **Project Name**: fungoogle
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-08
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# fungoogle

个人 Google Colab 环境初始化脚本：挂载 Google Drive、创建工作目录、安装依赖（`funutil`、`kaggle`）、把 Drive 里的个人文件拷贝到 Colab 本地环境。是作者自用的 Colab 启动脚手架，不是通用工具库，路径（如 `/content/drive/My Drive/home`、`/root/workspace`）都是硬编码的个人配置。

> 注意：本仓库尚未真正发布过版本。PyPI 上已存在一个 `fungoogle`（0.0.1）包，其 wheel 内容只有一个空的 `funapi/__init__.py`，是本组织早年批量占位发布时留下的空壳——metadata 里的作者（`bingtao`）和 homepage（本仓库地址）都指向 farfarfun 组织自己，**不是别人的包**，但内容与当前源码无关。真正发布正式版本前需要先在这个占位版本之上递增版本号，不能假设名字是全新的。

## 安装

暂无正式发布版本，直接从源码安装（依赖 `farlog`、`funshell` 会随之自动安装）：

```bash
pip install git+https://github.com/farfarfun/fungoogle.git
# 或克隆后本地安装
git clone https://github.com/farfarfun/fungoogle.git
cd fungoogle
pip install -e .
```

`google.colab` 仅 Colab notebook 环境自带，无需单独安装；离开 Colab 环境时，只有 `install_drive()` 会因导入它而报错。`default_import()` 不依赖 `google.colab`，但需要环境中已安装 `pandas`；其余函数可正常导入和调用。

## 用法示例

只能在 Google Colab 的 notebook 环境里运行：

```python
from fungoogle.init.core import init

init()
```

`init()` 依次执行：

1. `install_drive()`：挂载 `/content/drive`，创建 `/root/workspace` 工作目录；
2. `packages()`：`pip install` 安装带版本下限的 `funutil>=1.0.63` 和 `kaggle>=1.6.17`；已满足下限的已安装版本不会被升级，版本下限与 `pyproject.toml` 的 `colab` extra 一致；
3. `copy_files()`：把 Drive 里 `home/local_files/` 目录下的文件拷贝到 Colab 本地的 `/root/`；
4. `default_import()`：先导入 `pandas` 并记录版本作为环境检查，再把 `packages` 目录加入 `sys.path`。

`install_bash()` 不属于 `init()` 流程。它只会将环境变量 `FUNGOOGLE_EXTRA_PATH` 的目录加入当前 Python 进程的 `PATH`；未设置时不执行任何操作。它不会加载 shell 配置文件，也不会修改调用 notebook 之外的 shell。

## 开发

安装开发依赖并运行检查：

```bash
uv sync --group dev
uv run pytest
uv run ruff check --fix . && uv run ruff format .
```

`script/build.sh` 将参数原样传给 `funbuild build`，用于版本递增、构建、安装校验、发布和打 tag；运行前需要安装并完成 `funbuild` 的发布配置。`script/push.sh` 将参数传给 `funbuild push`，会提交并推送代码；不传 `-m` 时由 `funbuild` 生成提交信息，传入自定义信息时使用 `script/push.sh -m "<类型>: <做了什么>"`。请在确认工作区改动和远程目标后再运行这两个脚本。

## 已知局限（如实说明）

- 这是一份高度个人化的 Colab 初始化脚本，路径、Google Drive 目录结构均按作者本人的习惯硬编码，其他人直接用大概率跑不通，需要按自己的 Drive 目录结构改代码。

---

## 关于 farfarfun

[farfarfun](https://github.com/farfarfun) 是一个专注于实用工具库的开源组织，
涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

- 🏠 组织主页：<https://github.com/farfarfun>
- 📦 PyPI：<https://pypi.org/user/niuliangtao/>
- 📧 联系：farfarfun@qq.com

本项目基于 [MIT](LICENSE) 协议开源。