ruby-duckdb icon indicating copy to clipboard operation
ruby-duckdb copied to clipboard

Request: Add link to docs in README

Open DeflateAwning opened this issue 1 year ago • 3 comments

Are there any docs for this library? It would be awesome if there were.

The link to the docs should go in the README, whenever it is ready!

DeflateAwning avatar Sep 15 '24 23:09 DeflateAwning

There are no doc pages for this library now.

suketa avatar Sep 16 '24 20:09 suketa

Creating auto-generated docs would be fantastic! Not sure how tough that is in Ruby, but it'd be quite valuable to understand what parts of the DuckDB API have been implemented here

DeflateAwning avatar Sep 17 '24 04:09 DeflateAwning

You can use ri command to see auto-generated docs. (Not enough documented yet...)

for example,

$ ri DuckDB::Database
= DuckDB::Database < Object

(from gem duckdb-1.1.0.0)
------------------------------------------------------------------------
The Database class encapsulates a DuckDB database.

The usage is as follows:

  require 'duckdb'

  db = DuckDB::Database.open # database in memory
  con = db.connect

  con.query('CREATE TABLE users (id INTEGER, name VARCHAR(30))')

  con.query("INSERT into users VALUES(1, 'Alice')")
  con.query("INSERT into users VALUES(2, 'Bob')")
  con.query("INSERT into users VALUES(3, 'Cathy')")

  result = con.query('SELECT * from users')
  result.each do |row|
    p row
  end
------------------------------------------------------------------------
= Class methods:

  _db_open, open

= Instance methods:

  connect

suketa avatar Sep 17 '24 20:09 suketa

@DeflateAwning

Creating auto-generated docs would be fantastic!

Although some methods documents are not available, I opened the auto-generate docs. https://suketa.github.io/ruby-duckdb

suketa avatar Jan 19 '25 09:01 suketa

This is fantastic! Thanks a lot!

DeflateAwning avatar Jan 20 '25 17:01 DeflateAwning