hiiro 0.1.154 → 0.1.155

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2fdf896084fbec37ad190f81188a0e470aaf30c491acb77df209e3b6d3da6cf
-  data.tar.gz: 3310a848c676685907bec54adba6b2eb76be56a811cf73f1dd56fb4a3953ddd7
+  metadata.gz: bbe44699de1ea172d5b4d18436f3aae2e7fec81e0350f66aef04646c452e259d
+  data.tar.gz: c91fba3e8f92db14f581af937b103ef3a87c52f993fe306a64a629b2420d0aee
 SHA512:
-  metadata.gz: 85fe854d98a6ffa72e9df07b3816bd8a0e20ca044667afabefd8cd5918264804b8d92f85c464301aaf3275be71ba410399ab27499473ffb3b4b163e872040bff
-  data.tar.gz: 0ea45cfd61f388f051c50eca1fc6a7f1f46039cd56f6129dc03b12e5a93ad952298225d18ea0cb078aabea04f78fcf4e27ae6662d54abeb45bdaa9ffd0dba590
+  metadata.gz: 274b382097248a427e5300634e6928a92c2ce2135742fcd8ad9fea5c6f822f8e882445a82b3b6879c1062b5a86d19a86675b5c263d1e811fd7f3fede11b5af4f
+  data.tar.gz: 6cc068ece0ed1b5efcad1238ab14c42115364c33af8850781ef1e8dbca4bd5af751b53a33b421e8a95d12fa5d3bdcc6725a39682dade5356591cefb0c1ed1b50

data/examples/services.yml

