How I learned to stop worrying and love Hex.pm

HOW I LEARNED TO STOP WORRYING AND LOVE... HEX.PM

Darian Moody @djm_

@djm_ Why am I here? ..Totally got this one.

@djm_ HEX.PM PUBLISH TO

@djm_ My aim?

@djm_ Have you published to Hex?

@djm_ Why worry? ..you big baby!

@djm_ distutils setuptools distribute distutils2 bento virtualenv setup.py MANIFEST.in setup.cfg
requirements.txt easy_install pip

@djm_ Elixir has nuked these problems ..dead as a dodo.

@djm_ How? • Project structure • Tooling there from the
start • Project level deps (PDM)

@djm_ i. Hex Ready ii. Push to Hex iii.Hexdocs THE
MASTERPLAN

@djm_ $ mix new project_name SCRATCH STARTING FROM

@djm_ $ mix hex.build

@djm_ /mix.exs

@djm_ Add a description /mix.exs

@djm_ /mix.exs Add package meta

@djm_ /mix.exs Files included by default

@djm_ $ mix hex.build

@djm_ i. Fit for Hex ii. Push to Hex iii.Hexdocs
THE MASTERPLAN

@djm_ PUBLISH BEFORE WE

@djm_ $ mix hex.user register

@djm_ $ mix hex.publish

THE MASTERPLAN

@djm_ HEXDOCS PUSHING TO

@djm_ NEUTRAL DOC PACKAGE • Implement `mix docs` • Generate
HTML into /doc • Generate an index.html Must:

@djm_ ex_doc

@djm_ /mix.exs Add exdoc deps

@djm_ DOCS ADD SOME They look like this:

@djm_ $ mix deps.get DOCS GENERATE THE $ mix docs

@djm_ # OSX $ open doc/index.html # Linux $ xdc-open
doc/index.html

@djm_ PUBLISH LET'S $ mix hex.docs

THE MASTERPLAN

@djm_ TIPS SOME HANDY

@djm_ $ mix hex.config cdn_url <url> EU > Ireland Asia
> Singapore FASTER HEX

@djm_ UMBRELLA USE AN

@djm_ DOCS CAN HAVE A LOGO & PAGES

Darian Moody @djm_ Questions?

More Decks by Darian Moody