Advent of Code 项目使用教程

Advent of Code 项目使用教程

aoc 🎄 My solutions and walkthroughs for Advent of Code and more related stuff. 项目地址: https://gitcode.com/gh_mirrors/ao/aoc

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

Advent of Code 项目的主要目录结构如下：

aoc/
├── 2018/
├── 2019/
├── 2020/
├── 2021/
├── 2022/
├── 2023/
├── utils/
│   ├── editorconfig
│   ├── gitignore
│   ├── CONTRIBUTING.md
│   ├── LICENSE
│   ├── README.md
└── misc/

目录详细介绍：

• 年份目录 (2018, 2019, 2020, 2021, 2022, 2023):

  • 每个年份目录包含该年份的 Advent of Code 题目解决方案和相关文件。
  • README.md: 详细介绍了该年份题目的解决方案和解题思路。
  • solutions/: 包含经过优化和整理的题目解决方案。
  • original_solutions/: 包含最初的、未经过优化的题目解决方案。
  • lib/: 包含该年份通用的工具类代码。
  • misc/: 包含其他有趣的脚本、可视化等内容。
  • full_leaderboard.md: 包含该年份所有参与者的排行榜。
  • calendar.gif: 包含该年份完成所有题目的动画日历（如果作者完成了所有题目）。

• utils/:

  • editorconfig: 编辑器配置文件，用于统一代码风格。
  • gitignore: Git 忽略文件，指定哪些文件或目录不纳入版本控制。
  • CONTRIBUTING.md: 贡献指南，说明如何参与项目贡献。
  • LICENSE: 项目许可证文件，说明项目的版权和许可信息。
  • README.md: 项目总体介绍文件。

• misc/:

  • 包含一些与项目相关的杂项文件，如可视化图像、视频等。

2. 项目的启动文件介绍

项目的启动文件主要是指各个年份目录下的解决方案脚本。例如，2022 年的 Day 1 题目的解决方案脚本路径为 2022/solutions/day01.py。

启动方式：

1. 从标准输入提供输入数据：

   python 2022/solutions/day01.py
   # 然后粘贴输入数据，完成后按 CTRL+D
   

2. 从文件读取输入数据：

   python 2022/solutions/day01.py path/to/your/input.txt
   

3. 直接从 AoC 网站下载输入数据（需要提取浏览器中的 session cookie）：

   curl -s --cookie 'session=VALUE' 'https://adventofcode.com/2022/day/1/input' | python 2022/solutions/day01.py
   

3. 项目的配置文件介绍

项目中的配置文件主要包括 editorconfig 和 .gitignore。

editorconfig

editorconfig 文件用于统一代码风格，确保不同编辑器或 IDE 之间代码格式的一致性。其内容示例如下：

root = true

[*]
indent_style = space
indent_size = 4
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

.gitignore

.gitignore 文件用于指定哪些文件或目录不纳入 Git 版本控制。其内容示例如下：

# Dependency directories
node_modules/
jspm_packages/

# Production build output
build/
dist/

通过以上介绍，你应该能够更好地理解和使用这个 Advent of Code 项目。如果有任何问题或发现错误，欢迎提交 Issue 或 Pull Request。

aoc 🎄 My solutions and walkthroughs for Advent of Code and more related stuff. 项目地址: https://gitcode.com/gh_mirrors/ao/aoc