Hi all, During the hackfest in Marseille, we talked a lot about the new RESTful API and how to integrate it into Koha. Discussions have been summarized in the wiki page [1], in particular in sections "Suggested way forward" and "API Protocol Specification". A proof-of-concept patch was made and is attached to Bug 13799 [2]. It uses Mojolicious and its Swagger2 plugin (more details on the wiki page). This will be used as a base for building the API. So, please have a look at it and report any problem you can think of. [1] http://wiki.koha-community.org/wiki/New_REST_API_RFC [2] http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=13799 -- Julian Maurice <julian.maurice@biblibre.com> BibLibre
It is important that everyone raises its concerns or recomendations on this. On Fri, Mar 6, 2015 at 9:41 AM, Julian Maurice <julian.maurice@biblibre.com> wrote:
Hi all,
During the hackfest in Marseille, we talked a lot about the new RESTful API and how to integrate it into Koha.
Discussions have been summarized in the wiki page [1], in particular in sections "Suggested way forward" and "API Protocol Specification".
A proof-of-concept patch was made and is attached to Bug 13799 [2]. It uses Mojolicious and its Swagger2 plugin (more details on the wiki page). This will be used as a base for building the API. So, please have a look at it and report any problem you can think of.
[1] http://wiki.koha-community.org/wiki/New_REST_API_RFC [2] http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=13799
-- Julian Maurice <julian.maurice@biblibre.com> BibLibre _______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
-- Tomás Cohen Arazi Prosecretaría de Informática Universidad Nacional de Córdoba ✆ +54 351 5353750 ext 13168 GPG: B76C 6E7C 2D80 551A C765 E225 0A27 2EA1 B2F3 C15F
Hi, On Fri, Mar 6, 2015 at 7:41 AM, Julian Maurice <julian.maurice@biblibre.com> wrote:
A proof-of-concept patch was made and is attached to Bug 13799 [2].
Are we ready to jump to requiring a minimum of Perl 5.18? My read of the Mojolicious FAQ [1] is that 5.18 and 5.20 are well supported at present, while 5.10 is best effort. "Best effort" for frameworks does not, however, inspire great confidence in me. This is by not necessarily a showstopper -- Debian Jessie will ship with 5.20, Ubuntu Trusty ships 5.18, and so forth -- but if we're not ready to make the jump in Perl versions, I would suggest finding a different framework to use. [1] http://mojolicio.us/perldoc/Mojolicious/Guides/FAQ#Which-versions-of-Perl-ar... Regards, Galen -- Galen Charlton Infrastructure and Added Services Manager Equinox Software, Inc. / The Open Source Experts email: gmc@esilibrary.com direct: +1 770-709-5581 cell: +1 404-984-4366 skype: gmcharlt web: http://www.esilibrary.com/ Supporting Koha and Evergreen: http://koha-community.org & http://evergreen-ils.org
* Galen Charlton (gmc@esilibrary.com) wrote:
Hi,
On Fri, Mar 6, 2015 at 7:41 AM, Julian Maurice <julian.maurice@biblibre.com> wrote:
A proof-of-concept patch was made and is attached to Bug 13799 [2].
Are we ready to jump to requiring a minimum of Perl 5.18? My read of the Mojolicious FAQ [1] is that 5.18 and 5.20 are well supported at present, while 5.10 is best effort. "Best effort" for frameworks does not, however, inspire great confidence in me.
This is by not necessarily a showstopper -- Debian Jessie will ship with 5.20, Ubuntu Trusty ships 5.18, and so forth -- but if we're not ready to make the jump in Perl versions, I would suggest finding a different framework to use.
[1] http://mojolicio.us/perldoc/Mojolicious/Guides/FAQ#Which-versions-of-Perl-ar...
I'd like to hear what the advantages of us using Mojolicious are, vs something like Raisin? https://metacpan.org/pod/Raisin Chris -- Chris Cormack Catalyst IT Ltd. +64 4 803 2238 PO Box 11-053, Manners St, Wellington 6142, New Zealand
On Tue, Mar 10, 2015 at 5:07 PM, Chris Cormack <chrisc@catalyst.net.nz> wrote:
* Galen Charlton (gmc@esilibrary.com) wrote:
Hi,
On Fri, Mar 6, 2015 at 7:41 AM, Julian Maurice < julian.maurice@biblibre.com> wrote:
A proof-of-concept patch was made and is attached to Bug 13799 [2].
Are we ready to jump to requiring a minimum of Perl 5.18? My read of the Mojolicious FAQ [1] is that 5.18 and 5.20 are well supported at present, while 5.10 is best effort. "Best effort" for frameworks does not, however, inspire great confidence in me.
This is by not necessarily a showstopper -- Debian Jessie will ship with 5.20, Ubuntu Trusty ships 5.18, and so forth -- but if we're not ready to make the jump in Perl versions, I would suggest finding a different framework to use.
[1]
http://mojolicio.us/perldoc/Mojolicious/Guides/FAQ#Which-versions-of-Perl-ar...
I'd like to hear what the advantages of us using Mojolicious are, vs something like Raisin?
https://metacpan.org/pod/Raisin
Chris
Raisin was the first proposed tool to build the API. We found it was Plack-only, and that it implemented an outdated version of Swagger, which seemed a requirement for people proposing it. Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin. I'm not saying those are blockers, but that was part of the discussion. -- Tomás Cohen Arazi Prosecretaría de Informática Universidad Nacional de Córdoba ✆ +54 351 5353750 ext 13168 GPG: B76C 6E7C 2D80 551A C765 E225 0A27 2EA1 B2F3 C15F
* Tomas Cohen Arazi (tomascohen@gmail.com) wrote:
Raisin was the first proposed tool to build the API. We found it was Plack-only, and that it implemented an outdated version of Swagger, which seemed a requirement for people proposing it.
Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin.
I'm not saying those are blockers, but that was part of the discussion.
Excellent thanks, that's the information I was after Chris -- Chris Cormack Catalyst IT Ltd. +64 4 803 2238 PO Box 11-053, Manners St, Wellington 6142, New Zealand
Just adding in - great communication everyone. Love watching that. Cheers, Brendan On Tue, Mar 10, 2015 at 9:40 PM, Chris Cormack <chrisc@catalyst.net.nz> wrote:
* Tomas Cohen Arazi (tomascohen@gmail.com) wrote:
Raisin was the first proposed tool to build the API. We found it was Plack-only, and that it implemented an outdated version of Swagger, which seemed a requirement for people proposing it.
Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin.
I'm not saying those are blockers, but that was part of the discussion.
Excellent thanks, that's the information I was after
Chris
-- Chris Cormack Catalyst IT Ltd. +64 4 803 2238 PO Box 11-053, Manners St, Wellington 6142, New Zealand
_______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
-- --------------------------------------------------------------------------------------------------------------- Brendan A. Gallagher ByWater Solutions CEO Support and Consulting for Open Source Software Installation, Data Migration, Training, Customization, Hosting and Complete Support Packages Headquarters: Santa Barbara, CA - Office: Redding, CT Phone # (888) 900-8944 http://bywatersolutions.com info@bywatersolutions.com
Any further comments on the New RESTful API stuff? We are moving forward with that. We should have some work from Biblibre in the next few days (7~10) max. I'd be interested in knowing who would like to help test this all? Cheers, Brendan On Tue, Mar 10, 2015 at 1:40 PM, Chris Cormack <chrisc@catalyst.net.nz> wrote:
* Tomas Cohen Arazi (tomascohen@gmail.com) wrote:
Raisin was the first proposed tool to build the API. We found it was Plack-only, and that it implemented an outdated version of Swagger, which seemed a requirement for people proposing it.
Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin.
I'm not saying those are blockers, but that was part of the discussion.
Excellent thanks, that's the information I was after
Chris
-- Chris Cormack Catalyst IT Ltd. +64 4 803 2238 PO Box 11-053, Manners St, Wellington 6142, New Zealand
_______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
-- --------------------------------------------------------------------------------------------------------------- Brendan A. Gallagher ByWater Solutions CEO Support and Consulting for Open Source Software Installation, Data Migration, Training, Customization, Hosting and Complete Support Packages Headquarters: Santa Barbara, CA - Office: Redding, CT Phone # (888) 900-8944 http://bywatersolutions.com info@bywatersolutions.com
Hi!
From Stockholm University Library we would be willing to help out, if we can. We can try at least. =)
Best regards, Andreas Från: koha-devel-bounces@lists.koha-community.org [mailto:koha-devel-bounces@lists.koha-community.org] För Brendan Gallagher Skickat: den 20 mars 2015 04:25 Till: Tomas Cohen Arazi; Koha Devel Ämne: Re: [Koha-devel] New RESTful API Any further comments on the New RESTful API stuff? We are moving forward with that. We should have some work from Biblibre in the next few days (7~10) max. I'd be interested in knowing who would like to help test this all? Cheers, Brendan On Tue, Mar 10, 2015 at 1:40 PM, Chris Cormack <chrisc@catalyst.net.nz<mailto:chrisc@catalyst.net.nz>> wrote: * Tomas Cohen Arazi (tomascohen@gmail.com<mailto:tomascohen@gmail.com>) wrote:
Raisin was the first proposed tool to build the API. We found it was Plack-only, and that it implemented an outdated version of Swagger, which seemed a requirement for people proposing it.
Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin.
I'm not saying those are blockers, but that was part of the discussion.
Excellent thanks, that's the information I was after Chris -- Chris Cormack Catalyst IT Ltd. +64 4 803 2238<tel:%2B64%204%20803%202238> PO Box 11-053, Manners St, Wellington 6142, New Zealand _______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org<mailto:Koha-devel@lists.koha-community.org> http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/ -- --------------------------------------------------------------------------------------------------------------- Brendan A. Gallagher ByWater Solutions CEO Support and Consulting for Open Source Software Installation, Data Migration, Training, Customization, Hosting and Complete Support Packages Headquarters: Santa Barbara, CA - Office: Redding, CT Phone # (888) 900-8944 http://bywatersolutions.com info@bywatersolutions.com<mailto:info@bywatersolutions.com>
Greetings, slef and I were pondering outloud about asynchronous report generation. http://irc.koha-community.org/koha/2015-03-13#i_1650639 Perhaps that idea might fit in somehow? GPML, Mark Tompsett
Great work everyone with those specifications ! I think developers would like to be able to expands the API using plug-ins. What do you think ? Cheers, Eric Bégin Solutions inLibro inc. On 2015-03-19 23:24, Brendan Gallagher wrote:
Any further comments on the New RESTful API stuff? We are moving forward with that. We should have some work from Biblibre in the next few days (7~10) max. I'd be interested in knowing who would like to help test this all?
Cheers, Brendan
On Tue, Mar 10, 2015 at 1:40 PM, Chris Cormack <chrisc@catalyst.net.nz <mailto:chrisc@catalyst.net.nz>> wrote:
* Tomas Cohen Arazi (tomascohen@gmail.com <mailto:tomascohen@gmail.com>) wrote:
> Raisin was the first proposed tool to build the API. We found it was > Plack-only, and that it implemented an outdated version of Swagger, which > seemed a requirement for people proposing it. > > Mojolicious was found to be CGI-friendly, and also has a Swagger2 plugin. > > I'm not saying those are blockers, but that was part of the discussion. > Excellent thanks, that's the information I was after
Chris
-- Chris Cormack Catalyst IT Ltd. +64 4 803 2238 <tel:%2B64%204%20803%202238> PO Box 11-053, Manners St, Wellington 6142, New Zealand
_______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org <mailto:Koha-devel@lists.koha-community.org> http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
-- --------------------------------------------------------------------------------------------------------------- Brendan A. Gallagher ByWater Solutions CEO
Support and Consulting for Open Source Software Installation, Data Migration, Training, Customization, Hosting and Complete Support Packages Headquarters: Santa Barbara, CA - Office: Redding, CT Phone # (888) 900-8944 http://bywatersolutions.com info@bywatersolutions.com <mailto:info@bywatersolutions.com>
_______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
participants (8)
-
Andreas Hedström Mace -
Brendan Gallagher -
Chris Cormack -
Eric Bégin -
Galen Charlton -
Julian Maurice -
Mark Tompsett -
Tomas Cohen Arazi