2012-12-18 2 views
4

Je parle couramment les scripts perl/python, mais quand j'écris du code, je me sers souvent de google pour chercher l'ordre exact des opérandes d'une fonction intégrée, ou le nom exact d'une fonctionnalité que je connais . Alors que google fonctionne raisonnablement bien, il faut faire des recherches, et environ la moitié du temps, la page de référence n'a pas les bons exemples dont j'ai besoin.Perl/Python Aide-mémoire?

Quelqu'un connaît-il une bonne référence rapide pour perl ou python qui aurait la plupart des informations d'utilisation importantes et des exemples de base en un seul endroit? Devrais-je faire le mien? Ou est-ce que la plupart des gens utilisent des IDE et n'ont pas besoin de ce genre d'aide? (J'utilise vim, BTW).

Merci!

+0

Pour Python, quel est le problème avec [la documentation] (http://docs.python.org/3/)? – Ben

+4

http://perldoc.perl.org J'ai configuré mon navigateur avec des raccourcis afin que je puisse taper "perldoc perlop" dans la barre d'adresse. En fait, je ne peux pas imaginer développer en Perl sans accès au POD, et à search.cpan.org. – DavidO

+0

@Ben, rien à redire, mais je pense que j'ai besoin de plus d'exemples de temps en temps pour clarifier la façon d'utiliser les choses. Je n'ai pas un exemple de doc-page à portée de main. – sgauria

Répondre

7

Pour Perl, il est perldoc

perldoc Module::Name # display docs for Module::Name 
perldoc -f substr  # display docs for substr() 
perldoc -Q parse  # search the FAQ for "parse" 
perldoc -v %+   # display docs for special variable %+ 
perldoc perlcheat  # overview of most important syntax 
perldoc perl   # overview of interesting perldoc pages 
+2

Vous pouvez faire la même chose avec 'pydoc':' pydoc collections.OrderedDict' – mgilson

+0

Il y a des outils/des modules tels que 'perlfind' qui fournit automatiquement le paramètre correct à' perldoc', voir http://p3rl.org/App::perlfind –

7

La plupart bien écrit code python devrait avoir docstrings qui fournissent des informations sur les modules et les fonctions simplement en entrant aide dans l'interpréteur.

>>> help(str) 
>>> (lots of helpful output here!) 
3

Pour perl, si vous voulez quelque chose à votre coude, vous ne pouvez pas faire mieux que la Perl Reference Guide/Perl Pocket Reference par Johan Vromans. Imprimez le the PDF et agrafez-le dans un livret, ou ramassez-le simplement à votre librairie locale. (Regardons les choses en face, une référence rapide d'une page n'est pas suffisante pour perl).

Il m'a fait de nombreuses années de Perl utiliser ... jusqu'à ce que je suis passé à python :-)

Pour python, soit dit en passant, je google juste la documentation sur docs.python.org - ou ici sur stackoverflow; La syntaxe de python étant ce qu'elle est, quand je regarde quelque chose, je suis généralement après une description plus détaillée que ce que vous pouvez obtenir d'une carte de référence rapide.