MappedObject library

[Riven]

Knock yourselves out guys!

<project ...>

	<repositories>

		<repository>
			<releases>
				<enabled>true</enabled>
				<updatePolicy>always</updatePolicy>
				<checksumPolicy>fail</checksumPolicy>
			</releases>
			<id>net.indiespot</id>
			<name>MappedObjectLib</name>
			<url>http://indiespot.net/files/mappedobjectlib/maven2/</url>
			<layout>default</layout>
		</repository>

	</repositories>


	<dependencies>

		<dependency>
			<groupId>net.indiespot</groupId>
			<artifactId>MappedObjectLib</artifactId>
			<version>0.8.5</version>
		</dependency>

	</dependencies>

</project>

[lhkbob]

It’s not too bad, I’ve drunk the Maven cool-aid and although it infects everything you do, I don’t find I’m bothered by it.

[Gudradain]

@Riven

Just having installed Maven… :persecutioncomplex: I’m now able to compile it, package it with dependencies, make it spit out a JAR and even deploy it locally. Now what’s next?

Oh no, you start to used maven too :o

[Riven]

My public repository is basically a massive hack: generating a dummy JAR from dummy sourcecode, then replacing the JAR Eclipse generated and I obfuscated, then injecting the required Maven META-INF entries into the JAR, rehashing the *.jar.md5 and *.jar.sha1, then uploading the entire repo to a dir on my webserver.

All that, in a nifty .bat .sh file :-X

[Roquen]

Legal note: If the codebase is GPLed, the you should explicitly state what the license is for any AOT output…assuming that the AOT can run without the library.

[Riven]

@Roquen

Legal note: If the codebase is GPLed, the you should explicitly state what the license is for any AOT output…assuming that the AOT can run without the library.

I’ll have to rethink the licenses for a bit (don’t hold your breath)

BTW:
JIT & AOT cannot run without the library, as mapped types extend types from within the library.

[Roquen]

As the author you just need to state what the license rules are…but you should explicitly state them. So you’d need to state that class files and generated code is BSD or whatever. This opens up a can of worms however. Consider that using a reverse engineering tools of BSD licensed .class files is a “derived works” of the .class files and so logically BSD licensed, so defeating you’re purpose. You could add an exception clause, but I’d guess that would be deemed to be unenforceable. I’d suggest that you GPL everything and get the GPL taint and state that other licensing options are available from the original author…if you’re willing to deal with the generated emails. You could always drop to a less restrictive license in the future if that becomes too much of a PITA.

NOTE: I’m not a lawyer so take this for what it’s worth…which isn’t much.

[Nate]

@Riven

@Danny02

@Riven

Now what’s next?

Just follow this official guide https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide

Thanks, but I’m not going to jump through all the hoops, let alone creating some account on some website I never heard of on which my library will be dependent. Well, maybe later.

It’s simply not worth the effort: just add 3 JARs to your classpath and be done with it, mkay?

Haha! Amen brother!

[Riven]

@Nate

Haha! Amen brother!

I reworked it to this simple procedure:
[x] take your mylib-{version}.jar
[x] inject some META-INF entire in your JAR (take previous entries and replace the version string in those)
[x] generate a mylib-{version}.pom (take previous POM and replace version string)
[x] md5sum mylib-{version}.jar
[x] sha1sum mylib-{version}.jar
[x] md5sum mylib-{version}.pom
[x] sha1sum mylib-{version}.pom
[x] dump in some online folder that you defined in your dependencies

(yes, this really is the simplified method, and i’m now investigating maven install-file for funzies)

[princec]

My attempt at thread derailment: Maven is a symptom of everything wrong with software development in the modern age And as an aside: Project Jigsaw - solving a problem nobody has any more, in the most complicated way possible, so that they have failed to deliver what nearly everyone asked for 10 years ago that only took a couple of hours for an amateur to implement. Way to go, software engineers. The same guys probably invented Maven.

Cas

[Roquen]

In theory: Jigsaw coupled with the proposed (and AFIK unspecified) lightweight native interface should could be very interesting…too bad we’re not going to see it soon.

[Danny02]

@princec

Maven is a symptom of everything wrong with software development in the modern age

I know that you aren’t so fond of all these software design stuff and so on cas, but not everybody is writing only tiny little 1k loc mini games in the world. All this practices which evolved over time might be to big or complicated for some projects, but the nearly all have good ideas behind them. And I would even say that one should start to use them as early as possible.
I get when riven don’t want to go through all the hassle to set things up, but it would be a small price to pay to make it for a lot of people easier.

To finish things up, wtf are you talking about maven???
There are alternatives to maven like grandle … which I did not try yet, but overall it just makes the hole project live-cycle management so much easier. One might have to read 1-2 pages and try it once to understand the basics, but it is just so much easier to use then any other available tool + all the new positive aspects it brings with it.

So that was my little rant for all the “conservative” guys here.

[princec]

You seem to imply with your statement that I write tiny 1kloc games. (kloc? who uses that metric any more?)

For your amusement - Revenge of the Titans for example is ~151 kloc excluding the new online stuff we’re working on.

Cas

