{"id":13654291,"url":"https://github.com/neroden/timetable_kit","last_synced_at":"2025-04-23T08:32:03.527Z","repository":{"id":37242472,"uuid":"451949102","full_name":"neroden/timetable_kit","owner":"neroden","description":"A Python toolkit for generating human-readable timetables from GTFS data; uses PANDAS and gtfs_kit","archived":false,"fork":false,"pushed_at":"2024-08-10T05:43:17.000Z","size":25648,"stargazers_count":39,"open_issues_count":4,"forks_count":2,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-11-10T05:32:09.807Z","etag":null,"topics":["gtfs","html-timetables","metro","pandas","public-transport","public-transportation","python","static-gtfs","timetable","trains","transit","transit-data","transportation","trip-planning"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/neroden.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-25T16:13:31.000Z","updated_at":"2024-08-10T15:44:19.000Z","dependencies_parsed_at":"2023-10-04T12:13:57.546Z","dependency_job_id":"d1b9ddc6-3b86-4536-9f7b-5168d632e89e","html_url":"https://github.com/neroden/timetable_kit","commit_stats":{"total_commits":1442,"total_committers":4,"mean_commits":360.5,"dds":0.0846047156726768,"last_synced_commit":"bba264f86e55c35559af4fd53104f90061ca0f2d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neroden%2Ftimetable_kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neroden%2Ftimetable_kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neroden%2Ftimetable_kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neroden%2Ftimetable_kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neroden","download_url":"https://codeload.github.com/neroden/timetable_kit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250399528,"owners_count":21424199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gtfs","html-timetables","metro","pandas","public-transport","public-transportation","python","static-gtfs","timetable","trains","transit","transit-data","transportation","trip-planning"],"created_at":"2024-08-02T02:01:26.560Z","updated_at":"2025-04-23T08:31:58.516Z","avatar_url":"https://github.com/neroden.png","language":"Python","readme":"Timetable Kit\n*************\n\nTimetable Kit (timetable_kit) is a Python toolkit for generating human-readable timetables from `General Transit Feed Specification (GTFS) \u003chttps://en.wikipedia.org/wiki/GTFS\u003e` data.\n\nThe user provides a \"prototype\" timetable in CSV form (with stations/stops along the left column and train numbers/trip numbers along the top row), along with a TOML file specifying options.  Then timetable_kit fills in the times and other info (from GTFS) and produces either HTML \u0026 CSS, PDF, or a plaintext CSV file.\n\nDevelopment status\n==================\nTimetable_kit remains under active development.\nIt is quite usable to create Amtrak timetables and VIA Rail Canada timetables.\n\nIt has not yet been generalized to create timetables in general.\n\nInterfaces are moderately stable.  New options continue to be added in spec files.\nCommand line options remain in a state of flux.\nThe interface will change as needs are discovered while creating particular timetables.\n\nDirectory Structure\n===================\nIn keeping with the universal, if bizarre, Python package source directory structure,\nthe entire package is in a subdirectory called timetable_kit.\n\nThe only exceptions are HOWTO, certain build files, this file, and LICENSE.\n\nIn particular, data resources and documentation are largely inside the package directory at\nthis time.  This may change.\n\nDependencies\n============\nTimetable Kit requires Python 3.11, because it uses \"Self.\"\nEven if you removed those, it requires Python 3.10, because it uses the match/case statement,\nand it uses it very, very intensively.\n\nIt relies on `GTFS Kit \u003chttps://github.com/mrcagney/gtfs_kit\u003e` to parse GTFS.\n\nLike GTFS Kit, it uses `PANDAS \u003chttps://pandas.pydata.org\u003e` to do the heavy lifting.\nIt was most recently tested with PANDAS 2.1.4.\n\nTimetable Kit also requires the jinja2 package.  Jinja2 templates are used extensively.\n\nIt uses Weasyprint to convert HTML timetables to PDF timetables.\n\nIt uses tomlkit to read \u0026 write the TOML files.\n\nIt uses xdg-base-dirs to find out where to store its data.\n\nOne of the tools uses the LXML module to parse Amtrak's station web pages.\n\nIt's packaged as a package with Poetry, so presumably requires Poetry to install.\n\n\nFurther Documentation\n=====================\nLook in the HOWTO file for information on setting this up as an editable module.\nLook in the timetable_kit folder for the README.rst there for further info on using the program.\n\nAuthors\n=======\nCopyright 2021, 2022, 2023 Nathanael Nerode.\n\nSpartanTT Copyright 2023 Matt Bailey, Mirko Velimirovic, Nathanael Nerode.\n\nSome fonts, icons, and logos are from other sources and have their own authors, copyrights,\nand licenses, noted in their directories or files.\n\nLicenses\n========\nThe timetable_kit software is licensed under GNU Affero GPL v.3 or later.\nA copy of this is in the LICENSE file.\n\nProduced timetables might contain some copyrightable material from timetable_kit.\n\nAny copyrighted material from timetable_kit which appears in generated timetables and\nstylesheets is addtionally licensed under the \nCreative Commons Attribution 4.0 International License.\nTo view a copy of this license, visit\nhttp://creativecommons.org/licenses/by/4.0/\nor send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.\n\nThe font SpartanTT is licensed under the Open Font License 1.1.\nSee fonts/OFL.txt for more information.\nhttps://scripts.sil.org/cms/scripts/page.php?site_id=nrsi\u0026id=OFL\n\nSome fonts and icons are from other sources and have their own copyrights and licenses.\nThey are all free, libre, and open-source.  See their subdirectories for more information.\n\nConnecting service logos in the timetable_kit/connecting_services/logos directory may be subject to other copyrights\nand some might not be free, libre, or open-source.  They are mostly trademarks, used strictly to refer to the appropriate transit service or agency,\nwhich is legal to do without asking permission under trademark law.  They can be disabled (replaced with alternate text references)\nby removing the reference to the logo file in the connecting_services/connecting_services.csv file.\n\n\nExamples\n=========\n\nThis are some (probably out of date) timetables made using timetable_kit.\n\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/maple-leaf.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/vermont-to-upstate-ny.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/empire-builder.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/michigan-services.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/ocean.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/richmond-weekday-nb.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/jasper-prince-rupert.jpg\n.. image:: https://github.com/neroden/timetable_kit/raw/main/samples/canadian.jpg\n","funding_links":[],"categories":["Producing Data","awesome-open-transport"],"sub_categories":["GTFS","6. Other Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneroden%2Ftimetable_kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneroden%2Ftimetable_kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneroden%2Ftimetable_kit/lists"}