jscoverage/trunk/instrument-js.h

/*
    instrument-js.h - JavaScript instrumentation routines
    Copyright (C) 2007, 2008, 2009 siliconforks.com

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/

#ifndef INSTRUMENT_JS_H_
#define INSTRUMENT_JS_H_

/* ISO C99 specifies that C++ code must define this to get UINT16_MAX etc. */
#define __STDC_LIMIT_MACROS
#include <stdint.h>

#include "stream.h"
#include "util.h"

#ifdef __cplusplus
extern "C" {
#endif

enum FileType {
  FILE_TYPE_JS,
  FILE_TYPE_HTML,
  FILE_TYPE_OTHER
};

enum JSCoverageMode {
  JSCOVERAGE_NORMAL,
  JSCOVERAGE_MOZILLA,
  JSCOVERAGE_NO_BROWSER
};
extern enum JSCoverageMode jscoverage_mode;

void jscoverage_set_js_version(const char * version);

void jscoverage_init(void);

void jscoverage_cleanup(void);

void jscoverage_instrument_js(const char * id, const uint16_t * characters, size_t num_characters, Stream * output);

void jscoverage_copy_resources(const char * destination_directory);

typedef struct Coverage Coverage;

typedef struct FileCoverage {
  char * id;

  int * coverage_lines;
  char ** source_lines;

  /* SpiderMonkey uses uint32 for array lengths */
  uint32_t num_coverage_lines;
  uint32_t num_source_lines;
} FileCoverage;

Coverage * Coverage_new(void);

void Coverage_delete(Coverage * coverage);

typedef void (*CoverageForeachFunction) (const FileCoverage * file_coverage, int i, void * p);

void Coverage_foreach_file(Coverage * coverage, CoverageForeachFunction f, void * p);

int jscoverage_parse_json(Coverage * coverage, const uint8_t * data, size_t length) __attribute__((warn_unused_result));

void jscoverage_write_source(const char * id, const uint16_t * characters, size_t num_characters, Stream * output);

#ifdef __cplusplus
}
#endif

#endif /* INSTRUMENT_JS_H_ */
1	siliconforks	2	/*
2			instrument-js.h - JavaScript instrumentation routines
3	siliconforks	427	Copyright (C) 2007, 2008, 2009 siliconforks.com
4	siliconforks	2
5			This program is free software; you can redistribute it and/or modify
6			it under the terms of the GNU General Public License as published by
7			the Free Software Foundation; either version 2 of the License, or
8			(at your option) any later version.
9
10			This program is distributed in the hope that it will be useful,
11			but WITHOUT ANY WARRANTY; without even the implied warranty of
12			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13			GNU General Public License for more details.
14
15			You should have received a copy of the GNU General Public License along
16			with this program; if not, write to the Free Software Foundation, Inc.,
17			51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18			*/
19
20			#ifndef INSTRUMENT_JS_H_
21			#define INSTRUMENT_JS_H_
22
23	siliconforks	399	/* ISO C99 specifies that C++ code must define this to get UINT16_MAX etc. */
24			#define __STDC_LIMIT_MACROS
25	siliconforks	179	#include <stdint.h>
26
27	siliconforks	92	#include "stream.h"
28	siliconforks	116	#include "util.h"
29	siliconforks	2
30	siliconforks	399	#ifdef __cplusplus
31			extern "C" {
32			#endif
33
34	siliconforks	2	enum FileType {
35			FILE_TYPE_JS,
36			FILE_TYPE_HTML,
37	siliconforks	124	FILE_TYPE_OTHER
38	siliconforks	2	};
39
40	siliconforks	431	enum JSCoverageMode {
41			JSCOVERAGE_NORMAL,
42			JSCOVERAGE_MOZILLA,
43			JSCOVERAGE_NO_BROWSER
44			};
45			extern enum JSCoverageMode jscoverage_mode;
46	siliconforks	361
47	siliconforks	339	void jscoverage_set_js_version(const char * version);
48
49	siliconforks	2	void jscoverage_init(void);
50
51			void jscoverage_cleanup(void);
52
53	siliconforks	179	void jscoverage_instrument_js(const char * id, const uint16_t * characters, size_t num_characters, Stream * output);
54	siliconforks	2
55	siliconforks	116	void jscoverage_copy_resources(const char * destination_directory);
56
57			typedef struct Coverage Coverage;
58
59			typedef struct FileCoverage {
60			char * id;
61
62	siliconforks	179	int * coverage_lines;
63			char ** source_lines;
64	siliconforks	116
65	siliconforks	179	/* SpiderMonkey uses uint32 for array lengths */
66			uint32_t num_coverage_lines;
67			uint32_t num_source_lines;
68	siliconforks	116	} FileCoverage;
69
70			Coverage * Coverage_new(void);
71
72			void Coverage_delete(Coverage * coverage);
73
74			typedef void (CoverageForeachFunction) (const FileCoverage file_coverage, int i, void * p);
75
76			void Coverage_foreach_file(Coverage * coverage, CoverageForeachFunction f, void * p);
77
78			int jscoverage_parse_json(Coverage * coverage, const uint8_t * data, size_t length) __attribute__((warn_unused_result));
79
80	siliconforks	179	void jscoverage_write_source(const char * id, const uint16_t * characters, size_t num_characters, Stream * output);
81
82	siliconforks	399	#ifdef __cplusplus
83			}
84			#endif
85
86	siliconforks	398	#endif /* INSTRUMENT_JS_H_ */