Create a wrapper / generator gem 'locomotive' like the 'rails' gem

[mkempe]

We could create a 'locomotive' gem like the 'rails' gem which has one dependency to the locomotive engine + some commands like creating a new locomotive site.

Samples:

$ locomotive new foo

1. Runs the rails generator to create an new rails app 'foo'
2. Updates the Gemfile
3. Run bundle command to install / update dependencies
4. run 'bundle exec rails g mongoid:config'
5. run 'bundle exec rails g locomotive:install'
6. run 'bundle exec rake assets:precompile'

$ locomotive new foo --sample

Same as 'locomotive new foo' + import sample site

Problems:

There already exists a gem with the name locomotive. But perhaps we could ask the author to give up the namespace, because the only version on rubygems.org is 0.0.1 from June 29, 2010.

Nice to have:

Maybe we should rename 'locomotive_cms' to 'locomotive_engine' to clear things up.

What do you think ?

[did]

hi Maik !

That's a great idea. I've been thinking about that for a couple of weeks now. If you want to code something please, do it with the 2.0.0.rc branch. However, some stuff I've to tell you before you start:

1/ I renamed the locomotive editor binary filename to locomotive_editor (instead of locomotive)
2/ locomotive_engine sounds fine to me as well as locomotive_cms (I don't have a preference actually).
3/ during execution of the generator, we should ask the user about what will be the target hosting (heroku, bushido, her/his own server).
4/ the import as it was in the previous engine version does not exist anymore. It's being replaced by the new API mechanism. That also means that I'm going to release a free version of the new locomotive editor (more to come). So we need to figure out something else for the first install. please contact me on skype (dinedine31) next week.

thanks !

Did

[mariovisic]

Thanks for the suggestion; I really like this idea.

Could we possibly do this for the existing gem? We can still name the binary locomotive even though the gem is called locomotive_cms. The process would be as simple as:

gem install locomotive_cms
locomotive new foo

At the moment 99% of our users are using the master branch for running locomotive. I'm hoping we can change things so that most users are using a stable gem release and we can increase the rate of patch/minor releases.

[mkempe]

Hi there,

that's awesome news for locomotive editor. Maybe we could integrate the locomotive editor into the new gem. So you can create a new site + use the awesome locomotive editor to built your site locally, all in one package.

Yesterday I looked how you could build the generator. With the rails generators you can archive this really easy. Basically the generator have to create only a template file like this one: https://raw.github.com/gist/722911 and then run the following command:

$ rails new thud -m {template}

Here you find more details: http://guides.rubyonrails.org/generators.html

@did Can you please tell me the details for generating a heroku or bushido app ? I would then try to generate the corresponding template.

Then i looked at how to built the command line tool / interface:

• Thor
• Commander

I really like both but Commander has some nice extras. I think I give a chance to commander.

@mariovisic You are right, we should use the existing gem name, because the name is already known and you can tell from the name, that you will install the best CMS on the planet :).

Here you can see the first 'implementation' of the new gem:

https://github.com/mkempe/locomotive_cms

Nothing implemented yet, just a skeleton with one command 'locomotive'.

$ locomotive new foo

Next week, i hope, i can show you more.

[did]

hey Maik !
I've pretty much stabilized the 2.0.0.rc branch and I think it's time now to think about the locomotive binary which I'd like to have in the 2.0.0 version.
I suggest you to read the new documentation site (wip): http://doc.locomotivecms.com. That will give you a good idea of how to write your template.
If you need my help, feel free to contact me on skype (dinedine31).
thanks !

Did

[mkempe]

Hi Did!

that are awesome news. Thanks again for all your work. I have already made progress with the generator, but unfortunately had little time to complete the generator. Do you know already when you want to publish version 2.0? I will try my best to finish the generator until then.

Maik

[did]

The 2.0.0.rc1 is enough stable to be used. I already use it to serve locomotivecms.com, doc.locomotivecms.com, nocoffee.fr, ...etc. However, there still are some tiny but not blocking bugs to fix before I get confident in the 2.0.0.rc.
So I hope by the end of the month, we'll have a final version, meaning once we will be done with 2.0 milestone todo list.

[did]

hey @mkempe, I postpone this feature for the 2.1.0 version. So no hurry.... :-)

[did]

done here :-) https://github.com/locomotivecms/cmd. If someone could help to maintain it, that'd be awesome !