skynet 0.9.2 → 0.9.3

data/app_generators/skynet_install/templates/skynet_config.rb

@@ -0,0 +1,50 @@
+# Skynet Configuration File.  Should be in APP_ROOT/config/skynet_config.rb  
+# Start skynet from within your app root with 
+# > skynet start
+
+require 'rubygems'
+require 'skynet'         
+
+<% if in_rails -%>
+# Load your rails app
+if not defined?(RAILS_GEM_VERSION)
+  require File.expand_path(File.dirname(__FILE__)) + '/../config/environment'
+end
+<% end -%>
+
+Skynet::CONFIG[:SKYNET_LOG_LEVEL] = Logger::ERROR
+<% if in_rails -%>
+Skynet::CONFIG[:APP_ROOT]         = RAILS_ROOT
+Skynet::CONFIG[:SKYNET_LOG_DIR]   = File.expand_path(Skynet::CONFIG[:APP_ROOT]+ "/log")
+Skynet::CONFIG[:SKYNET_PID_DIR]   = File.expand_path(Skynet::CONFIG[:APP_ROOT] + "/log")
+Skynet::CONFIG[:SKYNET_LOG_FILE]  = "skynet_#{RAILS_ENV}.log"
+Skynet::CONFIG[:SKYNET_PID_FILE]  = "skynet_#{RAILS_ENV}.pid"
+<% else -%>
+Skynet::CONFIG[:SKYNET_LOG_DIR]   = File.expand_path(File.dirname(__FILE__) + "/../log") 
+Skynet::CONFIG[:SKYNET_PID_DIR]   = File.expand_path(File.dirname(__FILE__) + "/../log") 
+<% end -%>
+
+<% if mysql -%>
+<% if not in_rails -%>
+# Use the mysql message queue adapter
+Skynet::CONFIG[:MESSAGE_QUEUE_ADAPTER] = "Skynet::MessageQueueAdapter::Mysql"
+Skynet::CONFIG[:MYSQL_HOST]            = "localhost"
+Skynet::CONFIG[:MYSQL_USERNAME]        = "root"
+Skynet::CONFIG[:MYSQL_PASSWORD]        = ""
+Skynet::CONFIG[:MYSQL_DATABASE]        = "skynet"
+<% else %>
+# Use the mysql message queue adapter
+Skynet::CONFIG[:MESSAGE_QUEUE_ADAPTER] = "Skynet::MessageQueueAdapter::Mysql"
+<% end -%>
+<% end -%>
+
+# ==================================================================
+# = Require any other libraries you want skynet to know about here =
+# ==================================================================
+
+
+# ===========================================
+# = Set your own configuration options here =
+# ===========================================
+# You can also configure skynet with
+# Skynet.configure(:SOME_CONFIG_OPTION => true, :SOME_OTHER_CONFIG => 3)

data/app_generators/skynet_install/templates/skynet_initializer.rb

@@ -0,0 +1 @@
+require RAILS_ROOT+'/config/skynet_config.rb'

data/app_generators/skynet_install/templates/{skynet_schema.sql → skynet_mysql_schema.sql}

