[CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Jonathan Rochkind

I am a committer, but I have no idea how to do a marc4j release.

There are some fixes in master repo for marc4j. I can find all the parts 
of the source code that seem to have a version number and change them. I 
can make a git tag with the version number.


But what else is entailed, how do people actually get marc4j?  I need to 
update maven repo somehow or something? Anyone?


Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Robert Haschart
I believe that is one of the open issues for Marc4j.   I do not know how 
to push a jar or a new version of a jar to a Maven repo.
I believe Bill Dueber was looking into this just last month when he 
wrote the following to the Solrmarc list:


   I'm trying to get marc4j into maven central, and I don't know who
   owns the domain. If it's one of us, then we can use it. If not,
   well, I'm not sure what we do (except maybe use the github location?)

   -- 
   Bill Dueber

   Library Systems Programmer
   University of Michigan Library

The last release I did was to merely create the jar in the releases 
sub-directory, and reference it in the README.textile file. That 
emulates the way the releases had been done from the tigris.org site, 
but its not the right way to do a release.


-Bob Haschart

On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:

I am a committer, but I have no idea how to do a marc4j release.

There are some fixes in master repo for marc4j. I can find all the 
parts of the source code that seem to have a version number and change 
them. I can make a git tag with the version number.


But what else is entailed, how do people actually get marc4j?  I need 
to update maven repo somehow or something? Anyone?


Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Kevin S. Clarke
I have experience pushing projects into Maven's central repo through
Sonatype.  Maven has a standard structure (that you don't have to use, but
it makes things easier/more-Maven-ish).  Would you want the project
reorganized into that structure in the process?

Kevin



On Wed, Nov 13, 2013 at 5:15 PM, Robert Haschart rh...@virginia.edu wrote:

 I believe that is one of the open issues for Marc4j.   I do not know how
 to push a jar or a new version of a jar to a Maven repo.
 I believe Bill Dueber was looking into this just last month when he wrote
 the following to the Solrmarc list:

I'm trying to get marc4j into maven central, and I don't know who
owns the domain. If it's one of us, then we can use it. If not,
well, I'm not sure what we do (except maybe use the github location?)

--Bill Dueber
Library Systems Programmer
University of Michigan Library

 The last release I did was to merely create the jar in the releases
 sub-directory, and reference it in the README.textile file. That emulates
 the way the releases had been done from the tigris.org site, but its not
 the right way to do a release.

 -Bob Haschart


 On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:

 I am a committer, but I have no idea how to do a marc4j release.

 There are some fixes in master repo for marc4j. I can find all the parts
 of the source code that seem to have a version number and change them. I
 can make a git tag with the version number.

 But what else is entailed, how do people actually get marc4j?  I need to
 update maven repo somehow or something? Anyone?




Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Pottinger, Hardy J.
Hi, I don't know the details of marc4J, but I do know that the Maven
Release Plugin is very very handy for doing Maven releases:

http://maven.apache.org/maven-release/maven-release-plugin/


--
HARDY POTTINGER pottinge...@umsystem.edu
University of Missouri Library Systems
http://lso.umsystem.edu/~pottingerhj/
https://MOspace.umsystem.edu/
Don't undertake a project unless it is manifestly important and nearly
impossible. --Edwin Land





On 11/13/13 4:23 PM, Kevin S. Clarke kscla...@gmail.com wrote:

I have experience pushing projects into Maven's central repo through
Sonatype.  Maven has a standard structure (that you don't have to use, but
it makes things easier/more-Maven-ish).  Would you want the project
reorganized into that structure in the process?

Kevin



On Wed, Nov 13, 2013 at 5:15 PM, Robert Haschart rh...@virginia.edu
wrote:

 I believe that is one of the open issues for Marc4j.   I do not know how
 to push a jar or a new version of a jar to a Maven repo.
 I believe Bill Dueber was looking into this just last month when he
wrote
 the following to the Solrmarc list:

I'm trying to get marc4j into maven central, and I don't know who
owns the domain. If it's one of us, then we can use it. If not,
well, I'm not sure what we do (except maybe use the github location?)

--Bill Dueber
Library Systems Programmer
University of Michigan Library

 The last release I did was to merely create the jar in the releases
 sub-directory, and reference it in the README.textile file. That
emulates
 the way the releases had been done from the tigris.org site, but its not
 the right way to do a release.

 -Bob Haschart


 On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:

 I am a committer, but I have no idea how to do a marc4j release.

 There are some fixes in master repo for marc4j. I can find all the
parts
 of the source code that seem to have a version number and change them.
I
 can make a git tag with the version number.

 But what else is entailed, how do people actually get marc4j?  I need
to
 update maven repo somehow or something? Anyone?




Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Jonathan Rochkind

Okay, thanks Bob.

I guess for the moment I might just keep using Marc4J by building it 
myself from master without doing an official release.


I think that's probably better than halfway doing a release, like 
tagging it in the repo with a release tag, but without doing a proper 
maven release, just confusing everyone.


If anyone wants to take on a bit of release management for Marc4J -- 
sounds like we could use you!  Ie, figuring out how to do it, 
documenting it in the marc4j repo, making any changes to Marc4J source 
repo to make it easier, etc.  Tod Olsen tells me another part of this 
puzzle is making sure the javadocs get re-generated (to where? I have no 
idea!)


Anyone want to help? A bunch of people use marc4j, often through 
downstream dependencies, you'd have many thanks!


Jonathan

On 11/13/13 5:15 PM, Robert Haschart wrote:

I believe that is one of the open issues for Marc4j.   I do not know how
to push a jar or a new version of a jar to a Maven repo.
I believe Bill Dueber was looking into this just last month when he
wrote the following to the Solrmarc list:

I'm trying to get marc4j into maven central, and I don't know who
owns the domain. If it's one of us, then we can use it. If not,
well, I'm not sure what we do (except maybe use the github location?)

--
Bill Dueber
Library Systems Programmer
University of Michigan Library

The last release I did was to merely create the jar in the releases
sub-directory, and reference it in the README.textile file. That
emulates the way the releases had been done from the tigris.org site,
but its not the right way to do a release.

-Bob Haschart

On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:

I am a committer, but I have no idea how to do a marc4j release.

There are some fixes in master repo for marc4j. I can find all the
parts of the source code that seem to have a version number and change
them. I can make a git tag with the version number.

But what else is entailed, how do people actually get marc4j?  I need
to update maven repo somehow or something? Anyone?




Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Jonathan Rochkind

Aha, Kevin!

I'm not sure, would we?  Is that your advice?  Do you have any interest 
in taking this on?


There's possibly no current marc4j committers who understand how it's 
set up now, it's kind of just grown under various people's stewardship, 
I think it's possible nobody has strong opinions as long as it works and 
doens't make marc4j any harder to work with for developers.


(If someone _does_ have understanding and/or strong feelings about how 
marc4j source code is set up (maybe Bob?) then definitely correct me! 
And maybe work with Kevin on figuring out how to do a release?)


Otherwise, Kevin, you interested in getting committer privs and figuring 
out what needs to be done?


On 11/13/13 5:23 PM, Kevin S. Clarke wrote:

I have experience pushing projects into Maven's central repo through
Sonatype.  Maven has a standard structure (that you don't have to use, but
it makes things easier/more-Maven-ish).  Would you want the project
reorganized into that structure in the process?

Kevin



On Wed, Nov 13, 2013 at 5:15 PM, Robert Haschart rh...@virginia.edu wrote:


I believe that is one of the open issues for Marc4j.   I do not know how
to push a jar or a new version of a jar to a Maven repo.
I believe Bill Dueber was looking into this just last month when he wrote
the following to the Solrmarc list:

I'm trying to get marc4j into maven central, and I don't know who
owns the domain. If it's one of us, then we can use it. If not,
well, I'm not sure what we do (except maybe use the github location?)

--Bill Dueber
Library Systems Programmer
University of Michigan Library

The last release I did was to merely create the jar in the releases
sub-directory, and reference it in the README.textile file. That emulates
the way the releases had been done from the tigris.org site, but its not
the right way to do a release.

-Bob Haschart


On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:


I am a committer, but I have no idea how to do a marc4j release.

There are some fixes in master repo for marc4j. I can find all the parts
of the source code that seem to have a version number and change them. I
can make a git tag with the version number.

But what else is entailed, how do people actually get marc4j?  I need to
update maven repo somehow or something? Anyone?








Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Robert Haschart
If you mean re-organize the project so that it corresponds to Maven's 
conventions for doing things, and then relying on Maven to handle 
dependencies and build of the project, no thank you.


My experience with Maven is that it can make things that are already 
easy, a little bit easier, after a fair bit of work, but things that are 
outside its way of looking at the world become much more cumbersome.   
For instance because building Marc4j requires compiling some of the 
code, and then using that code to generate a couple of source files, and 
then compiling those generated files, and then bundling both sets of 
class files to produce the jar, it seemed that to Maven-ify the project 
would require splitting it into to separate projects with complicated 
dependencies between them.


If there is any way you can help with getting releases of Marc4j into 
the central Maven repo that would not require going all in with Maven 
it would be greatly appreciated.


-Bob Haschart

On 11/13/2013 5:52 PM, Jonathan Rochkind wrote:

Aha, Kevin!

I'm not sure, would we?  Is that your advice?  Do you have any 
interest in taking this on?


There's possibly no current marc4j committers who understand how it's 
set up now, it's kind of just grown under various people's 
stewardship, I think it's possible nobody has strong opinions as long 
as it works and doens't make marc4j any harder to work with for 
developers.


(If someone _does_ have understanding and/or strong feelings about how 
marc4j source code is set up (maybe Bob?) then definitely correct me! 
And maybe work with Kevin on figuring out how to do a release?)


Otherwise, Kevin, you interested in getting committer privs and 
figuring out what needs to be done?


On 11/13/13 5:23 PM, Kevin S. Clarke wrote:

I have experience pushing projects into Maven's central repo through
Sonatype.  Maven has a standard structure (that you don't have to 
use, but

it makes things easier/more-Maven-ish).  Would you want the project
reorganized into that structure in the process?

Kevin



On Wed, Nov 13, 2013 at 5:15 PM, Robert Haschart rh...@virginia.edu 
wrote:


I believe that is one of the open issues for Marc4j.   I do not know 
how

to push a jar or a new version of a jar to a Maven repo.
I believe Bill Dueber was looking into this just last month when he 
wrote

the following to the Solrmarc list:

I'm trying to get marc4j into maven central, and I don't know who
owns the domain. If it's one of us, then we can use it. If not,
well, I'm not sure what we do (except maybe use the github 
location?)


