[gnome-maps/wip/mlundblad/transit-plugin-gtfs-local: 1/7] WIP: Add class representing an agency in a GTFS feed

[Marcus Lundblad <mlundblad src gnome org>]

commit c2430a52fb8030c3af6423864c41d8d61460babf
Author: Marcus Lundblad <ml update uu se>
Date:   Sun Feb 23 11:53:31 2020 +0100

    WIP: Add class representing an agency in a GTFS feed

 lib/maps-gtfs-agency.c | 207 +++++++++++++++++++++++++++++++++++++++++++++++++
 lib/maps-gtfs-agency.h |  40 ++++++++++
 lib/meson.build        |   2 +
 3 files changed, 249 insertions(+)
---
diff --git a/lib/maps-gtfs-agency.c b/lib/maps-gtfs-agency.c
new file mode 100644
index 00000000..9c08e26a
--- /dev/null
+++ b/lib/maps-gtfs-agency.c
@@ -0,0 +1,207 @@
+/*
+ * Copyright (c) 2020 Marcus Lundblad
+ *
+ * GNOME Maps is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by the
+ * Free Software Foundation; either version 2 of the License, or (at your
+ * option) any later version.
+ *
+ * GNOME Maps is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with GNOME Maps; if not, see <http://www.gnu.org/licenses/>
+ *
+ * Author: Marcus Lundblad <ml update uu se>
+ */
+
+#include "maps-gtfs-agency.h"
+
+struct _MapsGTFSAgency
+{
+  GObject parent_instance;
+};
+
+typedef struct
+{
+  gchar *id;
+  gchar *name;
+  gchar *url;
+  GTimeZone *timezone;
+  gchar *lang;
+  gchar *phone;
+  gchar *fare_url;
+  gchar *email;
+} MapsGTFSAgencyPrivate;
+
+G_DEFINE_TYPE_WITH_PRIVATE (MapsGTFSAgency, maps_gtfs_agency, G_TYPE_OBJECT)
+
+enum {
+  PROP_0,
+  PROP_ID,
+  PROP_NAME,
+  PROP_URL,
+  PROP_TIMEZONE,
+  PROP_LANG,
+  PROP_PHONE,
+  PROP_FARE_URL,
+  PROP_EMAIL,
+  N_PROPS
+};
+
+static GParamSpec *properties [N_PROPS];
+
+/**
+ * maps_gtfs_agency_new:
+ *
+ * Create a new #MapsGtfsAgency.
+ *
+ * Returns: (transfer full): a newly created #MapsGtfsAgency
+ */
+MapsGTFSAgency *
+maps_gtfs_agency_new (gchar *id, gchar *name, gchar *url, GTimeZone *timezone,
+                      gchar *lang, gchar *phone, gchar *fare_url, gchar *email)
+{
+  MapsGTFSAgency *agency =
+    MAPS_GTFS_AGENCY (g_object_new (MAPS_TYPE_GTFS_AGENCY, NULL));
+  MapsGTFSAgencyPrivate *priv = maps_gtfs_agency_get_instance_private (agency);
+
+  priv->id = g_strdup (id);
+  priv->name = g_strdup (name);
+  priv->url = g_strdup (url);
+  priv->timezone = g_time_zone_ref (timezone);
+  priv->lang = g_strdup (lang);
+  priv->phone = g_strdup (phone);
+  priv->fare_url = g_strdup (fare_url);
+  priv->email = g_strdup (email);
+
+  return agency;
+}
+
+static void
+maps_gtfs_agency_finalize (GObject *object)
+{
+  MapsGTFSAgency *self = (MapsGTFSAgency *)object;
+  MapsGTFSAgencyPrivate *priv = maps_gtfs_agency_get_instance_private (self);
+
+  g_clear_pointer (&priv->id, g_free);
+  g_clear_pointer (&priv->name, g_free);
+  g_clear_pointer (&priv->url, g_free);
+  g_clear_pointer (&priv->timezone, g_time_zone_unref);
+  g_clear_pointer (&priv->lang, g_free);
+  g_clear_pointer (&priv->phone, g_free);
+  g_clear_pointer (&priv->fare_url, g_free);
+  g_clear_pointer (&priv->email, g_free);
+
+  G_OBJECT_CLASS (maps_gtfs_agency_parent_class)->finalize (object);
+}
+
+static void
+maps_gtfs_agency_get_property (GObject    *object,
+                               guint       prop_id,
+                               GValue     *value,
+                               GParamSpec *pspec)
+{
+  MapsGTFSAgency *self = MAPS_GTFS_AGENCY (object);
+  MapsGTFSAgencyPrivate *priv = maps_gtfs_agency_get_instance_private (self);
+
+  switch (prop_id)
+    {
+    case PROP_ID:
+      g_value_set_string (value, priv->id);
+      break;
+    case PROP_NAME:
+      g_value_set_string (value, priv->name);
+      break;
+    case PROP_URL:
+      g_value_set_string (value, priv->url);
+      break;
+    case PROP_TIMEZONE:
+      g_value_set_boxed (value, priv->timezone);
+      break;
+    case PROP_LANG:
+      g_value_set_string (value, priv->lang);
+      break;
+    case PROP_PHONE:
+      g_value_set_string (value, priv->phone);
+      break;
+    case PROP_FARE_URL:
+      g_value_set_string (value, priv->fare_url);
+      break;
+    case PROP_EMAIL:
+      g_value_set_string (value, priv->email);
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+    }
+}
+
+static void
+maps_gtfs_agency_class_init (MapsGTFSAgencyClass *klass)
+{
+  GObjectClass *object_class = G_OBJECT_CLASS (klass);
+
+  object_class->finalize = maps_gtfs_agency_finalize;
+  object_class->get_property = maps_gtfs_agency_get_property;
+
+  properties[PROP_ID] =
+    g_param_spec_string ("id",
+                         "ID", "Unique identifier for agency",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_NAME] =
+    g_param_spec_string ("name",
+                         "Name", "Name of agency",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_URL] =
+    g_param_spec_string ("url",
+                         "URL", "URL of agency web page",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_TIMEZONE] =
+    g_param_spec_boxed ("timezone",
+                        "Timezone", "Local timezone agency operates in",
+                        G_TYPE_TIME_ZONE,
+                        G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_LANG] =
+    g_param_spec_string ("lang",
+                         "Language",
+                         "ISO language code for the native language, e.g. 'en', 'pt-BR'",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_PHONE] =
+    g_param_spec_string ("phone",
+                         "Phone", "Phone number to agency",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_FARE_URL] =
+    g_param_spec_string ("fare_url",
+                         "Fare URL", "URL of agency's fare information web page",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+  properties[PROP_EMAIL] =
+    g_param_spec_string ("email",
+                         "E-mail", "E-mail address to agency",
+                         NULL,
+                         G_PARAM_READABLE|G_PARAM_EXPLICIT_NOTIFY);
+
+  g_object_class_install_properties (object_class, N_PROPS, properties);
+}
+
+static void
+maps_gtfs_agency_init (MapsGTFSAgency *self)
+{
+  MapsGTFSAgencyPrivate *priv = maps_gtfs_agency_get_instance_private (self);
+
+  priv->id = NULL;
+  priv->name = NULL;
+  priv->url = NULL;
+  priv->timezone = NULL;
+  priv->lang = NULL;
+  priv->phone = NULL;
+  priv->fare_url = NULL;
+  priv->email = NULL;
+}
diff --git a/lib/maps-gtfs-agency.h b/lib/maps-gtfs-agency.h
new file mode 100644
index 00000000..e2130373
--- /dev/null
+++ b/lib/maps-gtfs-agency.h
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2020 Marcus Lundblad
+ *
+ * GNOME Maps is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by the
+ * Free Software Foundation; either version 2 of the License, or (at your
+ * option) any later version.
+ *
+ * GNOME Maps is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with GNOME Maps; if not, see <http://www.gnu.org/licenses/>
+ *
+ * Author: Marcus Lundblad <ml update uu se>
+ */
+
+#pragma once
+
+#include <glib-object.h>
+
+G_BEGIN_DECLS
+
+#define MAPS_TYPE_GTFS_AGENCY (maps_gtfs_agency_get_type())
+
+G_DECLARE_FINAL_TYPE (MapsGTFSAgency, maps_gtfs_agency, MAPS, GTFS_AGENCY, GObject)
+
+struct _MapsGTFSAgencyClass
+{
+  GObjectClass parent_class;
+};
+
+MapsGTFSAgency *maps_gtfs_agency_new (gchar *id, gchar *name, gchar *url,
+                                      GTimeZone *timezone, gchar *lang,
+                                      gchar *phone, gchar *fare_url,
+                                      gchar *email);
+
+G_END_DECLS
diff --git a/lib/meson.build b/lib/meson.build
index 60543648..401325f6 100644
--- a/lib/meson.build
+++ b/lib/meson.build
@@ -4,6 +4,7 @@ headers_private = files(
        'maps-contact.h',
        'maps-contact-store.h',
        'maps-file-tile-source.h',
+       'maps-gtfs-agency.h',
        'maps-osm.h',
        'maps-osm-changeset.h',
        'maps-osm-node.h',
@@ -17,6 +18,7 @@ sources = files(
        'maps-contact.c',
        'maps-contact-store.c',
        'maps-file-tile-source.c',
+       'maps-gtfs-agency.c',
        'maps-osm.c',
        'maps-osm-changeset.c',
        'maps-osm-node.c',