Bug 16699: Fix mixed-up indentation from 2-4 spaces to 2 spaces
authorLari Taskula <larit@student.uef.fi>
Fri, 10 Jun 2016 14:25:40 +0000 (17:25 +0300)
committerKyle M Hall <kyle@bywatersolutions.com>
Fri, 26 Aug 2016 12:08:51 +0000 (12:08 +0000)
These definitions had indentation of 4 spaces, while rest of the specification
uses 2 spaces. This patch simply maintains the consistency in indentations and
provides no other modifications to code.

Signed-off-by: Olli-Antti Kivilahti <olli-antti.kivilahti@jns.fi>

My name is Olli-Antti Kivilahti and I approve this commit.
We have been using the Swagger2.0-driven REST API on Mojolicious for 1 year now
in production and I am certain we have a pretty good idea on how to work with
the limitations of Swagger2.0
We participated in the development of the Mojolicious::Plugin::Swagger and know
it well. We have made an extension to the plugin to provide full CORS support
and have been building all our in-house features on the new REST API.

Signed-off-by: Johanna Raisa <johanna.raisa@gmail.com>

My name is Johanna Räisä and I approve this commit.
We have been using Swagger2.0-driven REST API in production successfully.

Signed-off-by: Benjamin Rokseth <benjamin.rokseth@kul.oslo.kommune.no>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>

api/v1/definitions/hold.json
api/v1/definitions/holds.json
api/v1/definitions/patron.json

