Add Pgfe library to client interfaces

Started by Dmitriy Igrishinalmost 8 years ago7 messagesdocs
Jump to latest
#1Dmitriy Igrishin
dmitigr@gmail.com

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Attachments:

doc-pgfe.patchtext/x-patch; charset=US-ASCII; name=doc-pgfe.patchDownload+7-0
#2Bruce Momjian
bruce@momjian.us
In reply to: Dmitriy Igrishin (#1)
Re: Add Pgfe library to client interfaces

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Also libpqxx is listed in our docs as "New-style C++ interface". Should
we remove the "New" part?

---------------------------------------------------------------------------

diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
index 347b830..c74e391 100644
--- a/doc/src/sgml/external-projects.sgml
+++ b/doc/src/sgml/external-projects.sgml
@@ -83,6 +83,13 @@
</row>
<row>
+      <entry>Pgfe</entry>
+      <entry>C++</entry>
+      <entry>An API inspired by libpq</entry>
+      <entry><ulink url="https://github.com/dmitigr/pgfe"></ulink></entry>
+     </row>
+
+     <row>
<entry>node-postgres</entry>
<entry>JavaScript</entry>
<entry>Node.js driver</entry>

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +
#3Daniel Gustafsson
daniel@yesql.se
In reply to: Bruce Momjian (#2)
Re: Add Pgfe library to client interfaces

On 28 Jun 2018, at 15:32, Bruce Momjian <bruce@momjian.us> wrote:

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Since the linked repository readme states "ATTENTION, this software is "beta"
quality", does it makes more sense to just list it on the wiki for now (which
it already is on the Client_Libraries page).

cheers ./daniel

#4Bruce Momjian
bruce@momjian.us
In reply to: Daniel Gustafsson (#3)
Re: Add Pgfe library to client interfaces

On Thu, Jun 28, 2018 at 04:03:36PM +0200, Daniel Gustafsson wrote:

On 28 Jun 2018, at 15:32, Bruce Momjian <bruce@momjian.us> wrote:

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Since the linked repository readme states "ATTENTION, this software is "beta"
quality", does it makes more sense to just list it on the wiki for now (which
it already is on the Client_Libraries page).

Oh, seems perfect. Thanks.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +
#5Steve Atkins
steve@blighty.com
In reply to: Daniel Gustafsson (#3)
Re: Add Pgfe library to client interfaces

On Jun 28, 2018, at 7:03 AM, Daniel Gustafsson <daniel@yesql.se> wrote:

On 28 Jun 2018, at 15:32, Bruce Momjian <bruce@momjian.us> wrote:

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Since the linked repository readme states "ATTENTION, this software is "beta"
quality", does it makes more sense to just list it on the wiki for now (which
it already is on the Client_Libraries page).

Probably. There are interfaces I know have been in widespread use for
a decade or more that aren't listed in the manual, so adding a WIP might
not be the most appropriate thing.

Finishing up that wiki page (I think Go is the main thing I didn't get around
to adding yet) and linking to it from somewhere obvious is probably a good
idea, though.

Cheers,
Steve

#6Dmitriy Igrishin
dmitigr@gmail.com
In reply to: Daniel Gustafsson (#3)
Re: Add Pgfe library to client interfaces

чт, 28 июн. 2018 г. в 17:03, Daniel Gustafsson <daniel@yesql.se>:

On 28 Jun 2018, at 15:32, Bruce Momjian <bruce@momjian.us> wrote:

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces

section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Since the linked repository readme states "ATTENTION, this software is
"beta"
quality", does it makes more sense to just list it on the wiki for now
(which
it already is on the Client_Libraries page).

You are right. On the other hand, "H.1. Client Interfaces" refers to the
external projects.
I.e., by definition, PGDG is *not* responsible for the quality of these
projects.
I honestly noted that my library is on "beta" stage, and this is *my*
subjective opinion.
Does this mean specifically that this project can not be mentioned in the
documentation?
I *my* subjective opinion - no. Therefore, if someone refers to my opinion
about the "beta",
then why should he not refer to my opinion regarding the mention of my
library in the official
documentation? It seems to *me* logical.
But, please note. I don't insist on my proposal. I just think I did some
thing for PostgreSQL,
which is worthy of mention in the PostgreSQL documentation. That's all.

PS. I glad that my library is mentioned in the wiki. Thank you all!

#7Bruce Momjian
bruce@momjian.us
In reply to: Bruce Momjian (#2)
Re: Add Pgfe library to client interfaces

On Thu, Jun 28, 2018 at 09:32:23AM -0400, Bruce Momjian wrote:

On Fri, Jun 1, 2018 at 05:56:34PM +0300, Dmitry Igrishin wrote:

Hello,

Could we please add Pgfe client library to the external interfaces section?

Patch is attached.

Is everyone good with adding this? Is it too new?

Also libpqxx is listed in our docs as "New-style C++ interface". Should
we remove the "New" part?

I have removed the "New" description.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +