diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 00000000..ab8ecead --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,8 @@ +--- +name: Bug report +about: Create a report if you believe you've found a bug in this project; please use GitHub Discussions instead if you think the bug may be in your code. +title: '' +labels: bug +assignees: '' + +--- diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..caf05df5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Help and support + url: https://github.com/zeux/pugixml/discussions + about: Please use GitHub Discussions if you have questions or need help. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 00000000..83826c66 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,8 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: '' +labels: enhancement +assignees: '' + +--- diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml new file mode 100644 index 00000000..e48b2b4a --- /dev/null +++ b/.github/workflows/cifuzz.yml @@ -0,0 +1,24 @@ +name: CIFuzz +on: [pull_request] +jobs: + Fuzzing: + runs-on: ubuntu-latest + steps: + - name: Build Fuzzers + id: build + uses: google/oss-fuzz/infra/cifuzz/actions/build_fuzzers@master + with: + oss-fuzz-project-name: 'pugixml' + dry-run: false + - name: Run Fuzzers + uses: google/oss-fuzz/infra/cifuzz/actions/run_fuzzers@master + with: + oss-fuzz-project-name: 'pugixml' + fuzz-seconds: 30 + dry-run: false + - name: Upload Crash + uses: actions/upload-artifact@v3 + if: failure() && steps.build.outcome == 'success' + with: + name: artifacts + path: ./out/artifacts diff --git a/CMakeLists.txt b/CMakeLists.txt index 17f67d1f..9860f38c 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.4) -project(pugixml VERSION 1.12 LANGUAGES CXX) +project(pugixml VERSION 1.13 LANGUAGES CXX) include(CMakePackageConfigHelpers) include(CMakeDependentOption) @@ -101,6 +101,10 @@ if (BUILD_SHARED_LIBS) ${PROJECT_SOURCE_DIR}/src/pugixml.cpp) add_library(pugixml::shared ALIAS pugixml-shared) list(APPEND libs pugixml-shared) + string(CONCAT pugixml.msvc $, + $ + >) set_property(TARGET pugixml-shared PROPERTY EXPORT_NAME shared) target_include_directories(pugixml-shared @@ -111,7 +115,8 @@ if (BUILD_SHARED_LIBS) ${PUGIXML_BUILD_DEFINES} ${PUGIXML_PUBLIC_DEFINITIONS} PRIVATE - $<$:PUGIXML_API=__declspec\(dllexport\)>) + PUGIXML_API=$ + ) target_compile_options(pugixml-shared PRIVATE ${msvc-rt-mtd-shared} diff --git a/docs/manual.adoc b/docs/manual.adoc index ac515358..33bd98d5 100644 --- a/docs/manual.adoc +++ b/docs/manual.adoc @@ -969,6 +969,28 @@ xml_node xml_node::previous_sibling(const char_t* name) const; for (pugi::xml_node tool = tools.child("Tool"); tool; tool = tool.next_sibling("Tool")) ---- +[[xml_node::attribute_hinted]] +`attribute` function needs to look for the target attribute by name. If a node has many attributes, finding each by name can be time consuming. If you have an idea of how attributes are ordered in the node, you can use a faster function: + +[source] +---- +xml_attribute xml_node::attribute(const char_t* name, xml_attribute& hint) const; +---- + +The extra `hint` argument is used to guess where the attribute might be, and is updated to the location of the next attribute so that if you search for multiple attributes in the right order, the performance is maximized. Note that `hint` has to be either null or has to belong to the node, otherwise the behavior is undefined. + +You can use this function as follows: + +[source] +---- +xml_attribute hint; +xml_attribute id = node.attribute("id", hint); +xml_attribute name = node.attribute("name", hint); +xml_attribute version = node.attribute("version", hint); +---- + +This code is correct regardless of the order of the attributes, but it's faster if `"id"`, `"name"` and `"version"` occur in that order. + [[xml_node::find_child_by_attribute]] Occasionally the needed node is specified not by the unique name but instead by the value of some attribute; for example, it is common to have node collections with each node having a unique id: ` `. There are two functions for finding child nodes based on the attribute values: @@ -1254,6 +1276,7 @@ As discussed before, nodes can have name and value, both of which are strings. D ---- bool xml_node::set_name(const char_t* rhs); bool xml_node::set_value(const char_t* rhs); +bool xml_node::set_value(const char_t* rhs, size_t size); ---- Both functions try to set the name/value to the specified string, and return the operation result. The operation fails if the node can not have name or value (for instance, when trying to call `set_name` on a <> node), if the node handle is null, or if there is insufficient memory to handle the request. The provided string is copied into document managed memory and can be destroyed after the function returns (for example, you can safely pass stack-allocated buffers to these functions). The name/value content is not verified, so take care to use only valid XML names, or the document may become malformed. @@ -1275,6 +1298,7 @@ All attributes have name and value, both of which are strings (value may be empt ---- bool xml_attribute::set_name(const char_t* rhs); bool xml_attribute::set_value(const char_t* rhs); +bool xml_attribute::set_value(const char_t* rhs, size_t size); ---- Both functions try to set the name/value to the specified string, and return the operation result. The operation fails if the attribute handle is null, or if there is insufficient memory to handle the request. The provided string is copied into document managed memory and can be destroyed after the function returns (for example, you can safely pass stack-allocated buffers to these functions). The name/value content is not verified, so take care to use only valid XML names, or the document may become malformed. @@ -1428,6 +1452,7 @@ Once you have an `xml_text` object, you can set the text contents using the foll [source] ---- bool xml_text::set(const char_t* rhs); +bool xml_text::set(const char_t* rhs, size_t size); ---- This function tries to set the contents to the specified string, and returns the operation result. The operation fails if the text object was retrieved from a node that can not have a value and is not an element node (i.e. it is a <> node), if the text object is empty, or if there is insufficient memory to handle the request. The provided string is copied into document managed memory and can be destroyed after the function returns (for example, you can safely pass stack-allocated buffers to this function). Note that if the text object was retrieved from an element node, this function creates the PCDATA child node if necessary (i.e. if the element node does not have a PCDATA/CDATA child already). @@ -2138,6 +2163,23 @@ Because of the differences in document object models, performance considerations :!numbered: +[[v1.13]] +=== v1.13 ^2022-11-01^ + +Maintenance release. Changes: + +* Improvements: + . `xml_attribute::set_value`, `xml_node::set_value` and `xml_text::set` now have overloads that accept pointer to non-null-terminated string and size + . Improve performance of tree traversal when using compact mode (`PUGIXML_COMPACT`) + +* Bug fixes: + . Fix error handling in `xml_document::save_file` that could result in the function succeeding while running out of disk space + . Fix memory leak during error handling of some out-of-memory conditions during `xml_document::load` + +* Compatibility improvements: + . Fix exported symbols in CMake DLL builds when using CMake + . Fix exported symbols in CMake shared object builds when using -fvisibility=hidden + [[v1.12]] === v1.12 ^2022-02-09^ @@ -2798,6 +2840,7 @@ const unsigned int +++parse_wnorm_attribute bool +++set_name+++(const char_t* rhs); bool +++set_value+++(const char_t* rhs); + bool +++set_value+++(const char_t* rhs, size_t size); bool +++set_value+++(int rhs); bool +++set_value+++(unsigned int rhs); bool +++set_value+++(long rhs); @@ -2856,6 +2899,9 @@ const unsigned int +++parse_wnorm_attribute xml_attribute +++attribute+++(const char_t* name) const; xml_node +++next_sibling+++(const char_t* name) const; xml_node +++previous_sibling+++(const char_t* name) const; + + xml_attribute +++attribute+++(const char_t* name, xml_attribute& hint) const; + xml_node +++find_child_by_attribute+++(const char_t* name, const char_t* attr_name, const char_t* attr_value) const; xml_node +++find_child_by_attribute+++(const char_t* attr_name, const char_t* attr_value) const; @@ -2884,6 +2930,7 @@ const unsigned int +++parse_wnorm_attribute bool +++set_name+++(const char_t* rhs); bool +++set_value+++(const char_t* rhs); + bool +++set_value+++(const char_t* rhs, size_t size); xml_attribute +++append_attribute+++(const char_t* name); xml_attribute +++prepend_attribute+++(const char_t* name); @@ -2996,16 +3043,17 @@ const unsigned int +++parse_wnorm_attribute unsigned long long +++as_ullong+++(unsigned long long def = 0) const; bool +++set+++(const char_t* rhs); - - bool +++set+++(int rhs); - bool +++set+++(unsigned int rhs); - bool +++set+++(long rhs); - bool +++set+++(unsigned long rhs); - bool +++set+++(double rhs); - bool +++set+++(float rhs); - bool +++set+++(bool rhs); - bool +++set+++(long long rhs); - bool +++set+++(unsigned long long rhs); + bool +++set+++(const char_t* rhs, size_t size); + + bool +++set+++(int rhs); + bool +++set+++(unsigned int rhs); + bool +++set+++(long rhs); + bool +++set+++(unsigned long rhs); + bool +++set+++(double rhs); + bool +++set+++(float rhs); + bool +++set+++(bool rhs); + bool +++set+++(long long rhs); + bool +++set+++(unsigned long long rhs); xml_text& +++operator=+++(const char_t* rhs); xml_text& +++operator=+++(int rhs); diff --git a/docs/manual.html b/docs/manual.html index 6457a9a6..01f233c7 100644 --- a/docs/manual.html +++ b/docs/manual.html @@ -4,9 +4,9 @@ - + -pugixml 1.12 manual +pugixml 1.13 manual