[Gudradain]

Well, when I think about maven I always have the same question in mind : ''Why was Maven invented?"

I read here and there that it makes your project lifecycle a lot easier and it can replace ant, and that ant build are a pain to maintain and that it slow down your project velocity and etc.

But really, what does Maven do that I can’t do with Eclipse + a few mouse click + some .bat files?

[sproingie]

@Gudradain

But really, what does Maven do that I can’t do with Eclipse + a few mouse click + some .bat files?

Not require the .bat files. Want to add a dependency on commons-io? Type FileUtils in an editor in eclipse. It gets redlined because it doesn’t know what that is. Right click it, say “search for maven dependency” (or whatever it says in eclipse these days). Find commons-io in the list. It will download it, the source and javadoc (optionally), add it to your compile and run classpath, and the same for anything it depends on.

All clicky. No XML.

Oh but right, REAL MEN do it all by hand. Whatevs.

[Gudradain]

@sproingie

Not require the .bat files. Want to add a dependency on commons-io? Type FileUtils in an editor in eclipse. It gets redlined because it doesn’t know what that is. Right click it, say “search for maven dependency” (or whatever it says in eclipse these days). Find commons-io in the list. It will download it, the source and javadoc (optionally), add it to your compile and run classpath, and the same for anything it depends on.

So is that the reason why Maven was invented?

I will assume that for now. Something like that is really a good thing. I would want something that could manage all the external jar I need for my project without having to go download them by hand and that would update the jar for the newest version when I want. That would be really useful for sure. But why doesn’t maven only do that? Or is there any plugin or tool out there that only do that?

I don’t want maven to create my eclipse project. Eclipse can do it.
I don’t want maven to build my jar. Eclipse can do it.
I don’t want maven to run my test. Eclipse can do it.

I mean why did they tried to make 1 tool do everything and even worse force you to do everything with that tool? Nobody want that… Everyone like to work his own way.

My question stand, why was maven invented? To force you to do everything with it or to give you the opportunity to automatically download all the jars you need for your project to run?

[sproingie]

Dependency management is a big reason for Maven’s existence, yes. It also does quite a few other things.

As for the preference for eclipse, fine. If you prefer eclipse’s layout, change them from the defaults. No one is “forcing” you to use it at all, let alone use every last feature of it. Perhaps you should reserve your remaining criticisms of maven until you’ve learned more about it

[Riven]

@Danny02

I get when riven don’t want to go through all the hassle to set things up, but it would be a small price to pay to make it for a lot of people easier.

Wait, I made a public maven repository, I thought by doing that I actually went through the hassle - believe me, it was. And now you insinuate I didn’t bother.

Anyways, I’m willing to tolerate even more of a derailment than this! I’d appreciate it though if we could also discuss mapped objects, while we’re at it.

[ra4king]

I’m currently entertaining the idea of making a block-world kind of test game using MappedObjects, where I would have a Block class that’s a MappedType. No, not minecraft.
Give me a week to get back to my computer though.

[lhkbob]

@Riven

Wait, I made a public maven repository, I thought by doing that I actually went through the hassle - believe me, it was. And now you insinuate I didn’t bother.

You didn’t go through the hassle of getting your library hosted on the Maven central repository (which is managed by Sonatype). It’s “nice” to host things on the central repository because all Maven projects will check that location for libraries. With your way, we have to update our own project to use the additional repository

I use Maven quite a bit with work and really like it, and it sounds like some people have misconceptions or just don’t know much about Maven so here’s my take on what it can do and why it’s cuddly:

Maven is a combined dependency management system and project build/lifecycle manager. The build system is powerful but can be largely ignored if conventions are followed. The dependency manager is nice because it forces you to document the exact libraries AND their versions that you depend on. As said before, it will download the JARs for those dependencies, and the JARs of any transitive dependencies, etc. It will also resolve as best version conflicts between dependencies.

At work before Maven, my classpaths might grow to 50 jars in some of our servers, with libraries I’d never use personally but were a dependency. If I wanted to update Struts or Hibernate, it was a very bug prone hassle to try and get the correct new versions of their dependencies. This is trivially easy to do with Maven and should not be sneezed at. I doubt my games will ever need that many dependencies, but it’s still nice to have as a feature.

There is a very nice Maven plugin for Eclipse so you still create your project through Eclipse (just a different type than plain Java). Eclipse still does all of the compiling and it can still do its magic classpath sharing between projects (even other Maven ones in your workspace). The plugin will automatically download the Javadocs and source associated with a dependency when you go to inspect an element, and links it for you into the normal Eclipse source inspection system.

By the time you need to build your final application, you might have to mess with some XML funny business, but there’s a good chance you’d have done that with ant. Maven has much better fat-jar support compared with Eclipse.

IMO Maven helps keep your own projects more modularized because you can split them into separate modules. Do you have custom math functions and vectors, etc. It’s a module. Physics library or helper code; it’s a module. Input system or event system, or core AI routines? Module. Then you can have them depend on each other as needed, and have a last module that brings them all together and implements your game.

Want to make a new game, just pull in your modules you want to reuse instead of trying to gut pieces by hand.