New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improve documentation #2
Comments
I'm trying to get this to work, but so far I'm failing. I'd be happy to contribute a little example if I manage to get one to work... I added |
I think the problem may be that you need to use an architecture specific package: The plain one is a multiplatform package that should bring in the parts where needed. |
One of the problems with contributing is unusual code formatting rules. If I call auto-format, I will immediately break the formatting (I use official code-style). Do you plan to adopt official code-style in future? |
Yes. I've just added the gradle property. The style in the project actually already follows the official style, but there is a lot of older code that probably doesn't. |
Happy to hear it. I was really confused with non-standard closing braces position. |
I'm trying to reformat stuff at the moment. There is a lot of poor cruft due to the old formatter (like breaks where not needed). I also tend not to have autoformating enabled. I get really annoyed by poor line breaking algorithms that sometimes don't even give more horizontal space. |
A simple sample project would go a long way for this |
You are welcome to use our GDML connector. It uses a custom plugin to load dependencies, but I should not be a problem, |
I'm currently working on a significantly re-engineered version (in the dev / dev-1.4 branches). It actually works by creating a detailed tree structure for the type and then using that for serialization/deserialization. This cleans up the code massively and goes a long way into correctness as well. With 1.4 I'll also see about using dokka documentation. As to examples, a good place to look is in the test code, but I'll see if some more documentation can be there. Please note that I'll be bringing the API in line with kotlinx.serialization-1.0 and will also be changing the configuration in a way that allows for attaching a policy that is used to determine various properties, including handling missing values, determining how lists are serialized, etc. |
What the documentation lacks currently is a If I have Take the below xml <repository version="1.2"
xmlns="http://www.gtk.org/introspection/core/1.0"
xmlns:c="http://www.gtk.org/introspection/c/1.0"
xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
<include name="GObject" version="2.0"/>
<include name="Pango" version="1.0"/>
<include name="cairo" version="1.0"/>
<!-- More excluded -->
</repository> And my code @Serializable
@XmlSerialName("repository", "http://www.gtk.org/introspection/core/1.0", "")
data class Repository(
@XmlElement(false)
val version: String,
val include: Include
)
@Serializable
data class Include(
val name: String,
val version: String
) And the error
How do I know what I must do here? There is no |
Good idea. For this particular one, the answer is to specify the name on either the type or the property ( |
I'm having difficulty trying to make use of this library, could you please post even one basic use example? The examples directory seems to only include weird edge cases and it's incredibly difficult to glean basic usage from them, |
@Kryomancer For the most basic usage you follow the documentation of the base serialization library, and then use XML rather than Json. After that there are many ways to customize the generated xml. |
I have been scouting the repo for an hour now but I couldn't set foot on an actual starting point to deserialize a simple string-resource XML using XmlUtil since I couldn't find any basic parsing example. I believe a basic parsing example is the most crucial thing to include when it comes to documentation. Btw, thank you for your honorable hard work! |
@yuroyami I just pushed some changes to the readme, including two hello-world example (encoding and decoding). There is some expected familiarity with the kotlinx.serialization library though. The documentation mainly discusses specifics to xml. |
@pdvrieze Thank you so much ! |
The library has less focus on documentation than ideal. Better documentation is desirable.
The text was updated successfully, but these errors were encountered: