1、Erlware For Managing Distribution and Build,Erlang User Conference 2007,Erlware Goals,Allow the Erlang Community to drive itself Allow the community to evolve the language/platform Make the language/platform accessible to reasonably competent programmers,Steps to Reach Erlwares Goals,Define a Common
2、 Repository for OTP Artifacts Make it easy for anyone to host their own version of the Repository Build tools that leverage the features of the Repository,Repository Design Goals,Be Lazy Dont add more meta data then you need Where ever possible leverage existing OTP metadata,Repository and OTP,OTP a
3、lready provides most of the metadata that we need. OTP Applications make good artifacts. OTP *.app files make for good metadata. OTP *.boot, *.script, *.rel files make really good release packages.,Anatomy of a package,Contains a src directory Contains an ebin directory Contains a *.app file Contain
4、s source code,Application,Release,Contains an *.rel fileContains a sys.config fileContains command templates,Repository Implementation,Dirt Simple Http Server with WEBDAV Enabled Specific, well documented directory structure,Repository Layout,The structure of the repo is/ /and/Meta/Example: The Sina
5、n-1.0.1 release package for mac sits in:http:/repo.erlware.org/pub/5.5.5/ i386-apple-darwin8.9/releases/sinan/,Leveraging the Repository,Sinan is a build system that understands erlang and OTP. It makes it very easy to handle complex OTP build logic,Faxien is a distribution system built on the same
6、backend as Sinan. It provides functionality similar to rubygems or CPAN for Erlang.,OTP Centric Build System Expects OTP Applications, Understands OTP Applications Written and extensible in Erlang,Getting Started,Generate an OTP Projectsinan genAfter asking a few questions generates a useful, sinan
7、compliant, compilable OTP application with a complete skeleton,Dependency Detection,Just runsinan dependsEvaluates the OTP application dependencies and restrictions in the project. Hits the repository to gather information. Comes back with a list of hard dependencies (app, version) for each of the d
8、ependencies and transitive dependencies in the project. Many other tasks in Sinan depend on this one.,Building,Just runsinanorsinan buildBuilds all of your artifacts into the _build directory. Will only rebuild when a file needs to be rebuilt. Understands includes, parse transforms etc.,Testing,We d
9、ecided to leverage eunit in Sinan. Want to run all of the eunit tests in your project.sinan testSinan prints successes and failures to the shell. It also generates html code coverage reports to _build/reports.,The Good Stuff - Releases,Want to generate *.rel, *.boot, *.script files for your project?
10、 How about taring it up and getting it ready for a push to an Erlang node?Just dosinan releaseorsinan tarBest of all, Faxien knows how to push these releases out to a repository. That makes distribution a no brainer.,Extras,How about running dialyzer on your project?sinan analyzeThe first time its r
11、un it generates a plt file for dependencies so you only get the output relevant for your project.Want an erlang shell with all of your paths set so you can noodle with your project?sinan shell,The Future,Anything you want. Sinan is an extensible system so anything useful can be quickly incorporated.
12、 Of course, there is still a lot of functionality we want to expose in Sinan. No doubt the community will come up with a bunch of things that we have never thought of.,Easy to find and install otp packages list out packages available in remote repositories simply type faxien install to install anyon
13、e of them Install applications and releases Easy to publish OTP packages so that community can access them faxien publish auto discovers package type, app, release, or erts,Install the tools,http:/ (links also found at www.erlware.org)Execute faxien_launcher -b to install faxien now install Sinan wi
14、th faxien install sinan,Installation,The past -Google for an application that fits your needs Find lots of stuff written in perl but no Erlang Some obscure website listed on the 13th page has a half baked Erlang app Hack around with it for a bit Give up and write your ownWith Faxien -faxien list pic
15、k an app faxien install_app vsn faxien install vsn,How does installation work?,Configured to know about a list of repositories Pulls down packages both releases and applications then installs the now local tars creating scripts and boot files the fit the local environment among other things. Pulls d
16、own erts (you need not install Erlang from source anymore) If a package is not found for the erts vsn you specify Faxien automatically selects the next lowest compatible erts vsn. By default all packages are installed in /usr/local/erlware or on windows c:erlware though this is fully configurable. (
17、windows code not complete as of this writing),Publishing,The past -build it write some convoluted make file that would break for the next guy, put it up on your website and hope people find it Be disappointed when no one does and watch the community grow slowly without your codeWith faxien“faxien pu
18、blish my_app“ “faxien publish my_rel“Now everyone can get at it,How does publishing work?,Faxien publishes precompiled applications Publishes into a repo location specific to the local architecture, if project is pure Erlang then publishes to a platform neutral location Auto discovers the package ty
19、pe by looking for things like a .app file or a .rel file, or the fact the the directory looks something like “erts-“. faxien publish sasl-1.3.2.1 works faxien publish my_release-2.3.2 works faxien publish erts-5.5.5 works if a package does not have the appropriate OTP structure it will not be publis
20、hed.,Extra Commands,Faxien allows you to do quite a bit more than this short presentation has time to address. Two commands I want to note are:faxien list - list all available apps that match the supplied pattern across many reposfaxien upgrade - upgrade one or all packages on the local file system
21、to their latest vsnAnd of course lets not forget faxien help to print out a list of what faxien can do,Summing it up. (Erlware cycle),Install Faxien (Erlang Package Management) Install Sinan (Erlang Build System) Use Sinan projgen to create a project Build, document, and test with Sinan Publish an a
22、pp or release with Faxien Other folks download and use your package,Erlware Goals Revisited,Allow the Erlang Community to drive itself Create otp packages with Sinan then publish and install them with Faxien. Now we can easily leverage each others work. Allow the community to evolve the language/pla
23、tform No need to install Erlang from source, you can create your own release and people can simply install that if you want to bundle your alternative to stdlib instead of the original go ahead Make the language/platform accessible to reasonably competent programmers OTP apps and releases are easy to install, create, and publish with Faxien and Sinan.,Get Involved with Erlware,erlware- erlware- contacterlware.orgWe are a community project. We want your help, we will not succeed without it!,
