fossgit 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ff8a4c882972941862c63ab14c1a6a7612523c3e
+  data.tar.gz: f7057fc31c57762a4d3ff715a66a8c0a9ef23eb8
+SHA512:
+  metadata.gz: 46fc13e318b8ae5bcf8303e2f6ea6e6868894c3537d5eeed767a8f98fda325af781a3ff8dfc4de111da9001f9542830772db02258abaec5e63e968d99da4bc77
+  data.tar.gz: 065d66e51b3073b7cec46bc8bbf238a555a5af678634f1b45d568ad558e47d84502a5faa73a3a6e8a59fbea3bd34b51fbd6a4bd627cfea4fc2baeb8c0354be09

data/LICENSE

@@ -0,0 +1,35 @@
+FossGit: Copyright 2016 Chad Perrin, released under the terms of version 0.4 of
+the Copyfree Open Innovation License.
+
+## Terms and Conditions
+
+Redistributions, modified or unmodified, in whole or in part, must retain
+applicable copyright or other legal privilege notices, these conditions, and
+the following license terms and disclaimer.  Subject to these conditions, the
+holder(s) of copyright or other legal privileges, author(s) or assembler(s),
+and contributors of this work hereby grant to any person who obtains a copy of
+this work in any form:
+
+1. Permission to reproduce, modify, distribute, publish, sell, sublicense, use,
+and/or otherwise deal in the licensed material without restriction.
+
+2. A perpetual, worldwide, non-exclusive, royalty-free, irrevocable patent
+license to reproduce, modify, distribute, publish, sell, use, and/or otherwise
+deal in the licensed material without restriction, for any and all patents:
+
+    a. Held presently or in the future by each such holder of copyright or
+    other legal privilege, author or assembler, or contributor, necessarily
+    infringed by the contributions alone or by combination with the work, of
+    that privilege holder, author or assembler, or contributor.
+
+    b. Necessarily infringed by the work at the time that holder of copyright
+    or other privilege, author or assembler, or contributor made any
+    contribution to the work.
+
+NO WARRANTY OF ANY KIND IS IMPLIED BY, OR SHOULD BE INFERRED FROM, THIS LICENSE
+OR THE ACT OF DISTRIBUTION UNDER THE TERMS OF THIS LICENSE, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+AND NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS, ASSEMBLERS, OR HOLDERS OF
+COPYRIGHT OR OTHER LEGAL PRIVILEGE BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN ACTION OF CONTRACT, TORT, OR OTHERWISE ARISING FROM, OUT
+OF, OR IN CONNECTION WITH THE WORK OR THE USE OF OR OTHER DEALINGS IN THE WORK.

data/README.md