--Bill Dueber
Library Systems Programmer
University of Michigan Library

The last release I did was to merely create the jar in the releases
sub-directory, and reference it in the README.textile file. That 
emulates
the way the releases had been done from the tigris.org site, but its 
not

the right way to do a release.

-Bob Haschart


On 11/13/2013 4:43 PM, Jonathan Rochkind wrote:


I am a committer, but I have no idea how to do a marc4j release.

There are some fixes in master repo for marc4j. I can find all the 
parts
of the source code that seem to have a version number and change 
them. I

can make a git tag with the version number.

But what else is entailed, how do people actually get marc4j?  I 
need to

update maven repo somehow or something? Anyone?








Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Kevin S. Clarke
On Wed, Nov 13, 2013 at 6:04 PM, Robert Haschart rh...@virginia.edu wrote:

 If you mean re-organize the project so that it corresponds to Maven's
 conventions for doing things, and then relying on Maven to handle
 dependencies and build of the project, no thank you.


Yes, that's what I meant.


 For instance because building Marc4j requires compiling some of the code,
 and then using that code to generate a couple of source files, and then
 compiling those generated files, and then bundling both sets of class files
 to produce the jar, it seemed that to Maven-ify the project would require
 splitting it into to separate projects with complicated dependencies
 between them.


Not necessarily.  Is this process represented in the Ant build file
currently or are there some docs for it?  I'm not an active MARC4J user so
not aware of the process.  What I might do is Mavenize it (in my own fork)
just for fun.  If what I do looks more complicated to you, no problem... I
will have had my fun and I won't mind it not being picked up.


 If there is any way you can help with getting releases of Marc4j into the
 central Maven repo that would not require going all in with Maven it
 would be greatly appreciated.


