active_record_mysql_repl 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: accf9badcb507bbebe51faf48edd6ef5fe850e01214cc34a8be1b06400b5a8d7
-  data.tar.gz: 225572e71a93254ccb85ee5c1b5d0878a8fe5a71ac9c44eab6d236c4f113accc
+  metadata.gz: 1d60c9d4baca1fb49f423f128a5015c348e17301c593895afa9083c2ee47b495
+  data.tar.gz: 4060d8523d63a3db240d6cd96cefcc6f1e0a0e3e4c2e35691d736005f86f90e3
 SHA512:
-  metadata.gz: f8cd05e53b0e49770e89fdf93f9ceb9c29df31d814f7f721267304e9557df7d753673781a05b3c8282ab019b16306f5d4e4920a7a7b2ff8776f1ab6da0a0fa5e
-  data.tar.gz: 0db40cd1589fa912dbb76c2d95195bec40d5ffc59affef92afc35eb6ec32a3c66cb7bccd73114bb9472dc5e726f855bc73f473fbe2d3f91fa82313144eeecf88
+  metadata.gz: 9fa3e154a372791095e0b6e4766e7a23d3a1c3f4f74fda84a0d4aeac33d2ef202080911a447c4a9ebe6b7a47eb09a9138630715e46b7bb482dbac5b1d2528fe3
+  data.tar.gz: e8599c8c29441696533ace9baa75163a24a271cd8b74a67e7038af2ec8e16c540ef869029438344fe75aa2f455b8012d61459efa26046ebcf86987314ef66c2d

data/.bundle/config

@@ -0,0 +1,3 @@
+---
+BUNDLE_PATH: "vendor/bundle"
+BUNDLE_BUILD__MYSQL2: "--with-mysql-dir=/opt/homebrew/opt/mysql-client@8.4"

data/README.md

@@ -1,38 +1,629 @@
 # ActiveRecordMysqlRepl
 
