source: cpp/frams/util/extvalue.cpp @ 786

Last change on this file since 786 was 786, checked in by Maciej Komosinski, 6 years ago

Improved shortening of long stringified values in error messages

  • Property svn:eol-style set to native
File size: 33.1 KB
RevLine 
[286]1// This file is a part of Framsticks SDK.  http://www.framsticks.com/
[753]2// Copyright (C) 1999-2018  Maciej Komosinski and Szymon Ulatowski.
[286]3// See LICENSE.txt for details.
[109]4
5#include "extvalue.h"
6#include <frams/param/param.h>
7#include "sstringutils.h"
8#include <ctype.h>
9#include <frams/vm/classes/collectionobj.h>
10#include <frams/vm/classes/3dobject.h>
[205]11#include <frams/vm/classes/genoobj.h>
[109]12#include <common/nonstd_math.h>
13#include <common/Convert.h>
[325]14#include <climits>
[333]15#include <errno.h>
[109]16
17#ifndef NO_BARRIER
18#include <frams/simul/barrier.h>
19#include <common/threads.h>
20#endif
21
22#ifdef MULTITHREADED
23#include <pthread.h>
24//this lock only protects against ref.counter corruption caused by concurrent reads.
25//read/write conficts and nonatomicity are handled by BarrierObject (at least in theory ;-))
[337]26static pthread_mutex_t extobject_ref_lock = PTHREAD_MUTEX_INITIALIZER;
[109]27#define REF_LOCK pthread_mutex_lock(&extobject_ref_lock)
28#define REF_UNLOCK pthread_mutex_unlock(&extobject_ref_lock)
29#else
30#define REF_LOCK
31#define REF_UNLOCK
32#endif
33
34void ExtObject::incref() const
35{
[337]36        if (subtype & 1)
[109]37        {
[337]38                REF_LOCK;
39                dbobject->refcount++;
40                REF_UNLOCK;
[109]41        }
42}
43
44void ExtObject::decref() const
45{
[337]46        if (subtype & 1)
[109]47        {
[337]48                REF_LOCK;
49                bool destroy = !--dbobject->refcount;
50                REF_UNLOCK;
51                //another thread can now access the object while we are deleting it
52                //but this is not a bug since we only guarantee read/read safety
53                if (destroy) delete dbobject;
[109]54        }
55}
56
[257]57bool ExtObject::operator==(const ExtObject& src) const
58{
[337]59        if (object != src.object) return false;
60        const char* n1 = interfaceName();
61        const char* n2 = src.interfaceName();
62        return (n1 == n2) || (strcmp(n1, n2) == 0);
[257]63}
64
[109]65bool ExtObject::makeUnique()
66{
[337]67        if (!(subtype & 1)) return false;
68        if (dbobject->refcount == 1) return false;
69        VectorObject* v = VectorObject::fromObject(*this, false);
70        if (v)
[109]71        {
[337]72                VectorObject* n = new VectorObject;
73                n->data.setSize(n->data.size());
74                for (int i = 0; i < v->data.size(); i++)
[109]75                {
[337]76                        ExtValue *x = (ExtValue*)v->data(i);
77                        n->data.set(i, x ? new ExtValue(*x) : NULL);
[109]78                }
[337]79                operator=(n->makeObject());
80                return true;
[109]81        }
[337]82        return false;
[109]83}
84
[171]85void* ExtObject::getTarget(const char* classname, bool through_barrier, bool warn) const
[109]86{
[337]87        if (!strcmp(interfaceName(), classname))
88                return getTarget();
[109]89#ifndef NO_BARRIER
[337]90        if (through_barrier)
[109]91        {
[337]92                BarrierObject *bo = BarrierObject::fromObject(*this);
93                if (bo)
94                        return bo->getSourceObject().getTarget(classname, true, warn);
[109]95        }
96#endif
[171]97
[337]98        if (warn)
[171]99        {
[375]100                logPrintf("ExtValue", "getObjectTarget", LOG_WARN, "%s object expected, %s found", classname, interfaceName());
[171]101        }
102
[337]103        return NULL;
[109]104}
105
[522]106bool ExtObject::callDelegate(const char* delegate, ExtValue *args, ExtValue *ret)
[478]107{
[522]108        Param tmp;
109        ParamInterface *pi = getParamInterface(tmp);
110        if (pi)
[478]111        {
[522]112                int f = pi->findId(delegate);
113                if (f >= 0)
[478]114                {
[522]115                        pi->call(f, args, ret);
116                        return true;
[478]117                }
118        }
[522]119        logPrintf("Genotype", "get", LOG_ERROR, "Could not call delegate '%s.%s'", pi ? pi->getName() : "NULL", delegate);
120        return false;
[478]121}
[109]122
123SString ExtObject::toString() const
124{
[337]125        if (isEmpty()) return SString("null");
126        Param tmp_param;
127        ParamInterface *p = getParamInterface(tmp_param);
128        int tostr = p->findId("toString");
129        if (tostr >= 0)
[109]130        {
[337]131                return SString(p->getString(tostr));
[109]132        }
[337]133        else
[109]134        {
[337]135                SString tmp("<");
136                tmp += p->getName();
137                tmp += SString::sprintf(" object at %p>", object ? object : paraminterface);
138                return tmp;
[109]139        }
140}
141
[371]142THREAD_LOCAL_DEF(ExtObject::Serialization, ExtObject_serialization);
[109]143
144void ExtObject::Serialization::begin()
145{
[337]146        if (level == 0)
147                refs.clear();
148        level++;
[109]149}
150
151int ExtObject::Serialization::add(const ExtObject &o)
152{
[337]153        if (o.isEmpty()) return -1;
154        for (int i = 0; i < (int)refs.size(); i++)
[109]155        {
[337]156                ExtObject& r = refs[i];
157                if (r == o) return i;
[109]158        }
[337]159        refs.push_back(o);
160        return -1;
[109]161}
162
[337]163void ExtObject::Serialization::replace(const ExtObject& o, const ExtObject& other)
[109]164{
[337]165        if (o.isEmpty()) return;
166        for (int i = 0; i < (int)refs.size(); i++)
[109]167        {
[337]168                ExtObject& r = refs[i];
169                if (r == o)
[109]170                {
[337]171                        r = other;
172                        return;
[109]173                }
174        }
175}
176
177void ExtObject::Serialization::remove(const ExtObject& o)
178{
[337]179        if (o.isEmpty()) return;
180        for (int i = 0; i < (int)refs.size(); i++)
[109]181        {
[337]182                ExtObject& r = refs[i];
183                if (o == r) refs.erase(refs.begin() + i);
[109]184        }
185}
186
187const ExtObject* ExtObject::Serialization::get(int ref)
188{
[337]189        if (ref < 0) return NULL;
190        if (ref >= (int)refs.size()) return NULL;
191        return &refs[ref];
[109]192}
193
194void ExtObject::Serialization::end()
195{
[337]196        level--;
197        if (level == 0)
198                refs.clear();
[109]199}
200
[464]201SString ExtObject::serialize_inner(SerializationFormat format) const
[109]202{
[371]203        int ref = tlsGetRef(ExtObject_serialization).add(*this);
[464]204        SString ret;
205
[337]206        if (ref >= 0)
[522]207        {
208                switch (format)
[464]209                {
[522]210                case NativeSerialization: return SString::sprintf("^%d", ref);
211                case JSONSerialization: return SString("null");
[464]212                }
[522]213        }
[109]214
[337]215        if (isEmpty()) return SString("null");
[464]216        {
[522]217                VectorObject *vec = VectorObject::fromObject(*this, false);
218                if (vec)
219                {
220                        ret = vec->serialize(format); goto finally;
221                }
[464]222        }
223        {
[522]224                DictionaryObject *dic = DictionaryObject::fromObject(*this, false);
225                if (dic)
226                {
227                        ret = dic->serialize(format); goto finally;
228                }
[464]229        }
230        {
[522]231                Param tmp_param;
232                ParamInterface *p = getParamInterface(tmp_param);
233                int m = p->findId("toVector");
234                if (m < 0)
235                        m = p->findId("toDictionary");
236                if (m >= 0)
237                {
238                        ExtObject o(p->getObject(m));
239                        switch (format)
[464]240                        {
[522]241                        case NativeSerialization: ret = SString(interfaceName()) + o.serialize(format); break;
242                        case JSONSerialization: ret = SString::sprintf("{\"class\":\"%s\",\"data\":%s}", interfaceName(), o.serialize(format).c_str()); break;
[464]243                        }
[522]244                        goto finally;
245                }
246                m = p->findId("toString");
247                if (m >= 0)
248                {
249                        SString str = p->getString(m);
250                        sstringQuote(str);
251                        switch (format)
[464]252                        {
[522]253                        case NativeSerialization: ret = SString(interfaceName()) + "\"" + str + "\""; break;
254                        case JSONSerialization: ret = SString::sprintf("{\"class\":\"%s\",\"data\":\"%s\"}", interfaceName(), str.c_str()); break;
[464]255                        }
[522]256                        goto finally;
257                }
[109]258        }
259
[371]260        tlsGetRef(ExtObject_serialization).remove(*this);//undo nonserializable reference
[522]261        switch (format)
262        {
263        case NativeSerialization: return SString(interfaceName()) + SString::sprintf("<%p>", object ? object : paraminterface); break;
264        case JSONSerialization: return SString::sprintf("{\"class\":\"%s\"}", interfaceName()); break;
265        }
[464]266
[522]267        finally: // not 100% "finally", the case of nonserializable reference (directly above) returns directly without going through finally
[464]268
[522]269        switch (format)
270        {
271        case JSONSerialization:
272                tlsGetRef(ExtObject_serialization).remove(*this);//JSON only tracks recursion, does not track reuse
273                break;
274        case NativeSerialization:; //nop (just to avoid compiler warning)
275        }
[464]276
[337]277        return ret;
[109]278}
279
[464]280SString ExtObject::serialize(SerializationFormat format) const
[109]281{
[371]282        tlsGetRef(ExtObject_serialization).begin();
[464]283        SString ret = serialize_inner(format);
[371]284        tlsGetRef(ExtObject_serialization).end();
[337]285        return ret;
[109]286}
287
288///////////////////////////////////////
289
[228]290SString ExtValue::typeDescription() const
291{
[337]292        switch (type)
[228]293        {
[337]294        case TInt: return SString("int");
295        case TDouble: return SString("float");
296        case TString: return SString("string");
297        case TUnknown: return SString("null");
298        case TInvalid: return SString("invalid");
299        case TObj: return getObject().isEmpty() ? SString("null") : SString(getObject().interfaceName());
[228]300        }
[337]301        return SString::empty();
[228]302}
303
[337]304SString ExtValue::typeAndValue() const
[171]305{
[337]306        SString msg = typeDescription();
[786]307        SString delimit("'");
[337]308        switch (type)
[171]309        {
[786]310        case TString:
311                delimit = "\"";
312        case TInt: case TDouble: case TObj:
313                msg += " ";
314                msg += sstringDelimitAndShorten(getString(), 50, (type == TString), delimit, delimit);
[337]315        default:;
316        }
317        return msg;
318}
319
320void *ExtValue::getObjectTarget(const char* classname, bool warn) const
321{
322        if (type != TObj)
323        {
324                if (warn)
[171]325                {
[337]326                        SString tmp = getString();
327                        if (tmp.len() > 30) tmp = tmp.substr(0, 30) + "...";
328                        if (type == TString) tmp = SString("\"") + tmp + SString("\"");
[375]329                        logPrintf("ExtValue", "getObjectTarget", LOG_WARN, "%s object expected, %s found", classname, tmp.c_str());
[171]330                }
[337]331                return NULL;
[171]332        }
333
[337]334        return getObject().getTarget(classname, true, warn);
[171]335}
336
[109]337void ExtValue::set(const ExtValue& src)
338{
[337]339        switch (src.type)
[109]340        {
341        case TString: sets(src.sdata()); break;
342        case TInt: seti(src.idata()); break;
343        case TDouble: setd(src.ddata()); break;
344        case TObj: seto(src.odata()); break;
[337]345        default:type = src.type; break;
[109]346        }
347}
348
349void ExtValue::setEmpty()
350{
[337]351        switch (type)
[109]352        {
353#ifdef EXTVALUEUNION
354        case TString: sdata().~SString(); break;
355        case TObj: odata().~ExtObject(); break;
356#else
357        case TString: delete s; break;
358        case TObj: delete o; break;
359#endif
360        default:;
361        }
[337]362        type = TUnknown;
[109]363}
364
[490]365void ExtValue::setError(const SString& msg)
366{
[522]367        ErrorObject *err = new ErrorObject;
368        err->message = msg;
369        setObject(ErrorObject::makeDynamicObject(err));
[490]370}
371
[333]372static ExtValue::CompareResult longsign(paInt x)
[109]373{
[337]374        if (x < 0) return ExtValue::ResultLower;
375        if (x > 0) return ExtValue::ResultHigher;
376        return ExtValue::ResultEqual;
[109]377}
378
[333]379static ExtValue::CompareResult compareNull(const ExtValue& v)
[144]380{
[337]381        if (v.isNull()) return ExtValue::ResultEqualUnordered;
382        if ((v.getType() == TInt) && (v.getInt() == 0)) return ExtValue::ResultUnequal_RelaxedEqual;
383        return ExtValue::ResultUnequal_RelaxedUnequal; //comparing anything else with null is valid but null is neither higher nor lower than numbers or strings
[144]384}
385
[490]386static ExtValue::CompareResult compareInvalid(const ExtValue& v)
387{
[522]388        if (v.getType() == TInvalid) return ExtValue::ResultEqualUnordered;
[490]389        if ((v.getType() == TInt) && (v.getInt() == 0)) return ExtValue::ResultUnequal_RelaxedEqual;
390        return ExtValue::ResultMismatch; //comparing anything else with invalid is invalid
391}
392
[337]393static ExtValue::CompareResult compareFloat(double a, double b)
[109]394{
[337]395        double t = a - b;
396        if (t < 0) return ExtValue::ResultLower;
397        else if (t > 0) return ExtValue::ResultHigher;
398        return ExtValue::ResultEqual;
[333]399}
400
[337]401static ExtValue::CompareResult compareString(const SString &a, const SString &b)
[333]402{
[348]403        const char* s1 = a.c_str();
404        const char* s2 = b.c_str();
[337]405        return longsign(strcmp(s1, s2));
[333]406}
407
408ExtValue::CompareResult ExtValue::compare(const ExtValue& src) const
409{
[337]410        if (isNull())
411                return compareNull(src);
412        else if (src.isNull())
413                return compareNull(*this);
[522]414        if (getType() == TInvalid)
[490]415                return compareInvalid(src);
[522]416        else if (src.getType() == TInvalid)
[490]417                return compareInvalid(*this);
[337]418        switch (type)
[109]419        {
[333]420
[109]421        case TInt:
[333]422
[337]423                if (src.getType() == TInt)
424                {
425                        paInt t = src.getInt();
426                        if (idata() > 0)
[333]427                        {
[337]428                                if (t > 0) return longsign(idata() - t); else return ResultHigher;
429                        }
[333]430                        else
[337]431                        {
432                                if (t <= 0) return longsign(idata() - t); else return ResultLower;
[333]433                        }
[337]434                }
435                else if (src.getType() == TDouble)
436                        return compareFloat((double)idata(), src.getDouble());
[333]437                else
438                        return ResultMismatch;//comparing numbers with other things is invalid
439                break;
440
[109]441        case TDouble:
[337]442                if ((src.getType() == TDouble) || (src.getType() == TInt))
443                        return compareFloat(getDouble(), src.getDouble());
[333]444                else
445                        return ResultMismatch;
446                break;
447
[109]448        case TString:
[337]449                if (src.getType() == TString)
450                        return compareString(sdata(), src.getString());
[333]451                else
452                        return ResultMismatch;
453                break;
454
[337]455        case TObj:
[109]456        {
[337]457                if (src.type == TObj)
458                        return odata() == src.odata() ? ResultEqualUnordered : ResultUnequal_RelaxedUnequal;
459                if ((src.type == TInt) && (src.getInt() == 0))
460                        return ResultMismatch_RelaxedUnequal;
461                return ResultMismatch;
[109]462        }
463        default:;
464        }
[337]465        return ResultMismatch;
[109]466}
467
[337]468const char* ExtValue::cmp_op_names[] = { "==", "!=", ">=", "<=", ">", "<", "~=", "!~", NULL };
[333]469
[337]470int ExtValue::interpretCompare(CmpOperator op, CompareResult result, CmpContext *context)
[333]471{
[337]472        CompareResult error_threshold = ResultUnequal_RelaxedEqual;//error when ResultUnequal_RelaxedEqual or higher (not comparable)
473        int ret = 0;
474        switch (op)
[333]475        {
[337]476        case CmpEQ: ret = (result == ResultEqual) || (result == ResultEqualUnordered); error_threshold = ResultMismatch_RelaxedUnequal; break;
477        case CmpNE: ret = !((result == ResultEqual) || (result == ResultEqualUnordered)); error_threshold = ResultMismatch_RelaxedUnequal; break;
478        case CmpGT: ret = (result == ResultHigher); error_threshold = ResultEqualUnordered; break;
479        case CmpGE: ret = (result == ResultEqual) || (result == ResultHigher); error_threshold = ResultEqualUnordered; break;
480        case CmpLT: ret = (result == ResultLower); error_threshold = ResultEqualUnordered; break;
481        case CmpLE: ret = (result == ResultEqual) || (result == ResultLower); error_threshold = ResultEqualUnordered; break;
482        case CmpREQ: ret = (result == ResultEqual) || (result == ResultEqualUnordered) || (result == ResultUnequal_RelaxedEqual); error_threshold = ResultMismatch; break;
483        case CmpRNE: ret = !((result == ResultEqual) || (result == ResultEqualUnordered) || (result == ResultUnequal_RelaxedEqual)); error_threshold = ResultMismatch; break;
[333]484        default:;
485        }
[337]486        if (result >= error_threshold)
[333]487        {
[337]488                SString msg = "Type mismatch while comparing";
489                if (context)
[333]490                {
[337]491                        if (context->v1 && context->v2)
492                                msg += SString::sprintf(": %s %s %s",
[348]493                                context->v1->typeAndValue().c_str(),
[337]494                                cmp_op_names[op - CmpFIRST],
[348]495                                context->v2->typeAndValue().c_str());
[333]496                }
[375]497                logPrintf("ExtValue", "interpretCompare", LOG_ERROR, "%s", msg.c_str());
[337]498                ret = -1;
[333]499        }
[337]500        return ret;
[333]501}
502
[109]503int ExtValue::operator==(const ExtValue& src) const
504{
[337]505        if (type != src.type) return 0;
506        switch (type)
[109]507        {
[337]508        case TInt: return idata() == src.idata();
509        case TDouble: return ddata() == src.ddata();
510        case TString: return sdata() == src.sdata();
511        case TObj: return odata() == src.odata();
[109]512        default:;
513        }
[337]514        return 1;
[109]515}
516
517void ExtValue::operator+=(const ExtValue& src)
518{
[337]519        // return = ok, break = fail
520        switch (type)
[109]521        {
[337]522        case TInt:
523                switch (src.getType())
524                {
525                case TDouble:
526                        setDouble(double(getInt()) + src.getDouble());
527                        return;
528                case TString:
529                        break;
530                default:
531                        idata() += src.getInt();
532                        return;
533                }
534                break;
535        case TDouble:
536                switch (src.getType())
537                {
538                case TString:
539                        break;
540                default:
541                        ddata() += src.getDouble();
542                        return;
543                }
544                break;
545        case TString: sdata() += src.getString(); return;
[109]546        case TObj:
[337]547        {
548                VectorObject *vec = VectorObject::fromObject(getObject(), false);
549                VectorObject *vec2 = VectorObject::fromObject(src.getObject(), false);
550                if (vec && vec2)
[109]551                {
[337]552                        for (int i = 0; i < vec2->data.size(); i++)
[109]553                        {
[337]554                                ExtValue *s = (ExtValue*)vec2->data(i);
555                                ExtValue *d = s ? new ExtValue(*s) : NULL;
556                                vec->data += d;
557                        }
[228]558                        return;
[109]559                }
[337]560        }
[228]561                //NO break;
[109]562        default:;
563        }
[375]564        logPrintf("ExtValue", "add", LOG_ERROR, "Can't add %s to %s", src.typeAndValue().c_str(), typeAndValue().c_str());
[109]565}
566
567void ExtValue::operator-=(const ExtValue& src)
568{
[337]569        // return = ok, break = fail
570        switch (type)
[109]571        {
[337]572        case TInt:
573                switch (src.getType())
574                {
575                case TInt:
576                        idata() -= src.getInt();
577                        return;
578                case TDouble:
579                        setDouble(double(getInt()) - src.getDouble());
580                        return;
581                default:;
582                }
[228]583                break;
[337]584        case TDouble:
585                switch (src.getType())
586                {
587                case TDouble:
588                case TInt:
589                        ddata() -= src.getDouble();
590                        return;
591                default:;
592                }
593                break;
[109]594        default:;
595        }
[375]596        logPrintf("ExtValue", "subtract", LOG_ERROR, "Can't subtract %s from %s", src.typeAndValue().c_str(), typeAndValue().c_str());
[109]597}
598
599void ExtValue::operator*=(const ExtValue& src)
600{
[337]601        // return = ok, break = fail
602        switch (type)
[109]603        {
[337]604        case TInt:
605                switch (src.getType())
606                {
607                case TInt:
608                        idata() *= src.getInt();
609                        return;
610                case TDouble:
611                        setDouble(double(getInt())*src.getDouble());
612                        return;
613                default:;
614                }
615                break;
616        case TDouble:
617                switch (src.getType())
618                {
619                case TInt:
620                case TDouble:
621                        ddata() *= src.getDouble();
622                        return;
623                default:;
624                }
625                break;
[109]626        case TString:
[337]627                switch (src.getType())
628                {
629                case TInt: case TDouble:
630                {
631                        SString t;
632                        for (int n = src.getInt(); n > 0; n--)
633                                t += getString();
634                        setString(t);
635                        return;
636                }
637                default:;
638                }
639                break;
640        case TObj:
[109]641        {
[337]642                VectorObject *vec = VectorObject::fromObject(getObject(), false);
643                if (vec)
[109]644                {
[337]645                        int n = src.getInt();
646                        int orig_size = vec->data.size();
647                        if (n <= 0)
[109]648                        {
[337]649                                vec->clear(); return;
650                        }
651                        for (; n > 1; n--)
652                        {
653                                for (int i = 0; i < orig_size; i++)
[109]654                                {
[337]655                                        ExtValue *s = (ExtValue*)vec->data(i);
656                                        ExtValue *d = s ? new ExtValue(*s) : NULL;
657                                        vec->data += d;
[109]658                                }
[337]659                        }
[228]660                        return;
661                }
[337]662        }
[228]663                //NO break;
[109]664        default:;
665        }
[375]666        logPrintf("ExtValue", "multiply", LOG_WARN, "Can't multiply %s by %s", typeAndValue().c_str(), src.typeAndValue().c_str());
[109]667}
668
669/*#include "fpu_control.h"
670#include <signal.h>
671
672static int fpuexception;
673void mathhandler(int sig)
674{
675printf("fpu exception!\n");
676fpuexception=1;
677signal(SIGFPE,SIG_IGN);
678} */
679
[337]680void ExtValue::divInt(paInt a)
681{
682        if (a)
683                idata() /= a;
684        else
685        {
[478]686                logPrintf("ExtValue", "divide", LOG_ERROR, "Division by zero: %d/0", idata());
[337]687                setInvalid();
688        }
689}
690
691void ExtValue::divDouble(double a)
692{
693        if (a == 0.0)
694        {
[478]695                logPrintf("ExtValue", "divide", LOG_ERROR, "Division by zero: %s/0.0", getString().c_str());
[337]696                setInvalid();
697        }
698        else
699        {
700                fpExceptDisable();
701                double tmp = getDouble() / a;
702                if (!finite(tmp))
703                {
[478]704                        logPrintf("ExtValue", "divide", LOG_ERROR, "Overflow %s/%g", getString().c_str(), a); setInvalid();
[337]705                }
706                else
707                        setDouble(tmp);
708                // niby dobrze ale lepiej byloby to robic bardziej systematycznie a nie tylko w dzieleniu?
709                //if (isnan(ddata())) //http://www.digitalmars.com/d/archives/c++/Traping_divide_by_zero_5728.html
[375]710                //        { logPrintf("ExtValue","divide",LOG_ERROR,"not-a-number",(const char*)getString()); setInvalid(); }
[337]711                fpExceptEnable();
712        }
713}
714
[109]715void ExtValue::operator/=(const ExtValue& src)
716{
[337]717        switch (type)
[109]718        {
719        case TInt:
[337]720                switch (src.getType())
721                {
722                case TInt:
723                        divInt(src.idata());
724                        return;
725                case TDouble:
726                        divDouble(src.ddata());
727                        return;
728                default:;
729                }
[109]730                break;
731
732        case TDouble:
[337]733                switch (src.getType())
[109]734                {
[337]735                case TInt:
736                        divDouble(src.getDouble());
737                        return;
738                case TDouble:
739                        divDouble(src.ddata());
740                        return;
741                default:;
[109]742                }
743                break;
744
745        default:;
746        }
[375]747        logPrintf("ExtValue", "divide", LOG_ERROR, "Can't divide %s by %s", typeAndValue().c_str(), src.typeAndValue().c_str());
[109]748}
749
[639]750SString ExtValue::formatTime(char fmt, double value)
[109]751{
[753]752        if (fmt == 'i')
[639]753        { //could be Convert::ctime()
[753]754                int d, h, m, ti = value;
755                int ms = 1000 * (value - ti);
756                d = ti / 86400; ti -= d * 86400;
757                h = ti / 3600; ti -= h * 3600;
758                m = ti / 60; ti -= m * 60;
759                SString ret;
760                if (d > 0) ret += SString::sprintf("%dd ", d);
761                if (h > 0) ret += SString::sprintf("%d:", h);
762                ret += SString::sprintf("%02d:%02d.%03d", m, ti, ms);
763                return ret;
[639]764        }
[753]765        time_t ti = value;
766        struct tm tm = Convert::localtime(ti);
767        switch (fmt)
[639]768        {
769        case 'T': return SString::sprintf("%04d-%02d-%02d %02d:%02d:%02d", 1900 + tm.tm_year, 1 + tm.tm_mon, tm.tm_mday, tm.tm_hour, tm.tm_min, tm.tm_sec);
770        case 't': return SString(Convert::asctime(tm).c_str());
771        case 'y': return SString::sprintf("%04d-%02d-%02d", 1900 + tm.tm_year, 1 + tm.tm_mon, tm.tm_mday);
[753]772        case 'm': return SString::sprintf("%04d-%02d-%02d %02d:%02d:%02d.%03d", 1900 + tm.tm_year, 1 + tm.tm_mon, tm.tm_mday, tm.tm_hour, tm.tm_min, tm.tm_sec, int(1000 * (value - (double)ti)));
[639]773        }
[753]774        return SString();
[639]775}
776
777SString ExtValue::format(const SString& fmt, const ExtValue **values, int count)
778{
779        SString ret;
[337]780        // "..........%.........%..........%........"
781        //  ^_cur     ^_next
782        //  ^^^^^^^^^^___sub
783        //
784        // "..........%.........%..........%........"
785        //            ^-cur     ^-next
786        //            ^^^^^^^^^^___sub
[348]787        const char* begin = fmt.c_str(), *end = begin + fmt.len(), *curr = begin;
[337]788        int type = 0;
[109]789
[337]790        class Args
791        {
792                const ExtValue **values;
793                int count;
794                int arg;
795        public:
796                Args(const ExtValue **v, int c) :values(v), count(c), arg(0) {}
797                bool finished() { return arg >= count; }
798                const ExtValue *getNext() { const ExtValue *ret = NULL; if ((arg < count) && values[arg]) ret = values[arg]; arg++; return ret; }
799        };
800        Args args(values, count);
[109]801
[337]802        while (curr < end)
[109]803        {
[337]804                const char* next = strchr(curr, '%');
805                if (!next) next = end; else if ((next == curr) && (curr > begin))
[109]806                {
[337]807                        next = strchr(next + 1, '%'); if (!next) next = end;
[109]808                }
[337]809                type = 0;
810                if (curr > begin)
[109]811                {
[337]812                        type = 0;
813                        for (const char* t = curr; t < next; t++)
814                                switch (*t)
815                        {
816                                case 'd': case 'x': case 'X': case 'u': case 'p': case 'c': type = 'd'; t = next; break;
817                                case 'f': case 'g': case 'e': type = 'f'; t = next; break;
818                                case 's': type = 's'; t = next; break;
[639]819                                case 't': case 'T': case 'y': case 'i': case 'm': type = *t; t = next; break;
[337]820                                case '%': if (t > begin) { type = *t; t = next; } break;
821                        }
[109]822                }
[337]823                if (curr > begin) curr--;
824                const ExtValue *a;
825                if (args.finished() && (type != 0) && (type != '%'))
[109]826                {
[337]827                        ret += fmt.substr((int)(curr - begin));
828                        break;
829                }
830                SString sub = fmt.substr((int)(curr - begin), (int)(next - curr));
831                switch (type)
832                {
[348]833                case 'd': a = args.getNext(); ret += SString::sprintf(sub.c_str(), a ? a->getInt() : 0); break;
834                case 'f': a = args.getNext(); ret += SString::sprintf(sub.c_str(), a ? a->getDouble() : 0); break;
835                case 's': {a = args.getNext(); SString tmp; if (a) tmp = a->getString(); ret += SString::sprintf(sub.c_str(), tmp.c_str()); } break;
[639]836                case 't': case 'T': case 'i': case 'y': case 'm':
[337]837                        a = args.getNext();
[753]838                        ret += formatTime(type, a ? a->getDouble() : 0);
[337]839                        ret += sub.substr(2);
[109]840                        break;
[337]841                case '%': ret += '%'; ret += sub.substr(2); break;
842                case 0: ret += sub; break;
[109]843                }
[337]844                curr = next + 1;
[109]845        }
[337]846        return ret;
[109]847}
848
849
[636]850void ExtValue::modInt(paInt a)
851{
852        if (a)
853                idata() %= a;
854        else
855        {
856                logPrintf("ExtValue", "modulo", LOG_ERROR, "Modulo by zero: %d%%0", idata());
857                setInvalid();
858        }
859}
860
861void ExtValue::modDouble(double a)
862{
863        if (a == 0.0)
864        {
865                logPrintf("ExtValue", "modulo", LOG_ERROR, "Modulo by zero: %s%%0.0", getString().c_str());
866                setInvalid();
867        }
868        else
[753]869                setDouble(fmod(ddata(), a));
[636]870}
871
[109]872void ExtValue::operator%=(const ExtValue& src)
873{
[337]874        switch (type)
[109]875        {
[636]876        case TInt: modInt(src.getInt()); break;
877        case TDouble: modDouble(src.getDouble()); break;
[109]878
879        case TString:
880        {
[337]881                VectorObject *vec = VectorObject::fromObject(src.getObject(), false);
882                if (vec)
883                        sdata() = format(sdata(), (const ExtValue**)&vec->data.getref(0), vec->data.size());
884                else
885                {
886                        const ExtValue *ptr = &src; sdata() = ExtValue::format(sdata(), &ptr, 1);
887                }
[109]888        }
[337]889                break;
[109]890
[228]891        case TObj: case TUnknown: case TInvalid:
[375]892                logPrintf("ExtValue", "modulo", LOG_WARN, "Can't apply modulo to %s", typeDescription().c_str());
[228]893
[109]894        default:;
895        }
896}
897
[326]898bool ExtValue::parseInt(const char* s, paInt &result, bool strict, bool error)
[144]899{
[325]900        ExtValue tmp;
901        const char* after = tmp.parseNumber(s, strict ? TInt : TUnknown);
[326]902        if ((after == NULL) || (after[0] != 0))
[337]903        {
904                if (error)
[375]905                        logPrintf("ExtValue", "parseInt", LOG_ERROR, "Could not parse '%s'%s", s, strict ? " (strict)" : "");
[326]906                return false;
[337]907        }
[325]908        result = tmp.getInt();
909        return true;
[144]910}
911
[326]912bool ExtValue::parseDouble(const char* s, double &result, bool error)
[325]913{
914        ExtValue tmp;
915        const char* after = tmp.parseNumber(s, TDouble);
[326]916        if ((after == NULL) || (after[0] != 0))
[337]917        {
918                if (error)
[375]919                        logPrintf("ExtValue", "parseDouble", LOG_ERROR, "Could not parse '%s'", s);
[326]920                return false;
[337]921        }
[325]922        result = tmp.getDouble();
923        return true;
924}
925
[337]926paInt ExtValue::getInt(const char* s, bool strict)
[325]927{
928        paInt result;
[326]929        if (parseInt(s, result, strict, true))
[325]930                return result;
931        return 0;
932}
933
[144]934double ExtValue::getDouble(const char* s)
935{
[325]936        double result;
[326]937        if (parseDouble(s, result, true))
[325]938                return result;
939        return 0;
[144]940}
941
[247]942paInt ExtValue::getInt() const
[109]943{
[325]944        switch (type)
[109]945        {
946        case TInt: return idata();
947        case TDouble: return (int)ddata();
[348]948        case TString: return getInt(sdata().c_str());
[144]949        case TObj:
[478]950                logPrintf("ExtValue", "getInt", LOG_ERROR, "Getting integer value from object reference (%s)", getString().c_str());
[247]951                return (paInt)(intptr_t)odata().param;
[109]952        default:;
953        }
[325]954        return 0;
[109]955}
[144]956
[109]957double ExtValue::getDouble() const
958{
[325]959        switch (type)
[109]960        {
961        case TDouble: return ddata();
962        case TInt: return (double)idata();
[348]963        case TString: return getDouble(sdata().c_str());
[144]964        case TObj:
[478]965                logPrintf("ExtValue", "getDouble", LOG_ERROR, "Getting floating point value from object reference (%s)", getString().c_str());
[247]966                return (double)(intptr_t)odata().param;
[109]967        default:;
968        }
[325]969        return 0.0;
[109]970}
[325]971
[109]972SString ExtValue::getString() const
973{
[325]974        switch (type)
[109]975        {
976        case TString: return sdata();
977        case TInt: return SString::valueOf(idata());
978        case TDouble: return SString::valueOf(ddata());
979        case TObj: return odata().toString();
980        case TInvalid:  return SString("invalid");
981        default: return SString("null");
982        }
983}
984
985const SString* ExtValue::getStringPtr() const
986{
[325]987        if (type == TString)
988                return &sdata();
989        return NULL;
[109]990}
991
[464]992SString ExtValue::serialize(SerializationFormat format) const
[109]993{
[337]994        switch (type)
[109]995        {
996        case TString:
[337]997        {
998                SString q = sdata();
[109]999                sstringQuote(q);
[337]1000                return SString("\"") + q + SString("\"");
1001        }
[109]1002        case TInt:
1003                return SString::valueOf(idata());
1004        case TDouble:
1005                return SString::valueOf(ddata());
1006        case TObj:
[464]1007                return odata().serialize(format);
[109]1008        case TInvalid:
[522]1009                if (format == NativeSerialization)
[464]1010                        return SString("invalid");
1011                // else null --v
[109]1012        default:
1013                return SString("null");
1014        }
1015}
1016
[325]1017/// returns the first character after the parsed number, or NULL if not a number
1018/// @param strict_type = restrict the allowed return value (TUnknown = unrestricted)
1019const char* ExtValue::parseNumber(const char* in, ExtPType strict_type)
[109]1020{
[325]1021        char* after;
1022        if (in == NULL) return NULL;
1023        if (in[0] == 0) return NULL;
1024        while (isspace(*in)) in++;
[326]1025        bool minus = (in[0] == '-');
1026        bool plus = (in[0] == '+');
[337]1027        if (((in[0] == '0') && ((in[1] == 'x') || (in[1] == 'X')))
1028                || (((minus || plus) && (in[1] == '0') && ((in[2] == 'x') || (in[2] == 'X')))))
[109]1029        {
[326]1030                in += (minus || plus) ? 3 : 2;
[325]1031                if (isspace(*in)) return NULL;
1032                errno = 0;
1033                unsigned long intvalue = strtoul(in, &after, 16);
1034                if ((after > in) && (errno == 0) && (intvalue <= 0xffffffff))
[109]1035                {
[325]1036                        if (strict_type == TDouble)
1037                                setDouble(minus ? -(double)intvalue : (double)intvalue);
1038                        else
[698]1039                                setInt(minus ? -(paInt)intvalue : (paInt)intvalue);
[325]1040                        return after;
[109]1041                }
[325]1042                else
1043                        return NULL;
1044        }
[109]1045
[325]1046        errno = 0;
1047        double fpvalue = strtod(in, &after);
1048        if ((after > in) && (errno == 0))
1049        {
1050                if (strict_type != TDouble)
[109]1051                {
[325]1052                        if ((memchr(in, '.', after - in) == NULL) && (memchr(in, 'e', after - in) == NULL) && (memchr(in, 'E', after - in) == NULL) // no "special" characters
1053                                && (fpvalue == floor(fpvalue)) // value is integer
1054                                && (fpvalue >= INT_MIN) && (fpvalue <= INT_MAX)) // within limits
1055                        {
1056                                setInt(fpvalue);
1057                                return after;
1058                        }
1059                        else if (strict_type == TInt)
1060                                return NULL;
[109]1061                }
[325]1062                setDouble(fpvalue);
1063                return after;
[109]1064        }
[325]1065        return NULL;
[109]1066}
1067
[222]1068PtrListTempl<ParamInterface*> &ExtValue::getDeserializableClasses()
[109]1069{
[337]1070        static PtrListTempl<ParamInterface*> classes;
1071        return classes;
[109]1072}
1073
1074ParamInterface *ExtValue::findDeserializableClass(const char* name)
1075{
[337]1076        FOREACH(ParamInterface*, cls, getDeserializableClasses())
1077                if (!strcmp(cls->getName(), name))
1078                        return cls;
1079        return NULL;
[109]1080}
1081
1082static const char* skipWord(const char* in)
1083{
[337]1084        while (isalpha(*in) || (*in == '_'))
1085                in++;
1086        return in;
[109]1087}
1088
1089//returns the first character after the parsed portion or NULL if invalid format
1090const char* ExtValue::deserialize_inner(const char* in)
1091{
[522]1092        while (isspace(*in)) in++;
[337]1093        const char* ret = parseNumber(in);
1094        if (ret)
1095                return ret;
1096        else if (*in == '\"')
[109]1097        {
[337]1098                ret = skipQuoteString(in + 1, NULL);
1099                SString s(in + 1, (int)(ret - (in + 1)));
1100                sstringUnquote(s);
1101                setString(s);
1102                if (*ret == '\"')
1103                        return ret + 1;
1104                else
[333]1105                {
[375]1106                        logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing '\"' in string: '%s'", ret);
[337]1107                        return NULL;
[333]1108                }
[109]1109        }
[337]1110        else if (*in == '[')
[109]1111        {
[337]1112                VectorObject *vec = new VectorObject;
1113                ExtObject o(&VectorObject::par, vec);
[371]1114                tlsGetRef(ExtObject_serialization).add(o);
[337]1115                const char* p = in + 1;
[753]1116                ExtValue tmp; bool first = true, comma = false;
1117                const char* prev_element = p;
1118                while (true)
[109]1119                {
[753]1120                        while (isspace(*p)) p++;
1121                        if (*p == 0)
1122                        {
1123                                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing ']' in Vector");
1124                                return NULL;
1125                        }
1126                        if (*p == ']')
1127                        {
1128                                if (comma)
1129                                {
1130                                        logPrintf("ExtValue", "deserialize", LOG_ERROR, "No element after ',' in Vector");
1131                                        return NULL;
1132                                }
1133                                p++;
1134                                break;
1135                        }
1136                        if (!first && !comma)
1137                        {
1138                                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing ',' in Vector: '%s'", prev_element);
1139                                return NULL;
1140                        }
[337]1141                        ret = tmp.deserialize(p);
[753]1142                        prev_element = p; first = false; comma = false;
[337]1143                        if (ret)
[109]1144                        {
[337]1145                                vec->data += new ExtValue(tmp);
1146                                p = ret;
[753]1147                                if (*p == ',') { p++; comma = true; }
[109]1148                        }
[337]1149                        else
[109]1150                        {
[337]1151                                p = NULL;
1152                                break;
[109]1153                        }
1154                }
[337]1155                setObject(o);
1156                return p;
[109]1157        }
[337]1158        else if (*in == '{')
[109]1159        {
[337]1160                DictionaryObject *dic = new DictionaryObject;
1161                ExtObject o(&DictionaryObject::par, dic);
[371]1162                tlsGetRef(ExtObject_serialization).add(o);
[337]1163                const char* p = in + 1;
1164                ExtValue args[2]/*={value,key}*/, dummy_ret;
[753]1165                bool first = true, comma = false;
1166                const char* prev_element = p;
1167                while (true)
[109]1168                {
[753]1169                        while (isspace(*p)) p++;
1170                        if (*p == 0)
1171                        {
1172                                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing '}' in Dictionary");
1173                                return NULL;
1174                        }
1175                        if (*p == '}')
1176                        {
1177                                if (comma)
1178                                {
1179                                        logPrintf("ExtValue", "deserialize", LOG_ERROR, "No element after ',' in Dictionary");
1180                                        return NULL;
1181                                }
1182                                p++;
1183                                break;
1184                        }
1185                        if (!first && !comma)
1186                        {
1187                                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing ',' in Dictionary: '%s'", prev_element);
1188                                return NULL;
1189                        }
[337]1190                        ret = args[1].deserialize(p);
[753]1191                        prev_element = p; first = false; comma = false;
[337]1192                        if ((!ret) || (args[1].getType() != TString)) { p = NULL; break; }
1193                        p = ret;
[375]1194                        if (*p != ':') { logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing ':' in Dictionary: '%s'", p); p = NULL; break; }
[337]1195                        p++;
1196                        ret = args[0].deserialize(p);
1197                        if (!ret) { p = NULL; break; }
1198                        p = ret;
1199                        dic->p_set(args, &dummy_ret);
[753]1200                        if (*p == ',') { p++; comma = true; }
[109]1201                }
[337]1202                setObject(o);
1203                return p;
[109]1204        }
[337]1205        else if (!strncmp(in, "null", 4))
[109]1206        {
[337]1207                setEmpty();
1208                return in + 4;
[109]1209        }
[472]1210        else if (!strncmp(in, "true", 4))
1211        {
1212                setInt(1);
1213                return in + 4;
1214        }
1215        else if (!strncmp(in, "false", 5))
1216        {
1217                setInt(0);
1218                return in + 5;
1219        }
[490]1220        else if (!strncmp(in, "invalid", 7))
[109]1221        {
[337]1222                setInvalid();
[490]1223                return in + 7;
[109]1224        }
[337]1225        else if (*in == '<')
[109]1226        { //unserializable object
[522]1227                const char* end = in + 1;
[490]1228                while (*end)
1229                        if (*end == '>')
[522]1230                        {
1231                        setError(SString("Unserializable class: ") + SString(in + 1, end - in - 1));
1232                        return end + 1;
1233                        }
[490]1234                        else
1235                                end++;
1236                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Missing '>'");
1237                return NULL;
[109]1238        }
[337]1239        else if (*in == '^')
[109]1240        {
[337]1241                in++;
1242                ExtValue ref;
1243                ret = ref.parseNumber(in, TInt);
1244                if (ret && (ref.getType() == TInt))
[109]1245                {
[371]1246                        const ExtObject* o = tlsGetRef(ExtObject_serialization).get(ref.getInt());
[337]1247                        if (o)
[109]1248                        {
[337]1249                                setObject(*o);
1250                                return ret;
[109]1251                        }
1252                }
[375]1253                logPrintf("ExtValue", "deserialize", LOG_ERROR, "Invalid reference: '%s'", in - 1);
[337]1254                return NULL;
[109]1255        }
[337]1256        else if ((ret = skipWord(in)) && (ret != in))
[109]1257        {
[337]1258                SString clsname(in, (int)(ret - in));
1259                ExtValue tmp;
1260                ret = tmp.deserialize(ret);
[348]1261                ParamInterface *cls = findDeserializableClass(clsname.c_str());
[337]1262                if (cls && (tmp.getType() != TUnknown) && (tmp.getType() != TInvalid))
[109]1263                {
[337]1264                        VectorObject *vec = VectorObject::fromObject(tmp.getObject(), false);
1265                        if (vec)
[109]1266                        {
[337]1267                                int m = cls->findId("newFromVector");
1268                                if (m >= 0)
[109]1269                                {
[337]1270                                        cls->call(m, &tmp, this);
[371]1271                                        tlsGetRef(ExtObject_serialization).replace(tmp.getObject(), getObject());
[337]1272                                        return ret;
[109]1273                                }
1274                        }
[337]1275                        DictionaryObject *dic = DictionaryObject::fromObject(tmp.getObject(), false);
1276                        if (dic)
[109]1277                        {
[337]1278                                int m = cls->findId("newFromDictionary");
1279                                if (m >= 0)
[109]1280                                {
[337]1281                                        cls->call(m, &tmp, this);
[371]1282                                        tlsGetRef(ExtObject_serialization).replace(tmp.getObject(), getObject());
[337]1283                                        return ret;
[109]1284                                }
1285                        }
[337]1286                        if (tmp.getType() == TString)
[109]1287                        {
[337]1288                                int m = cls->findId("newFromString");
1289                                if (m >= 0)
[109]1290                                {
[337]1291                                        cls->call(m, &tmp, this);
[371]1292                                        tlsGetRef(ExtObject_serialization).replace(tmp.getObject(), getObject());
[337]1293                                        return ret;
[109]1294                                }
1295                        }
[371]1296                        tlsGetRef(ExtObject_serialization).remove(tmp.getObject());
[337]1297                        setEmpty();
1298                }
[109]1299                setEmpty();
[375]1300                logPrintf("ExtValue", "deserialize", LOG_WARN, "object of class \"%s\" could not be deserialized", clsname.c_str());
[337]1301                return ret;
1302        }
[375]1303        logPrintf("ExtValue", "deserialize", LOG_ERROR, "Bad syntax: '%s'", in);
[109]1304        setEmpty();
[337]1305        return NULL;
[109]1306}
1307
1308const char* ExtValue::deserialize(const char* in)
1309{
[371]1310        tlsGetRef(ExtObject_serialization).begin();
[337]1311        const char* ret = deserialize_inner(in);
[522]1312        if (ret) while (isspace(*ret)) ret++;
[371]1313        tlsGetRef(ExtObject_serialization).end();
[337]1314        return ret;
[109]1315}
1316
1317ExtObject ExtValue::getObject() const
1318{
[337]1319        if (type == TObj) return odata();
1320        return ExtObject();
[109]1321}
1322
1323ExtValue ExtValue::getExtType()
1324{
[337]1325        static const char* typenames[] = { "null", "int", "float", "string", "", "invalid" };
1326        if (getType() != TObj)
1327                return ExtValue(typenames[(int)getType()]);
1328        ExtObject& o = odata();
1329        return ExtValue(SString(o.isEmpty() ? "" : o.interfaceName()));
[109]1330}
1331
1332SString SString::valueOf(const ExtValue& v)
1333{
[337]1334        return v.getString();
[109]1335}
1336SString SString::valueOf(const ExtObject& v)
1337{
[337]1338        return v.toString();
[109]1339}
[490]1340
1341#define FIELDSTRUCT ErrorObject
[522]1342static ParamEntry errorobject_paramtab[] =
[490]1343{
[522]1344        { "Error", 1, 3, "Error", },
1345        { "message", 0, 0, "Message", "s", FIELD(message), },
1346        { "newFromString", 0, 0, "create new object", "p oError(s message)", PROCEDURE(p_newfromstring), },
1347        { "toString", 0, PARAM_READONLY | PARAM_NOSTATIC, "Textual form", "s", GETONLY(toString), },
1348        { 0, 0, 0, },
[490]1349};
1350#undef FIELDSTRUCT
1351
1352Param& ErrorObject::getParam()
1353{
1354        static Param param(errorobject_paramtab);
1355        return param;
1356}
1357
1358ExtObject ErrorObject::makeDynamicObject(ErrorObject* e)
1359{
1360        return ExtObject(&getParam(), (DestrBase*)e);
1361}
1362
[522]1363const SString ErrorObject::TO_STRING_PREFIX = "Error: ";
[490]1364
1365void ErrorObject::get_toString(ExtValue* ret)
1366{
[522]1367        ret->setString(TO_STRING_PREFIX + message);
[490]1368}
1369
1370void ErrorObject::p_newfromstring(ExtValue *args, ExtValue *ret)
1371{
[522]1372        ErrorObject *err = new ErrorObject();
1373        err->message = args[0].getString();
1374        if (err->message.startsWith(TO_STRING_PREFIX.c_str()))
1375                err->message = err->message.substr(TO_STRING_PREFIX.len());
1376        *ret = makeDynamicObject(err);
[490]1377}
1378
1379REGISTER_DESERIALIZABLE(ErrorObject)
Note: See TracBrowser for help on using the repository browser.