Panda3D
Loading...
Searching...
No Matches
dcparse.cxx
Go to the documentation of this file.
1/**
2 * PANDA 3D SOFTWARE
3 * Copyright (c) Carnegie Mellon University. All rights reserved.
4 *
5 * All use of this software is subject to the terms of the revised BSD
6 * license. You should have received a copy of this license along
7 * with this source code in a file named "LICENSE."
8 *
9 * @file dcparse.cxx
10 * @author drose
11 * @date 2000-10-05
12 */
13
14#include "dcbase.h"
15#include "dcFile.h"
16#include "dcClass.h"
17#include "dcTypedef.h"
18#include "memoryUsage.h"
19#include "indent.h"
20#include "panda_getopt.h"
21
22using std::cerr;
23using std::cout;
24
25void
26usage() {
27 cerr <<
28 "\n"
29 "Usage:\n\n"
30 "dcparse [options] [file1 file2 ...]\n"
31 "dcparse -h\n\n";
32}
33
34void
35help() {
36 usage();
37 cerr <<
38 "This program reads one or more DC files, which are used to describe the\n"
39 "communication channels in the distributed class system. By default,\n"
40 "the file(s) are read and concatenated, and a single hash code is printed\n"
41 "corresponding to the file's contents.\n\n"
42
43 "Options:\n\n"
44
45 " -v Writes a complete parseable version of the file to standard\n"
46 " output instead of printing a hash code.\n\n"
47
48 " -b Writes a brief parseable version of the file instead of a full\n"
49 " version. This is semantically the same as the output produced\n"
50 " the above -v option--reading it would produce exactly the same\n"
51 " results--but it is designed to be slightly obfuscated. The\n"
52 " comments and parameter names are not included.\n\n"
53
54 " -c Write a list of class names, showing the inheritance hierarchy.\n"
55 " Some class names will be listed twice in the presence of multiple\n"
56 " inheritance.\n\n"
57
58 " -f Write a complete list of field names available for each class,\n"
59 " including all inherited fields.\n\n";
60}
61
62void
63write_class_hierarchy(int indent_level, const DCFile &file,
64 const DCClass *this_dclass) {
65 indent(cout, indent_level)
66 << this_dclass->get_name() << "\n";
67
68 int num_classes = file.get_num_classes();
69 for (int i = 0; i < num_classes; ++i) {
70 const DCClass *dclass = file.get_class(i);
71 bool is_my_child = false;
72 int num_parents = dclass->get_num_parents();
73 for (int j = 0; j < num_parents && !is_my_child; ++j) {
74 is_my_child = (dclass->get_parent(j) == this_dclass);
75 }
76
77 if (is_my_child) {
78 write_class_hierarchy(indent_level + 2, file, dclass);
79 }
80 }
81}
82
83void
84write_class_hierarchy(const DCFile &file) {
85 int num_classes = file.get_num_classes();
86 for (int i = 0; i < num_classes; ++i) {
87 const DCClass *dclass = file.get_class(i);
88 if (dclass->get_num_parents() == 0) {
89 write_class_hierarchy(0, file, dclass);
90 cout << "\n";
91 }
92 }
93}
94
95void
96write_complete_field_list(const DCFile &file) {
97 int num_classes = file.get_num_classes();
98 for (int i = 0; i < num_classes; ++i) {
99 const DCClass *dclass = file.get_class(i);
100 cout << "\n" << dclass->get_name() << "\n";
101 int num_inherited_fields = dclass->get_num_inherited_fields();
102 for (int j = 0; j < num_inherited_fields; ++j) {
103 const DCField *field = dclass->get_inherited_field(j);
104 cout << " ";
105 if (field->get_class() != dclass) {
106 cout << field->get_class()->get_name() << "::";
107 }
108 cout << field->get_name();
109 if (field->as_atomic_field() != nullptr ||
110 field->as_molecular_field() != nullptr) {
111 // It's a "method".
112 cout << "()";
113 }
114 field->output_keywords(cout);
115 cout << "\n";
116 }
117 }
118}
119
120int
121main(int argc, char *argv[]) {
122 // extern char *optarg;
123 extern int optind;
124 const char *optstr = "bvcfh";
125
126 bool dump_verbose = false;
127 bool dump_brief = false;
128 bool dump_classes = false;
129 bool dump_fields = false;
130
131 int flag = getopt(argc, argv, optstr);
132
133 while (flag != EOF) {
134 switch (flag) {
135 case 'b':
136 dump_brief = true;
137 break;
138
139 case 'v':
140 dump_verbose = true;
141 break;
142
143 case 'c':
144 dump_classes = true;
145 break;
146
147 case 'f':
148 dump_fields = true;
149 break;
150
151 case 'h':
152 help();
153 exit(1);
154
155 default:
156 exit(1);
157 }
158 flag = getopt(argc, argv, optstr);
159 }
160
161 argc -= (optind-1);
162 argv += (optind-1);
163
164 if (argc < 2) {
165 usage();
166 exit(1);
167 }
168
169 DCFile file;
170 for (int i = 1; i < argc; i++) {
171 if (!file.read(argv[i])) {
172 return (1);
173 }
174 }
175
176 if (!file.all_objects_valid() && !dump_brief) {
177 cerr << "File is incomplete. The following objects are undefined:\n";
178
179 int num_typedefs = file.get_num_typedefs();
180 int i;
181 for (i = 0; i < num_typedefs; i++) {
182 DCTypedef *dtypedef = file.get_typedef(i);
183 if (dtypedef->is_bogus_typedef()) {
184 cerr << " " << dtypedef->get_name() << "\n";
185 }
186 }
187
188 int num_classes = file.get_num_classes();
189 for (i = 0; i < num_classes; i++) {
190 DCClass *dclass = file.get_class(i);
191 if (dclass->is_bogus_class()) {
192 cerr << " " << dclass->get_name() << "\n";
193 }
194 }
195
196 return 1;
197 }
198
199 if (dump_verbose || dump_brief) {
200 if (!file.write(cout, dump_brief)) {
201 return 1;
202 }
203
204 } else if (dump_classes) {
205 write_class_hierarchy(file);
206
207 } else if (dump_fields) {
208 write_complete_field_list(file);
209
210 } else {
211 unsigned long hash = file.get_hash();
212 cerr << "File hash is " << hash << " (signed " << (long)hash << ")\n";
213 }
214
215#ifdef DO_MEMORY_USAGE
217 file.clear();
219 for (int i = 1; i < argc; i++) {
220 file.read(argv[i]);
221 }
222 file.clear();
224 }
225#endif
226
227 return 0;
228}
Defines a particular DistributedClass as read from an input .dc file.
Definition dcClass.h:44
DCField * get_inherited_field(int n) const
Returns the nth field field in the class and all of its ancestors.
Definition dcClass.cxx:288
DCClass * get_parent(int n) const
Returns the nth parent class this class inherits from.
Definition dcClass.cxx:143
bool is_bogus_class() const
Returns true if the class has been flagged as a bogus class.
Definition dcClass.I:55
int get_num_inherited_fields() const
Returns the total number of field fields defined in this class and all ancestor classes.
Definition dcClass.cxx:255
const std::string & get_name() const
Returns the name of this class.
Definition dcClass.I:26
int get_num_parents() const
Returns the number of base classes this class inherits from.
Definition dcClass.cxx:135
A single field of a Distributed Class, either atomic or molecular.
Definition dcField.h:37
DCClass * get_class() const
Returns the DCClass pointer for the class that contains this field.
Definition dcField.I:27
virtual DCAtomicField * as_atomic_field()
Returns the same field pointer converted to an atomic field pointer, if this is in fact an atomic fie...
Definition dcField.cxx:112
virtual DCMolecularField * as_molecular_field()
Returns the same field pointer converted to a molecular field pointer, if this is in fact a molecular...
Definition dcField.cxx:130
Represents the complete list of Distributed Class descriptions as read from a .dc file.
Definition dcFile.h:32
unsigned long get_hash() const
Returns a 32-bit hash index associated with this file.
Definition dcFile.cxx:419
bool all_objects_valid() const
Returns true if all of the classes read from the DC file were defined and valid, or false if any of t...
Definition dcFile.I:20
int get_num_typedefs() const
Returns the number of typedefs read from the .dc file(s).
Definition dcFile.cxx:349
DCTypedef * get_typedef(int n) const
Returns the nth typedef read from the .dc file(s).
Definition dcFile.cxx:357
int get_num_classes() const
Returns the number of classes read from the .dc file(s).
Definition dcFile.cxx:244
bool write(Filename filename, bool brief) const
Opens the indicated filename for output and writes a parseable description of all the known distribut...
Definition dcFile.cxx:185
bool read(Filename filename)
Opens and reads the indicated .dc file by name.
Definition dcFile.cxx:124
DCClass * get_class(int n) const
Returns the nth class read from the .dc file(s).
Definition dcFile.cxx:252
void clear()
Removes all of the classes defined within the DCFile and prepares it for reading a new file.
Definition dcFile.cxx:59
const std::string & get_name() const
Returns the name of this field, or empty string if the field is unnamed.
This represents a single typedef declaration in the dc file.
Definition dcTypedef.h:26
const std::string & get_name() const
Returns the name of this typedef.
Definition dcTypedef.cxx:68
bool is_bogus_typedef() const
Returns true if the typedef has been flagged as a bogus typedef.
Definition dcTypedef.cxx:89
static void show_current_types()
Shows the breakdown of types of all of the active pointers.
is_tracking
Returns true if the MemoryUsage object is currently tracking memory (e.g.
Definition memoryUsage.h:93
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
std::ostream & indent(std::ostream &out, int indent_level)
A handy function for doing text formatting.
Definition indent.cxx:20
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.