Received-SPF: pass (sog-mx-1.v43.ch3.sourceforge.com: domain of gmail.com
	designates 209.85.214.179 as permitted sender)
	client-ip=209.85.214.179; envelope-from=mh.in.england@gmail.com;
	helo=mail-ob0-f179.google.com; 
MIME-Version: 1.0
Sender: mh.in.england@gmail.com
Date: Tue, 5 Aug 2014 17:00:10 +0200
Message-ID: <CANEZrP1mU6iS6NRyK6iJtg4BEQ3nQRFc-dVwaOd+P_NFThqxjw@mail.gmail.com>
From: Mike Hearn <mike@plan99.net>
To: Bitcoin Dev <bitcoin-development@lists.sourceforge.net>
Content-Type: multipart/alternative; boundary=001a11c29966afe34e04ffe31cdf
Subject: [Bitcoin-development] How to create a pull tester JAR
Precedence: list

--001a11c29966afe34e04ffe31cdf
Content-Type: text/plain; charset=UTF-8

I just checked in a change to bitcoinj git master that makes it much easier
to create a pull tester jar. Here are instructions for how to do it.

You will need:

   - A Java Development Kit (JDK), version 6 or up should work. As Java 6
   was released eight years ago, this should not be a challenging requirement.
   If you have a Mac just running "java" from the command line should give you
   a GUI prompt to install it automatically. Otherwise apt-get or fetch the
   latest from the interwebs.

   - Apache Maven. This is a rough equivalent of autotools, except it does
   dependency resolution for you. Grab it from
   http://maven.apache.org/download.cgi then unzip it and make sure the bin
   directory is in your PATH. You may need to set the JAVA_HOME environment
   variable if you installed Java to an odd place.

   - git

Make sure you can run "javac" from the command line, then make sure you can
run "mvn", it should complain it can't find a POM (this is a build config
file) and not, say, that it can't find Java.

Now grab bitcoinj from git master:

git clone https://github.com/bitcoinj/bitcoinj.git

... and build ....

cd bitcoinj
mvn -DskipTests package

It will go off and download the libraries needed, compile, and create a
bundled executable JAR called core/target/pull-tests.jar. This is sort of
analogous to static linking in the Java world. It should be fast - expect a
full build plus downloads to take less than a minute. You can use it either
with the QA scripts in the bitcoin core qa/pull-tester directory or just
run things directly:

./bitcoind -regtest -connect=0.0.0.0 -listen -whitelist=127.0.0.1
-datadir=/tmp/pulltester
java -jar core/target/pull-tests.jar

It should go ahead and print lots of debug spew, then at the end say it's
happy.

Let me know if you encounter any problems with this.

Java JARs (which are just zip files renamed) are easily reproduced if you
use the same version of javac and the same bitcoinj version. The ZIP
container has timestamps, but unzipping them and simply diffing the files
between two builds should reveal no differences. I am happy to provide a
pull-tests.jar from my local machine if anyone would like to do this.

--001a11c29966afe34e04ffe31cdf
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">I just checked in a change to bitcoinj git master that mak=
es it much easier to create a pull tester jar. Here are instructions for ho=
w to do it.<div><br></div><div>You will need:</div><div><ul><li>A Java Deve=
lopment Kit (JDK), version 6 or up should work. As Java 6 was released eigh=
t years ago, this should not be a challenging requirement. If you have a Ma=
c just running &quot;java&quot; from the command line should give you a GUI=
 prompt to install it automatically. Otherwise apt-get or fetch the latest =
from the interwebs.<br>
<br></li><li>Apache Maven. This is a rough equivalent of autotools, except =
it does dependency resolution for you. Grab it from=C2=A0<a href=3D"http://=
maven.apache.org/download.cgi">http://maven.apache.org/download.cgi</a> the=
n unzip it and make sure the bin directory is in your PATH. You may need to=
 set the JAVA_HOME environment variable if you installed Java to an odd pla=
ce.<br>
<br></li><li>git</li></ul></div><div>Make sure you can run &quot;javac&quot=
; from the command line, then make sure you can run &quot;mvn&quot;, it sho=
uld complain it can&#39;t find a POM (this is a build config file) and not,=
 say, that it can&#39;t find Java.</div>
<div><br></div><div>Now grab bitcoinj from git master:</div><div><br></div>=
<div><font face=3D"courier new, monospace">git clone=C2=A0<a href=3D"https:=
//github.com/bitcoinj/bitcoinj.git">https://github.com/bitcoinj/bitcoinj.gi=
t</a></font></div>
<div><br></div><div>... and build ....</div><div><br></div><div><font face=
=3D"courier new, monospace">cd bitcoinj</font></div><div><font face=3D"cour=
ier new, monospace">mvn -DskipTests package</font></div><div><br></div><div=
>
It will go off and download the libraries needed, compile, and create a bun=
dled executable JAR called core/target/pull-tests.jar. This is sort of anal=
ogous to static linking in the Java world. It should be fast - expect a ful=
l build plus downloads to take less than a minute. You can use it either wi=
th the QA scripts in the bitcoin core qa/pull-tester directory or just run =
things directly:</div>
<div><br></div><div><font face=3D"courier new, monospace">./bitcoind -regte=
st -connect=3D0.0.0.0 -listen -whitelist=3D127.0.0.1 -datadir=3D/tmp/pullte=
ster</font></div><div><font face=3D"courier new, monospace">java -jar core/=
target/pull-tests.jar</font></div>
<div><br></div><div>It should go ahead and print lots of debug spew, then a=
t the end say it&#39;s happy.</div><div><br></div><div>Let me know if you e=
ncounter any problems with this.</div><div><br></div><div>Java JARs (which =
are just zip files renamed) are easily reproduced if you use the same versi=
on of javac and the same bitcoinj version. The ZIP container has timestamps=
, but unzipping them and simply diffing the files between two builds should=
 reveal no differences. I am happy to provide a pull-tests.jar from my loca=
l machine if anyone would like to do this.</div>
</div>

--001a11c29966afe34e04ffe31cdf--