hglib 0.1.pre20180129173049

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: afdee42722ca60142d6bb0ebffa22802d2aa881e83a16669f085cd3af24c4cf2
+  data.tar.gz: d1cbac7bd6ac25ef43a3d58ff0097244c108ca22146819a8bf867224e517e81f
+SHA512:
+  metadata.gz: 1a8e70e26c53215b1036b8d7acfc7543f25e5f49c1180d7a6dcfd481c1ea3b376dbe454ce6399a40ffd3f3f4731546bbe6de0b7f9916c69d46b811cb3c311343
+  data.tar.gz: f80807c638195e83f14e4429c6df1aa886bddc9c14979e97713fd8bcfed553c3b5684884f64985179a959cfefe155cd3f2b3cdcf817d1841ecedf4d090f76796

data/.simplecov

@@ -0,0 +1,9 @@
+# Simplecov config
+
+SimpleCov.start do
+	add_filter 'spec'
+	add_filter 'integration'
+	add_group "Needing tests" do |file|
+		file.covered_percent < 90
+	end
+end

data/ChangeLog

@@ -0,0 +1,13 @@
+2018-01-24  Michael Granger  <ged@FaerieMUD.org>
+
+	* .ruby-version:
+	Make ruby-version less specific
+	[81f357f730d9] [tip]
+
+	* .document, .editorconfig, .gems, .hg_archival.txt, .hgignore,
+	.pryrc, .rdoc_options, .ruby-gemset, .ruby-version, .simplecov,
+	Gemfile, History.md, LICENSE.txt, Manifest.txt, README.md, Rakefile,
+	certs/ged.pem, lib/hglib.rb, spec/hglib_spec.rb,
+	spec/spec_helper.rb:
+	Initial commit.
+	[d6c97f99b012]

data/History.md

@@ -0,0 +1,4 @@
+## v0.0.1 [YYYY-MM-DD] Michael Granger <ged@FaerieMUD.org>
+
+Initial release.
+

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2018 Michael Granger
+
+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/Manifest.txt

@@ -0,0 +1,10 @@
+.simplecov
+ChangeLog
+History.md
+LICENSE.txt
+Manifest.txt
+README.md
+Rakefile
+lib/hglib.rb
+spec/hglib_spec.rb
+spec/spec_helper.rb

data/README.md