@@ -0,0 +1,57 @@
+# fossgit
+
+This is a simple command line utility for creating and updating Git
+repositories as (one-way) mirrors of Fossil repositories.
+
+## Installation
+
+Clone it from the [Fossil repository](https://fossrec.com/u/apotheon/fossgit/)
+or the [GitHub mirror](https://github.com/apotheon/fossgit/).
+
+Copy the `fossgit` file to a directory in your execution path, create a symlink
+or hardlink to the repository's `fossgit` file in a directory in your execution
+path, add its location in this repository to your execution path, or execute it
+by entering the explicit path to the `fossgit` file at a shell prompt.
+
+## Usage
+
+With an open checkout of your Fossil repository:
+
+    $ cd /path/to/open/fossil/checkout
+    $ fossgit /path/to/git/repository
+
+## Dependencies
+
+* Fossil SCM
+* Git
+* a Fossil repository to mirror
+* a Git repository you will use as your mirror
+* an open checkout of the Fossil repository
+
+## Bug Reports And Feature Requests
+
+In order from most preferred to least preferred:
+
+* Add a ticket in the Fossil repository.
+* Add a ticket in the GitHub repository (then I'll copy it to Fossil).
+
+## Roadmap
+
+* Make this a stand-alone Ruby Gem some day, maybe.
+* Add tests, maybe.
+* Add automatic GitHub publishing, maybe.
+* Incorporate this functionality into FossRec, a more comprehensive tool.
+
+## Development
+
+The discerning programmer may look over FossGit in its current form and realize
+it is neither object-oriented nor functional in its design.  It is, in fact, a
+pretty straightforward procedural program, written in Ruby (an odd language to
+use for procedural programming, perhaps).  The reason for this is simple: it is
+in essence a glorified shell script.  There are plans to make it part of a
+larger set of libraries and utilities (see the Roadmap), and it will need to
+undergo a fair bit of redesign as part of that; I expect it to be largely
+unrecognizable by then.
+
+Much of this work was done on Christmas weekend 2016.  That may or may not be
+significant.

data/bin/fossgit

@@ -0,0 +1,158 @@
+#!/usr/bin/env ruby
+require 'fossgit'
+
+@fossil_repository = nil
+
+def mirror_command
+  [fossil_command, sed_command, git_command].join '|'
+end
+
+def sed_command
+  %q{sed 's/^\(committer \+\)\([^ ]\+@[^ ]\+\)\( *<\)\(\w\+\)\(>.*\)$/\1\4\3\2\5/'}
+end
+
+def fossil_command
+  cmd = ['fossil export --git']
+
+  cmd << "--import-marks #{fossil_marks}" if update_export?
+  cmd << "--export-marks #{fossil_marks}"
+  cmd << fossil_repository
+
+  cmd.join ' '
+end
+
+def git_command
+  cmd = ['git fast-import']
+
+  cmd << "--import-marks=#{git_marks}" if update_export?
+  cmd << "--export-marks=#{git_marks}"
+
+  cmd.join ' '
+end
+
+def push_command
+  '; git checkout trunk; git push origin trunk'
+end
+
+def update_export?
+  File.exist? git_marks and File.exist? fossil_marks
+end
+
+def fossil_marks
+  fossil_file 'fossil.marks'
+end
+
+def git_marks
+  fossil_file 'git.marks'
+end
+
+def fossil_file filename
+  File.join fossil_path, filename
+end
+
+def fossil_path
+  get_option '-c' or Dir.pwd
+end
+
+def get_option opt, default=nil
+  ARGV.index(opt).tap do |val|
+    return val ? (ARGV.delete_at val and ARGV.delete_at val) : default
+  end
+end
+
+def option_switch? long_name
+  ARGV.delete "-#{long_name[0]}" or ARGV.delete "--#{long_name}"
+end
+
+def fossil_repository
+  idregex = /^repository: +/
+
+  @fossil_repository ||= File.absolute_path(
+    `fossil status`.split(/\n/).select do |line|
+      line.match idregex
+    end.first.sub idregex, ''
+  )
+end
+
+name = File.basename $0
+
+help = <<-EOF
+
+  FossGit provides a simple tool for creating Git mirrors of Fossil
+  repositories.  To use it, you need:
+  
+  1. both Fossil SCM and Git installed
+  2. a Fossil repository to mirror with an open checkout
+  3. a Git repository to use as a mirror
+
+  USAGE:  #{name} -h
+          #{name} [-c <CHECKOUT>] [-l] <GITREPO>
+          #{name} -t
+
+      By default, when exporting to local Git repository GITREPO, #{name}
+      attempts to push updates to a configured upstream Git repository.  It
+      harmlessly fails to push if no upstream repository is configured for the
+      local Git repository.
+
+  OPTIONS/ARGUMENTS:
+
+      -h              Display this help text and exit, ignoring all other
+                      arguments.
+
+      -c CHECKOUT     Specify the location of your Fossil repository's open
+                      checkout, CHECKOUT.  This is optional; you may simply use
+                      this tool from within an open checkout of your Fossil
+                      repository instead.
+
+      -l              Perform local-only mirror operations, without trying to
+                      push Git updates to a remote repository.  By default,
+                      #{name} tries to push to an upstream Git repository
+                      whenever it exports from Fossil to Git.
+
+      -t              Dump export to STDOUT rather than sending it to Git.
+                      This overrides the `-l` option and GITREPO argument, if
+                      present.
+
+      GITREPO         Specify the location of your local Git repository.
+
+  EXAMPLES:
+
+      $ fossgit -h
+
+      $ fossgit -c ~/fossil_checkouts/projectname ~/git/projectname
+
+      $ cd ~/fossil_checkouts/projectname && fossgit ~/git/projectname
+
+EOF
+
+if option_switch? 'help'
+  puts help
+  exit
+elsif option_switch? 'version'
+  puts [name, FossGit.version].join ' '
+elsif option_switch? 'text-export'
+  puts `#{fossil_command}|#{sed_command}`
+  exit
+else
+  command_line = mirror_command
+  command_line << push_command unless option_switch? 'local'
+
+  git_path = ARGV.shift
+
+  if git_path.to_s.empty?
+    STDERR.puts 'Error!  No Git path provided.'
+    exit!
+  elsif Dir.exist? git_path
+    Dir.chdir git_path
+  else
+    STDERR.puts %Q{Error!  Invalid Git path "#{git_path}" provided.}
+    exit!
+  end
+
+  if system 'git status'
+    system command_line
+  else
+    STDERR.print %Q{Error!  Invalid Git repository "#{Dir.pwd}" provided.}
+    exit!
+  end
+end

data/lib/fossgit.rb

@@ -0,0 +1,5 @@
+class FossGit
+  def self.version
+    '1.0.0'
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: fossgit
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Chad Perrin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-25 00:00:00.000000000 Z
+dependencies: []
+description: |2
+      Maintain a presence in Git hosting for Fossil projects.
+email: code@apotheon.net
+executables:
+- fossgit
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/fossgit
+- lib/fossgit.rb
+homepage: https://fossrec.com/u/apotheon/fossgit
+licenses:
+- COIL
+metadata: {}
+post_install_message: |2
+      Thank you for using FossGit.  For it to work properly, you need to have the
+      following software dependencies installed:
+
+      * Fossil SCM (the world's most decentralized SCM and DVCS)
+      * Git (the world's most popular DVCS)
+      * sed (standard on Unix-like systems)
+
+      Run "fossgit -h" for usage information.
+
+      Version 1.0.0 of FossGit is dedicated to my wife.  Happy holidays.
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: 'FossGit: Mirror Fossil to Git.'
+test_files: []