CPAN Day Upload!

August 16th, 2014

Happy CPAN day, everyone!  If I’m reading the history right, it’s been nineteen years since CPAN went live, and it’s thrived since then.

Thanks in part to Neil Bowers’ steady blogging, I’ve finally uploaded a module of my own to CPAN.  I am tickled pink to see the new module show on search.cpan.org already; I’m sure it’ll be on metacpan in a few minutes.  (I even got my picture to work!)

I also uploaded a maintenance release of a module Tomas Doran gave me co-maint on, because I had changes and he is alway extremely busy.  I was happy to update it and get it put on CPAN.  That one will show, as it’s an existing module.

There’s a few hours left in CPAN day, so if you’ve got something to share, now is a great time!

 

 

PBP: 030 Ambiguous Abbreviations

August 14th, 2014

This boils down to “don’t abbreviate when it isn’t clear.”  The response to this should be, “Well, duh!” Read the rest of this entry »

PBP: Too Many Posts? Feedback, please!

August 12th, 2014

A commenter on another one of the PBP posts pointed requested I stop posting so often.

Rather than have a discussion there in comments where it is easy to get lost, I thought I’d start a new post and ask: Is it too many posts?  Is is useless?  Should I stop? Read the rest of this entry »

PBP: 029 Abbreviations

August 11th, 2014

Abbreviations are hard, and the PBP suggests making them by keeping the start of each word, rather than other habits like chopping out vowels or other ways to shorten thing.  It has an effective reason why in a ftnt. Read the rest of this entry »

PBP: 028 Capitalization

August 7th, 2014

The PBP suggests using different formats of case to help explain what a thing is. Read the rest of this entry »

PBP: 027 Underscores

August 4th, 2014

The PBP suggests using underscores to separate phrases in a variable name.  Since we can’t use spaces or hyphens, as English (and many other languages, honestly) would have us do, we have to use something else.

The PBP suggests an underscore.  Problem: I dislike underscores. Read the rest of this entry »

PBP: 026 Arrays and Hashes

July 31st, 2014

The PBP suggests naming for hashes and arrays; hashes in the singular, and arrays in the plural. Read the rest of this entry »

PBP: 025 Reference Variables

July 28th, 2014

The PBP suggests suffixing reference variables with _ref.  The book notes in a footnote that this is the only type of “Hungarian notation” suggested in the book.  That’s good, because Hungarian notation is a bad idea. Read the rest of this entry »

PBP: 024 Booleans

July 24th, 2014

The PBP suggests that boolean variables and subroutines should get special naming consideration, and be named in ways that read well.  That may involve giving them names like “is_whatever” or “has_whaterver” or “can_whatever”, so that they make contextual sense.

Read the rest of this entry »

PBP: 023 Identifiers

July 21st, 2014

This section of the PBP is a long one, and goes into great detail about how to think about naming important parts of your programs.  It covers explicitly modules/namespaces, variables (several types of them), and functions.

I thought, at first glance, it was way too picky and specific, but the more I read it, the more I liked it.

Read the rest of this entry »