Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss

New module name (Eclipse::PHPMe)

7 views
Skip to first unread message

kinow

unread,
Apr 2, 2012, 8:10:22 PM4/2/12
to
Hi all!

I wrote a Perl utility to turn an ordinary directory into an Eclipse
PHP project. I'm new to CPAN and Perl, so I have few questions:

- Is CPAN the right place for it? It's only a script (referenced in
EXE_FILES in Makefile.PL). I intend to use this script as I'm always
importing different PHP projects in Eclipse and it can be handy
- I've looked for the Eclipse namespace in CPAN, searching for Eclipse
with the filter set to 'Module', and found nothing. Is Eclipse::PHPMe
a good name?

The code is at https://github.com/kinow/eclipse_phpme

Thank you in advance :-)

Bruno

Ivan Shmakov

unread,
Apr 3, 2012, 1:27:38 AM4/3/12
to
>>>>> kinow <brunod...@yahoo.com.br> writes:

[Cross-posting to news:comp.lang.perl.misc, for
news:comp.lang.perl.modules has somewhat low activity these
days.]

> Hi all! I wrote a Perl utility to turn an ordinary directory into an
> Eclipse PHP project. I'm new to CPAN and Perl, so I have few
> questions:

> - Is CPAN the right place for it? It's only a script (referenced in
> EXE_FILES in Makefile.PL). I intend to use this script as I'm always
> importing different PHP projects in Eclipse and it can be handy

> - I've looked for the Eclipse namespace in CPAN, searching for
> Eclipse with the filter set to 'Module', and found nothing. Is
> Eclipse::PHPMe a good name?

There's the App:: namespace prefix for applications (and
scripts):

--cut: https://pause.perl.org/pause/query?ACTION=pause_namingmodules --
App

You can distribute applications as Perl distributions. Typically,
those sorts of distributions go under the App namespace, like
App::Ack, App::Cpan, and App::Prove. The namespace implies that its
a ready-to-use program rather than a module.
--cut: https://pause.perl.org/pause/query?ACTION=pause_namingmodules --

There seem to be a plenty of Perl applications distributed this
way. Consider, e. g.:

http://search.cpan.org/~petdance/ack-1.96/
http://search.cpan.org/~rjbs/App-Addex-0.023/

[...]

--
FSF associate member #7257

kinow

unread,
Apr 6, 2012, 4:00:33 AM4/6/12
to
On Apr 3, 2:27 am, Ivan Shmakov <oneing...@gmail.com> wrote:
> http://search.cpan.org/~petdance/ack-1.96/http://search.cpan.org/~rjbs/App-Addex-0.023/
>
> [...]
>
> --
> FSF associate member #7257

Hi Ivan!

Thanks for the feedback.

App seems to be the right place for this application. However, I think
App::PHPMe would not be the right name for it. Maybe
App::Eclipse::PHPMe, or App::EclipsePHPMe? What do you think?

By the way, do I need to talk with someone else about using the App
namespace prefix?

Much appreciated!

Bruno

Ben Morrow

unread,
Apr 10, 2012, 4:23:34 PM4/10/12
to

Quoth kinow <brunod...@yahoo.com.br>:
>
> App seems to be the right place for this application. However, I think
> App::PHPMe would not be the right name for it. Maybe
> App::Eclipse::PHPMe, or App::EclipsePHPMe? What do you think?

What is the executable that gets installed called? If it's called phpme,
I'd call the distribution App::PHPMe, since you've effectively already
'claimed' that name; if it's called something like eclipse_phpme or is
installed somewhere where it only gets called from Eclipse, I'd call it
App::Eclipse::PHPMe.

> By the way, do I need to talk with someone else about using the App
> namespace prefix?

No. In general names on CPAN are first-come, first-served. There are a
few official restrictions, mostly now quite old (for instance, names
under DBI:: are restricted), and there is an unofficial convention that
putting your module under the namespace of an existing module with many
supplied sub-modules (like, say, Catalyst, or Plack) should only be done
after coordinating with the author(s) of that module, but generic
top-level namespaces like App:: are free-for-all.

If you want advice about module naming from the people who run CPAN and
PAUSE, you can write to the mod...@perl.org mailing list.

Ben

kinow

unread,
Apr 13, 2012, 8:23:51 PM4/13/12
to Ben Morrow
Hi Ben!

Thanks for the explanation, you were very clear :-)

I'll the PHP::PHPMe as the module name for now, but when submitting to
Pause I will take a look at mod...@perl.org to check if the name is
fine too.

Thank you very very much.

All the best,
Bruno

On Apr 10, 5:23 pm, Ben Morrow <b...@morrow.me.uk> wrote:
> Quoth kinow <brunod...@yahoo.com.br>:
>
>
>
> > App seems to be the right place for this application. However, I think
> > App::PHPMe would not be the right name for it. Maybe
> > App::Eclipse::PHPMe, or App::EclipsePHPMe? What do you think?
>
> What is the executable that gets installed called? If it's called phpme,
> I'd call the distribution App::PHPMe, since you've effectively already
> 'claimed' that name; if it's called something like eclipse_phpme or is
> installed somewhere where it only gets called fromEclipse, I'd call it
0 new messages