@@ -0,0 +1,82 @@
+# hglib
+
+home
+: http://bitbucket.org/ged/ruby-hglib
+
+code
+: http://bitbucket.org/ged/ruby-hglib
+
+github
+: https://github.com/ged/ruby-hglib
+
+docs
+: http://deveiate.org/code/hglib
+
+
+## Description
+
+This is a client library for the Mercurial distributed revision control tool
+that uses the [Command Server][cmdserver] for efficiency.
+
+
+### Examples
+
+
+
+## Prerequisites
+
+* Ruby
+
+
+## Installation
+
+    $ gem install hglib
+
+
+## Contributing
+
+You can check out the current development source with Mercurial via its
+[project page](http://bitbucket.org/ged/ruby-hglib). Or if you prefer Git, via
+[its Github mirror](https://github.com/ged/ruby-hglib).
+
+After checking out the source, run:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the API documentation.
+
+
+## License
+
+Copyright (c) 2018, Michael Granger
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author/s, nor the names of the project's
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+[cmdserver]:https://www.mercurial-scm.org/wiki/CommandServer
+

data/Rakefile

@@ -0,0 +1,99 @@
+#!/usr/bin/env rake
+
+begin
+	require 'hoe'
+rescue LoadError
+	abort "This Rakefile requires hoe (gem install hoe)"
+end
+
+GEMSPEC = 'hglib.gemspec'
+
+
+Hoe.plugin :mercurial
+Hoe.plugin :signing
+Hoe.plugin :deveiate
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugins.delete :gemcutter # Remove for public gems
+
+hoespec = Hoe.spec 'hglib' do |spec|
+	spec.readme_file = 'README.md'
+	spec.history_file = 'History.md'
+
+	spec.extra_rdoc_files = FileList[ '*.rdoc', '*.md' ]
+	spec.license 'BSD-3-Clause'
+
+	spec.urls = {
+		home:   'http://deveiate.org/projects/hglib',
+		code:   'http://bitbucket.org/ged/hglib',
+		docs:   'http://deveiate.org/code/hglib',
+		github: 'http://github.com/ged/hglib',
+	}
+
+	spec.developer 'Michael Granger', 'ged@FaerieMUD.org'
+
+	spec.dependency 'loggability', '~> 0.11'
+
+	spec.dependency 'hoe-deveiate',            '~> 0.10', :developer
+	spec.dependency 'simplecov',               '~> 0.7', :developer
+	spec.dependency 'rdoc-generator-fivefish', '~> 0.1', :developer
+	spec.dependency 'rdoc',                    '~> 6.0', :developer
+
+	spec.require_ruby_version( '>=2.5.0' )
+	spec.hg_sign_tags = true if spec.respond_to?( :hg_sign_tags= )
+	spec.check_history_on_release = true if spec.respond_to?( :check_history_on_release= )
+
+	self.rdoc_locations << "deveiate:/usr/local/www/public/code/#{remote_rdoc_dir}"
+end
+
+
+ENV['VERSION'] ||= hoespec.spec.version.to_s
+
+# Run the tests before checking in
+task 'hg:precheckin' => [ :check_history, :check_manifest, :gemspec, :spec ]
+
+task :test => :spec
+
+# Rebuild the ChangeLog immediately before release
+task :prerelease => 'ChangeLog'
+CLOBBER.include( 'ChangeLog' )
+
+desc "Build a coverage report"
+task :coverage do
+	ENV["COVERAGE"] = 'yes'
+	Rake::Task[:spec].invoke
+end
+CLOBBER.include( 'coverage' )
+
+
+# Use the fivefish formatter for docs generated from development checkout
+if File.directory?( '.hg' )
+	require 'rdoc/task'
+
+	Rake::Task[ 'docs' ].clear
+	RDoc::Task.new( 'docs' ) do |rdoc|
+	    rdoc.main = "README.rdoc"
+		rdoc.markup = 'markdown'
+	    rdoc.rdoc_files.include( "*.rdoc", "ChangeLog", "lib/**/*.rb" )
+	    rdoc.generator = :fivefish
+		rdoc.title = 'hglib'
+	    rdoc.rdoc_dir = 'doc'
+	end
+end
+
+task :gemspec => GEMSPEC
+file GEMSPEC => __FILE__
+task GEMSPEC do |task|
+	spec = $hoespec.spec
+	spec.files.delete( '.gemtest' )
+	spec.signing_key = nil
+	spec.cert_chain = ['certs/ged.pem']
+	spec.version = "#{spec.version.bump}.pre#{Time.now.strftime("%Y%m%d%H%M%S")}"
+	File.open( task.name, 'w' ) do |fh|
+		fh.write( spec.to_ruby )
+	end
+end
+CLOBBER.include( GEMSPEC.to_s )
+
+task :default => :gemspec
+

data/lib/hglib.rb

@@ -0,0 +1,81 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'e2mmap'
+require 'loggability'
+require 'pathname'
+
+
+# Toplevel namespace
+module Hglib
+	extend Loggability,
+	       Exception2MessageMapper
+
+	# Package version
+	VERSION = '0.0.1'
+
+	# Version control revision
+	REVISION = %q$Revision: a366819bd05b $
+
+	# The default path to the `hg` command
+	DEFAULT_HG_PATH = begin
+		paths = ENV['PATH'].
+			split( File::PATH_SEPARATOR ).
+			map {|dir| Pathname(dir) + 'hg' }
+
+		paths.find( &:executable? ) || Pathname( '/usr/bin/hg' )
+	end
+
+
+	# Base exception class for errors raised by this library
+	def_exception :Error, "hglib error"
+	def_exception :CommandError, "error in hg command", Hglib::Error
+
+	# Loggability API -- set up a Logger for Hglib objects
+	log_as :hglib
+
+
+	### Return the currently-configured path to the `hg` binary./
+	def self::hg_path
+		return @hg_path ||= DEFAULT_HG_PATH
+	end
+
+
+	### Set the path to the `hg` binary that will be used for any new commands.
+	def self::hg_path=( new_path )
+		@hg_path = Pathname( new_path )
+	end
+
+
+	# Set up automatic loading of submodules
+	autoload :Server, 'hglib/server'
+	autoload :Repo, 'hglib/repo'
+
+
+	### Return an Hglib::Server set to use the current ::hg_path, creating one if
+	### necessary.
+	def self::server( repo='.' )
+		@hg_servers ||= {}
+		return @hg_servers[ repo ] ||= Hglib::Server.new( repo )
+	end
+
+
+	### Return an Hglib::Repo object for the specified +path+.
+	def self::repo( path='.' )
+		return Hglib::Repo.new( path )
+	end
+
+
+	### Clone the +remote_repo+ to the specified +local_dir+, which defaults to a
+	### directory with the basename of the +remote_repo+ in the current working
+	### directory.
+	def self::clone( remote_repo, local_dir=nil )
+		output = self.server( nil ).run( :clone, remote_repo, local_dir )
+		self.log.debug "Clone output: %s" % [ output ]
+
+		local_dir ||= Pathname.pwd + File.basename( remote_repo )
+		return self.repo( local_dir )
+	end
+
+end # module Hglib
+

data/spec/hglib_spec.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env rspec -cfd
+
+require_relative 'spec_helper'
+
+require 'hglib'
+
+
+RSpec.describe Hglib do
+
+	before( :each ) do
+		@real_hg_path = described_class.hg_path
+	end
+
+	after( :each ) do
+		described_class.hg_path = @real_hg_path
+	end
+
+
+	describe "binary path" do
+
+		it "has a default" do
+			expect( described_class::DEFAULT_HG_PATH ).to be_a( Pathname )
+			expect( described_class::DEFAULT_HG_PATH.to_s ).to end_with( '/hg' )
+		end
+
+
+		it "can be configured to use a different hg binary" do
+			expect {
+				described_class.hg_path = '/somewhere/else/hg'
+			}.to change { described_class.hg_path }
+		end
+
+	end
+
+
+	describe "server" do
+
+		it "can create a server object" do
+			expect( described_class.server ).to be_a( Hglib::Server )
+			expect( described_class.server ).to equal( described_class.server )
+			expect( described_class.server.repo ).to eq( Pathname('.') )
+		end
+
+	end
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+# -*- ruby -*-
+#encoding: utf-8
+
+require 'simplecov' if ENV['COVERAGE']
+require 'rspec'
+
+require 'hglib'
+
+RSpec.configure do |config|
+	config.expect_with :rspec do |expectations|
+		expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+	end
+
+	config.mock_with :rspec do |mocks|
+		mocks.verify_partial_doubles = true
+	end
+
+	config.shared_context_metadata_behavior = :apply_to_host_groups
+	config.filter_run_when_matching :focus
+	config.example_status_persistence_file_path = "spec/.status"
+	config.disable_monkey_patching!
+	config.warnings = true
+	config.profile_examples = 10
+	config.order = :random
+
+	config.filter_run_excluding( :requires_binary ) unless Hglib.hg_path.executable?
+
+	Kernel.srand( config.seed )
+end

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: hglib
+version: !ruby/object:Gem::Version
+  version: 0.1.pre20180129173049
+platform: ruby
+authors:
+- Michael Granger
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEbDCCAtSgAwIBAgIBATANBgkqhkiG9w0BAQUFADA+MQwwCgYDVQQDDANnZWQx
+  GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
+  HhcNMTcwOTI3MDAzMDQ0WhcNMTgwOTI3MDAzMDQ0WjA+MQwwCgYDVQQDDANnZWQx
+  GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
+  ggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC/JWGRHO+USzR97vXjkFgt
+  83qeNf2KHkcvrRTSnR64i6um/ziin0I0oX23H7VYrDJC9A/uoUa5nGRJS5Zw/+wW
+  ENcvWVZS4iUzi4dsYJGY6yEOsXh2CcF46+QevV8iE+UmbkU75V7Dy1JCaUOyizEt
+  TH5UHsOtUU7k9TYARt/TgYZKuaoAMZZd5qyVqhF1vV+7/Qzmp89NGflXf2xYP26a
+  4MAX2qqKX/FKXqmFO+AGsbwYTEds1mksBF3fGsFgsQWxftG8GfZQ9+Cyu2+l1eOw
+  cZ+lPcg834G9DrqW2zhqUoLr1MTly4pqxYGb7XoDhoR7dd1kFE2a067+DzWC/ADt
+  +QkcqWUm5oh1fN0eqr7NsZlVJDulFgdiiYPQiIN7UNsii4Wc9aZqBoGcYfBeQNPZ
+  soo/6za/bWajOKUmDhpqvaiRv9EDpVLzuj53uDoukMMwxCMfgb04+ckQ0t2G7wqc
+  /D+K9JW9DDs3Yjgv9k4h7YMhW5gftosd+NkNC/+Y2CkCAwEAAaN1MHMwCQYDVR0T
+  BAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFHKN/nkRusdqCJEuq3lgB3fJvyTg
+  MBwGA1UdEQQVMBOBEWdlZEBGYWVyaWVNVUQub3JnMBwGA1UdEgQVMBOBEWdlZEBG
+  YWVyaWVNVUQub3JnMA0GCSqGSIb3DQEBBQUAA4IBgQB/qyi5pCjK8ceoKalfVAjS
+  vG64FEnLnD1bm39T5UaFIRmo+abZtfpg2QhwKvPbPjOicau2+m+MDQ2Cc3tgyaC3
+  dZxcP6w8APFg4AId09uWAZKf0xajvBMS2aOz8Bbmag6fwqRRkTMqsNYnmqcF7aRT
+  DuEzbEMfaOUYjU9RuB48vr4q8yRft0ww+3jq5iwNkrX1buL2pwBbyvgms6D/BV41
+  MaTVMjsHqJUwU2xVfhGtxGAWAer5S1HGYHkbio6mGVtiie0uWjmnzi7ppIlMr48a
+  7BNTsoZ+/JRk3iQWmmNsyFT7xfqBKye7cH11BX8V8P4MeGB5YWlMI+Myj5DZY3fQ
+  st2AGD4rb1l0ia7PfubcBThSIdz61eCb8gRi/RiZZwb3/7+eyEncLJzt2Ob9fGSF
+  X0qdrKi+2aZZ0NGuFj9AItBsVmAvkBGIpX4TEKQp5haEbPpmaqO5nIIhV26PXmyT
+  OMKv6pWsoS81vw5KAGBmfX8nht/Py90DQrbRvakATGI=
+  -----END CERTIFICATE-----
+date: 2018-01-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: loggability
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: hoe-mercurial
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: hoe-deveiate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: hoe-highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc-generator-fivefish
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+description: |-
+  This is a client library for the Mercurial distributed revision control tool
+  that uses the [Command Server][cmdserver] for efficiency.
+email:
+- ged@FaerieMUD.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+files:
+- ".simplecov"
+- ChangeLog
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/hglib.rb
+- spec/hglib_spec.rb
+- spec/spec_helper.rb
+homepage: http://deveiate.org/projects/hglib
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.4
+signing_key: 
+specification_version: 4
+summary: This is a client library for the Mercurial distributed revision control tool
+  that uses the [Command Server][cmdserver] for efficiency.
+test_files: []