ObjFW  History of src/OFURL.m of b7cf59038a815afc

While the idea sounds nice that the tag name is the class, this means the
serialization includes whether something is mutable or immutable. This means
doing as much as making something immutable changes the serialization, which
can then cause issues after being deserialized. file: [fdb5d156bf] check-in: [6ce0093f8d] user: js, branch: trunk, size: 30640 [annotate] [blame] [check-ins using] [diff]

This is as per the RFC, which says the scheme and path can never be
missing, while the path can be empty. file: [fd812a6a57] check-in: [3e455c4839] user: js, branch: trunk, size: 28143 [annotate] [blame] [check-ins using] [diff]

The scheme does not allow percent encoding. file: [57bba32cb0] check-in: [13ead1212f] user: js, branch: trunk, size: 28245 [annotate] [blame] [check-ins using] [diff]

This allows constructing a URI to access a file within an archive. file: [a82a35d7aa] check-in: [19bbbbd95d] user: js, branch: trunk, size: 29020 [annotate] [blame] [check-ins using] [diff]

With a dictionary the order is lost and keys cannot exist more than
once. file: [bd23469364] check-in: [bd6dd6dd00] user: js, branch: trunk, size: 27532 [annotate] [blame] [check-ins using] [diff]

Embedded files are available via the objfw-embedded: URL scheme. file: [54ccbf7591] check-in: [1483709ab2] user: js, branch: trunk, size: 26582 [annotate] [blame] [check-ins using] [diff]

The internal hash is still 32 bit in most places, but this way, it is at
least not baked into the API and ABI and can be upgraded later, should
that ever be necessary. file: [0558fd50c5] check-in: [aeb403a1ed] user: js, branch: trunk, size: 26269 [annotate] [blame] [check-ins using] [diff]

Since C guarantees minimum sizes for char, short, int, long and long
long, these can be used instead. file: [a6ef5631a2] check-in: [25c985fec1] user: js, branch: trunk, size: 24470 [annotate] [blame] [check-ins using] [diff]

This solves the old signed vs. unsigned problem and allows for more
bases than just 8, 10 and 16, as well as auto-detection of the base (if
base is 0). file: [50000beafa] check-in: [b6ee372b98] user: js, branch: trunk, size: 24476 [annotate] [blame] [check-ins using] [diff]

These were way too simplistic, as paths differ in more than just that on
various operating systems. file: [13457e7f1d] check-in: [156b850131] user: js, branch: trunk, size: 23298 [annotate] [blame] [check-ins using] [diff]

When using self = [self init…], this already releases self on an
exception, so using it inside of a @try / @catch block that releases
self would lead to a double-release. file: [bb7c13caac] check-in: [81156ee75a] user: js, branch: trunk, size: 23329 [annotate] [blame] [check-ins using] [diff]

These were unavailable in the immutable class, but available in the
mutable subclass. However, Clang 3.4 does not support this. file: [5197d0902a] check-in: [dae363ef82] user: js, branch: trunk, size: 23279 [annotate] [blame] [check-ins using] [diff]

This now doesn't use -[initWithString:relativeToURL:] anymore and
properly escapes everything. file: [18e5b35188] check-in: [e2f6ad3876] user: js, branch: trunk, size: 21514 [annotate] [blame] [check-ins using] [diff]

This allows retrieving it how it was originally stored, which is useful
for example for query strings, as these often URL-encode allowed
characters in order to allow pairs of the form foo=bar&bar=qux. file: [674edf5266] check-in: [a15b403a11] user: js, branch: trunk, size: 17901 [annotate] [blame] [check-ins using] [diff]

This also means the parameters go away and get folded into the path. file: [45850285e0] check-in: [5f7305c659] user: js, branch: trunk, size: 12877 [annotate] [blame] [check-ins using] [diff]

This also adds -[OFURL fileSystemRepresentation] to correctly convert a
URL back to a path in the local file system. file: [7016e3a6f1] check-in: [b83d1414b1] user: js, branch: trunk, size: 11176 [annotate] [blame] [check-ins using] [diff]

This removes the special handling dependent on the scheme. file: [6274573b21] check-in: [0f995db06d] user: js, branch: trunk, size: 10005 [annotate] [blame] [check-ins using] [diff]

Instead, explicitly declare them, as OF_ASSUME_NONNULL_{BEGIN,END} does
not apply to implicit return types. This means that after this commit,
all init methods have a nonnull return type, as they should have. file: [bc22950fc0] check-in: [2f4e0df8be] user: js, branch: trunk, size: 10380 [annotate] [blame] [check-ins using] [diff]

Casts are now written like types in variable declarations. file: [b76d8bb1be] check-in: [4af49a13c3] user: js, branch: trunk, size: 9966 [annotate] [blame] [check-ins using] [diff]

Forgot to add 2017, even though I already did quite some changes in
2017. file: [8108588b31] check-in: [44f45c2e35] user: js, branch: trunk, size: 9974 [annotate] [blame] [check-ins using] [diff]

These are independent of the locale and work on the ASCII character set.

Unlike the C ones, these are 8-bit safe, meaning if a character > 0x7F
is passed, is{alpha,alnum} returns false and to{upper,lower} returns the
original character. file: [cbd9a32b8b] check-in: [d9eb7b50b3] user: js, branch: trunk, size: 9968 [annotate] [blame] [check-ins using] [diff]

