Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/senotrusov/workety
A library to run Ruby classes as daemons. Process start, signal handling, logfile/pidfile, restart by watchdog, exception handling, reporting to Airbrake and Exceptional, Rails environment load, mutithreaded workers.
https://github.com/senotrusov/workety
daemon error-reporting exception-handling logging multithreading pidfile process rails ruby watchdog
Last synced: 12 days ago
JSON representation
A library to run Ruby classes as daemons. Process start, signal handling, logfile/pidfile, restart by watchdog, exception handling, reporting to Airbrake and Exceptional, Rails environment load, mutithreaded workers.
- Host: GitHub
- URL: https://github.com/senotrusov/workety
- Owner: senotrusov
- License: apache-2.0
- Archived: true
- Created: 2009-07-23T07:24:29.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2017-04-23T20:00:57.000Z (almost 8 years ago)
- Last Synced: 2024-10-01T15:53:04.392Z (4 months ago)
- Topics: daemon, error-reporting, exception-handling, logging, multithreading, pidfile, process, rails, ruby, watchdog
- Language: Ruby
- Homepage:
- Size: 136 KB
- Stars: 5
- Watchers: 4
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Workety
A library to run Ruby classes as daemons.
* process start
* terminal detach
* run as a user/group (root privileges drop)
* signal handling
* logfile
* pidfile, check for already running daemon
* may restart in a case of failure, by forking from watchdog
* may send exceptions to Airbrake and Exceptional
* Rails environment load at a late stage
* support for mutithreaded workers
* command-line argument parsing by use of the [trollop](http://trollop.rubyforge.org) library
* simple API for an application code
### Command-line invocation
```sh
# run a daemon
workety -e development start Workety::SimpleThread --foo=bar
# ^^^^^ Start as a daemon
# ^^^^^^^^^^^^^^ Options for Workety ^^^^^^^^^ Options for the class
# run a thread in the console
workety Workety::SimpleThread
```
### SimpleThread example
```ruby
class SimpleThread
# Before dropping privileges
def initialize
end
# After changing privileges to some user/group
def start
@t = Thread.workety do
until Workety.must_stop? do
sleep 1
end
end
Thread.workety do
sleep 10
Workety.stop
end
end
def join
@t.join
end
def stop
@t.kill
end
end
```
### GracefulStopThread example
```ruby
class GracefulStopThread
# Before dropping privileges
def initialize
@mutex = Mutex.new
@wakeup = ConditionVariable.new
end
# After changing privileges to some user/group
def start
@worker = Thread.workety do
@mutex.synchronize do
until Workety.must_stop? do
puts "Hello"
@wakeup.wait(@mutex, 10)
end
end
end
end
def join
@worker.join
end
def stop
@mutex.synchronize do
@wakeup.signal
end
end
end
```
## Copyright and License
```
Copyright 2006-2011 Stanislav Senotrusov
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```
## Contributing
Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.