swarm-to-sqlite

创建包含您的Foursquare Swarm签到历史的SQLite数据库。

安装方法

$ pip install swarm-to-sqlite

用法

您首先需要为您的Foursquare账户获取一个有效的OAuth令牌。您可以使用此工具： https://your-foursquare-oauth-token.glitch.me/

最简单的用法是仅提供您希望写入的数据库文件名称。该工具会提示您粘贴令牌，然后将您的签到下载并存储在指定的数据库文件中。

$ swarm-to-sqlite checkins.db
Please provide your Foursquare OAuth token:
Importing 3699 checkins  [#########-----------------------] 27% 00:02:31

您也可以将令牌作为命令行选项传递

$ swarm-to-sqlite checkins.db --token=XXX

或作为环境变量

$ export FOURSQUARE_TOKEN=XXX
$ swarm-to-sqlite checkins.db

要检索过去X小时、天或周的签到，请使用--since=选项。例如，要仅拉取过去10天的签到，请使用

$ swarm-to-sqlite checkins.db --token=XXX --since=10d

使用2w表示两周，10h表示十小时，3d表示三天。

除了将签到保存到数据库中，您还可以使用--save选项将它们写入JSON文件

$ swarm-to-sqlite checkins.db --save=checkins.json

完成此操作后，您可以像这样直接从该文件重新导入签到（而不是通过调用Foursquare的API来获取数据）

$ swarm-to-sqlite checkins.db --load=checkins.json

与Datasette一起使用

此工具生成的SQLite数据库旨在使用Datasette进行浏览。

您可以安装datasette-cluster-map插件来查看您的签到在地图上的位置。