URL decoding and reencoding is not lossless: For example, if the query
was foo=bar&qux=foo%25bar, it will be decoded to foo=bar&qux=foo&bar and
then reencoded to foo=bar%25qux=foo%25bar, which is a different thing.

The only way to solve this is to let the application handle the URL
decoding and encoding according to its own rules, as those might be
different depending on the application. file: [6c7fd6999e] check-in: [516517deb3] user: js, branch: trunk, size: 9974 [annotate] [blame] [check-ins using] [diff]

This is required as passing something signed to it is an error on
NetBSD, but passing anything else than a char is undefined on Linux. file: [ad4fe54b6f] check-in: [09a0d12bae] user: js, branch: trunk, size: 10546 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [db9ac3e565] check-in: [cec0f072f8] user: js, branch: 0.8, size: 11204 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [a6e52ebdfd] check-in: [2a27cf3000] user: js, branch: trunk, size: 10266 [annotate] [blame] [check-ins using] [diff]

This increases the required GCC version from 4.0 to 4.6 (exception:
Apple GCC, which already supports this with >= 4.0 starting with OS X
10.5). Since even GCC 4.6 is really old by now, there is no point in
still supporting something even older and making the code ugly because
of that. While some hardware and OS support was dropped from GCC 4.6
compared to GCC 4.0, there is nothing in there that would be an
interesting target with the exception of BeOS maybe - but a port to BeOS
can also be achieved using the Haiku support. The other dropped OSes are
mostly old versions of OSes while newer ones are still being supported
(and those newer versions of those OSes still support the same
hardware). file: [23f0ea8813] check-in: [48980f2297] user: js, branch: trunk, size: 10262 [annotate] [blame] [check-ins using] [diff]

While Cocoa includes it, RFC 1738 explicitly states that the "/" between
host / port and path is not part of the path. file: [2209074f5b] check-in: [d2487bc7e1] user: js, branch: trunk, size: 10442 [annotate] [blame] [check-ins using] [diff]

This means that OFObject.h imports macros.h now, making it unnecessary
to manually import macros.h in almost every file. And while at it, also
import autorelease.h in OFObject.h, so that this doesn't need to be
manually imported in almost every file as well. file: [bcc6187243] check-in: [13ee56edf3] user: js, branch: trunk, size: 10458 [annotate] [blame] [check-ins using] [diff]

Not using -std=gnu11 means _GNU_SOURCE does not get defined anymore,
therefore this commit also adds the required feature defines for glibc.

Additionally, this adds of_strdup in macros.h, as strdup is an
extension. file: [50139ad3bd] check-in: [2f5af58573] user: js, branch: trunk, size: 10502 [annotate] [blame] [check-ins using] [diff]

This mostly removes the argument for the class in which the exception
occurred. As backtraces were recently added for all platforms, the
passed class does not give any extra information on where the exception
occurred anymore.

This also removes a few other arguments which were not too helpful. In
the past, the idea was to pass as many arguments as possible so that it
is easier to find the origin of the exception. However, as backtraces
are a much better way to find the origin, those are not useful anymore
and just make the exception more cumbersome to use. The rule is now to
only pass arguments that might help in recovering from the exception or
provide information that is otherwise not easily accessible. file: [a580a39551] check-in: [3d16a30f41] user: js, branch: trunk, size: 10507 [annotate] [blame] [check-ins using] [diff]

The only places where BOOL is left are those where they are required by
the ABI. file: [269af2cde7] check-in: [c5ef582958] user: js, branch: trunk, size: 10761 [annotate] [blame] [check-ins using] [diff]

Before, it was not clear that the object is an OFURL, which could make
debugging hard. file: [2267fdd898] check-in: [e164def279] user: js, branch: trunk, size: 10721 [annotate] [blame] [check-ins using] [diff]

This also makes -[description] more robust, as with this change, it is
now possible that required parts of the URL are nil. file: [3b200a0eea] check-in: [12a4d43f67] user: js, branch: trunk, size: 11394 [annotate] [blame] [check-ins using] [diff]

This greatly improves performance, as it gets rid of the overhead of
OFAutoreleasePool. file: [4eed3ec6f3] check-in: [1255f3a11a] user: js, branch: trunk, size: 11239 [annotate] [blame] [check-ins using] [diff]

This is required for the new array literals. file: [c16b58c0b2] check-in: [008be86a16] user: js, branch: trunk, size: 11212 [annotate] [blame] [check-ins using] [diff]

This is safe as an "exception loop" can't happen, since if allocating
an exception fails, it throws an OFAllocFailedException which is
preallocated and can always be thrown.

So, the worst case would be that an autorelease of an exception fails,
triggering an OFOutOfMemoryException for which there is no memory,
resulting in an OFAllocFailedException to be thrown. file: [d2a8a715d5] check-in: [e1e7ffa903] user: js, branch: trunk, size: 11202 [annotate] [blame] [check-ins using] [diff]

Also removes unnecessary OF_HASH_ADD_INT* macros (except
OF_HASH_ADD_INT32 which was often used to hash hashes and is now called
OF_HASH_ADD_HASH). file: [9e5eb723f2] check-in: [f3db074478] user: js, branch: trunk, size: 11154 [annotate] [blame] [check-ins using] [diff]

This way, we don't need a new parser and don't use a new format. file: [8362d51987] check-in: [494dca4ae4] user: js, branch: trunk, size: 10657 [annotate] [blame] [check-ins using] [diff]