v2.16.2: Respect COLUMNS and ROWS env vars if stdout is not a TTY; improve logging

Author: dimikot

README.md

@@ -19,6 +19,9 @@ Each microshard is a PostgreSQL schema with numeric suffix. Microshard schemas h
 ## Usage
 
 ```
+pg-microsharding install
+  [--dsn=DSN | --dsns=DNS1,DSN2,...]
+
 pg-microsharding list | ls
   [--weight-sql='SELECT returning weight with optional unit']
   [--verbose]
@@ -246,7 +249,15 @@ This is the second part of pg-microsharding tool: a set of stored functions you
 
 ### Installing into the Database
 
-Run the following SQL files in your up- and down-migrations to install (or upgrade) and uninstall the tool:
+To manually install or upgrade the library's stored functions in the database without a migration tool, run the `install` action:
+
+```bash
+pg-microsharding install
+```
+
+<figure><img src="https://raw.githubusercontent.com/dimikot/ent-framework/refs/heads/main/gitbook/.gitbook/assets/pg-microsharding-install.png" alt="" width="563"><figcaption></figcaption></figure>
+
+Otherwise, run the following SQL files in your up- and down-migrations to install (or upgrade) and uninstall the tool:
 
 * sql/pg-microsharding-up.sql: to install/upgrade the library
 * sql/pg-microsharding-down.sql: to uninstall

docs/README.md

@@ -23,6 +23,9 @@ Each microshard is a PostgreSQL schema with numeric suffix. Microshard schemas h
 ## Usage
 
 ```
+pg-microsharding install
+  [--dsn=DSN | --dsns=DNS1,DSN2,...]
+
 pg-microsharding list | ls
   [--weight-sql='SELECT returning weight with optional unit']
   [--verbose]
@@ -250,7 +253,15 @@ This is the second part of pg-microsharding tool: a set of stored functions you
 
 ### Installing into the Database
 
-Run the following SQL files in your up- and down-migrations to install (or upgrade) and uninstall the tool:
+To manually install or upgrade the library's stored functions in the database without a migration tool, run the `install` action:
+
+```bash
+pg-microsharding install
+```
+
+<figure><img src="https://raw.githubusercontent.com/dimikot/ent-framework/refs/heads/main/gitbook/.gitbook/assets/pg-microsharding-install.png" alt="" width="563"><figcaption></figcaption></figure>
+
+Otherwise, run the following SQL files in your up- and down-migrations to install (or upgrade) and uninstall the tool:
 
 * sql/pg-microsharding-up.sql: to install/upgrade the library
 * sql/pg-microsharding-down.sql: to uninstall

docs/functions/actionInstall.md

@@ -8,7 +8,7 @@
 
 > **actionInstall**(`args`): `Promise`\<`boolean`\>
 
-Defined in: src/actions/actionInstall.ts:8
+Defined in: [src/actions/actionInstall.ts:8](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionInstall.ts#L8)
 
 Installs the library in the provided databases.
 

docs/functions/install.md

@@ -8,7 +8,7 @@
 
 > **install**(`__namedParameters`): `Promise`\<`void`\>
 
-Defined in: src/api/install.ts:10
+Defined in: [src/api/install.ts:10](https://github.com/clickup/pg-microsharding/blob/master/src/api/install.ts#L10)
 
 Installs/updates microsharding schema and functions.