Flatten project structure created by crystal init

[straight-shoota]

crystal init previously created src/example/version.cr file which only contained a VERSION constant. This is moved into the main library file. It also removes require "./example/*" from main file.

The old version.cr convention persisted from Ruby due to the need for gemspec files to require only the version constant from the library.

Extracted from #5428 to make this easier to merge with (hopfully) less discussion and we can focus there (or in a new issue) on the value of VERSION. @RX14 I hope you don't mind 😉

#5428 (comment)

In my view version.cr is much more cluttered than just adding a line in your main file. Ruby convention has it separate only because the gemspec depends on the version.cr - in Crystal we have it the other way around so we can merge it back in.

[ysbaddaden]

I prefer to put everything under src, not the artificial src/foo folder inherited from rubygem. I'm all in for this evolution.

[jkthorne]

I cant 👍 @ysbaddaden comment but I agree.

[kostya]

put everything in src produce much more require conflicts, as src is a search path in crystal.

[straight-shoota]

@kostya What? require "./shardname/foo" results in exactly the same naming issues (if you can call it such) as require "./foo" if everything is just put into src/shardname/ instead of src/

[ysbaddaden]

@kostya no, this conflict only happens in Rubygem, which adds each gem lib folder to the search path, which forces to use a lib/foo folder. This doesn't happen in Crystal, where only the project's lib folder is added, not each src folder of every shard. Having a src/foo folder or not is exactly the same.

[icyleaf]

In my view version.cr is much more cluttered than just adding a line in your main file. Ruby convention has it separate only because the gemspec depends on the version.cr - in Crystal we have it the other way around so we can merge it back in.

I agree with @RX14 opinion, Is there have a better solve to combine VERSION in src and version in shard.yml, like keep last one to call Shards.version("name") .