-TODO: Delete this and the text below, and describe your gem
+## Prerequisites
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/active_record_mysql_repl`. To experiment with that code, run `bin/console` for an interactive prompt.
+### Ruby version 3.0.0 or higher
 
-## Installation
+e.g) Using rbenv
+
+```bash
+$ rbenv install 3.3.6
+```
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+### mysql-client 8.0
 
-Install the gem and add to the application's Gemfile by executing:
+e.g) on macOS
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+$ brew install mysql-client@8.0
+$ gem install mysql2 -v 0.5.6 -- --with-ldflags=-L$(brew --prefix zstd)/lib --with-mysql-dir=/opt/homebrew/opt/mysql-client@8.4
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+## Installation
+
+Just by installing the gem, you can use the `army` command.
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+$ gem install active_record_mysql_repl
+Successfully installed active_record_mysql_repl-x.x.x
+Parsing documentation for active_record_mysql_repl-x.x.x
+Installing ri documentation for active_record_mysql_repl-x.x.x
+Done installing documentation for active_record_mysql_repl after 0 seconds
+1 gem installed
+```
+
+```
+$ army
+ActiveRecordMysqlRepl Version: x.x.x
+```
+
+If you want to use the zsh completion, you can add the following line to your `.zshrc` file.
+
+```sh
+$ eval "$(army --zsh-completion)"
+```
+
+Then you can use the completion feature like below.
+
+```sh
+$ army [TAB]
+option
+-c  -- path to .armyrc file
+-d  -- Database name
+-e  -- output erd
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
+### Sample Configurations
 
-## Development
+From the following link, you can Download the sample configuration files
+https://github.com/nogahighland/active_record_mysql_repl/tree/main/sample_config
+
+Also you can try with sample database on your local MySQL server
+https://github.com/nogahighland/active_record_mysql_repl/blob/main/sample_config/sample_db.sql
+
+### Sample Database
+
+```sql
+CREATE DATABASE test;
+```
+
+The sample configuration assumes the sample database is running on
+127.0.0.1:3306/test (user: root, password: root)
+
+```
+$ mysql -u root -p test < sample_db.sql
+```
+
+![image](https://github.com/user-attachments/assets/ddc59020-42db-4240-91db-76dae560fdf5)
+
+This ER Diagram can be generated by the following command
+
+```sh
+army -c sample_config/.army.sample.yml -d test -e erd
+```
+
+### Showcases
+
+```sh
+army -c /path/to/sample_config/.army.sample.yml -d test
+Ensureing connection to test on port 127.0.0.1:33060
+Loading tables
+Loading custom extensions from /path/to/sample_config/./.army.sample/extensions
+```
+
+Now you can access to the table classes as `User` if the table name is `users`.
+
+```rb
+[1] test(main)> User.all
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-12T12:57:38.581127 #2816] DEBUG -- :   User Load (10.5ms)  SELECT `users`.* FROM `users`
+[
+  [0] #<User:0x0000000123188de0> {
+    :id         => "1",
+    :login_id   => "user1",
+    :profile_id => 1
+  }
+]
+```
+
+</details>
+
+---
+
+`.d` method shows the schema of the table. Let's see the `Order` table schema.
+
+```rb
+[8] test(main)> Order.d
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-12T12:32:20.100309 #2816] DEBUG -- :    (10.6ms)  DESCRIBE orders
+D, [2024-12-12T12:32:20.107976 #2816] DEBUG -- :    (6.9ms)  SHOW INDEX FROM orders
+# orders
++---------+-------------+------+-----+---------+-------+
+| Field   | Type        | Null | Key | Default | Extra |
++---------+-------------+------+-----+---------+-------+
+| id      | varchar(64) | NO   | PRI |         |       |
+| user_id | varchar(64) | NO   |     |         |       |
+| item_id | varchar(64) | NO   |     |         |       |
++---------+-------------+------+-----+---------+-------+
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table  | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| orders | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+```
+
+</details>
+
+---
+
+`.ddl` method shows the DDL of the table.
+
+```rb
+[9] test(main)> Order.ddl
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-12T12:32:21.878444 #2816] DEBUG -- :    (8.7ms)  SHOW CREATE TABLE orders
+CREATE TABLE `orders` (
+  `id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL,
+  `user_id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL,
+  `item_id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
+```
+
+</details>
+
+---
+
+`models` is globally defined to get and array of all the table classes. By `.map(&:d)` you can see the schema of all the tables.
+
+https://github.com/nogahighland/active_record_mysql_repl/blob/main/lib/active_record_mysql_repl/extensions/global.rb#L10-L12
+
+```rb
+[6] test(main)> puts models.map(&:d)
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-12T01:26:36.677988 #25446] DEBUG -- :   Brand Load (2.1ms)  SELECT `brands`.* FROM `brands`
+D, [2024-12-12T01:26:36.681307 #25446] DEBUG -- :   Category Load (2.8ms)  SELECT `categories`.* FROM `categories`
+D, [2024-12-12T01:26:36.683967 #25446] DEBUG -- :   Item Load (2.0ms)  SELECT `items`.* FROM `items`
+D, [2024-12-12T01:26:36.687282 #25446] DEBUG -- :   Order Load (3.0ms)  SELECT `orders`.* FROM `orders`
+D, [2024-12-12T01:26:36.691204 #25446] DEBUG -- :   UserProfile Load (3.6ms)  SELECT `user_profiles`.* FROM `user_profiles`
+D, [2024-12-12T01:26:36.694081 #25446] DEBUG -- :   User Load (2.2ms)  SELECT `users`.* FROM `users`
+# users
++------------+-------------+------+-----+---------+-------+
+| Field      | Type        | Null | Key | Default | Extra |
++------------+-------------+------+-----+---------+-------+
+| id         | varchar(64) | NO   | PRI |         |       |
+| login_id   | varchar(64) | NO   |     |         |       |
+| profile_id | int         | YES  |     |         |       |
++------------+-------------+------+-----+---------+-------+
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| users | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+# user_profiles
++-------+-------------+------+-----+---------+-------+
+| Field | Type        | Null | Key | Default | Extra |
++-------+-------------+------+-----+---------+-------+
+| id    | varchar(64) | NO   | PRI |         |       |
+| name  | varchar(64) | NO   |     |         |       |
++-------+-------------+------+-----+---------+-------+
++---------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table         | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++---------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| user_profiles | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++---------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+# orders
++---------+-------------+------+-----+---------+-------+
+| Field   | Type        | Null | Key | Default | Extra |
++---------+-------------+------+-----+---------+-------+
+| id      | varchar(64) | NO   | PRI |         |       |
+| user_id | varchar(64) | NO   |     |         |       |
+| item_id | varchar(64) | NO   |     |         |       |
++---------+-------------+------+-----+---------+-------+
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table  | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| orders | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+# items
++-------------+-------------+------+-----+---------+-------+
+| Field       | Type        | Null | Key | Default | Extra |
++-------------+-------------+------+-----+---------+-------+
+| id          | varchar(64) | NO   | PRI |         |       |
+| category_id | varchar(64) | NO   |     |         |       |
+| brand_id    | varchar(64) | NO   |     |         |       |
++-------------+-------------+------+-----+---------+-------+
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| items | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++-------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+# categories
++-----------+-------------+------+-----+---------+-------+
+| Field     | Type        | Null | Key | Default | Extra |
++-----------+-------------+------+-----+---------+-------+
+| id        | varchar(64) | NO   | PRI |         |       |
+| name      | varchar(64) | NO   |     |         |       |
+| parent_id | varchar(64) | NO   |     |         |       |
++-----------+-------------+------+-----+---------+-------+
++------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table      | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| categories | 0          | PRIMARY  | 1            | id          | A         | 2           |          |        |      | BTREE      |         |               | YES     |            |
++------------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+# brands
++-------+-------------+------+-----+---------+-------+
+| Field | Type        | Null | Key | Default | Extra |
++-------+-------------+------+-----+---------+-------+
+| id    | varchar(64) | NO   | PRI |         |       |
+| name  | varchar(64) | NO   |     |         |       |
++-------+-------------+------+-----+---------+-------+
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| Table  | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+| brands | 0          | PRIMARY  | 1            | id          | A         | 1           |          |        |      | BTREE      |         |               | YES     |            |
++--------+------------+----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+
+```
+
+</details>
+
+---
+
+To get the last record of order,
+
+```rb
+[1] test(main)> Order.last
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:45:49.743857 #96076] DEBUG -- :   Order Load (5.5ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+#<Order:0x00000001293677c8> {
+  :id      => "1",
+  :user_id => "1",
+  :item_id => "1"
+}
+```
+
+</details>
+
+---
+
+You can get the last order's user because `user_id` column exists on `orders` table. For the same reason you can get the order's item and its category too.
+All the associations are chainable by the native functionality of ActiveRecord.
+
+```rb
+[5] test(main)> Order.last.user
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:46:11.154678 #96076] DEBUG -- :   Order Load (6.9ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-11T23:46:11.176424 #96076] DEBUG -- :   User Load (2.9ms)  SELECT `users`.* FROM `users` WHERE `users`.`id` = '1' LIMIT 1
+#<User:0x000000012961fda8> {
+  :id         => "1",
+  :login_id   => "user1",
+  :profile_id => 1
+}
+```
+
+</details>
+
+```rb
+[7] test(main)> Order.last.item
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:46:17.098874 #96076] DEBUG -- :   Order Load (3.5ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-11T23:46:17.112940 #96076] DEBUG -- :   Item Load (2.2ms)  SELECT `items`.* FROM `items` WHERE `items`.`id` = '1' LIMIT 1
+#<Item:0x000000012a416c40> {
+  :id          => "1",
+  :category_id => "2",
+  :brand_id    => "1"
+}
+```
+
+</details>
+
+```rb
+[8] test(main)> Order.last.item.category
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:46:21.104696 #96076] DEBUG -- :   Order Load (2.1ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-11T23:46:21.106696 #96076] DEBUG -- :   Item Load (1.5ms)  SELECT `items`.* FROM `items` WHERE `items`.`id` = '1' LIMIT 1
+D, [2024-12-11T23:46:21.117169 #96076] DEBUG -- :   Category Load (2.5ms)  SELECT `categories`.* FROM `categories` WHERE `categories`.`id` = '2' LIMIT 1
+#<Category:0x000000012a5d7b38> {
+  :id        => "2",
+  :name      => "category2",
+  :parent_id => "1"
+}
+```
+
+</details>
+
+---
+
+A category's parent is fetched from the same table because `parent_id`'s `parent` is treated by `ActiveRecordMysqlRepl` as inplicitly pointing to the same table.
+
+```rb
+[9] test(main)> Order.last.item.category.parent
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:46:23.553443 #96076] DEBUG -- :   Order Load (2.0ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-11T23:46:23.555918 #96076] DEBUG -- :   Item Load (2.1ms)  SELECT `items`.* FROM `items` WHERE `items`.`id` = '1' LIMIT 1
+D, [2024-12-11T23:46:23.560142 #96076] DEBUG -- :   Category Load (3.8ms)  SELECT `categories`.* FROM `categories` WHERE `categories`.`id` = '2' LIMIT 1
+D, [2024-12-11T23:46:23.562496 #96076] DEBUG -- :   Category Load (1.3ms)  SELECT `categories`.* FROM `categories` WHERE `categories`.`id` = '1' LIMIT 1
+#<Category:0x000000012a73dd60> {
+  :id        => "1",
+  :name      => "category1",
+  :parent_id => ""
+}
+```
+
+</details>
+
+---
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+You can get user's profile by `.profile` because the custom association is defined here
+
+https://github.com/nogahighland/active_record_mysql_repl/blob/main/sample_config/.army.sample/associations.sample.yml#L4-L8
+
+```rb
+[6] test(main)> Order.last.user.profile
+```
+
+<details><summary>output:</summary>
+
+```rb
+
+D, [2024-12-12T18:23:41.382606 #2816] DEBUG -- :   Order Load (8.6ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-12T18:23:41.389954 #2816] DEBUG -- :   User Load (2.4ms)  SELECT `users`.* FROM `users` WHERE `users`.`id` = '1' LIMIT 1
+D, [2024-12-12T18:23:41.392060 #2816] DEBUG -- :   UserProfile Load (1.8ms)  SELECT `user_profiles`.* FROM `user_profiles` WHERE `user_profiles`.`id` = '1' LIMIT 1
+#<UserProfile:0x000000012330a010> {
+  :id   => "1",
+  :name => "user1"
+}
+```
+
+</details>
+
+---
+
+
+
+```rb
+[10] test(main)> Order.last.item.brand
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:46:28.715219 #96076] DEBUG -- :   Order Load (4.1ms)  SELECT `orders`.* FROM `orders` ORDER BY `orders`.`id` DESC LIMIT 1
+D, [2024-12-11T23:46:28.717319 #96076] DEBUG -- :   Item Load (1.7ms)  SELECT `items`.* FROM `items` WHERE `items`.`id` = '1' LIMIT 1
+D, [2024-12-11T23:46:28.731254 #96076] DEBUG -- :   Brand Load (3.1ms)  SELECT `brands`.* FROM `brands` WHERE `brands`.`id` = '1' LIMIT 1
+#<Brand:0x000000012a411ab0> {
+  :id   => "1",
+  :name => "brand1"
+}
+```
+
+</details>
+
+---
+
+By `tab` (an alias to `tabulate`), the filtered records are shown in a table format. `.tab(orientation)` accepts the `:h(orizontal)` (default when <5 columns), and `:v(ertival)` (default when >=5 columns)
+
+https://github.com/nogahighland/active_record_mysql_repl/blob/9f7c91774b176e1204ed434dad2867721982c660/lib/active_record_mysql_repl/extensions/object.rb#L11
+
+```rb
+[3] test(main)> Order.all.tab
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:48:46.013935 #96381] DEBUG -- :   Order Load (2.2ms)  SELECT `orders`.* FROM `orders`
++----+---------+---------+
+| id | user_id | item_id |
++----+---------+---------+
+| 1  | 1       | 1       |
++----+---------+---------+
+```
+
+</details>
+
+---
+
+```rb
+[4] test(main)> Order.all.tab(:v)
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:48:49.461243 #96381] DEBUG -- :   Order Load (3.2ms)  SELECT `orders`.* FROM `orders`
++---------+-------+
+| Name    | Value |
++---------+-------+
+| id      | 1     |
+| user_id | 1     |
+| item_id | 1     |
++---------+-------+
+```
+
+</details>
+
+---
+
+`.j` is aliased to `.to_json` and `.jp` is defined to generate pretty json.
+
+https://github.com/nogahighland/active_record_mysql_repl/blob/9f7c91774b176e1204ed434dad2867721982c660/lib/active_record_mysql_repl/extensions/object.rb#L128-L132
+
+```rb
+[5] test(main)> Order.all.j
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:48:55.267761 #96381] DEBUG -- :   Order Load (4.4ms)  SELECT `orders`.* FROM `orders`
+[{"id":"1","user_id":"1","item_id":"1"}]
+```
+
+</details>
+
+```rb
+[6] test(main)> Order.all.jp
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:48:57.250492 #96381] DEBUG -- :   Order Load (1.8ms)  SELECT `orders`.* FROM `orders`
+[
+  {
+    "id": "1",
+    "user_id": "1",
+    "item_id": "1"
+  }
+]
+```
+
+</details>
+
+---
+
+`.csv(orientation)` is defined to generate csv format. The default orientation is same as `.tab`.
+
+https://github.com/nogahighland/active_record_mysql_repl/blob/9f7c91774b176e1204ed434dad2867721982c660/lib/active_record_mysql_repl/extensions/object.rb#L71
+
+```rb
+[1] test(main)> Order.all.csv
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-12T01:29:12.844339 #26252] DEBUG -- :   Order Load (2.7ms)  SELECT `orders`.* FROM `orders`
+id,user_id,item_id
+1,1,1
+```
+
+</details>
+
+---
+
+`.cp` is defined to copy to clipboard the receiver object's `.to_s` representation.
+
+```rb
+[7] test(main)> Order.all.jp.cp
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:48:59.443202 #96381] DEBUG -- :   Order Load (2.0ms)  SELECT `orders`.* FROM `orders`
+true
+```
+
+</details>
+
+---
+
+`.exec_sql` is defined to execute the sql query and return the result as an array of hash.
+
+```rb
+[8] test(main)> exec_sql('select 1')
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:49:15.879841 #96381] DEBUG -- :    (1.2ms)  select 1
+[
+  [0] {
+    "1" => 1
+  }
+]
+```
+
+</details>
+
+---
+
+```rb
+[9] test(main)> exec_sql('select 1').tab
+```
+
+<details><summary>output:</summary>
+
+```rb
+D, [2024-12-11T23:49:17.187358 #96381] DEBUG -- :    (2.1ms)  select 1
++---+
+| 1 |
++---+
+| 1 |
++---+
+```
+
+</details>
+
+---
+
+```rb
+[10] test(main)> exec_sql('select 1 as num').tab
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-11T23:49:22.406631 #96381] DEBUG -- :    (1.3ms)  select 1 as num
++-----+
+| num |
++-----+
+| 1   |
++-----+
+```
+
+</details>
+
+---
+
+You can define your own extension script. For example `.upcase_name` is defined on `UserProfile` by the sample extension which is specified in the `.army.sample.yml` file.
+
+- https://github.com/nogahighland/active_record_mysql_repl/blob/9f7c91774b176e1204ed434dad2867721982c660/sample_config/.army.sample.yml#L5
+- https://github.com/nogahighland/active_record_mysql_repl/blob/main/sample_config/.army.sample/extensions/hello.rb
+
+```rb
+[3] test(main)> UserProfile.last.upcase_name
+```
+
+<details><summary>output:</summary>
+
+```
+D, [2024-12-12T12:09:10.987656 #60808] DEBUG -- :   UserProfile Load (1.7ms)  SELECT `user_profiles`.* FROM `user_profiles` ORDER BY `user_profiles`.`id` DESC LIMIT 1
+USER1
+```
+
+</details>
+
+---
+
+## Development
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+TODO
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/active_record_mysql_repl. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/active_record_mysql_repl/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/nogahifhland/active_record_mysql_repl. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/nogahighland/active_record_mysql_repl/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 

data/lib/active_record_mysql_repl/cli/main.rb

@@ -10,13 +10,18 @@ module ActiveRecordMysqlRepl
   module CLI
     module Main
       def self.run(args)
+        if args.empty?
+          puts "ActiveRecordMysqlRepl Version: #{VERSION}"
+          return
+        end
+
         if args[0] == '--zsh-completion'
           puts ZshCompletion.generate
           return
         end
 
         opts = CLI::Options.parse(args)
-        army_config = Config.load(opts[:c] || '~/.army.yml')
+        army_config = Config.load(opts[:c] || File.join(Dir.home, '.army.yml'))
 
         db_configs = Database::Configs.load(army_config.database_config)
         db_config_key = opts[:d]

data/lib/active_record_mysql_repl/config.rb

@@ -14,7 +14,7 @@ module ActiveRecordMysqlRepl
     end
 
     def associations
-      File.join(@army_config_dir, @associations)
+      File.join(@army_config_dir, @associations) if @associations.present?
     end
 
     def extensions_dir

data/lib/active_record_mysql_repl/database/association.rb

@@ -27,7 +27,7 @@ module ActiveRecordMysqlRepl
 
       # Analyze the relationship between tables based on the information of *_id columns
       # For example, if users.company_id exists, users belongs_to companies and companies has_many users
-      def self.analyze(tables, association_settings)
+      def self.analyze(tables, association_settings = {})
         analyzed_tables = tables.map { |table| [table, AnalyzedTable.new(table)] }.to_h
 
         analyzed_tables.each do |table_name, table|

data/lib/active_record_mysql_repl/database/loader.rb

@@ -11,9 +11,15 @@ module ActiveRecordMysqlRepl
         puts "Loading tables".gray
 
         tables = ActiveRecord::Base.connection.tables
-        association_settings = Associations.load(army_config.associations)
-
-        analyzed_tables = Associations.analyze(tables, association_settings[db_config_key])
+        association_settings = army_config.associations.present? ? Associations.load(army_config.associations) : {}
+        association_setting = association_settings[db_config_key]
+        analyzed_tables = begin
+                            if association_setting.present?
+                              Associations.analyze(tables, association_setting)
+                            else
+                              Associations.analyze(tables)
+                            end
+                          end
         skipped = []
         analyzed_tables.each do |analyzed_table|
           # defer model definition for tables with `has_many: :xxx, through: xxx` associations

data/lib/active_record_mysql_repl/extensions/active_record.rb

@@ -10,6 +10,7 @@ module ActiverecordMysqlRepl
 
         def describe
           [
+            "# #{self.table_name}",
             exec_sql("DESCRIBE #{self.table_name}").tab(:h),
             exec_sql("SHOW INDEX FROM #{self.table_name}").tab(:h)
           ].join("\n")

data/lib/active_record_mysql_repl/extensions/object.rb

@@ -71,14 +71,14 @@ module ActiverecordMysqlRepl
       def csv(orientation = nil)
         arr = if self.is_a?(Array)
                 self
-              elsif self.is_a?(ActiveRecord::Relation)
+              elsif self.is_a?(::ActiveRecord::Relation)
                 self.to_a
               else
                 [self]
               end
 
         arr = arr.map do |e|
-          if e.is_a?(ActiveRecord::Base)
+          if e.is_a?(::ActiveRecord::Base)
             values =  e.attributes.transform_values do |v|
               next JSON.pretty_generate(v) if v.is_a?(Enumerable) && v.size > 0
               next 'NULL' if v.nil?

data/lib/active_record_mysql_repl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveRecordMysqlRepl
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/sample_config/{.pryrc.sample → .army.sample/.pryrc.sample}

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 begin
   require "awesome_print"
   Pry.config.print = proc do |_output, value, pry_instance|

data/sample_config/{databases.sample.yml → .army.sample/databases.sample.yml}

@@ -1,9 +1,9 @@
-# yaml-language-server: $schema=https://raw.githubusercontent.com/nogahighland/active_record_mysql_repl/refs/heads/main/json_schema/databases_schema.json
+# yaml-language-server: $schema=https://raw.githubusercontent.com/nogahighland/active_record_mysql_repl/refs/heads/main/json_schemas/databases_schema.json
 
 test:
   remote_host: 127.0.0.1
   database: test
-  port: 3306
+  port: 33060
   user: root
   password: root
   prompt_color: cyan

data/sample_config/.army.sample/extensions/hello.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module UpcaseName
+  def upcase_name
+    self.name.upcase
+  end
+end
+
+::UserProfile.include UpcaseName

data/sample_config/.army.sample.yml

@@ -1,6 +1,6 @@
 # yaml-language-server: $schema=https://raw.githubusercontent.com/nogahighland/active_record_mysql_repl/refs/heads/main/json_schemas/army_schema.json
 
-database_config: ./databases.sample.yml
-associations: ./associations.sample.yml
-extensions_dir:
-pryrc: ./.pryrc.sample
+database_config: ./.army.sample/databases.sample.yml
+associations: ./.army.sample/associations.sample.yml
+extensions_dir: ./.army.sample/extensions
+pryrc: ./.army.sample/.pryrc.sample

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_record_mysql_repl
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Hiroki Kishi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-11 00:00:00.000000000 Z
+date: 2024-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -214,6 +214,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".bundle/config"
 - ".rspec"
 - ".standard.yml"
 - CHANGELOG.md
@@ -248,9 +249,10 @@ files:
 - lib/active_record_mysql_repl/ssh_tunnel.rb
 - lib/active_record_mysql_repl/version.rb
 - sample_config/.army.sample.yml
-- sample_config/.pryrc.sample
-- sample_config/associations.sample.yml
-- sample_config/databases.sample.yml
+- sample_config/.army.sample/.pryrc.sample
+- sample_config/.army.sample/associations.sample.yml
+- sample_config/.army.sample/databases.sample.yml
+- sample_config/.army.sample/extensions/hello.rb
 - sample_config/sample_db.sql
 homepage: https://github.com/nogahighland/active_record_mysql_repl
 licenses: