過去時点のコミットをでっちあげて10年分のGoogleマイマップの編集履歴をGitHubに移行するまでの軌跡

やったこと

Before：手動履歴管理

Googleマイマップから出力したKMLファイルをひたすらフォルダに溜めていました。ファイル名に日付を書く伝統的な履歴管理スタイルです。

エンジニアの端くれですがプライベートではこのざま

After：GitHubでのバージョン管理

GitHubでのバージョン管理に移行して、作業記録（コミットメッセージ）も付けました。

ﾄﾞﾔｧ

過去時点のコミットをでっちあげる特殊な操作を行っているので、本記事では特にそのあたりの時間偽装テクニックを紹介しようと思います。

GitHubに移行するまでの軌跡

混沌

Googleマイマップを使って趣味で小字地図を作っているのですが、あいにくGoogleマイマップにはバックアップ機能がありません。そこでとりあえずファイルをエクスポートしてフォルダに保存していました。

冒頭で「ファイル名に日付を書く伝統的な履歴管理スタイル」だったと書きましたが、実は本当の最初はこんな感じでした……

ごみ箱ですか？いいえ、バックアップです。

つらい。

ファイル形式がバラバラ。.csv.kmzとかいうのもあって最悪です。これをあれやこれやして全部.kmlに揃えました。

`.kmz`から`.kml`への変換

KMZファイルはKMLファイルのZIP圧縮なので、拡張子を.zipに変更すると普通に展開でき、KMLファイルを取り出せます。

`.csv`から`.kml`への変換

小字地図作成の黎明期に Google Fusion Tables（現在は廃止）経由でダウンロードしたファイルがCSV形式になってました。

構造化データから非構造化データへの変換は流石に人力では無理なので、Pythonで適当なスクリプトを組んでマッピングしました。

【クリックで「CSV→KML変換スクリプト」を表示】

# CSVをdataframeに格納
import pandas as pd
df = pd.read_csv('草津市小字地図_20130904_297.csv')
df = df.fillna("")

# KMLのヘッダー部分とフッター部分を用意
# (Googleマイマップから出力したKMLを雑に加工しただけなので不要なタグが入っているかも…)
kml_name = "草津市小字地図_20130904_297"

kml_head = f"""\
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>{kml_name}</name>
    <Style id="poly-DB4436-1801-76-normal">
      <LineStyle>
        <color>ff3644db</color>
        <width>1.801</width>
      </LineStyle>
      <PolyStyle>
        <color>4c3644db</color>
        <fill>1</fill>
        <outline>1</outline>
      </PolyStyle>
    </Style>
    <Style id="poly-DB4436-1801-76-highlight">
      <LineStyle>
        <color>ff3644db</color>
        <width>2.7015</width>
      </LineStyle>
      <PolyStyle>
        <color>4c3644db</color>
        <fill>1</fill>
        <outline>1</outline>
      </PolyStyle>
    </Style>
    <StyleMap id="poly-DB4436-1801-76">
      <Pair>
        <key>normal</key>
        <styleUrl>#poly-DB4436-1801-76-normal</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#poly-DB4436-1801-76-highlight</styleUrl>
      </Pair>
    </StyleMap>
"""

kml_tail = """\
  </Document>
</kml>
"""

# CSVの各要素を然るべき場所にマッピングしてKMLを作成
s = kml_head
for _, row in df.iterrows():
    s += f"""\
    <Placemark>
      <name>{row['小字']}</name>
      <styleUrl>#poly-DB4436-1801-76</styleUrl>
      <ExtendedData>
        <Data name="説明">
          <value/>
        </Data>
        <Data name="大字">
          <value>{row['大字']}</value>
        </Data>
        <Data name="No">
          <value>{row['No']}</value>
        </Data>
      </ExtendedData>
      {row['geometry']}
    </Placemark>
"""
s += kml_tail

# ファイル出力
import pathlib
output_file = pathlib.Path(kml_name + ".kml")
output_file.write_text(s)

過去時点のコミットをでっちあげる

バックアップファイルの形式を揃え終わったので、いよいよgitでコミットしていきます。

git環境構築やGitHub リポジトリ作成については本記事では触れませんので、そのあたりの解説は「GitHub 最初」とかでググってください。Macでのgit環境構築については過去記事でも軽く触れてます。

（以下、リポジトリ作成済みの状態とします）

一番古いバックアップファイルをローカルリポジトリに配置して、ファイル名をkusatsu-city-koaza-map.kml にリネームします。

そして普通にgit addします。

git add kusatsu-city-koaza-map.kml

次が重要です。過去時点でコミットしたことにするために、git commitに--dateオプションを付けて日時指定でコミットします。

git commit --date="Feb 25 01:08:00 2012 +0900"

これでgit logを確認すると

% git log
commit ee276ac... (HEAD -> master)
Author: fffw2
Date:   Sat Feb 25 01:08:00 2012 +0900
    野村・上笠・平井の一部の小字を追加

…と、コミット時に指定した日時が「Date」に表示されていて「うまくいった」と安心してしまうのですが、これは巧妙なトラップです！！

このままGitHubにプッシュしても残念ながら指定した日時では表示されません。

実はgitのコミットには2種類の日時が存在しています。

AuthorDate：
- git commit --dateで指定できるのはこっち
- git logで表示されるのはこっち
CommitDate：
- GitHubで使われるのはこっち

git log --pretty=fullerで CommitDate を見てみましょう。

% git log --pretty=fuller
commit ee276ac... (HEAD -> master)
Author:     fffw2 
AuthorDate: Sat Feb 25 01:08:00 2012 +0900
Commit:     fffw2 
CommitDate: Mon Oct 10 18:30:20 2022 +0900
    野村・上笠・平井の一部の小字を追加

AuthorDateは10年前の日付（git commit --dateで指定した日付）ですが、CommitDateは現在の日付になってしまってます。GitHubで使われるのはCommitDateのほうなのでこちらも改変しなくてはいけません。

2種類の日付の齟齬を解消するには

git rebase HEAD~ --committer-date-is-author-date

を実行すればOKです。（ここのオプションはcommit-dateではなくcommitter-dateです）

% git log --pretty=fuller
commit ee276ac... (HEAD -> master)
Author:     fffw2 
AuthorDate: Sat Feb 25 01:08:00 2012 +0900
Commit:     fffw2 
CommitDate: Sat Feb 25 01:08:00 2012 +0900
    野村・上笠・平井の一部の小字を追加

CommitDate＝AuthorDate に書き換わりました。

あとは通常通り git push origin master でリモートにプッシュすれば、GitHubに10年前のコミットが出現します。

他の日付のバックアップファイルについても同様の作業を繰り返しましょう。最終的にこんな感じになります。

ちゃんと過去に草も生えます。

(追記 / 2022-11-30)
GitHubのコミット履歴ではCommitDateが使われますが、プロフィールページに表示される草にはAuthorDateのほうが使われているようです。ややこしいですね。(参考) How GitHub uses the Git author date and commit date - GitHub Docs

On your profile page, the author date is used to calculate when a commit was made. Whereas, in a repository, the commit date is used to calculate when a commit was made in the repository.

歴史改変コマンドまとめ

% git add kusatsu-city-koaza-map.kml
% git commit --date="Feb 25 01:08:00 2012 +0900"
% git rebase HEAD~ --committer-date-is-author-date
% git log --pretty=fuller
% git push origin master

git log は確認用コマンドなので慣れたら省略しても大丈夫です。