Update README.md

2020-03-28 12:05:20 +03:00 · 2020-03-28 12:05:20 +03:00 · 083d98e431
commit 083d98e431
parent c8c9a5d2b4
25 changed files with 2577 additions and 2 deletions
--- a/.clang-format
+++ b/.clang-format
@ -0,0 +1,31 @@
+# Configuration file for clang-format, based on docs/CPP_STYLE.md.
+
+BasedOnStyle: Google
+IndentWidth: 2
+BreakBeforeBraces: Allman
+ColumnLimit: 100
+
+Language: Cpp
+AccessModifierOffset: -2
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: true
+AllowShortFunctionsOnASingleLine: true
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+BreakConstructorInitializersBeforeComma: true
+ConstructorInitializerIndentWidth: 4
+DerivePointerAlignment: false
+IndentCaseLabels: false
+NamespaceIndentation: None
+PointerAlignment: Middle
+SortIncludes: true
+Standard: Cpp11
+
+IncludeBlocks:   Preserve
+IncludeCategories:
+  - Regex:           '^<.*\.h>'
+    Priority:        1
+  - Regex:           '^<.*'
+    Priority:        2
+  - Regex:           '.*'
+    Priority:        3
--- a/.github/workflows/ccpp.yml
+++ b/.github/workflows/ccpp.yml
@ -0,0 +1,31 @@
+name: C/C++ CI
+
+on:
+  push:
+    branches: [ master, add-* ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: git_actions
+      run: git submodule update --init --recursive
+    - name: cmake
+      run: |
+        sudo apt update
+        sudo apt install mm-common g++-9
+        export CXX=g++-9
+        cmake .
+    - name: make
+      run: |
+       export CXX=g++-9
+       make
+    - name: run_tests
+      run: |
+        pwd
+        ctest --output-on-failure
--- a/.gitignore
+++ b/.gitignore
@ -30,3 +30,12 @@
 *.exe
 *.out
 *.app
+
+# Other
+.DS_Store
+.idea/
+cmake-build-debug/
+CMakeFiles/
+Makefile
+*.cmake
+CMakeCache.txt
--- a/.gitmodules
+++ b/.gitmodules
@ -0,0 +1,3 @@
+[submodule "doctest"]
+	path = doctest
+	url = https://github.com/onqtam/doctest
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@ -0,0 +1,15 @@
+cmake_minimum_required(VERSION 3.6)
+
+project(just_gtfs LANGUAGES CXX VERSION 0.1)
+
+include_directories(include)
+include_directories(doctest/doctest)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED on)
+set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -Werror")
+
+enable_testing()
+
+add_subdirectory(tests)
+add_subdirectory(benchmarks)
--- a/LICENSE.MIT
+++ b/LICENSE.MIT
--- a/README.md
+++ b/README.md
@ -1,2 +1,110 @@
-# just_gtfs
-C++17 header-only GTFS parsing library
+# just_gtfs - header-only modern C++ GTFS parsing library
+
+[![GTFS parser for C++](https://github.com/mapsme/just_gtfs/blob/add-the-most-important-readers/docs/logo.jpeg)](https://github.com/mapsme/just_gtfs)
+
+[![C++](https://img.shields.io/badge/c%2B%2B-17-informational.svg)](https://shields.io/)
+[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)
+![](https://github.com/mapsme/just_gtfs/workflows/C%2FC%2B%2B%20CI/badge.svg)
+[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/mapsme/just_gtfs/issues)
+
+ - Header-only
+ - C++17
+ - Tested on GCC and Clang
+ - STL-compatible containers
+ - Fast reading and parsing of GTFS feeds
+
+## Table of Contents
+- [Working with GTFS feeds](#working-with-gtfs-feeds)
+- [How to use just_library](#how-to-use-it)
+- [Used third-party tools](#used-third-party-tools)
+
+## Working with GTFS feeds
+The library implements reading static transit data in GTFS - [General Transit Feed Specification](https://developers.google.com/transit/gtfs/reference).
+It provides class for working with GTFS feeds: `gtfs::Feed`.
+GTFS csv files are mapped to the corresponding C++ classes. Every GTFS entity can be accessed through `gtfs::Feed`.
+
+:pushpin: Example of providing `gtfs::Feed` the feed path, reading it and working with GTFS entities such as stops and routes:
+```c++
+Feed feed("~/data/SFMTA/");
+if (feed.read_feed() == ResultCode::OK)
+{
+	Stops stops = feed.get_stops();
+	std::cout << stops.size() << std::endl;
+
+	Route route = feed.get_route("route_id_1009");
+	if (route)
+	{
+		std::cout << route->route_long_name << std::endl;
+	}
+}
+```
+
+GTFS feed can be wholly read from directory as in the example above or you can read GTFS files separately. E.g., if you need only shapes data, you can avoid parsing all other files and just work with the shapes.
+
+:pushpin: Example of reading only `shapes.txt` from the feed and working with shapes:
+```c++
+Feed feed("~/data/SFMTA/");
+if (feed.read_shapes() == ResultCode::OK)
+{
+	Shapes all_shapes = feed.get_shapes();
+	Shape shape = feed.get_shape("9367");
+}
+```
+
+
+## Methods for reading and writing GTFS entities
+Methods of the `Feed` class for working with agencies:
+
+Read agencies from the corresponding csv file.
+```c++
+Result read_agencies()
+```
+
+Get reference to `Agencies` - `std::vector` of `Agency` objects.
+```c++
+const Agencies & get_agencies()
+```
+
+Find agency by its id. This method returns `std::optional` so you should check if the result is `std::nullopt`.
+```c++
+std::optional<Agency> get_agency(const Id & agency_id)
+``` 
+
+Add agency to the feed.
+```c++
+void add_agency(const Agency & agency)
+```
+
+Add agency to the feed by filling agency object fields with parsed csv values. `row` is `std::map` with csv column titles as keys ans csv row items as values. 
+```c++
+Result add_agency(ParsedCsvRow const & row)
+```
+
+
+:pushpin: **There are similar methods for all other GTFS entities** for getting the list of entities, finding and adding them.
+For some of them additional methods are provided. 
+For example, you can find all the stop times for current stop by its id:
+```c++
+StopTimes get_stop_times_for_stop(const Id & stop_id)
+```
+
+Or you can find stop times for the particular trip:
+```c++
+StopTimes get_stop_times_for_trip(const Id & trip_id, bool sort_by_sequence = true)
+```
+
+## How to use library
+- For including the library in your own project: just_gtfs is completely contained inside a single header and therefore it is sufficient to copy include/just_gtfs/just_gtfs.h to your include pathes. The library does not have to be explicitly build.
+- For running library tests:
+Clone just_gtfs with `git clone --recursive` or run `git submodule update --init --recursive` after cloning.
+In the just_gtfs project directory build the project and run unit tests: 
+```
+cmake .
+make
+ctest --output-on-failure
+```
+The library makes use of the C++17 features and therefore you have to use appropriate compiler version.
+- For including as a submodule: use branch "for-usage-as-submodule" which consists of a single header.
+
+## Used third-party tools
+- [**doctest**](https://github.com/onqtam/doctest) for unit testing.
--- a/benchmarks/CMakeLists.txt
+++ b/benchmarks/CMakeLists.txt
--- a/docs/CPP_STYLE.md
+++ b/docs/CPP_STYLE.md
@ -0,0 +1,6 @@
+## C++ Style Guide
+
+We use C++ code style similar to the [MAPS.ME project](https://github.com/mapsme/omim/blob/master/docs/CPP_STYLE.md) with some differences:
+- Use **CamelCase** for class names and **snake_case** for other entities like methods, variables, etc.
+- Use left-to-right order for variables/params: `const std::string & s` (reference to the const string).
+- Do not use prefixes like `m_` for member variables.
--- a/docs/logo.jpeg
+++ b/docs/logo.jpeg
--- a/1
+++ b/1
@ -0,0 +1 @@
+Subproject commit 932a2ca50666138256dae56fbb16db3b1cae133a
--- a/include/just_gtfs/just_gtfs.h
+++ b/include/just_gtfs/just_gtfs.h
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@ -0,0 +1,10 @@
+file(GLOB TESTS RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.cpp)
+
+message(STATUS "CMAKE_CURRENT_BINARY_DIR=" ${CMAKE_CURRENT_BINARY_DIR})
+
+foreach(TEST_SOURCE ${TESTS})
+    string(REPLACE ".cpp" "" TEST_TARGET "${TEST_SOURCE}")
+    add_executable(${TEST_TARGET} ${TEST_SOURCE})
+    target_compile_features(${TEST_TARGET} PRIVATE cxx_std_17)
+    add_test("${TEST_TARGET}" "${TEST_TARGET}" WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} --verbose)
+endforeach()
--- a/tests/data/sample_feed/agency.txt
+++ b/tests/data/sample_feed/agency.txt
@ -0,0 +1,2 @@
+agency_id,agency_name,agency_url,agency_timezone
+DTA,Demo Transit Authority,http://google.com,America/Los_Angeles
--- a/tests/data/sample_feed/calendar.txt
+++ b/tests/data/sample_feed/calendar.txt
@ -0,0 +1,3 @@
+service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date
+FULLW,1,1,1,1,1,1,1,20070101,20101231
+WE,0,0,0,0,0,1,1,20070101,20101231
--- a/tests/data/sample_feed/calendar_dates.txt
+++ b/tests/data/sample_feed/calendar_dates.txt
@ -0,0 +1,2 @@
+service_id,date,exception_type
+FULLW,20070604,2
--- a/tests/data/sample_feed/fare_attributes.txt
+++ b/tests/data/sample_feed/fare_attributes.txt
@ -0,0 +1,3 @@
+fare_id,price,currency_type,payment_method,transfers,transfer_duration
+p,1.25,USD,0,0,
+a,5.25,USD,0,0,
--- a/tests/data/sample_feed/fare_rules.txt
+++ b/tests/data/sample_feed/fare_rules.txt
@ -0,0 +1,5 @@
+fare_id,route_id,origin_id,destination_id,contains_id
+p,AB,,,
+p,STBA,,,
+p,BFC,,,
+a,AAMV,,,
--- a/tests/data/sample_feed/frequencies.txt
+++ b/tests/data/sample_feed/frequencies.txt
@ -0,0 +1,12 @@
+trip_id,start_time,end_time,headway_secs
+STBA,6:00:00,22:00:00,1800
+CITY1,6:00:00,7:59:59,1800
+CITY2,6:00:00,7:59:59,1800
+CITY1,8:00:00,9:59:59,600
+CITY2,8:00:00,9:59:59,600
+CITY1,10:00:00,15:59:59,1800
+CITY2,10:00:00,15:59:59,1800
+CITY1,16:00:00,18:59:59,600
+CITY2,16:00:00,18:59:59,600
+CITY1,19:00:00,22:00:00,1800
+CITY2,19:00:00,22:00:00,1800
--- a/tests/data/sample_feed/routes.txt
+++ b/tests/data/sample_feed/routes.txt
@ -0,0 +1,6 @@
+route_id,agency_id,route_short_name,route_long_name,route_desc,route_type,route_url,route_color,route_text_color
+AB,DTA,10,Airport - Bullfrog,,3,,,
+BFC,DTA,20,Bullfrog - Furnace Creek Resort,,3,,,
+STBA,DTA,30,Stagecoach - Airport Shuttle,,3,,,
+CITY,DTA,40,City,,3,,,
+AAMV,DTA,50,Airport - Amargosa Valley,,3,,,
--- a/tests/data/sample_feed/shapes.txt
+++ b/tests/data/sample_feed/shapes.txt
@ -0,0 +1,9 @@
+shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
+10237,  43.5176524709, -79.6906570431,50017,12669
+10237,  43.5176982107, -79.6906412064,50018,12669
+10237,  43.5177439788, -79.6906278437,50019,12669
+10237,  43.5177457792, -79.6906278048,50020,12669
+10243,  43.6448714082, -79.5249161004,10001,0
+10243,  43.6448078510, -79.5252239093,10002,0
+10243,  43.6446766156, -79.5251713255,10003,0
+10243,  43.6445544452, -79.5251234796,10004,0
--- a/tests/data/sample_feed/stop_times.txt
+++ b/tests/data/sample_feed/stop_times.txt
@ -0,0 +1,29 @@
+trip_id,arrival_time,departure_time,stop_id,stop_sequence,stop_headsign,pickup_type,drop_off_time,shape_dist_traveled
+STBA,6:00:00,6:00:00,STAGECOACH,1,,,,
+STBA,6:20:00,6:20:00,BEATTY_AIRPORT,2,,,,
+CITY1,6:00:00,6:00:00,STAGECOACH,1,,,,
+CITY1,6:05:00,6:07:00,NANAA,2,,,,
+CITY1,6:12:00,6:14:00,NADAV,3,,,,
+CITY1,6:19:00,6:21:00,DADAN,4,,,,
+CITY1,6:26:00,6:28:00,EMSI,5,,,,
+CITY2,6:28:00,6:30:00,EMSI,1,,,,
+CITY2,6:35:00,6:37:00,DADAN,2,,,,
+CITY2,6:42:00,6:44:00,NADAV,3,,,,
+CITY2,6:49:00,6:51:00,NANAA,4,,,,
+CITY2,6:56:00,6:58:00,STAGECOACH,5,,,,
+AB1,8:00:00,8:00:00,BEATTY_AIRPORT,1,,,,
+AB1,8:10:00,8:15:00,BULLFROG,2,,,,
+AB2,12:05:00,12:05:00,BULLFROG,1,,,,
+AB2,12:15:00,12:15:00,BEATTY_AIRPORT,2
+BFC1,8:20:00,8:20:00,BULLFROG,1
+BFC1,9:20:00,9:20:00,FUR_CREEK_RES,2
+BFC2,11:00:00,11:00:00,FUR_CREEK_RES,1
+BFC2,12:00:00,12:00:00,BULLFROG,2
+AAMV1,8:00:00,8:00:00,BEATTY_AIRPORT,1
+AAMV1,9:00:00,9:00:00,AMV,2
+AAMV2,10:00:00,10:00:00,AMV,1
+AAMV2,11:00:00,11:00:00,BEATTY_AIRPORT,2
+AAMV3,13:00:00,13:00:00,BEATTY_AIRPORT,1
+AAMV3,14:00:00,14:00:00,AMV,2
+AAMV4,15:00:00,15:00:00,AMV,1
+AAMV4,16:00:00,16:00:00,BEATTY_AIRPORT,2
--- a/tests/data/sample_feed/stops.txt
+++ b/tests/data/sample_feed/stops.txt
@ -0,0 +1,10 @@
+stop_id,stop_name,stop_desc,stop_lat,stop_lon,zone_id,stop_url
+FUR_CREEK_RES,Furnace Creek Resort (Demo),,36.425288,-117.133162,,
+BEATTY_AIRPORT,Nye County Airport (Demo),,36.868446,-116.784582,,
+BULLFROG,Bullfrog (Demo),,36.88108,-116.81797,,
+STAGECOACH,Stagecoach Hotel & Casino (Demo),,36.915682,-116.751677,,
+NADAV,North Ave / D Ave N (Demo),,36.914893,-116.76821,,
+NANAA,North Ave / N A Ave (Demo),,36.914944,-116.761472,,
+DADAN,Doing Ave / D Ave N (Demo),,36.909489,-116.768242,,
+EMSI,E Main St / S Irving St (Demo),,36.905697,-116.76218,,
+AMV,Amargosa Valley (Demo),,36.641496,-116.40094,,
--- a/tests/data/sample_feed/trips.txt
+++ b/tests/data/sample_feed/trips.txt
@ -0,0 +1,12 @@
+route_id,service_id,trip_id,trip_headsign,direction_id,block_id,shape_id
+AB,FULLW,AB1,to Bullfrog,0,1,
+AB,FULLW,AB2,to Airport,1,2,
+STBA,FULLW,STBA,Shuttle,,,
+CITY,FULLW,CITY1,,0,,
+CITY,FULLW,CITY2,,1,,
+BFC,FULLW,BFC1,to Furnace Creek Resort,0,1,
+BFC,FULLW,BFC2,to Bullfrog,1,2,
+AAMV,WE,AAMV1,to Amargosa Valley,0,,
+AAMV,WE,AAMV2,to Airport,1,,
+AAMV,WE,AAMV3,to Amargosa Valley,0,,
+AAMV,WE,AAMV4,to Airport,1,,
--- a/tests/unit_tests.cpp
+++ b/tests/unit_tests.cpp
@ -0,0 +1,345 @@
+#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
+#include "doctest.h"
+
+#include "just_gtfs/just_gtfs.h"
+
+using namespace gtfs;
+
+TEST_SUITE_BEGIN("Handling time GTFS fields");
+TEST_CASE("Time in H:MM:SS format")
+{
+  Time stop_time("0:19:00");
+  CHECK(stop_time.is_provided());
+  CHECK_EQ(stop_time.get_hh_mm_ss(), std::make_tuple(0, 19, 0));
+  CHECK_EQ(stop_time.get_raw_time(), "0:19:00");
+  CHECK_EQ(stop_time.get_total_seconds(), 19 * 60);
+}
+
+TEST_CASE("Time in HH:MM:SS format")
+{
+  Time stop_time("39:45:30");
+  CHECK_EQ(stop_time.get_hh_mm_ss(), std::make_tuple(39, 45, 30));
+  CHECK_EQ(stop_time.get_raw_time(), "39:45:30");
+  CHECK_EQ(stop_time.get_total_seconds(), 39 * 60 * 60 + 45 * 60 + 30);
+}
+
+TEST_CASE("Time from integers 1")
+{
+  Time stop_time(14, 30, 0);
+  CHECK_EQ(stop_time.get_hh_mm_ss(), std::make_tuple(14, 30, 0));
+  CHECK_EQ(stop_time.get_raw_time(), "14:30:00");
+  CHECK_EQ(stop_time.get_total_seconds(), 14 * 60 * 60 + 30 * 60);
+}
+
+TEST_CASE("Time from integers 2")
+{
+  Time stop_time(3, 0, 0);
+  CHECK_EQ(stop_time.get_hh_mm_ss(), std::make_tuple(3, 0, 0));
+  CHECK_EQ(stop_time.get_raw_time(), "03:00:00");
+  CHECK_EQ(stop_time.get_total_seconds(), 3 * 60 * 60);
+}
+
+TEST_CASE("Invalid time format")
+{
+  CHECK_THROWS_AS(Time("12/10/00"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Time("12:100:00"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Time("12:10:100"), const InvalidFieldFormat &);
+}
+
+TEST_CASE("Time not provided")
+{
+  Time stop_time("");
+  CHECK(!stop_time.is_provided());
+}
+
+TEST_CASE("Convert to Time with 24 hours max")
+{
+  Time stop_time_near_midnight("24:05:00");
+  CHECK(stop_time_near_midnight.limit_hours_to_24max());
+  CHECK_EQ(stop_time_near_midnight.get_raw_time(), "00:05:00");
+
+  Time stop_time_morning("27:05:00");
+  stop_time_morning.limit_hours_to_24max();
+  CHECK_EQ(stop_time_morning.get_raw_time(), "03:05:00");
+}
+
+TEST_SUITE_END();
+
+TEST_SUITE_BEGIN("Handling date GTFS fields");
+TEST_CASE("Date not provided")
+{
+  Date date("");
+  CHECK(!date.is_provided());
+}
+
+TEST_CASE("Invalid date format")
+{
+  // Violation of the format YYYYMMDD:
+  CHECK_THROWS_AS(Date("1999314"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Date("20081414"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Date("20170432"), const InvalidFieldFormat &);
+
+  // Count of days in february (leap year):
+  CHECK_THROWS_AS(Date("20200230"), const InvalidFieldFormat &);
+  // Count of days in february (not leap year):
+  CHECK_THROWS_AS(Date("20210229"), const InvalidFieldFormat &);
+
+  // Count of days in months with 30 days:
+  CHECK_THROWS_AS(Date("19980431"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Date("19980631"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Date("19980931"), const InvalidFieldFormat &);
+  CHECK_THROWS_AS(Date("19981131"), const InvalidFieldFormat &);
+}
+
+TEST_CASE("Date from string 1")
+{
+  Date date("20230903");
+  CHECK_EQ(date.get_yyyy_mm_dd(), std::make_tuple(2023, 9, 3));
+  CHECK_EQ(date.get_raw_date(), "20230903");
+  CHECK(date.is_provided());
+}
+
+TEST_CASE("Date from string 2")
+{
+  Date date("20161231");
+  CHECK_EQ(date.get_yyyy_mm_dd(), std::make_tuple(2016, 12, 31));
+  CHECK_EQ(date.get_raw_date(), "20161231");
+  CHECK(date.is_provided());
+}
+
+TEST_CASE("Date from string 3")
+{
+  Date date("20200229");
+  CHECK_EQ(date.get_yyyy_mm_dd(), std::make_tuple(2020, 2, 29));
+  CHECK_EQ(date.get_raw_date(), "20200229");
+  CHECK(date.is_provided());
+}
+
+TEST_CASE("Date from integers")
+{
+  Date date(2022, 8, 16);
+  CHECK_EQ(date.get_yyyy_mm_dd(), std::make_tuple(2022, 8, 16));
+
+  CHECK_EQ(date.get_raw_date(), "20220816");
+  CHECK(date.is_provided());
+}
+
+TEST_SUITE_END();
+
+TEST_SUITE_BEGIN("Csv parsing");
+TEST_CASE("Record with empty values")
+{
+  const auto res = CsvParser::split_record(",, ,");
+  CHECK_EQ(res.size(), 4);
+  for (const auto & token : res)
+    CHECK(token.empty());
+}
+
+TEST_CASE("Header with UTF BOM")
+{
+  const auto res = CsvParser::split_record("\xef\xbb\xbfroute_id, agency_id", true);
+  CHECK_EQ(res.size(), 2);
+  CHECK_EQ(res[0], "route_id");
+  CHECK_EQ(res[1], "agency_id");
+}
+
+TEST_CASE("Quotation marks")
+{
+  const auto res = CsvParser::split_record(R"(27681 ,,"Sisters, OR",,"44.29124",1)");
+  CHECK_EQ(res.size(), 6);
+  CHECK_EQ(res[2], "Sisters, OR");
+  CHECK_EQ(res[4], "44.29124");
+  CHECK_EQ(res[5], "1");
+}
+TEST_SUITE_END();
+
+TEST_SUITE_BEGIN("Read");
+// Credits:
+// https://www.sfmta.com/reports/gtfs-transit-data
+TEST_CASE("Empty container before parsing")
+{
+  Feed feed("data/San Francisco Municipal Transportation Agency");
+  CHECK(feed.get_agencies().empty());
+  auto agency = feed.get_agency("10");
+  CHECK(!agency);
+}
+
+TEST_CASE("Transfers")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_transfers();
+  CHECK_EQ(res.code, ResultCode::ERROR_FILE_ABSENT);
+  CHECK_EQ(feed.get_transfers().size(), 0);
+}
+
+TEST_CASE("Calendar")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_calendar();
+  CHECK_EQ(res.code, ResultCode::OK);
+  const auto & calendar = feed.get_calendar();
+  CHECK_EQ(calendar.size(), 2);
+
+  const auto calendar_record = feed.get_calendar("WE");
+  CHECK(calendar_record);
+
+  CHECK_EQ(calendar_record->start_date, Date(2007, 01, 01));
+  CHECK_EQ(calendar_record->end_date, Date(2010, 12, 31));
+
+  CHECK_EQ(calendar_record->monday, CalendarAvailability::NotAvailable);
+  CHECK_EQ(calendar_record->tuesday, CalendarAvailability::NotAvailable);
+  CHECK_EQ(calendar_record->wednesday, CalendarAvailability::NotAvailable);
+  CHECK_EQ(calendar_record->thursday, CalendarAvailability::NotAvailable);
+  CHECK_EQ(calendar_record->friday, CalendarAvailability::NotAvailable);
+  CHECK_EQ(calendar_record->saturday, CalendarAvailability::Available);
+  CHECK_EQ(calendar_record->sunday, CalendarAvailability::Available);
+}
+
+TEST_CASE("Calendar dates")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_calendar_dates();
+  CHECK_EQ(res.code, ResultCode::OK);
+  const auto & calendar_dates = feed.get_calendar_dates();
+  CHECK_EQ(calendar_dates.size(), 1);
+
+  const auto calendar_record = feed.get_calendar_dates("FULLW");
+  CHECK(!calendar_record.empty());
+
+  CHECK_EQ(calendar_record[0].date, Date(2007, 06, 04));
+  CHECK_EQ(calendar_record[0].exception_type, CalendarDateException::Removed);
+}
+
+TEST_CASE("Read GTFS feed")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_feed();
+  CHECK_EQ(res.code, ResultCode::OK);
+  CHECK_EQ(feed.get_agencies().size(), 1);
+  CHECK_EQ(feed.get_routes().size(), 5);
+  CHECK_EQ(feed.get_trips().size(), 11);
+  CHECK_EQ(feed.get_shapes().size(), 8);
+  CHECK_EQ(feed.get_stops().size(), 9);
+  CHECK_EQ(feed.get_stop_times().size(), 28);
+}
+
+TEST_CASE("Agencies")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_agencies();
+  CHECK_EQ(res.code, ResultCode::OK);
+  const auto & agencies = feed.get_agencies();
+  CHECK_EQ(agencies.size(), 1);
+  CHECK_EQ(agencies[0].agency_id, "DTA");
+  CHECK_EQ(agencies[0].agency_name, "Demo Transit Authority");
+  CHECK_EQ(agencies[0].agency_url, "http://google.com");
+  CHECK(agencies[0].agency_lang.empty());
+  CHECK_EQ(agencies[0].agency_timezone, "America/Los_Angeles");
+
+  const auto agency = feed.get_agency("DTA");
+  CHECK(agency);
+}
+
+TEST_CASE("Routes")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_routes();
+  CHECK_EQ(res.code, ResultCode::OK);
+  const auto & routes = feed.get_routes();
+  CHECK_EQ(routes.size(), 5);
+  CHECK_EQ(routes[0].route_id, "AB");
+  CHECK_EQ(routes[0].agency_id, "DTA");
+  CHECK_EQ(routes[0].route_short_name, "10");
+  CHECK_EQ(routes[0].route_long_name, "Airport - Bullfrog");
+  CHECK_EQ(routes[0].route_type, RouteType::Bus);
+  CHECK(routes[0].route_text_color.empty());
+  CHECK(routes[0].route_color.empty());
+  CHECK(routes[0].route_desc.empty());
+
+  auto const route = feed.get_route("AB");
+  CHECK(route);
+}
+
+TEST_CASE("Trips")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_trips();
+  CHECK_EQ(res.code, ResultCode::OK);
+  const auto & trips = feed.get_trips();
+  CHECK_EQ(trips.size(), 11);
+
+  CHECK_EQ(trips[0].block_id, "1");
+  CHECK_EQ(trips[0].route_id, "AB");
+  CHECK_EQ(trips[0].direction_id, TripDirectionId::DefaultDirection);
+  CHECK_EQ(trips[0].trip_headsign, "to Bullfrog");
+  CHECK(trips[0].shape_id.empty());
+  CHECK_EQ(trips[0].service_id, "FULLW");
+  CHECK_EQ(trips[0].trip_id, "AB1");
+
+  auto const trip = feed.get_trip("AB1");
+  CHECK(trip);
+  CHECK(trip.value().trip_short_name.empty());
+}
+
+TEST_CASE("Stops")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_stops();
+  CHECK_EQ(res.code, ResultCode::OK);
+
+  const auto & stops = feed.get_stops();
+  CHECK_EQ(stops.size(), 9);
+  CHECK_EQ(stops[0].stop_lat, 36.425288);
+  CHECK_EQ(stops[0].stop_lon, -117.133162);
+  CHECK(stops[0].stop_code.empty());
+  CHECK(stops[0].stop_url.empty());
+  CHECK_EQ(stops[0].stop_id, "FUR_CREEK_RES");
+  CHECK(stops[0].stop_desc.empty());
+  CHECK_EQ(stops[0].stop_name, "Furnace Creek Resort (Demo)");
+  CHECK_EQ(stops[0].location_type, StopLocationType::GenericNode);
+  CHECK(stops[0].zone_id.empty());
+
+  auto const stop = feed.get_stop("FUR_CREEK_RES");
+  CHECK(stop);
+}
+
+TEST_CASE("StopTimes")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_stop_times();
+  CHECK_EQ(res.code, ResultCode::OK);
+
+  const auto & stop_times = feed.get_stop_times();
+  CHECK_EQ(stop_times.size(), 28);
+
+  CHECK_EQ(stop_times[0].trip_id, "STBA");
+  CHECK_EQ(stop_times[0].arrival_time, Time(06, 00, 00));
+  CHECK_EQ(stop_times[0].departure_time, Time(06, 00, 00));
+  CHECK_EQ(stop_times[0].stop_id, "STAGECOACH");
+  CHECK_EQ(stop_times[0].stop_sequence, 1);
+  CHECK(stop_times[0].stop_headsign.empty());
+  CHECK_EQ(stop_times[0].pickup_type, StopTimeBoarding::RegularlyScheduled);
+  CHECK_EQ(stop_times[0].drop_off_type, StopTimeBoarding::RegularlyScheduled);
+
+  CHECK_EQ(feed.get_stop_times_for_stop("STAGECOACH").size(), 3);
+  CHECK_EQ(feed.get_stop_times_for_trip("STBA").size(), 2);
+}
+
+TEST_CASE("Shapes")
+{
+  Feed feed("data/sample_feed");
+  auto res = feed.read_shapes();
+  CHECK_EQ(res.code, ResultCode::OK);
+
+  const auto & shapes = feed.get_shapes();
+  CHECK_EQ(shapes.size(), 8);
+  CHECK_EQ(shapes[0].shape_id, "10237");
+  CHECK_EQ(shapes[0].shape_pt_lat, 43.5176524709);
+  CHECK_EQ(shapes[0].shape_pt_lon, -79.6906570431);
+  CHECK_EQ(shapes[0].shape_pt_sequence, 50017);
+  CHECK_EQ(shapes[0].shape_dist_traveled, 12669);
+
+  auto const shape = feed.get_shape("10237");
+  CHECK_EQ(shape.size(), 4);
+}
+TEST_SUITE_END();
				`@ -0,0 +1 @@`
				`Subproject commit 932a2ca50666138256dae56fbb16db3b1cae133a`