preparing importer

Signed-off-by: Stephan Richter <s.richter@srsoftware.de>

de.srsoftware.cal.api/src/main/java/de/srsoftware/cal/api/Appointment.java

@@ -9,7 +9,6 @@ import java.util.Set;
  * This is the central object of the calendar: An appointment
  */
 public interface Appointment {
-
 	/**
 	 * list of attachments associated with the appointment. may be used for flyers or images
 	 * @return list of attachments
@@ -66,5 +65,4 @@ public interface Appointment {
 	 * @return set of links
 	 */
 	Set<Link> urls();
-
 }

de.srsoftware.cal.api/src/main/java/de/srsoftware/cal/api/Attachment.java

@@ -7,7 +7,6 @@ import java.net.URL;
  * attachments may provide additional information about an appointment
  */
 public interface Attachment {
-
 	/**
 	 * the mime type of the attached document
 	 * @return a mime type

de.srsoftware.cal.api/src/main/java/de/srsoftware/cal/api/Coords.java

@@ -5,7 +5,6 @@ package de.srsoftware.cal.api;
  * cartesian coordinates
  */
 public interface Coords {
-
 	/**
 	 * the longitude
 	 * @return the longitude

de.srsoftware.cal.api/src/main/java/de/srsoftware/cal/api/Importer.java

@@ -0,0 +1,21 @@
+/* © SRSoftware 2024 */
+package de.srsoftware.cal.api;
+
+import java.util.List;
+
+/**
+ * Instances of this class can be used to read Appointments from various sources
+ */
+public interface Importer {
+	/**
+	 * Text descripbing this importer
+	 * @return informational text
+	 */
+	String description();
+
+	/**
+	 * get the list of appointments from the source associated with this importer
+	 * @return a list of appointments
+	 */
+	List<Appointment> fetch();
+}

de.srsoftware.cal.api/src/main/java/de/srsoftware/cal/api/Link.java

@@ -6,8 +6,7 @@ import java.net.URL;
 /**
  * Links are additional content that may be added to appointments
  */
-public interface Link{
-
+public interface Link {
 	/**
 	 * some information about the target of the link
 	 * @return descriptive text