jvig

发音为d͡ʑvʲik（来自🇵🇱dźwig），它是一个GTFS查看器，使用Flask创建。

jvig仍在开发中，但它确实可以工作。

安装

安装Python（至少3.9）和pip。请咨询您的操作系统存储库以获取软件包名称，但通常为python3和python3-pip。如果您使用没有包管理器的系统，我强烈建议使用一个，例如brew（用于MacOS）或Chocolatey（用于Windows）。

之后，使用pip安装jvig：pip install --upgrade jvig。

使用方法

jvig /path/to/gtfs.zip

或（如果pip安装脚本的路径不在PATH中）

python3 -m jvig /path/to/gtfs.zip

jvig可以打开文件夹和ZIP存档。

jvig本身不包含GUI - 而是在localhost和端口5000上启动一个Web服务器。在控制台看到 * 运行在http://127.0.0.1:5000后，打开http://127.0.0.1:5000。

警告：这是一个开发服务器。

jvig使用默认的Flask服务器，不适合公开到互联网。jvig只绑定到回环地址，服务器只能从您的计算机访问。

请勿将jvig公开到整个互联网。

功能/待办事项

显示的GTFS表

• 机构
• 站点
• 路线
• 行程
• 频率
• 日历
• 票价
• 换乘
• 路径
• 数据源信息
• 归属
• 翻译
• 形状

其他改进

• 搜索（由浏览器提供）
• 验证暗黑模式
• 如果没有提供文件，则启用文件选择器
• 更好的加载屏幕

许可协议

GNU GPL v3或更高版本。完整文本可在license.md文件中找到。

图标

很糟糕，我知道。如果您想，可以制作一个更好的图标。

目前它是这两者结合在一起

• https://thenounproject.com/term/crane/1689627/（购买了使用权）
• https://material.io/resources/icons/?icon=directions_bus&style=outline (Apache 2.0)

开发

此项目使用isort和black进行文件格式化，使用pyright进行类型检查。最大行长度增加到99，类型检查设置为严格。

CI运行以下命令以帮助维护高代码质量

$ black --check .
$ isort --check .
$ pyright
$ python -m pytest

如果您使用VS Code，我建议使用以下设置

{
    "[python]": {
        "editor.codeActionsOnSave": {
            "source.organizeImports": true
        },
        "editor.formatOnSave": true
    },
    "js/ts.implicitProjectConfig.checkJs": true,
    "python.formatting.provider": "black",
    "python.languageServer": "Pylance",
    "python.linting.enabled": false,
}