I'm sure there is a way to do that, but I'm probably not your guy for that.
 I agree there is a fair amount of work to see things Maven's way but, once
you do, straying from that worldview takes more effort.  Someone else will
probably be better suited than me to take that other path.

Kevin


Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Kevin S. Clarke
On Wed, Nov 13, 2013 at 5:52 PM, Jonathan Rochkind rochk...@jhu.edu wrote:


 I'm not sure, would we?  Is that your advice?


That would be my advice, yes, but I understand Robert's perspective.
 People have strong feelings one way or the other about Maven.


 Otherwise, Kevin, you interested in getting committer privs and figuring
 out what needs to be done?


Maybe I should just tinker in my own fork of it for a bit and see what
comes from it... I'll need to understand the workflow Robert is describing
a bit more.

Kevin


Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Simon Spero
I brought marc4j under ivy; I haven't bothered with the maven  artifact
generation tasks, but that would be the way to go.
On Nov 13, 2013 6:16 PM, Kevin S. Clarke kscla...@gmail.com wrote:

 On Wed, Nov 13, 2013 at 6:04 PM, Robert Haschart rh...@virginia.edu
 wrote:

  If you mean re-organize the project so that it corresponds to Maven's
  conventions for doing things, and then relying on Maven to handle
  dependencies and build of the project, no thank you.
 

 Yes, that's what I meant.


  For instance because building Marc4j requires compiling some of the code,
  and then using that code to generate a couple of source files, and then
  compiling those generated files, and then bundling both sets of class
 files
  to produce the jar, it seemed that to Maven-ify the project would require
  splitting it into to separate projects with complicated dependencies
  between them.
 

 Not necessarily.  Is this process represented in the Ant build file
 currently or are there some docs for it?  I'm not an active MARC4J user so
 not aware of the process.  What I might do is Mavenize it (in my own fork)
 just for fun.  If what I do looks more complicated to you, no problem... I
 will have had my fun and I won't mind it not being picked up.


  If there is any way you can help with getting releases of Marc4j into the
  central Maven repo that would not require going all in with Maven it
  would be greatly appreciated.


 I'm sure there is a way to do that, but I'm probably not your guy for that.
  I agree there is a fair amount of work to see things Maven's way but, once
 you do, straying from that worldview takes more effort.  Someone else will
 probably be better suited than me to take that other path.

 Kevin



Re: [CODE4LIB] anyone know how to properly do a marc4j release?

2013-11-13 Thread Jonathan Rochkind
That would be super awesome if you wanted to do that, and see if you can 
come up with something that Bob is okay with, but makes it possible for 
us to actually do releases to maven, so people expecting to find 
releases there can find them there.


I'm not sure I, or any of the other committers but Bob, understand any 
of that workflow either. I know that right now it is (thankfully) in a 
state where you can use ant to succesfully build it to a .jar, and use 
ant to run tests. Hooray. But yeah, there are, I had noticed, some 
generated .java files that are not in the source repo, but are in fact 
generated by the build process.


On 11/13/13 6:21 PM, Kevin S. Clarke wrote:

On Wed, Nov 13, 2013 at 5:52 PM, Jonathan Rochkind rochk...@jhu.edu
mailto:rochk...@jhu.edu wrote:


I'm not sure, would we?  Is that your advice?


That would be my advice, yes, but I understand Robert's perspective.
  People have strong feelings one way or the other about Maven.

Otherwise, Kevin, you interested in getting committer privs and
figuring out what needs to be done?


Maybe I should just tinker in my own fork of it for a bit and see what
comes from it... I'll need to understand the workflow Robert is
describing a bit more.

Kevin