[DRE-commits] r3821 - in packages-wip/stompserver/trunk: . debian

Thu Jul 23 01:01:35 UTC 2009

Author: btm-guest
Date: 2009-07-23 01:01:34 +0000 (Thu, 23 Jul 2009)
New Revision: 3821

Added:
   packages-wip/stompserver/trunk/debian/
   packages-wip/stompserver/trunk/debian/changelog
   packages-wip/stompserver/trunk/debian/compat
   packages-wip/stompserver/trunk/debian/control
   packages-wip/stompserver/trunk/debian/copyright
   packages-wip/stompserver/trunk/debian/docs
   packages-wip/stompserver/trunk/debian/rules
   packages-wip/stompserver/trunk/debian/stompserver.1
   packages-wip/stompserver/trunk/debian/watch
Log:
[svn-inject] Applying Debian modifications to trunk


Property changes on: packages-wip/stompserver/trunk/debian
___________________________________________________________________
Added: mergeWithUpstream
   + 1

Added: packages-wip/stompserver/trunk/debian/changelog
===================================================================

--- packages-wip/stompserver/trunk/debian/changelog	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/changelog	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,5 @@
+stompserver (0.9.9-1) unstable; urgency=low
+
+  * Initial release (Closes: #537410)
+
+ -- Bryan McLellan <btm at loftninjas.org>  Fri, 17 Jul 2009 16:38:07 -0700

Added: packages-wip/stompserver/trunk/debian/compat
===================================================================
--- packages-wip/stompserver/trunk/debian/compat	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/compat	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1 @@
+7

Added: packages-wip/stompserver/trunk/debian/control
===================================================================
--- packages-wip/stompserver/trunk/debian/control	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/control	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,19 @@
+Source: stompserver
+Section: ruby
+Priority: extra
+Maintainer: Bryan McLellan <btm at loftninjas.org>
+Uploaders: Debian Ruby Extras Maintainers <pkg-ruby-extras-maintainers at lists.alioth.debian.org>
+Vcs-Browser: http://svn.debian.org/wsvn/pkg-ruby-extras/packages/stompserver/trunk/
+Vcs-Svn: svn://svn.debian.org/pkg-ruby-extras/packages/stompserver/trunk/
+Build-Depends: cdbs, debhelper (>= 7), ruby-pkg-tools (>= 0.14)
+Build-Depends-Indep: graphviz, ruby1.8
+Standards-Version: 3.8.2
+Homepage: http://stompserver.rubyforge.org/
+
+Package: stompserver
+Architecture: all
+Depends: ${shlibs:Depends}, ${misc:Depends}, ruby1.8, libdaemons-ruby1.8, libeventmachine-ruby1.8
+Description: a stomp messaging server implemented in ruby
+ Stompserver is a stomp messaging server with support for multiple FIFO
+ based queue backends including file, dbm, memory and activerecord.
+ It supports basic authentication and queue monitoring.

Added: packages-wip/stompserver/trunk/debian/copyright
===================================================================
--- packages-wip/stompserver/trunk/debian/copyright	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/copyright	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,53 @@
+This package was debianized by Bryan McLellan <btm at loftninjas.org> on
+Fri, 17 Jul 2009 16:38:07 -0700.
+
+It was downloaded from <http://rubyforge.org/projects/stompserver/>
+
+Upstream Authors:
+
+    Patrick Hurley <phurley at gmail.com>
+    Lionel Bouton
+
+Copyright:
+
+    Copyright © 2006 Patrick Hurley
+    Copyright © 2007 Lionel Bouton
+
+License:
+
+    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.
+
+setup.rb:
+
+    Copyright © 2000-2004 Minero Aoki
+
+    This program is free software.
+    You can distribute/modify this program under the terms of
+    the GNU Lesser General Public License version 2.1,
+    see '/usr/share/common-licenses/LGPL-2.1'
+
+debian/stompserver.1:
+
+    The manual page included is compiled from existing package documentation, which
+    is released under the terms of the MIT license which is listed above in the
+    License section.
+
+The Debian packaging is Copyright 2009, Bryan McLellan <btm at loftninjas.org> and
+is licensed under the GPL version 2, see `/usr/share/common-licenses/GPL-2'.

Added: packages-wip/stompserver/trunk/debian/docs
===================================================================
--- packages-wip/stompserver/trunk/debian/docs	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/docs	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,2 @@
+History.txt
+README.txt

Added: packages-wip/stompserver/trunk/debian/rules
===================================================================
--- packages-wip/stompserver/trunk/debian/rules	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/rules	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,15 @@
+#!/usr/bin/make -f
+export DH_VERBOSE=1
+
+
+include /usr/share/cdbs/1/rules/debhelper.mk
+include /usr/share/ruby-pkg-tools/1/class/ruby-setup-rb.mk
+
+DEB_RUBY_CONFIG_ARGS += --shebang=all
+
+binary-install/stompserver::
+	dh_rdoc -pstompserver
+	dh_installman debian/stompserver.1
+	dh_installexamples config/stompserver.conf
+	dh_installexamples etc/passwd.example
+


Property changes on: packages-wip/stompserver/trunk/debian/rules
___________________________________________________________________
Added: svn:executable
   + *

Added: packages-wip/stompserver/trunk/debian/stompserver.1
===================================================================
--- packages-wip/stompserver/trunk/debian/stompserver.1	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/stompserver.1	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,138 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH STOMPSERVER "1" "July 2009" "stompserver" "User Commands"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+stompserver \- Stomp protocol messaging server
+.SH SYNOPSIS
+.B stompserver
+[\fIoptions\fR]
+.SH DESCRIPTION
+Stomp messaging server with file/dbm/memory/activerecord based FIFO
+queues, queue monitoring, and basic authentication.
+
+.SH OPTIONS
+.TP
+\fB\-C\fR, \fB\-\-config\fR=\fICONFIGFILE\fR
+Configuration File (default: stompserver.conf)
+.TP
+\fB\-p\fR, \fB\-\-port\fR=\fIPORT\fR
+Change the port (default: 61613)
+.TP
+\fB\-b\fR, \fB\-\-host\fR=\fIADDR\fR
+Change the host (default: localhost)
+.TP
+\fB\-q\fR, \fB\-\-queuetype\fR=\fIQUEUETYPE\fR
+Queue type (memory|dbm|activerecord|file) (default: memory)
+.TP
+\fB\-w\fR, \fB\-\-working_dir\fR=\fIDIR\fR
+Change the working directory (default: current directory)
+.TP
+\fB\-s\fR, \fB\-\-storage\fR=\fIDIR\fR
+Change the storage directory (default: .stompserver, relative to working_dir)
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+Turn on debug messages
+.TP
+\fB\-a\fR, \fB\-\-auth\fR
+Require client authorization
+.TP
+\fB\-c\fR, \fB\-\-checkpoint\fR=\fISECONDS\fR
+Time between checkpointing the queues in seconds (default: 0)
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show this message
+
+.SH QUEUES
+
+Stompserver handles basic message queue processing using memory, file, or dbm
+based queues. Messages are sent and consumed in FIFO order (unless a
+client error happens, this should be corrected in the future). Topics
+are memory-only storage.  You can select activerecord, file or dbm
+storage and the queues will use that, but topics will only be stored
+in memory.
+
+memory queues are of course the fastest ones but shouldn't be used if
+you want to ensure all messages are delivered.
+
+dbm queues will use berkeleydb if available, otherwise dbm or gdbm
+depending on the platform. sdbm does not work well with marshalled
+data. Note that these queues have not been tested in this release.
+
+For the file based storage, each frame is stored in a single file. The
+first 8 bytes contains the header length, the next 8 bytes contains
+the body length, then the headers are stored as a marshalled object
+followed by the body stored as a string. This storage is currently
+inefficient because queues are stored separately from messages, which
+forces a double write for data safety reasons on each message stored.
+
+The activerecord based storage expects to find a database.yml file in
+the configuration directory. It should be the most robust backend, but
+the slowest one. The database must have an ar_messages table which can
+be created with the following code (you are responsible to do so):
+
+  ActiveRecord::Schema.define do
+    create_table 'ar_messages' do |t|
+      t.column 'stomp_id', :string, :null => false
+      t.column 'frame', :text, :null => false
+    end
+  end
+
+You can read the frames with this model:
+
+  class ArMessage < ActiveRecord::Base
+    serialize :frame
+  end
+
+The ar_message implementation will certainly change in the future.
+
+This is meant to be easily readable by a Rails application (which
+could handle the ar_messages table creation with a migration).
+
+.SH ACCESS CONTROL
+
+Basic client authorization is also supported.  If the \-a flag is
+passed to stompserver on startup, and a .passwd file exists in the run
+directory, then clients will be required to provide a valid login and
+passcode.  See passwd.example for the password file format.
+
+.SH MONITORING
+
+Queues can be monitored via the monitor queue (this will probably not
+be supported this way in the future to avoid polluting the queue
+namespace). If you subscribe to /queue/monitor, you will receive a
+status message every 5 seconds that displays each queue, it's size,
+frames enqueued, and frames dequeued. Stats are sent in the same
+format of stomp headers, so they are easy to parse. Following is an
+example of a status message containing stats for 2 queues:
+
+Queue: /queue/client2
+size: 0
+dequeued: 400
+enqueued: 400
+
+Queue: /queue/test
+size: 50
+dequeued: 250
+enqueued: 300
+
+
+.SH AUTHOR
+stompserver was written by Patrick Hurley <phurley at gmail.com> and Lionel Bouton.
+.PP
+This manual page was compiled from the included documentation by 
+Bryan McLellan <btm at loftninjas.org> for the Debian project (and may be used by others).
+The existing documentation is distributed under the MIT license.

Added: packages-wip/stompserver/trunk/debian/watch
===================================================================
--- packages-wip/stompserver/trunk/debian/watch	                        (rev 0)
+++ packages-wip/stompserver/trunk/debian/watch	2009-07-23 01:01:34 UTC (rev 3821)
@@ -0,0 +1,3 @@
+version=3
+http://rubyforge.org/frs/?group_id=2372 \
+  .*/stompserver-([\d\.]*).tgz


