yahns Ruby server user/dev discussion
 help / color / mirror / code / Atom feed
blob bb96e2db4062f85f42e92d459f7b1e2318422f3b 1826 bytes (raw)
name: HACKING 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
development dependencies
------------------------

* minitest RubyGem (version 4 or 5, standard in Ruby 2.0+)
* curl - http://curl.haxx.se/ - we don't trust our own Ruby abilities :>
* dd(1) - standard POSIX tool - to feed curl
* ab - http://httpd.apache.org - for concurrent testing
* GNU make - https://www.gnu.org/software/make/
* git - http://www.git-scm.com/
* ruby - http://www.ruby-lang.org/

	git clone git://yhbt.net/yahns

tests
-----

* make test - run each test in a separate process (parallelize using -j)
* make test-mt - run tests-multithreaded in one process
* make coverage - "make test" with coverage output
* make coverage-mt - "make test-mt" with coverage output
* ruby test/covshow.rb - show coverage output from previous test run

For non-GNU users, GNU make may be installed as "gmake".

test environment
----------------

N - specify the number of threads for *-mt targets (minitest parallelize_me!)
RUBY - specify an alternative ruby(1) runtime
V - set to 1 for verbose test output (may be mangled if multithreaded)

documentation
-------------

We use pandoc for converting Markdown to (groff) man:

* pandoc - http://johnmacfarlane.net/pandoc/

installing from git
-------------------

* make install-gem (pandoc is required for generating manpages)

contact
-------

We use git(7) and develop yahns on a public mailing list like git
developers do.  Please send patches via git-send-email(1) to the public
mailing list at <yahns-public@yhbt.net>.  Pull requests should be
formatted using git-request-pull(1).

Mailing list archives: http://yhbt.net/yahns-public/
No subscription is necessary to post to the mailing list.
Please remember to Cc: all recipients.

Copyright 2013, Eric Wong <normalperson@yhbt.net> and all contributors.
License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>

debug log:

solving bb96e2d ...
found bb96e2d in https://yhbt.net/yahns.git/

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhbt.net/yahns.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).