Harfang Web framework 1.0.0 released

112 views
Skip to first unread message

Nicolas Juneau

unread,
Aug 14, 2016, 10:49:12 PM8/14/16
to Haxe language and help discussion group
Hello fellow Haxers,

It is with immense pleasure that I announce to you tonight (at least in
the EDT timezone) the 1.0.0 release of the Harfang Web framework!

Last release was 0.4 in 2013 - which makes this version about 3 years in
the making. The 1.0.0 version was actually supposed to be version 0.5,
but in order to respect the semver scheme, the version was bumped to
1.0.0. So for those expecting a big blast, I'm sorry in advance. Version
1.0.0 is more an evolution of the API than a revolution.

A very brief history : Harfang started as an internal project of mine
called "Hawk" (for Haxe web frameworK). The name changed to Harfang
because it would have been presumptuous of me to pretend that my work
was part of the core of Haxe. Moreover, Harfang is far from being the
only Web framework in the Haxe world! If you're curious, you can
actually find some "Hawk" references in the Git repository's first commits.

The reason for this framework's existence was that in the first Haxe
versions, there was no Dispatch API. I was (an still am) a big fan of
how Django performed that task, and that's where Harfang came in. Today,
it can be seen as an alternative to the Dispatch API.

Actually, Harfang is the french name of the Snowy Owl ("Harfang des
neiges") It is a bird commonly found in Canada (among other places) :
https://en.wikipedia.org/wiki/Snowy_owl .

Now, back to the framework! What's new in version 1.0.0? It's all there:
https://github.com/njuneau/Harfang/blob/master/CHANGES . I didn't write
the migration guide yet, so be on the lookout for API changes!

Among the cool things you can now do with the framework: It should now
be easier to write Web services since the default URLMapping
implementation now supports HTTP method matching. Hence, you can now
specify both an URL and a method for a mapping to match (example here :
https://github.com/njuneau/Harfang/wiki/Using-class-Metadata-to-generate-URL-Mappings-1.0
). Say goodbye to those pesky "if method == POST"!

Again in the metadata department, you can now use your very own
URLMapping implementations with metadata :
https://njuneau.github.io/harfangweb/docs/api/1.0.0/harfang/url/URLMappingFactory.html#createMappingArray
. So if you don't like regular expressions, it won't stop you from using
Harfang's macros to generate your mappings.

In the documentation department, I migrated the old Haxe docs to Github.
You can now access all the necessary information through its wiki :
https://github.com/njuneau/Harfang/wiki .

The framework's API documentation is also hosted on Github, thanks to
Github Pages and the awesome Dox library :
https://njuneau.github.io/harfangweb/docs/api/1.0.0/

Regarding the supported targets, Neko and PHP are still the only ones
supported for now.

I would like to thank everybody who submitted feedback and issues. Your
comments are always appreciated!

In the hopes that you find the framework useful, here are the links to
all the resources you need to get started:

* https://njuneau.github.io/harfangweb/ (A little hub all things Harfang)
* https://github.com/njuneau/Harfang (For the code and documentation)
* http://lib.haxe.org/p/Harfang/1.0.0/ (Haxelib)

Good night and enjoy!
--
Nicolas Juneau

Confidant

unread,
Aug 14, 2016, 11:55:17 PM8/14/16
to Haxe
Congratulations on the release!

Tarwin Stroh-Spijer

unread,
Aug 15, 2016, 2:45:33 AM8/15/16
to haxe...@googlegroups.com
Congratulations!



Tarwin Stroh-Spijer
_______________________

phone: +1 650 842 0920

Developer at Fanplayr Inc. (Palo Alto)
Original at Touch My Pixel (touchmypixel.com)
_______________________

On Sun, Aug 14, 2016 at 8:55 PM, Confidant <alter...@gmail.com> wrote:
Congratulations on the release!

--
To post to this group haxe...@googlegroups.com
http://groups.google.com/group/haxelang?hl=en
---
You received this message because you are subscribed to the Google Groups "Haxe" group.
For more options, visit https://groups.google.com/d/optout.

Reply all
Reply to author
Forward
0 new messages