Diese Präsentation wurde erfolgreich gemeldet.
Wir verwenden Ihre LinkedIn Profilangaben und Informationen zu Ihren Aktivitäten, um Anzeigen zu personalisieren und Ihnen relevantere Inhalte anzuzeigen. Sie können Ihre Anzeigeneinstellungen jederzeit ändern.

CPAN Workshop, Chicago 2014

2.334 Aufrufe

Veröffentlicht am

Upload your first module to the Comprehensive Perl Archive Network, interact with it in Github, and send and merge pull requests from co-maintainers.

Veröffentlicht in: Technologie
  • No mention of dzil? Held my hand nicely for my first module.
       Antworten 
    Sind Sie sicher, dass Sie …  Ja  Nein
    Ihre Nachricht erscheint hier

CPAN Workshop, Chicago 2014

  1. 1. Uploading Your First Module to CPAN brian d foy! The Perl Review! August 2014, Chicago.pm
  2. 2. Tonight’s Goals • Create a PAUSE account! • Create a basic module! • Set up a git repo! • Create a Github account! • Upload a module! • Send a pull request! • Merge a pull request
  3. 3. PAUSE
  4. 4. PAUSE • You upload through PAUSE! http://pause.perl.org! • The Perl Authors Upload Server! • This is a stepping stone to CPAN
  5. 5. Indexing • PAUSE indexes and creates data files for the CPAN clients! • Only the latest distributions get into it! • People have permissions for namespaces
  6. 6. Get PAUSE Account https://pause.perl.org/pause/query?ACTION=request_id
  7. 7. Choose a module name https://pause.perl.org/pause/query? ACTION=pause_namingmodules
  8. 8. Acme::MyFirstModule::PAUSEID
  9. 9. Permissions • You can upload a namespace someone else already uses! • But PAUSE will ignore it! • A good name goes a long way! • We have general advice on names! https://pause.perl.org/pause/query? ACTION=pause_namingmodules
  10. 10. Create
  11. 11. Create the distro • There are modules that can help you! • Module::Starter! • Distribution::Cooker! • h2xs (comes with Perl)! • many others
  12. 12. Module::Starter
  13. 13. 25,000 Examples • Look at other distributions as examples! • See how other people do it! • Ask them questions
  14. 14. Git
  15. 15. Github
  16. 16. Upload
  17. 17. Upload early & often • You don’t have to be perfect! • … or even good! • Other people can help as soon as possible! • CPAN Testers can send you feedback
  18. 18. Upload https://pause.perl.org/pause/authenquery?ACTION=add_uri
  19. 19. Now, break it • Insert a mistake in your module! • Ensure the tests pass! • Bump the version number! • Reupload! • Push changes up to Github
  20. 20. Pull request
  21. 21. Fork a repo
  22. 22. Clone it
  23. 23. Send Pull Request
  24. 24. Check sites
  25. 25. CPAN Search
  26. 26. MetaCPAN
  27. 27. Lots more • PAUSE lets you add co-maintainers! • You can take over existing modules! • You can help with other people’s modules
  28. 28. Publicize your module • Don’t be shy! • Write something on blogs.perl.org! • Tweet it, plus it, facebook it! • Give a lightning talk
  29. 29. Getting help • For help with PAUSE issues, write to modules@perl.org! • One of the PAUSE volunteer admins can help you! • For general module questions, you might try module-authors@perl.org! • For CPAN Search issues, try cpansearch@perl.org

×