natswork-server 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e3e313802b887c8c1df6acb9b69088b95b80f6747d795aaf065473f99a01b65a
+  data.tar.gz: c578ea4a71db61f6f003b600d8b9170025f36e5a97b95eac4581252eee672d0c
+SHA512:
+  metadata.gz: 876e45dd43cbb2ab3209a68bb348825f475758b3c2dcf30195244231e6aba2d10289a5079856bb815ea7a05b468a10cf0eacfbb37157f07f171471365fd717fe
+  data.tar.gz: e29dff32d4f1ad7a29629538834869c190b523d3a62e1df4a017e3c048a3775acedc5aaf016d6cd2ab776e8da850dcf4c229ff4f3ce01fd564eb43f095cddd24

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tesote.com Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,286 @@
+# NatsWork::Server
+
+Job processing server for the NatsWork distributed job processing system.
+
+## Installation
+
+Add to your application's Gemfile:
+
+```ruby
+gem 'natswork-server'
+```
+
+And execute:
+
+    $ bundle install
+
+## Configuration
+
+```ruby
+NatsWork::Server.configure do |config|
+  config.nats_url = ENV['NATS_URL'] || 'nats://localhost:4222'
+  config.concurrency = 25
+  config.queues = ['critical', 'default', 'low']
+  config.logger = Logger.new(STDOUT)
+end
+```
+
+## Starting a Worker
+
+### Command Line
+
+```bash
+# Start with default settings
+natswork
+
+# Specify queues and concurrency
+natswork -q critical,default -c 10
+
+# With config file
+natswork -C config/natswork.yml
+```
+
+### Programmatically
+
+```ruby
+require 'natswork/server'
+
+worker = NatsWork::Worker.new(
+  queues: ['critical', 'default'],
+  concurrency: 10,
+  logger: Logger.new(STDOUT)
+)
+
+# Handle signals gracefully
+trap('TERM') { worker.stop }
+trap('INT') { worker.stop }
+
+worker.start
+```
+
+## Worker Features
+
+### Concurrency
+
+Workers process jobs concurrently using a thread pool:
+
+```ruby
+worker = NatsWork::Worker.new(
+  concurrency: 25  # Number of concurrent jobs
+)
+```
+
+### Queue Priority
+
+Process queues in order of priority:
+
+```ruby
+worker = NatsWork::Worker.new(
+  queues: ['critical', 'default', 'low'],
+  strict: true  # Strict priority ordering
+)
+```
+
+### Middleware
+
+Add server-side middleware:
+
+```ruby
+class MetricsMiddleware
+  def call(job, message)
+    start = Time.now
+    yield
+  ensure
+    duration = Time.now - start
+    StatsD.timing("job.duration", duration, tags: ["job:#{job.class.name}"])
+  end
+end
+
+NatsWork::Server.configure do |config|
+  config.server_middleware do |chain|
+    chain.add MetricsMiddleware
+  end
+end
+```
+
+### Error Handling
+
+Configure error handling and retries:
+
+```ruby
+NatsWork::Server.configure do |config|
+  # Retry configuration
+  config.max_retries = 5
+  config.retry_backoff = :exponential
+  
+  # Dead letter queue
+  config.enable_dead_letter = true
+  config.dead_letter_queue = 'failed_jobs'
+  
+  # Error callbacks
+  config.error_handler = ->(error, job, message) {
+    Bugsnag.notify(error, {
+      job_class: job.class.name,
+      job_id: message['job_id']
+    })
+  }
+end
+```
+
+## Monitoring
+
+### Health Checks
+
+Built-in health check endpoint:
+
+```ruby
+# Add health checks
+NatsWork::HealthChecker.global.add_check('database') do
+  ActiveRecord::Base.connection.active?
+end
+
+# Check health
+health = NatsWork::HealthChecker.global.report
+# => { status: :healthy, checks: { ... } }
+```
+
+### Metrics
+
+Track worker metrics:
+
+```ruby
+metrics = worker.stats
+# => {
+#   jobs_processed: 1000,
+#   jobs_failed: 5,
+#   active_jobs: 3,
+#   queue_latency: { default: 0.5 }
+# }
+```
+
+### Logging
+
+Structured logging with job context:
+
+```ruby
+NatsWork::Server.configure do |config|
+  config.logger = Logger.new(STDOUT)
+  config.log_level = :info
+  config.log_format = :json  # JSON structured logs
+end
+```
+
+## Deployment
+
+### Systemd
+
+```ini
+[Unit]
+Description=NatsWork Worker
+After=network.target
+
+[Service]
+Type=simple
+User=app
+WorkingDirectory=/app
+ExecStart=/usr/local/bin/bundle exec natswork
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target
+```
+
+### Docker
+
+```dockerfile
+FROM ruby:3.1
+
+WORKDIR /app
+COPY Gemfile* ./
+RUN bundle install
+
+COPY . .
+
+CMD ["bundle", "exec", "natswork"]
+```
+
+### Kubernetes
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: natswork-worker
+spec:
+  replicas: 3
+  template:
+    spec:
+      containers:
+      - name: worker
+        image: myapp/worker:latest
+        env:
+        - name: NATS_URL
+          value: nats://nats:4222
+        - name: CONCURRENCY
+          value: "25"
+        resources:
+          requests:
+            memory: "256Mi"
+            cpu: "500m"
+          limits:
+            memory: "512Mi"
+            cpu: "1000m"
+```
+
+## Scaling
+
+### Horizontal Scaling
+
+Deploy multiple workers:
+
+```bash
+# Start multiple workers on different machines
+natswork -q default -c 25  # Machine 1
+natswork -q default -c 25  # Machine 2
+natswork -q default -c 25  # Machine 3
+```
+
+### Auto-scaling
+
+Configure based on queue depth:
+
+```ruby
+# Monitor queue depth
+monitor = NatsWork::QueueMonitor.new
+if monitor.queue_depth('default') > 1000
+  # Scale up workers
+end
+```
+
+## Testing
+
+```ruby
+require 'natswork/testing'
+
+RSpec.describe MyJob do
+  it 'processes job' do
+    NatsWork::Testing.inline! do
+      MyJob.perform_async('arg1', 'arg2')
+      # Job runs synchronously in test
+    end
+  end
+end
+```
+
+## API Reference
+
+See the [API documentation](https://rubydoc.info/gems/natswork-server) for detailed class and method documentation.
+
+## Contributing
+
+Bug reports and pull requests are welcome at https://github.com/yourusername/natswork.
+
+## License
+
+MIT License