@@ -0,0 +1,289 @@
+# Example services.yml
+# Place at ~/.config/hiiro/services.yml
+#
+# Base env templates referenced by base_env live in:
+#   ~/.config/hiiro/env_templates/
+
+# =============================================================================
+# Simple service - single start command, no env files
+# =============================================================================
+redis:
+  base_dir: ""
+  host: localhost
+  port: 6379
+  start:
+    - redis-server
+
+# Usage:
+#   h service start redis
+#   h service stop redis          # sends C-c
+
+# =============================================================================
+# Rails API - multiple init steps, single env file with variations
+# =============================================================================
+api-rails:
+  base_dir: ~/work/api
+  host: localhost
+  port: 3000
+  init:
+    - bundle install
+    - bin/rails db:migrate
+  start:
+    - bundle exec rails s -p 3000
+  cleanup:
+    - rm -f tmp/pids/server.pid
+  env_files:
+    - env_file: .env.development
+      base_env: api-rails.env
+      env_vars:
+        DATABASE_URL:
+          variations:
+            local: postgres://localhost:5432/api_dev
+            docker: postgres://db:5432/api_dev
+            staging: postgres://readonly:pass@staging-db.internal:5432/api
+        REDIS_URL:
+          variations:
+            local: redis://localhost:6379
+            docker: redis://redis:6379
+        LOG_LEVEL:
+          variations:
+            local: debug
+            quiet: warn
+
+# Usage:
+#   h service start api-rails
+#     -> uses "local" for all variations (DATABASE_URL=postgres://localhost..., REDIS_URL=redis://localhost..., LOG_LEVEL=debug)
+#
+#   h service start api-rails --use DATABASE_URL=docker --use REDIS_URL=docker
+#     -> uses docker DB and redis, LOG_LEVEL defaults to "local" (debug)
+#
+#   h service start api-rails --use DATABASE_URL=staging --use LOG_LEVEL=quiet
+#     -> connects to staging DB (readonly), quiet logging, REDIS_URL defaults to local
+#
+#   h service start api-rails --use LOG_LEVEL=quiet
+#     -> everything local except warn-level logging
+
+# =============================================================================
+# GraphQL service - multiple env files
+# =============================================================================
+graphql:
+  base_dir: ~/work/graphql
+  host: localhost
+  port: 4000
+  init:
+    - npm install
+  start:
+    - npm run dev
+  env_files:
+    - env_file: .env.local
+      base_env: graphql.env
+      env_vars:
+        API_URL:
+          variations:
+            local: http://localhost:3000
+            staging: https://api.staging.example.com
+            production: https://api.example.com
+        AUTH_PROVIDER:
+          variations:
+            local: http://localhost:8080/auth
+            staging: https://auth.staging.example.com
+            production: https://auth.example.com
+    - env_file: .env.test
+      base_env: graphql-test.env
+      env_vars:
+        API_URL:
+          variations:
+            local: http://localhost:3001
+            mock: http://localhost:9999
+
+# Usage:
+#   h service start graphql
+#     -> writes BOTH env files:
+#        .env.local   gets API_URL=http://localhost:3000, AUTH_PROVIDER=http://localhost:8080/auth
+#        .env.test    gets API_URL=http://localhost:3001
+#
+#   h service start graphql --use API_URL=staging --use AUTH_PROVIDER=staging
+#     -> .env.local   gets API_URL=https://api.staging.example.com, AUTH_PROVIDER=https://auth.staging.example.com
+#        .env.test    gets API_URL=http://localhost:3001 (no "staging" variation defined for .env.test, falls back to "local")
+#
+#   h service start graphql --use API_URL=mock
+#     -> .env.local   gets API_URL=http://localhost:3000 (no "mock" variation in .env.local, falls back to "local")
+#        .env.test    gets API_URL=http://localhost:9999 (uses "mock" variation)
+#
+#   h service start graphql --use API_URL=production --use AUTH_PROVIDER=production
+#     -> .env.local   gets API_URL=https://api.example.com, AUTH_PROVIDER=https://auth.example.com
+#        .env.test    gets API_URL=http://localhost:3001 (no "production" defined, falls back to "local")
+
+# =============================================================================
+# Frontend - depends on graphql URL
+# =============================================================================
+frontend:
+  base_dir: ~/work/frontend
+  host: localhost
+  port: 8080
+  start:
+    - npm run dev
+  env_files:
+    - env_file: .env.local
+      base_env: frontend.env
+      env_vars:
+        GRAPHQL_URL:
+          variations:
+            local: http://localhost:4000/graphql
+            staging: https://graphql.staging.example.com/graphql
+            production: https://graphql.example.com/graphql
+        FEATURE_FLAGS:
+          variations:
+            local: all
+            staging: released
+            production: released
+
+# Usage:
+#   h service start frontend
+#     -> GRAPHQL_URL=http://localhost:4000/graphql, FEATURE_FLAGS=all
+#
+#   h service start frontend --use GRAPHQL_URL=staging --use FEATURE_FLAGS=staging
+#     -> GRAPHQL_URL=https://graphql.staging.example.com/graphql, FEATURE_FLAGS=released
+
+# =============================================================================
+# Worker with custom stop command
+# =============================================================================
+sidekiq:
+  base_dir: ~/work/api
+  host: localhost
+  port: ""
+  start:
+    - bundle exec sidekiq -C config/sidekiq.yml
+  stop: "pkill -f sidekiq"
+  env_files:
+    - env_file: .env.development
+      base_env: api-rails.env
+      env_vars:
+        REDIS_URL:
+          variations:
+            local: redis://localhost:6379
+            docker: redis://redis:6379
+
+# Usage:
+#   h service start sidekiq
+#   h service stop sidekiq    # runs "pkill -f sidekiq" instead of C-c
+
+# =============================================================================
+# Multi-command start - seed data then launch
+# =============================================================================
+demo-server:
+  base_dir: ~/work/demo
+  host: localhost
+  port: 5000
+  init:
+    - npm install
+  start:
+    - npm run db:seed
+    - npm run build:assets
+    - npm start
+  env_files:
+    - env_file: .env
+      base_env: demo.env
+      env_vars:
+        DEMO_MODE:
+          variations:
+            local: full
+            lite: minimal
+
+# Usage:
+#   h service start demo-server
+#     -> creates a script that runs: db:seed && build:assets && start
+#     -> DEMO_MODE=full
+#
+#   h service start demo-server --use DEMO_MODE=lite
+#     -> same commands, DEMO_MODE=minimal
+
+# =============================================================================
+# SERVICE GROUPS
+# =============================================================================
+
+# Full local stack - everything pointing at localhost
+full-stack:
+  services:
+    - name: redis
+    - name: api-rails
+      use:
+        DATABASE_URL: local
+        REDIS_URL: local
+        LOG_LEVEL: local
+    - name: graphql
+      use:
+        API_URL: local
+        AUTH_PROVIDER: local
+    - name: frontend
+      use:
+        GRAPHQL_URL: local
+        FEATURE_FLAGS: local
+
+# Usage:
+#   h service start full-stack
+#     -> creates ONE tmux window with 4 split panes (redis, api-rails, graphql, frontend)
+#     -> all services use "local" variations
+
+# Frontend + GraphQL against staging API (no local rails needed)
+staging-fe:
+  services:
+    - name: graphql
+      use:
+        API_URL: staging
+        AUTH_PROVIDER: staging
+    - name: frontend
+      use:
+        GRAPHQL_URL: local
+        FEATURE_FLAGS: staging
+
+# Usage:
+#   h service start staging-fe
+#     -> ONE tmux window, 2 split panes
+#     -> graphql points at staging API/auth
+#     -> frontend points at local graphql (which proxies to staging)
+
+# Backend only - rails + sidekiq + redis, docker DB
+backend-docker:
+  services:
+    - name: redis
+    - name: api-rails
+      use:
+        DATABASE_URL: docker
+        REDIS_URL: docker
+        LOG_LEVEL: local
+    - name: sidekiq
+      use:
+        REDIS_URL: docker
+
+# Usage:
+#   h service start backend-docker
+#     -> 3 split panes: redis, api-rails, sidekiq
+#     -> all using docker postgres and redis URLs
+
+# =============================================================================
+# QUICK REFERENCE - all start commands
+# =============================================================================
+#
+# Start with defaults (all "local" variations):
+#   h service start <name>
+#
+# Start with specific variations:
+#   h service start <name> --use VAR=variation
+#   h service start <name> --use VAR1=v1 --use VAR2=v2
+#
+# Start a group (pre-configured variation combos):
+#   h service start <group-name>
+#
+# Interactive selection (no name):
+#   h service start
+#
+# Other commands:
+#   h service stop [name]       # C-c (or custom stop cmd), fuzzy select if no name
+#   h service attach [name]     # switch to service's tmux pane
+#   h service status [name]     # show service details
+#   h service reset [name]      # clear stale running state
+#   h service clean             # auto-prune dead panes from state
+#   h service ls                # list all services + status
+#   h service env <name>        # show env file config and variations
+#   h service groups            # list all groups and members

data/lib/hiiro/version.rb

@@ -1,3 +1,3 @@
 class Hiiro
-  VERSION = "0.1.154"
+  VERSION = "0.1.155"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.154
+  version: 0.1.155
 platform: ruby
 authors:
 - Joshua Toyota
@@ -113,6 +113,7 @@ files:
 - docs/h-session.md
 - docs/h-window.md
 - editboth
+- examples/services.yml
 - exe/h
 - exe/hiiro
 - h-tmux-plugins.tmux