Re: Advice for improving https://metacpan.org/release/Freecell-App
Hi Shirl, On Fri, 25 Jan 2013 18:49:10 -0800 Shirl Hart sh9h...@gmail.com wrote: Shlomi, As I mentioned earlier, this is my first attempt to upload to CPAN so I greatly appreciate your suggestions for improving my module. I'm glad you do and are not too territorial around your code and are open for input. (A lot of developers unfortunately are). I'll try to incorporate your suggestions in my next release plus I was researching the Test-More framework so I could add some test. Sounds good. There are many higher-level extensions for Test-More, layers above it, and various abstractions, but Test::More is still what many people use. Some other stuff I like and use: * https://metacpan.org/module/Test::Differences - better output for comparing two scalars than is()/is_deeply(). * https://metacpan.org/release/Test-Count (my own distribution) - allows one to keep track of the number of assertions by providing a mini-language-embeddded in Perl comments for keeping track of tests. Lately, the trend among most clueful CPAN authors appears to have been to move towards done_testing() and without an explicit numeric plan, but I and some other people still prefer counting assertions explicitly and Test-Count can help with that. I was considering using git-hub for my source but that also something new for me to dig into and try to understand. Yes, you should be using some kind of remote (and publicly accessible) hosting. GitHub provides a very nice service, but I find that even though I have several years of experience with CVS and Subversion (and a little with BitKeeper - http://better-scm.shlomifish.org/bk/ - not sure anyone remembers it now), I found that git often throws me off and requires me to search the web or turn to #git for help. Mercurial ( http://en.wikipedia.org/wiki/Mercurial ) also throws me off sometimes, but in different ways than git, but I still usually prefer it and http://bitbucket.org/ usually (but sometimes settle on using GitHub just to use what all the cool kids/hipsters are using). Anyway, the book http://git-scm.com/book is pretty good, and it's available online under one of the CC licences. This is all new to me but at the same time I'm enjoying the experience very much. I plan on refactoring my code until it is structured better. I'm struggling with the code layout a bit. Again, thank you for your input and recommendations. Shirl Hart You're welcome. I guess you have quite a lot to learn now (but everyone does in this day and age, including people with many years of experience - see http://www.joelonsoftware.com/articles/LordPalmerston.html ), so don't worry if you get it a bit wrong at first. It is relatively easy to change, refactor (or sometimes even rewrite) code to fix some original design decisions (as opposed to more tangible forms of craftsmanship and engineering), and usually nothing in software is set in stone, if you don't mind losing some backwards compatibility. Good luck and have fun. Regards, Shlomi Fish -- - Shlomi Fish http://www.shlomifish.org/ Original Riddles - http://www.shlomifish.org/puzzles/ Flock aims to be the browser for the social web, but I found it to be the completely anti-social browser. Please reply to list if it's a mailing list post - http://shlom.in/reply .
RE: Advice for improving https://metacpan.org/release/Freecell-App
Shlomi, As I mentioned earlier, this is my first attempt to upload to CPAN so I greatly appreciate your suggestions for improving my module. I'll try to incorporate your suggestions in my next release plus I was researching the Test-More framework so I could add some test. I was considering using git-hub for my source but that also something new for me to dig into and try to understand. This is all new to me but at the same time I'm enjoying the experience very much. I plan on refactoring my code until it is structured better. I'm struggling with the code layout a bit. Again, thank you for your input and recommendations. Shirl Hart -Original Message- From: Shlomi Fish [mailto:shlo...@shlomifish.org] Sent: Thursday, January 24, 2013 4:32 PM To: shi...@cpan.org Cc: module-authors@perl.org Subject: Advice for improving https://metacpan.org/release/Freecell-App Hi Shirl (and the esteemed module-authors mailing list), We've talked a little in private about https://metacpan.org/release/Freecell-App after this post to fc-solve-discuss - http://tech.groups.yahoo.com/group/fc-solve-discuss/message/1336 - and I mentioned the fact that in the Perl/CPAN community prefer to avoid adding more top-level namespaces on CPAN , and you mentioned that you had to fix t/pod-coverage.t too in case Pod::Coverage was installed, but here is some more advice from a cursory browse of the code. I'm CCing this message to module-authors@perl.org because it may be of general interest and should be googlable, so if you want to CC the list on your reply, hit reply-to-all (it accepts messages from non-subscribers). 1. Are you using a version control system for Freecell::App? If not, you should. See: * http://perl-begin.org/tutorials/bad-elements/#version_control And: * http://szabgab.com/license-and-repository-of-cpan-packages.html 2. Related to it is the fact that the file https://metacpan.org/source/SHIRHA/Freecell-App-0.03/Changes was not kept up-to-date. It should mention the changes done in each release. Some authors use their version control system's logs to generate it, but normally you should mention the major changes that you select yourself in every release. Also see: https://metacpan.org/module/CPAN::Changes 3. This is also still a generic file, while it should not contain the boilerplate - https://metacpan.org/source/SHIRHA/Freecell-App-0.03/README 4. https://metacpan.org/module/Freecell::App should mention metacpan.org in the links too. Furthermore, ::App by convention should be modulinos - http://www.slideshare.net/brian_d_foy/advanced-modulinos-trial The algorithmic logic of the solver should be outside the modulino. See for instance: https://metacpan.org/module/AI::Pathfinding::OptimizeMultiple::App::CmdLine vs: https://metacpan.org/module/AI::Pathfinding::OptimizeMultiple 5. https://metacpan.org/source/SHIRHA/Freecell-App-0.03/lib/Freecell/App/Tableau.pm - please consider adding more emptying lines between code paragraphs, giving more meaningful variable names and getting rid of http://en.wikipedia.org/wiki/Magic_number_%28programming%29 . For more about that see: http://perl-begin.org/tutorials/bad-elements/ . That's all I can find from a cursory look, but it should keep you a little busy for a while. Thanks for your contribution to CPAN and to the world of Freecell solvers. I may draw some inspiration from your solver into my own. Best regards, Shlomi Fish -- - Shlomi Fish http://www.shlomifish.org/ Beginners Site for the Vim text editor - http://vim.begin-site.org/ I used to be arrogant. Now I’m simply Perfect. — one of Shlomi Fish’s relatives. Please reply to list if it's a mailing list post - http://shlom.in/reply .
Unauthorizated release
Hi all, I've upload development version of LemonLDAP::NG libraries, but they are displayed as unauthorizated release even if modules are registered by me. Any idea ? Cheers, Xavier
Re: Unauthorizated release
On Sat, Jan 26, 2013 at 8:03 AM, Xavier x.guim...@free.fr wrote: I've upload development version of LemonLDAP::NG libraries, but they are displayed as unauthorizated release even if modules are registered by me. Any idea ? As can be seen at https://pause.perl.org/pause/authenquery?pause99_peek_perms_by=mlpause99_peek_perms_query=Lemonldap%3A%3ANG%3A%3APortal%3A%3A%25pause99_peek_perms_sub=Submit, you're lacking permissions on a number of namespaces. You should talk to coudot and let him fix that for you. Leon