index 620187e..5bbdd82 100644 (file)
@@ -1,67 +1,67 @@
 {
-    "type": "object",
-    "properties": {
-        "reserve_id": {
-            "description": "Internal hold identifier"
-        },
-        "borrowernumber": {
-            "type": "string",
-            "description": "internally assigned user identifier"
-        },
-        "reservedate": {
-            "description": "the date the hold was placed"
-        },
-        "biblionumber": {
-            "type": "string",
-            "description": "internally assigned biblio identifier"
-        },
-        "branchcode": {
-            "type": ["string", "null"],
-            "description": "internally assigned branch identifier"
-        },
-        "notificationdate": {
-            "description": "currently unused"
-        },
-        "reminderdate": {
-            "description": "currently unused"
-        },
-        "cancellationdate": {
-            "description": "the date the hold was cancelled"
-        },
-        "reservenotes": {
-            "description": "notes related to this hold"
-        },
-        "priority": {
-            "description": "where in the queue the patron sits"
-        },
-        "found": {
-            "description": "a one letter code defining what the status of the hold is after it has been confirmed"
-        },
-        "timestamp": {
-            "description": "date and time the hold was last updated"
-        },
-        "itemnumber": {
-            "type": ["string", "null"],
-            "description": "internally assigned item identifier"
-        },
-        "waitingdate": {
-            "description": "the date the item was marked as waiting for the patron at the library"
-        },
-        "expirationdate": {
-            "description": "the date the hold expires"
-        },
-        "lowestPriority": {
-            "description": ""
-        },
-        "suspend": {
-            "description": ""
-        },
-        "suspend_until": {
-            "description": ""
-        },
-        "itemtype": {
-            "type": ["string", "null"],
-            "description": "If record level hold, the optional itemtype of the item the patron is requesting"
-        }
+  "type": "object",
+  "properties": {
+    "reserve_id": {
+      "description": "Internal hold identifier"
+    },
+    "borrowernumber": {
+      "type": "string",
+      "description": "internally assigned user identifier"
+    },
+    "reservedate": {
+      "description": "the date the hold was placed"
+    },
+    "biblionumber": {
+      "type": "string",
+      "description": "internally assigned biblio identifier"
+    },
+    "branchcode": {
+      "type": ["string", "null"],
+      "description": "internally assigned branch identifier"
+    },
+    "notificationdate": {
+      "description": "currently unused"
+    },
+    "reminderdate": {
+      "description": "currently unused"
+    },
+    "cancellationdate": {
+      "description": "the date the hold was cancelled"
+    },
+    "reservenotes": {
+      "description": "notes related to this hold"
+    },
+    "priority": {
+      "description": "where in the queue the patron sits"
+    },
+    "found": {
+      "description": "a one letter code defining what the status of the hold is after it has been confirmed"
+    },
+    "timestamp": {
+      "description": "date and time the hold was last updated"
+    },
+    "itemnumber": {
+      "type": ["string", "null"],
+      "description": "internally assigned item identifier"
+    },
+    "waitingdate": {
+      "description": "the date the item was marked as waiting for the patron at the library"
+    },
+    "expirationdate": {
+      "description": "the date the hold expires"
+    },
+    "lowestPriority": {
+      "description": ""
+    },
+    "suspend": {
+      "description": ""
+    },
+    "suspend_until": {
+      "description": ""
+    },
+    "itemtype": {
+      "type": ["string", "null"],
+      "description": "If record level hold, the optional itemtype of the item the patron is requesting"
     }
+  }
 }
index 6d64441..e551885 100644 (file)
@@ -1,4 +1,6 @@
 {
-    "type": "array",
-    "items": { "$ref": "hold.json" }
+  "type": "array",
+  "items": {
+    "$ref": "hold.json"
+  }
 }
index 8e7d08b..38cf8db 100644 (file)
 {
-      "type": "object",
-      "properties": {
-        "borrowernumber": {
-          "type": "string",
-          "description": "internally assigned user identifier"
-        },
-        "cardnumber": {
-          "type": ["string", "null"],
-          "description": "library assigned user identifier"
-        },
-        "surname": {
-          "type": "string",
-          "description": "patron's last name"
-        },
-        "firstname": {
-          "type": ["string", "null"],
-          "description": "patron's first name"
-        },
-        "title": {
-          "type": ["string", "null"],
-          "description": "patron's title"
-        },
-        "othernames": {
-          "type": ["string", "null"],
-          "description": "any other names associated with the patron"
-        },
-        "initials": {
-          "type": ["string", "null"],
-          "description": "initials of the patron"
-        },
-        "streetnumber": {
-          "type": ["string", "null"],
-          "description": "street number of patron's primary address"
-        },
-        "streettype": {
-          "type": ["string", "null"],
-          "description": "street type of patron's primary address"
-        },
-        "address": {
-          "type": "string",
-          "description": "first address line of patron's primary address"
-        },
-        "address2": {
-          "type": ["string", "null"],
-          "description": "second address line of patron's primary address"
-        },
-        "city": {
-          "type": "string",
-          "description": "city or town of patron's primary address"
-        },
-        "state": {
-          "type": ["string", "null"],
-          "description": "state or province of patron's primary address"
-        },
-        "zipcode": {
-          "type": ["string", "null"],
-          "description": "zip or postal code of patron's primary address"
-        },
-        "country": {
-          "type": ["string", "null"],
-          "description": "country of patron's primary address"
-        },
-        "email": {
-          "type": ["string", "null"],
-          "description": "primary email address for patron's primary address"
-        },
-        "phone": {
-          "type": ["string", "null"],
-          "description": "primary phone number for patron's primary address"
-        },
-        "mobile": {
-          "type": ["string", "null"],
-          "description": "the other phone number for patron's primary address"
-        },
-        "fax": {
-          "type": ["string", "null"],
-          "description": "fax number for patron's primary address"
-        },
-        "emailpro": {
-          "type": ["string", "null"],
-          "description": "secondary email address for patron's primary address"
-        },
-        "phonepro": {
-          "type": ["string", "null"],
-          "description": "secondary phone number for patron's primary address"
-        },
-        "B_streetnumber": {
-          "type": ["string", "null"],
-          "description": "street number of patron's alternate address"
-        },
-        "B_streettype": {
-          "type": ["string", "null"],
-          "description": "street type of patron's alternate address"
-        },
-        "B_address": {
-          "type": ["string", "null"],
-          "description": "first address line of patron's alternate address"
-        },
-        "B_address2": {
-          "type": ["string", "null"],
-          "description": "second address line of patron's alternate address"
-        },
-        "B_city": {
-          "type": ["string", "null"],
-          "description": "city or town of patron's alternate address"
-        },
-        "B_state": {
-          "type": ["string", "null"],
-          "description": "state or province of patron's alternate address"
-        },
-        "B_zipcode": {
-          "type": ["string", "null"],
-          "description": "zip or postal code of patron's alternate address"
-        },
-        "B_country": {
-          "type": ["string", "null"],
-          "description": "country of patron's alternate address"
-        },
-        "B_email": {
-          "type": ["string", "null"],
-          "description": "email address for patron's alternate address"
-        },
-        "B_phone": {
-          "type": ["string", "null"],
-          "description": "phone number for patron's alternate address"
-        },
-        "dateofbirth": {
-          "type": ["string", "null"],
-          "description": "patron's date of birth"
-        },
-        "branchcode": {
-          "type": "string",
-          "description": "code of patron's home branch"
-        },
-        "categorycode": {
-          "type": "string",
-          "description": "code of patron's category"
-        },
-        "dateenrolled": {
-          "type": ["string", "null"],
-          "description": "date the patron was added to Koha"
-        },
-        "dateexpiry": {
-          "type": ["string", "null"],
-          "description": "date the patron's card is set to expire"
-        },
-        "gonenoaddress": {
-          "type": ["string", "null"],
-          "description": "set to 1 if library marked this patron as having an unconfirmed address"
-        },
-        "lost": {
-          "type": ["string", "null"],
-          "description": "set to 1 if library marked this patron as having lost his card"
-        },
-        "debarred": {
-          "type": ["string", "null"],
-          "description": "until this date the patron can only check-in"
-        },
-        "debarredcomment": {
-          "type": ["string", "null"],
-          "description": "comment on the stop of the patron"
-        },
-        "contactname": {
-          "type": ["string", "null"],
-          "description": "used for children and professionals to include surname or last name of guarantor or organization name"
-        },
-        "contactfirstname": {
-          "type": ["string", "null"],
-          "description": "used for children to include first name of guarantor"
-        },
-        "contacttitle": {
-          "type": ["string", "null"],
-          "description": "used for children to include title of guarantor"
-        },
-        "guarantorid": {
-          "type": ["string", "null"],
-          "description": "borrowernumber used for children or professionals to link them to guarantor or organizations"
-        },
-        "borrowernotes": {
-          "type": ["string", "null"],
-          "description": "a note on the patron's account"
-        },
-        "relationship": {
-          "type": ["string", "null"],
-          "description": "used for children to include the relationship to their guarantor"
-        },
-        "sex": {
-          "type": ["string", "null"],
-          "description": "patron's gender"
-        },
-        "password": {
-          "type": ["string", "null"],
-          "description": "patron's encrypted password"
-        },
-        "flags": {
-          "type": ["string", "null"],
-          "description": "a number associated with the patron's permissions"
-        },
-        "userid": {
-          "type": ["string", "null"],
-          "description": "patron's login"
-        },
-        "opacnote": {
-          "type": ["string", "null"],
-          "description": "a note on the patron's account visible in OPAC and staff client"
-        },
-        "contactnote": {
-          "type": ["string", "null"],
-          "description": "a note related to patron's alternate address"
-        },
-        "sort1": {
-          "type": ["string", "null"],
-          "description": "a field that can be used for any information unique to the library"
-        },
-        "sort2": {
-          "type": ["string", "null"],
-          "description": "a field that can be used for any information unique to the library"
-        },
-        "altcontactfirstname": {
-          "type": ["string", "null"],
-          "description": "first name of alternate contact for the patron"
-        },
-        "altcontactsurname": {
-          "type": ["string", "null"],
-          "description": "surname or last name of the alternate contact for the patron"
-        },
-        "altcontactaddress1": {
-          "type": ["string", "null"],
-          "description": "the first address line for the alternate contact for the patron"
-        },
-        "altcontactaddress2": {
-          "type": ["string", "null"],
-          "description": "the second address line for the alternate contact for the patron"
-        },
-        "altcontactaddress3": {
-          "type": ["string", "null"],
-          "description": "the city for the alternate contact for the patron"
-        },
-        "altcontactstate": {
-          "type": ["string", "null"],
-          "description": "the state for the alternate contact for the patron"
-        },
-        "altcontactzipcode": {
-          "type": ["string", "null"],
-          "description": "the zipcode for the alternate contact for the patron"
-        },
-        "altcontactcountry": {
-          "type": ["string", "null"],
-          "description": "the country for the alternate contact for the patron"
-        },
-        "altcontactphone": {
-          "type": ["string", "null"],
-          "description": "the phone number for the alternate contact for the patron"
-        },
-        "smsalertnumber": {
-          "type": ["string", "null"],
-          "description": "the mobile phone number where the patron would like to receive notices (if SMS turned on)"
-        },
-        "sms_provider_id": {
-          "type": ["string", "null"],
-          "description": "the provider of the mobile phone number defined in smsalertnumber"
-        },
-        "privacy": {
-          "type": "string",
-          "description": "patron's privacy settings related to their reading history"
-        },
-        "privacy_guarantor_checkouts": {
-          "type": "string",
-          "description": "controls if relatives can see this patron's checkouts"
-        },
-        "checkprevcheckout": {
-          "type": "string",
-          "description": "produce a warning for this patron if this item has previously been checked out to this patron if 'yes', not if 'no', defer to category setting if 'inherit'"
-        },
-        "updated_on": {
-          "type": "string",
-          "description": "time of last change could be useful for synchronization with external systems (among others)"
-        }
-      }
+  "type": "object",
+  "properties": {
+    "borrowernumber": {
+      "type": "string",
+      "description": "internally assigned user identifier"
+    },
+    "cardnumber": {
+      "type": ["string", "null"],
+      "description": "library assigned user identifier"
+    },
+    "surname": {
+      "type": "string",
+      "description": "patron's last name"
+    },
+    "firstname": {
+      "type": ["string", "null"],
+      "description": "patron's first name"
+    },
+    "title": {
+      "type": ["string", "null"],
+      "description": "patron's title"
+    },
+    "othernames": {
+      "type": ["string", "null"],
+      "description": "any other names associated with the patron"
+    },
+    "initials": {
+      "type": ["string", "null"],
+      "description": "initials of the patron"
+    },
+    "streetnumber": {
+      "type": ["string", "null"],
+      "description": "street number of patron's primary address"
+    },
+    "streettype": {
+      "type": ["string", "null"],
+      "description": "street type of patron's primary address"
+    },
+    "address": {
+      "type": "string",
+      "description": "first address line of patron's primary address"
+    },
+    "address2": {
+      "type": ["string", "null"],
+      "description": "second address line of patron's primary address"
+    },
+    "city": {
+      "type": "string",
+      "description": "city or town of patron's primary address"
+    },
+    "state": {
+      "type": ["string", "null"],
+      "description": "state or province of patron's primary address"
+    },
+    "zipcode": {
+      "type": ["string", "null"],
+      "description": "zip or postal code of patron's primary address"
+    },
+    "country": {
+      "type": ["string", "null"],
+      "description": "country of patron's primary address"
+    },
+    "email": {
+      "type": ["string", "null"],
+      "description": "primary email address for patron's primary address"
+    },
+    "phone": {
+      "type": ["string", "null"],
+      "description": "primary phone number for patron's primary address"
+    },
+    "mobile": {
+      "type": ["string", "null"],
+      "description": "the other phone number for patron's primary address"
+    },
+    "fax": {
+      "type": ["string", "null"],
+      "description": "fax number for patron's primary address"
+    },
+    "emailpro": {
+      "type": ["string", "null"],
+      "description": "secondary email address for patron's primary address"
+    },
+    "phonepro": {
+      "type": ["string", "null"],
+      "description": "secondary phone number for patron's primary address"
+    },
+    "B_streetnumber": {
+      "type": ["string", "null"],
+      "description": "street number of patron's alternate address"
+    },
+    "B_streettype": {
+      "type": ["string", "null"],
+      "description": "street type of patron's alternate address"
+    },
+    "B_address": {
+      "type": ["string", "null"],
+      "description": "first address line of patron's alternate address"
+    },
+    "B_address2": {
+      "type": ["string", "null"],
+      "description": "second address line of patron's alternate address"
+    },
+    "B_city": {
+      "type": ["string", "null"],
+      "description": "city or town of patron's alternate address"
+    },
+    "B_state": {
+      "type": ["string", "null"],
+      "description": "state or province of patron's alternate address"
+    },
+    "B_zipcode": {
+      "type": ["string", "null"],
+      "description": "zip or postal code of patron's alternate address"
+    },
+    "B_country": {
+      "type": ["string", "null"],
+      "description": "country of patron's alternate address"
+    },
+    "B_email": {
+      "type": ["string", "null"],
+      "description": "email address for patron's alternate address"
+    },
+    "B_phone": {
+      "type": ["string", "null"],
+      "description": "phone number for patron's alternate address"
+    },
+    "dateofbirth": {
+      "type": ["string", "null"],
+      "description": "patron's date of birth"
+    },
+    "branchcode": {
+      "type": "string",
+      "description": "code of patron's home branch"
+    },
+    "categorycode": {
+      "type": "string",
+      "description": "code of patron's category"
+    },
+    "dateenrolled": {
+      "type": ["string", "null"],
+      "description": "date the patron was added to Koha"
+    },
+    "dateexpiry": {
+      "type": ["string", "null"],
+      "description": "date the patron's card is set to expire"
+    },
+    "gonenoaddress": {
+      "type": ["string", "null"],
+      "description": "set to 1 if library marked this patron as having an unconfirmed address"
+    },
+    "lost": {
+      "type": ["string", "null"],
+      "description": "set to 1 if library marked this patron as having lost his card"
+    },
+    "debarred": {
+      "type": ["string", "null"],
+      "description": "until this date the patron can only check-in"
+    },
+    "debarredcomment": {
+      "type": ["string", "null"],
+      "description": "comment on the stop of the patron"
+    },
+    "contactname": {
+      "type": ["string", "null"],
+      "description": "used for children and professionals to include surname or last name of guarantor or organization name"
+    },
+    "contactfirstname": {
+      "type": ["string", "null"],
+      "description": "used for children to include first name of guarantor"
+    },
+    "contacttitle": {
+      "type": ["string", "null"],
+      "description": "used for children to include title of guarantor"
+    },
+    "guarantorid": {
+      "type": ["string", "null"],
+      "description": "borrowernumber used for children or professionals to link them to guarantor or organizations"
+    },
+    "borrowernotes": {
+      "type": ["string", "null"],
+      "description": "a note on the patron's account"
+    },
+    "relationship": {
+      "type": ["string", "null"],
+      "description": "used for children to include the relationship to their guarantor"
+    },
+    "sex": {
+      "type": ["string", "null"],
+      "description": "patron's gender"
+    },
+    "password": {
+      "type": ["string", "null"],
+      "description": "patron's encrypted password"
+    },
+    "flags": {
+      "type": ["string", "null"],
+      "description": "a number associated with the patron's permissions"
+    },
+    "userid": {
+      "type": ["string", "null"],
+      "description": "patron's login"
+    },
+    "opacnote": {
+      "type": ["string", "null"],
+      "description": "a note on the patron's account visible in OPAC and staff client"
+    },
+    "contactnote": {
+      "type": ["string", "null"],
+      "description": "a note related to patron's alternate address"
+    },
+    "sort1": {
+      "type": ["string", "null"],
+      "description": "a field that can be used for any information unique to the library"
+    },
+    "sort2": {
+      "type": ["string", "null"],
+      "description": "a field that can be used for any information unique to the library"
+    },
+    "altcontactfirstname": {
+      "type": ["string", "null"],
+      "description": "first name of alternate contact for the patron"
+    },
+    "altcontactsurname": {
+      "type": ["string", "null"],
+      "description": "surname or last name of the alternate contact for the patron"
+    },
+    "altcontactaddress1": {
+      "type": ["string", "null"],
+      "description": "the first address line for the alternate contact for the patron"
+    },
+    "altcontactaddress2": {
+      "type": ["string", "null"],
+      "description": "the second address line for the alternate contact for the patron"
+    },
+    "altcontactaddress3": {
+      "type": ["string", "null"],
+      "description": "the city for the alternate contact for the patron"
+    },
+    "altcontactstate": {
+      "type": ["string", "null"],
+      "description": "the state for the alternate contact for the patron"
+    },
+    "altcontactzipcode": {
+      "type": ["string", "null"],
+      "description": "the zipcode for the alternate contact for the patron"
+    },
+    "altcontactcountry": {
+      "type": ["string", "null"],
+      "description": "the country for the alternate contact for the patron"
+    },
+    "altcontactphone": {
+      "type": ["string", "null"],
+      "description": "the phone number for the alternate contact for the patron"
+    },
+    "smsalertnumber": {
+      "type": ["string", "null"],
+      "description": "the mobile phone number where the patron would like to receive notices (if SMS turned on)"
+    },
+    "sms_provider_id": {
+      "type": ["string", "null"],
+      "description": "the provider of the mobile phone number defined in smsalertnumber"
+    },
+    "privacy": {
+      "type": "string",
+      "description": "patron's privacy settings related to their reading history"
+    },
+    "privacy_guarantor_checkouts": {
+      "type": "string",
+      "description": "controls if relatives can see this patron's checkouts"
+    },
+    "checkprevcheckout": {
+      "type": "string",
+      "description": "produce a warning for this patron if this item has previously been checked out to this patron if 'yes', not if 'no', defer to category setting if 'inherit'"
+    },
+    "updated_on": {
+      "type": "string",
+      "description": "time of last change could be useful for synchronization with external systems (among others)"
+    }
+  }
 }