@@ -7,7 +7,7 @@ CREATE TABLE skynet_message_queues (
   tasktype varchar(255) default NULL,
   task_id bigint(20) unsigned default NULL,
   job_id bigint(20) unsigned default NULL,
-  raw_payload text,
+  raw_payload longtext,
   payload_type varchar(255) default NULL,
   name varchar(255) default NULL,
   expiry int(11) default NULL,
@@ -22,29 +22,6 @@ CREATE TABLE skynet_message_queues (
   KEY index_skynet_message_queues_on_task_id (task_id),
   KEY index_skynet_mqueue_for_take (queue_id,tasktype,payload_type,expire_time)
 ) ENGINE=InnoDB DEFAULT CHARSET=latin1;
-CREATE TABLE skynet_worker_queues (
-  id int(11) NOT NULL auto_increment,
-  queue_id int(11) default '0',
-  created_on datetime default NULL,
-  updated_on datetime default NULL,
-  tasktype varchar(255) default NULL,
-  tasksubtype varchar(255) default NULL,
-  worker_id bigint(20) unsigned default NULL,
-  hostname varchar(255) default NULL,
-  process_id int(11) default NULL,
-  job_id bigint(20) unsigned default NULL,
-  task_id bigint(20) unsigned default NULL,
-  iteration int(11) default NULL,
-  name varchar(255) default NULL,
-  map_or_reduce varchar(255) default NULL,
-  started_at decimal(16,4) default NULL,
-  version int(11) default NULL,
-  processed int(11) default NULL,
-  timeout decimal(16,4) default NULL,
-  PRIMARY KEY  (id),
-  UNIQUE KEY index_skynet_worker_queues_on_worker_id (worker_id),
-  KEY index_skynet_worker_queues_on_hostname_and_process_id (hostname,process_id)
-) ENGINE=InnoDB DEFAULT CHARSET=latin1;
 CREATE TABLE skynet_queue_temperature (
   id int(11) NOT NULL auto_increment,
   queue_id int(11) default '0',

data/bin/skynet

@@ -27,18 +27,45 @@
 require 'rubygems'
 require File.expand_path(File.dirname(__FILE__)) + '/../lib/skynet.rb'
 
-Skynet::CONFIG[:WORKER_CHECK_DELAY]     ||= 4
-Skynet::CONFIG[:LAUNCHER_PATH]          = File.expand_path(__FILE__)
 
-begin
-  mq = Skynet::MessageQueue.new
-rescue Skynet::ConnectionError
-  if Skynet::MessageQueue.adapter == :tuplespace
-    pid = fork do
-      exec("skynet_tuplespace_server start")
+if config_arg = ARGV.detect {|i| i =~ /--help/ }
+  Skynet.start
+  exit
+end
+
+conf_file = nil
+if config_arg = ARGV.detect {|i| i =~ /--config/i }
+  conf_file = config_arg.split('=').last
+  ARGV.delete_if {|i| i =~ /--config/ }  
+else
+  ['config/skynet_config.rb', 'skynet_config.rb', "../config/skynet_config.rb" , "#{ENV['HOME']}/.skynet/config.rb"].each do |path|
+    if File.exists?(path)
+      conf_file = path
+      break
     end
-    sleep 3
   end
 end
 
-Skynet.new
+if conf_file
+  Skynet::CONFIG[:CONFIG_FILE]      = File.expand_path(conf_file)
+  Skynet::CONFIG[:APP_ROOT]         = File.dirname(Skynet::CONFIG[:CONFIG_FILE])
+  Skynet::CONFIG[:SKYNET_LOG_DIR]   = File.expand_path(Skynet::CONFIG[:APP_ROOT]+ "/../log")
+  Skynet::CONFIG[:SKYNET_PID_DIR]   = File.expand_path(Skynet::CONFIG[:APP_ROOT] + "/../log")
+  begin
+    require conf_file
+  rescue MissingSourceFile => e
+    puts "Specified config file #{conf_file} is missing."
+    exit
+  end
+  puts "using config file: #{File.expand_path(conf_file)}" unless conf_file == 'config/skynet_config.rb'
+else
+  puts "No configuration file found.\nTry running skynet_install to create a config/skynet_config.rb or starting skynet with --config=CONFIG_FILE_LOCATION.  Exiting."
+  exit
+end
+
+Skynet::CONFIG[:WORKER_CHECK_DELAY]     ||= 4
+Skynet::CONFIG[:LAUNCHER_PATH]          = File.expand_path(__FILE__)
+
+Skynet::CONFIG[:SYSTEM_RUNNER] = true
+
+Skynet.start

data/bin/skynet_install

@@ -1,15 +1,15 @@
 #!/usr/bin/env ruby
 
-# skynet_install is used to install skynet binaries into your application.
-# The value of using your own skynet binaries is that they can ensure your code
-# is available to all skynet workers.
+# skynet_install is used to install skynet libraries into your application.
+# Specifically, it installs a config/skynet_config.rb file
+# Once you have a config/skynet_config.rb you can run skynet start from within your root_app_dir/
 # This is also how you can run skynet from within rails. (using --rails)
 #
-# USAGE: skynet_install [--rails] directory (can be '.' for current)"
+# USAGE: skynet_install [--rails] directory/ (can be '.' for current)"
 # 
 #   Options:
 #       -v, --version                    Show the skynet_install version number and quit.
-#           --include-migration          Include mysql migration if you want to use mysql as your message queue
+#           --mysql                      Include mysql migration if you want to use mysql as your message queue
 #       -r, --rails                      Install into rails app
 #                                        Default: false
 #   General Options:

data/bin/skynet_tuplespace_server

@@ -4,24 +4,25 @@
 #   Skynet::CONFIG[:MESSAGE_QUEUE_ADAPTER] = "Skynet::MessageQueueAdapter::TupleSpace"
 #
 # Usage: skynet_tuplespace_server (start|stop|run) [options]
-#     -t, --ontop TRUE                 Dont Daemonize
-#     -p, --port PORT                  Port to listen on. default 7647
-#     -o, --log LOGFILE                Logfile to log to
-#     -l, --loglevel LOGLEVEL          Log level defaults to DEBUG
-#     -d, --piddir PIDDIR              Directory to put pidfile
-#     -u, --drburi Drb URI             What DRbURI to use
+#     -t, --ontop=TRUE                 Dont Daemonize
+#     -p, --port=PORT                  Port to listen on. default 7647
+#     -o, --logfile=LOGFILE            Logfile to log to
+#     -l, --loglevel=LOGLEVEL          Log level defaults to DEBUG
+#     -d, --piddir=PIDDIR              Directory to put pidfile
+#     -u, --drburi=druby://DRB_URI     What DRbURI to use
 
 require 'rubygems'
 require 'daemons'
 require 'pp'
 
-require File.expand_path(File.dirname(__FILE__)) + '/../lib/skynet.rb'         
+require File.expand_path(File.dirname(__FILE__)) + '/../lib/skynet.rb'
 
 options = { 
-  :port     => 7647,
-  :logfile  => Skynet::CONFIG[:SKYNET_LOG_FILE],
-  :loglevel => "DEBUG",
-  :piddir   => Skynet::CONFIG[:SKYNET_PID_DIR]
+  :port           => 7647,
+  :logfile        => Skynet::Config.pidfile_location,
+  :loglevel       => "ERROR",
+  :piddir         => Skynet::CONFIG[:SKYNET_PID_DIR],
+  :use_ringserver => Skynet::CONFIG[:TS_USE_RINGSERVER],
 }
 
 OptionParser.new do |opt|
@@ -29,26 +30,33 @@ OptionParser.new do |opt|
   opt.on('-t', '--ontop TRUE', 'Dont Daemonize') do |v| 
     options[:ontop] = true if v.upcase == "TRUE" or v == "1"
   end
-  opt.on('-p', '--port PORT', 'Port to listen on. default 7647') do |v| 
+  opt.on('-p', '--port=PORT', 'Port to listen on. default 7647') do |v| 
     options[:port] = v.to_i
   end
-  opt.on('-o', '--log LOGFILE', 'Logfile to log to') do |v|
-    options[:logfile] = v
+  opt.on('-o', '--logfile=LOGFILE', 'Logfile to log to') do |v|
+    options[:logfile] = File.expand_path(v)
   end
-  opt.on('-l', '--loglevel LOGLEVEL', 'Log level defaults to DEBUG') do |v|
+  opt.on('-l', '--loglevel=LOGLEVEL', 'Log level defaults to DEBUG') do |v|
     options[:loglevel] = v
   end
-  opt.on('-d', '--piddir PIDDIR', 'Directory to put pidfile') do |v|
+  opt.on('-d', '--piddir=PIDDIR', 'Directory to put pidfile') do |v|
     options[:piddir] = File.expand_path(v)
   end
-  opt.on('-u', '--drburi Drb URI', 'What DRbURI to use') do |v|
+  opt.on('--use_ringserver=TRUE', 'Use ringserver?') do |v|
+    if v.downcase == "true" or v == "1"
+      options[:use_ringserver] = true
+    else
+      options[:use_ringserver] = false
+    end      
+  end
+  opt.on('-u', '--drburi=druby://DRB_URI', 'What DRbURI to use') do |v|
     if v =~ %r{druby://}
       options[:drburi] = v
     else
       options[:drburi] = "druby://#{v}"
     end
     options[:drburi] =~ /druby:\/\/.+?:(\d*)/
-    options[:port] = $1.to_i
+    options[:port] ||= $1.to_i
   end
 
   opt.parse!(ARGV)
@@ -62,5 +70,5 @@ Daemons.run_proc("skynet_tuplespace_server#{options[:port]}",
   # :monitor => true,
   :ontop     => options[:ontop] || false
 }) do
-  server = Skynet::Server.new(options)
+  server = Skynet::TuplespaceServer.start(options)
 end

data/examples/dgrep/README

@@ -0,0 +1,70 @@
+
+EXAMPLE 1: Distributed Grep
+------------------------------
+You have a list of files and want to see how many times each word shows up in those files.
+All of the map_reduce code is in lib/mapreduce_test.rb
+
+To 
+1. Run Skynet
+ > ./script/skynet start
+
+2. Watch the logs in another terminal
+ > tail -f log/skynet.log
+ 
+3. Run dgrep providing it with some words and a directory
+ > ./script/dgrep -r love hate ./data
+
+I've put all of shakespears poetry in the data directory.  You can download all of Shakespeare's work
+to add to the data at http://www.it.usyd.edu.au/~matty/Shakespeare/shakespeare.tar.gz
+
+Thats it!!
+
+EXAMPLE 2: Distributed Grep with distributed reducing
+------------------------------
+Same example as above, but this time we want to aggregate our results across multiple partitioners. This would
+be useful if you had a large reduce data set, or complex calculations in order to reduce.   All the code is already
+in dgrep.pl.  Specifically, notice I've included a self.reduce_partition method (which just forwards to a pre-packaged
+partitioner).  This partitioner not only breaks up the data returned from the mappers, but also makes sure each reducer 
+gets all the same keys.
+
+1. Run dgrep passing --reducers=2  This tells Skynet to try and use up to 2 reducers (instead of the default of 1)
+> ./script/dgrep -r --reducers=2 data file ./data
+
+This sample application was created by creating in the following way
+
+1. Create new app
+ > mkdir simple_example
+ > mkdir data lib
+
+2. Install Skynet
+ > skynet_install
+
+3. Add Data Files to /data
+These are any text files named testfileN.txt and so on
+
+4. Create dgrep.rb and drep script (found in lib/ and script/)
+
+------------------------------------
+
+EXAMPLE 1: Most Common Words
+------------------------------
+You have a list of files and want the 10 most common 5 or more letter words in all of those fules.
+
+1. Run Skynet
+ > ./script/skynet start
+
+2. Watch the logs in another terminal
+ > tail -f log/skynet.log
+ 
+3. Run dgrep providing it with the '-mcw' (most common words) command, some words and a directory
+ > ./script/dgrep -r -mcw ./data
+
+To see what's going on check out lib/most_common_words.rb
+------------------------------------
+
+If you'd like get a peak at what Skynet is doing, edit ./config/skynet_config.rb and set
+
+Skynet::CONFIG[:SKYNET_LOG_LEVEL] = Logger::INFO # or Logger::INFO
+
+and tail ./log/skynet.log
+

data/examples/dgrep/config/skynet_config.rb

@@ -0,0 +1,26 @@
+# Skynet Configuration File.  Should be in APP_ROOT/config/skynet_config.rb  
+# Start skynet from within your app root with 
+# $ skynet start
+
+require 'rubygems'
+require 'skynet'         
+
+Skynet::CONFIG[:SKYNET_LOG_LEVEL] = Logger::ERROR
+Skynet::CONFIG[:SKYNET_LOG_DIR]   = File.expand_path(File.dirname(__FILE__) + "/../log") 
+Skynet::CONFIG[:SKYNET_PID_DIR]   = File.expand_path(File.dirname(__FILE__) + "/../log") 
+
+# ==================================================================
+# = Require any other libraries you want skynet to know about here =
+# ==================================================================
+
+# require all ruby files in lib/
+Dir["#{File.dirname(__FILE__)}" + "/../lib/**/*.rb"].each do |file|
+  require file
+end
+
+# ===========================================
+# = Set your own configuration options here =
+# ===========================================
+# You can also configure skynet with
+# Skynet.configure(:SOME_CONFIG_OPTION => true, :SOME_OTHER_CONFIG => 3)
+

data/examples/dgrep/data/shakespeare/README

@@ -0,0 +1,2 @@
+Download the complete text of shakespeare at
+http://www.it.usyd.edu.au/~matty/Shakespeare/shakespeare.tar.gz

data/examples/dgrep/data/shakespeare/poetry/loverscomplaint

@@ -0,0 +1,381 @@
+  	A LOVER'S COMPLAINT
+
+
+
+FROM off a hill whose concave womb reworded
+A plaintful story from a sistering vale,
+My spirits to attend this double voice accorded,
+And down I laid to list the sad-tuned tale;
+Ere long espied a fickle maid full pale,
+Tearing of papers, breaking rings a-twain,
+Storming her world with sorrow's wind and rain.
+
+Upon her head a platted hive of straw,
+Which fortified her visage from the sun,
+Whereon the thought might think sometime it saw
+The carcass of beauty spent and done:
+Time had not scythed all that youth begun,
+Nor youth all quit; but, spite of heaven's fell rage,
+Some beauty peep'd through lattice of sear'd age.
+
+Oft did she heave her napkin to her eyne,
+Which on it had conceited characters,
+Laundering the silken figures in the brine
+That season'd woe had pelleted in tears,
+And often reading what contents it bears;
+As often shrieking undistinguish'd woe,
+In clamours of all size, both high and low.
+
+Sometimes her levell'd eyes their carriage ride,
+As they did battery to the spheres intend;
+Sometime diverted their poor balls are tied
+To the orbed earth; sometimes they do extend
+Their view right on; anon their gazes lend
+To every place at once, and, nowhere fix'd,
+The mind and sight distractedly commix'd.
+
+Her hair, nor loose nor tied in formal plat,
+Proclaim'd in her a careless hand of pride
+For some, untuck'd, descended her sheaved hat,
+Hanging her pale and pined cheek beside;
+Some in her threaden fillet still did bide,
+And true to bondage would not break from thence,
+Though slackly braided in loose negligence.
+
+A thousand favours from a maund she drew
+Of amber, crystal, and of beaded jet,
+Which one by one she in a river threw,
+Upon whose weeping margent she was set;
+Like usury, applying wet to wet,
+Or monarch's hands that let not bounty fall
+Where want cries some, but where excess begs all.
+
+Of folded schedules had she many a one,
+Which she perused, sigh'd, tore, and gave the flood;
+Crack'd many a ring of posied gold and bone
+Bidding them find their sepulchres in mud;
+Found yet moe letters sadly penn'd in blood,
+With sleided silk feat and affectedly
+Enswathed, and seal'd to curious secrecy.
+
+These often bathed she in her fluxive eyes,
+And often kiss'd, and often 'gan to tear:
+Cried 'O false blood, thou register of lies,
+What unapproved witness dost thou bear!
+Ink would have seem'd more black and damned here!'
+This said, in top of rage the lines she rents,
+Big discontent so breaking their contents.
+
+A reverend man that grazed his cattle nigh--
+Sometime a blusterer, that the ruffle knew
+Of court, of city, and had let go by
+The swiftest hours, observed as they flew--
+Towards this afflicted fancy fastly drew,
+And, privileged by age, desires to know
+In brief the grounds and motives of her woe.
+
+So slides he down upon his grained bat,
+And comely-distant sits he by her side;
+When he again desires her, being sat,
+Her grievance with his hearing to divide:
+If that from him there may be aught applied
+Which may her suffering ecstasy assuage,
+'Tis promised in the charity of age.
+
+'Father,' she says, 'though in me you behold
+The injury of many a blasting hour,
+Let it not tell your judgment I am old;
+Not age, but sorrow, over me hath power:
+I might as yet have been a spreading flower,
+Fresh to myself, If I had self-applied
+Love to myself and to no love beside.
+
+'But, woe is me! too early I attended
+A youthful suit--it was to gain my grace--
+Of one by nature's outwards so commended,
+That maidens' eyes stuck over all his face:
+Love lack'd a dwelling, and made him her place;
+And when in his fair parts she did abide,
+She was new lodged and newly deified.
+
+'His browny locks did hang in crooked curls;
+And every light occasion of the wind
+Upon his lips their silken parcels hurls.
+What's sweet to do, to do will aptly find:
+Each eye that saw him did enchant the mind,
+For on his visage was in little drawn
+What largeness thinks in Paradise was sawn.
+
+'Small show of man was yet upon his chin;
+His phoenix down began but to appear
+Like unshorn velvet on that termless skin
+Whose bare out-bragg'd the web it seem'd to wear:
+Yet show'd his visage by that cost more dear;
+And nice affections wavering stood in doubt
+If best were as it was, or best without.
+
+'His qualities were beauteous as his form,
+For maiden-tongued he was, and thereof free;
+Yet, if men moved him, was he such a storm
+As oft 'twixt May and April is to see,
+When winds breathe sweet, untidy though they be.
+His rudeness so with his authorized youth
+Did livery falseness in a pride of truth.
+
+'Well could he ride, and often men would say
+'That horse his mettle from his rider takes:
+Proud of subjection, noble by the sway,
+What rounds, what bounds, what course, what stop
+he makes!'
+And controversy hence a question takes,
+Whether the horse by him became his deed,
+Or he his manage by the well-doing steed.
+
+'But quickly on this side the verdict went:
+His real habitude gave life and grace
+To appertainings and to ornament,
+Accomplish'd in himself, not in his case:
+All aids, themselves made fairer by their place,
+Came for additions; yet their purposed trim
+Pieced not his grace, but were all graced by him.
+
+'So on the tip of his subduing tongue
+All kinds of arguments and question deep,
+All replication prompt, and reason strong,
+For his advantage still did wake and sleep:
+To make the weeper laugh, the laugher weep,
+He had the dialect and different skill,
+Catching all passions in his craft of will:
+
+'That he did in the general bosom reign
+Of young, of old; and sexes both enchanted,
+To dwell with him in thoughts, or to remain
+In personal duty, following where he haunted:
+Consents bewitch'd, ere he desire, have granted;
+And dialogued for him what he would say,
+Ask'd their own wills, and made their wills obey.
+
+'Many there were that did his picture get,
+To serve their eyes, and in it put their mind;
+Like fools that in th' imagination set
+The goodly objects which abroad they find
+Of lands and mansions, theirs in thought assign'd;
+And labouring in moe pleasures to bestow them
+Than the true gouty landlord which doth owe them:
+
+'So many have, that never touch'd his hand,
+Sweetly supposed them mistress of his heart.
+My woeful self, that did in freedom stand,
+And was my own fee-simple, not in part,
+What with his art in youth, and youth in art,
+Threw my affections in his charmed power,
+Reserved the stalk and gave him all my flower.
+
+'Yet did I not, as some my equals did,
+Demand of him, nor being desired yielded;
+Finding myself in honour so forbid,
+With safest distance I mine honour shielded:
+Experience for me many bulwarks builded
+Of proofs new-bleeding, which remain'd the foil
+Of this false jewel, and his amorous spoil.
+
+'But, ah, who ever shunn'd by precedent
+The destined ill she must herself assay?
+Or forced examples, 'gainst her own content,
+To put the by-past perils in her way?
+Counsel may stop awhile what will not stay;
+For when we rage, advice is often seen
+By blunting us to make our wits more keen.
+
+'Nor gives it satisfaction to our blood,
+That we must curb it upon others' proof;
+To be forbod the sweets that seem so good,
+For fear of harms that preach in our behoof.
+O appetite, from judgment stand aloof!
+The one a palate hath that needs will taste,
+Though Reason weep, and cry, 'It is thy last.'
+
+'For further I could say 'This man's untrue,'
+And knew the patterns of his foul beguiling;
+Heard where his plants in others' orchards grew,
+Saw how deceits were gilded in his smiling;
+Knew vows were ever brokers to defiling;
+Thought characters and words merely but art,
+And bastards of his foul adulterate heart.
+
+'And long upon these terms I held my city,
+Till thus he gan besiege me: 'Gentle maid,
+Have of my suffering youth some feeling pity,
+And be not of my holy vows afraid:
+That's to ye sworn to none was ever said;
+For feasts of love I have been call'd unto,
+Till now did ne'er invite, nor never woo.
+
+''All my offences that abroad you see
+Are errors of the blood, none of the mind;
+Love made them not: with acture they may be,
+Where neither party is nor true nor kind:
+They sought their shame that so their shame did find;
+And so much less of shame in me remains,
+By how much of me their reproach contains.
+
+''Among the many that mine eyes have seen,
+Not one whose flame my heart so much as warm'd,
+Or my affection put to the smallest teen,
+Or any of my leisures ever charm'd:
+Harm have I done to them, but ne'er was harm'd;
+Kept hearts in liveries, but mine own was free,
+And reign'd, commanding in his monarchy.
+
+''Look here, what tributes wounded fancies sent me,
+Of paled pearls and rubies red as blood;
+Figuring that they their passions likewise lent me
+Of grief and blushes, aptly understood
+In bloodless white and the encrimson'd mood;
+Effects of terror and dear modesty,
+Encamp'd in hearts, but fighting outwardly.
+
+''And, lo, behold these talents of their hair,
+With twisted metal amorously impleach'd,
+I have received from many a several fair,
+Their kind acceptance weepingly beseech'd,
+With the annexions of fair gems enrich'd,
+And deep-brain'd sonnets that did amplify
+Each stone's dear nature, worth, and quality.
+
+''The diamond,--why, 'twas beautiful and hard,
+Whereto his invised properties did tend;
+The deep-green emerald, in whose fresh regard
+Weak sights their sickly radiance do amend;
+The heaven-hued sapphire and the opal blend
+With objects manifold: each several stone,
+With wit well blazon'd, smiled or made some moan.
+
+''Lo, all these trophies of affections hot,
+Of pensived and subdued desires the tender,
+Nature hath charged me that I hoard them not,
+But yield them up where I myself must render,
+That is, to you, my origin and ender;
+For these, of force, must your oblations be,
+Since I their altar, you enpatron me.
+
+''O, then, advance of yours that phraseless hand,
+Whose white weighs down the airy scale of praise;
+Take all these similes to your own command,
+Hallow'd with sighs that burning lungs did raise;
+What me your minister, for you obeys,
+Works under you; and to your audit comes
+Their distract parcels in combined sums.
+
+''Lo, this device was sent me from a nun,
+Or sister sanctified, of holiest note;
+Which late her noble suit in court did shun,
+Whose rarest havings made the blossoms dote;
+For she was sought by spirits of richest coat,
+But kept cold distance, and did thence remove,
+To spend her living in eternal love.
+
+''But, O my sweet, what labour is't to leave
+The thing we have not, mastering what not strives,
+Playing the place which did no form receive,
+Playing patient sports in unconstrained gyves?
+She that her fame so to herself contrives,
+The scars of battle 'scapeth by the flight,
+And makes her absence valiant, not her might.
+
+''O, pardon me, in that my boast is true:
+The accident which brought me to her eye
+Upon the moment did her force subdue,
+And now she would the caged cloister fly:
+Religious love put out Religion's eye:
+Not to be tempted, would she be immured,
+And now, to tempt, all liberty procured.
+
+''How mighty then you are, O, hear me tell!
+The broken bosoms that to me belong
+Have emptied all their fountains in my well,
+And mine I pour your ocean all among:
+I strong o'er them, and you o'er me being strong,
+Must for your victory us all congest,
+As compound love to physic your cold breast.
+
+''My parts had power to charm a sacred nun,
+Who, disciplined, ay, dieted in grace,
+Believed her eyes when they to assail begun,
+All vows and consecrations giving place:
+O most potential love! vow, bond, nor space,
+In thee hath neither sting, knot, nor confine,
+For thou art all, and all things else are thine.
+
+''When thou impressest, what are precepts worth
+Of stale example? When thou wilt inflame,
+How coldly those impediments stand forth
+Of wealth, of filial fear, law, kindred, fame!
+Love's arms are peace, 'gainst rule, 'gainst sense,
+'gainst shame,
+And sweetens, in the suffering pangs it bears,
+The aloes of all forces, shocks, and fears.
+
+''Now all these hearts that do on mine depend,
+Feeling it break, with bleeding groans they pine;
+And supplicant their sighs to you extend,
+To leave the battery that you make 'gainst mine,
+Lending soft audience to my sweet design,
+And credent soul to that strong-bonded oath
+That shall prefer and undertake my troth.'
+
+'This said, his watery eyes he did dismount,
+Whose sights till then were levell'd on my face;
+Each cheek a river running from a fount
+With brinish current downward flow'd apace:
+O, how the channel to the stream gave grace!
+Who glazed with crystal gate the glowing roses
+That flame through water which their hue encloses.
+
+'O father, what a hell of witchcraft lies
+In the small orb of one particular tear!
+But with the inundation of the eyes
+What rocky heart to water will not wear?
+What breast so cold that is not warmed here?
+O cleft effect! cold modesty, hot wrath,
+Both fire from hence and chill extincture hath.
+
+'For, lo, his passion, but an art of craft,
+Even there resolved my reason into tears;
+There my white stole of chastity I daff'd,
+Shook off my sober guards and civil fears;
+Appear to him, as he to me appears,
+All melting; though our drops this difference bore,
+His poison'd me, and mine did him restore.
+
+'In him a plenitude of subtle matter,
+Applied to cautels, all strange forms receives,
+Of burning blushes, or of weeping water,
+Or swooning paleness; and he takes and leaves,
+In either's aptness, as it best deceives,
+To blush at speeches rank to weep at woes,
+Or to turn white and swoon at tragic shows.
+
+'That not a heart which in his level came
+Could 'scape the hail of his all-hurting aim,
+Showing fair nature is both kind and tame;
+And, veil'd in them, did win whom he would maim:
+Against the thing he sought he would exclaim;
+When he most burn'd in heart-wish'd luxury,
+He preach'd pure maid, and praised cold chastity.
+
+'Thus merely with the garment of a Grace
+The naked and concealed fiend he cover'd;
+That th' unexperient gave the tempter place,
+Which like a cherubin above them hover'd.
+Who, young and simple, would not be so lover'd?
+Ay me! I fell; and yet do question make
+What I should do again for such a sake.
+
+'O, that infected moisture of his eye,
+O, that false fire which in his cheek so glow'd,
+O, that forced thunder from his heart did fly,
+O, that sad breath his spongy lungs bestow'd,
+O, all that borrow'd motion seeming owed,
+Would yet again betray the fore-betray'd,
+And new pervert a reconciled maid!'