{"id":13410516,"url":"https://github.com/AdaCore/xmlada","last_synced_at":"2025-03-14T16:32:19.067Z","repository":{"id":7075227,"uuid":"56078077","full_name":"AdaCore/xmlada","owner":"AdaCore","description":"The XML/Ada toolkit.","archived":false,"fork":false,"pushed_at":"2024-10-24T16:04:19.000Z","size":7920,"stargazers_count":22,"open_issues_count":8,"forks_count":13,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-10-25T23:36:41.377Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ada","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdaCore.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING.RUNTIME","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-12T16:04:26.000Z","updated_at":"2024-10-05T23:13:00.000Z","dependencies_parsed_at":"2023-02-10T21:15:17.179Z","dependency_job_id":"8b3f8b7e-7ea1-4bc6-861f-f13209d27117","html_url":"https://github.com/AdaCore/xmlada","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaCore%2Fxmlada","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaCore%2Fxmlada/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaCore%2Fxmlada/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaCore%2Fxmlada/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdaCore","download_url":"https://codeload.github.com/AdaCore/xmlada/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243610237,"owners_count":20318930,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T20:01:07.434Z","updated_at":"2025-03-14T16:32:19.055Z","avatar_url":"https://github.com/AdaCore.png","language":"Ada","funding_links":[],"categories":["Libraries"],"sub_categories":["Format Readers and Writers","Format Readers, Writers and Checkers"],"readme":"XML/Ada: An XML parser for Ada95\n================================\n\nINSTALLING THIS LIBRARY ON UNIX\n-------------------------------\n\nMake sure that you do not have a previous installation of XML/Ada in one\nof the directories given in ADA_OBJECTS_PATH, or some files will not be\nproperly recompiled.\n\nCompiling with GNAT 3.16 or newer versions of GNAT\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nYou need to automatically detect a few aspects of your build environment,\nwhich is done by running\n    ./configure --prefix=PREFIX\nwhere PREFIX is the installation directory you wish to use. It is recommended\nto install into the GNAT directory. This way the project files will be\ninstalled into the default location where gnatmake and gprbuild are looking\nfor projects.\n\nIf, however, you are running a cross-compiler, you need to add an additional\ncommand line switch to configure, namely\n    ./configure --prefix=PREFIX --target=TARGET\nwhere target will be similar to \"powerpc-wrs-vxworks\", \"powerpc-elinos-linux\",\nor any other prefix used to find the name of the gnatmake executable to run.\n\nBy default, XML/Ada will build both static and shared libraries, if\n\"configure\" detected that the latter were supported on your system. You can\nprevent the building of shared libraries by specifying --disable-shared as\nan extra switch to configure.\n\nOnce installed, your applications will by default be linked statically with\nXML/Ada. You can change that default by specifying explicitly --enable-shared\nas an extra switch to configure.\n\nTo install the library, use the following command line:\n   make all install\n\nIf your application is built using a runtime which is not the default,\nyou need to build XmlAda with the same runtime. This is done by simply\nadding an RTS=NAME argument to the make command above. For instance,\nto build and install the XmlAda library with the \"rtp\" runtime, adjust\nthe make command above as follow:\n\n   make all install RTS=rtp\n\nYou can also override the default install location by adding the argument\nIPREFIX=PATH to the make command above.\n\nCompiling with other Ada compilers\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThis library has been reported as being compilable with other compilers than\nGNAT. No build script is provided however.\n\nINSTALLING THIS LIBRARY ON WINDOWS\n----------------------------------\n\n1. Due to the nature of GNU Make you need to have a UNIX-type shell and\n   utilities installed to build this library. If you do not have this,\n   you can download a set at:\n\n     Cygwin : http://cygwin.com/\n     Mingw  : http://www.mingw.org/ (MSYS Toolset)\n\n2. Run 'sh configure --prefix=\u003cinstallation directory\u003e' to generate the\n   makefile.\n   where \"installation directory\" is the place where you want to install\n   XML/Ada.\n\n3. Before building make sure to set the following values in 'Makefile':\n      PREFIX=C:/GNATPRO/6.4.2\n   the makefile where to install the library. Note the slashes in the path!\n   The value should have been set properly by the call to configure.\n\n   It is recommended to install into the GNAT directory. This way the project\n   files will be installed into the default location where gnatmake and\n   gprbuild are looking for projects.\n\n4. As a general rule for GNAT, the temporary directory must be accessible\n   from gnatmake native applications (not a cygwin path). For instance, from\n   cygwin:\n       export TMPDIR=c:/tmp\n   Failing to check this might prevent the building of shared libraries\n\n5. The best way to proceed is to do a 'make all install'.\n   It is possible that make complains that it cannot execute an \"install\"\n   executable. In such a case, it is recommended to execute\n   \"make INSTALL=cp install\" instead to use \"cp\" to do the installation\n\nTWEAKING THE LIBRARY\n--------------------\n\nYou can change the way the library behaves, in particular the DOM part,\nby changing some of the hard-coded constants in the code. If you change\nthese, you will need to recompile the library and your application:\n\n- sax-encodings.ads :: Encoding\n  It contains the encoding used internally by the library. The default is\n  UTF8, which supports the whole Unicode range, and is economical\n  memory-wise\n\n- dom-core.ads :: Shared_Strings  and dom-core.ads :: Shared_Node_Names\n  Whether the internal representation of namespaces should be shared among\n  nodes. The default is yes\n\nUSING THE LIBRARY\n-----------------\n\nSee the XML/Ada user's guide for information on how to use this library.\n\nTESTING THE LIBRARY\n-------------------\n\nSeveral test programs are provided in the XML/Ada source package. These\nare found in the dom/test and sax/test subdirectories. These are very simple\nexamples on how to use the DOM and SAX API.\n\nThe w3c organization has constructed an official testsuite that can be used to\ncheck XML/Ada. Most likely, this is only useful to you if you are modifying\nXML/Ada itself. Here is how you can run this testsuite:\n   You need to download the official XML Conformance Testsuite for XML,\n   The name of the current archive is\n       xmlts20080827.tar\n   The URL is:\n       http://www.w3.org/XML/Test/\n\n   Uncompress it somewhere on your disk, then add a link in tests/dom, which\n   points to the directory where you unpackaged the testsuite. The link should\n   be called \"tests\".\n\nA similar setup is required for the W3C schema testsuite. The URL of the\ntestsuite is:\n   http://www.w3.org/XML/2004/xml-schema-test-suite/xmlschema2006-11-06/xsts-2007-06-20.tar.gz\nThis file should be extracted in the tests/schema directory (creating a\nxmlschema-2006-11-06 subdirectory as a result).\n\n   Then execute the command from the toplevel directory:\n       make run_test\n\n   This will report the number of errors found.\n\nThe W3C committee has reviewed the status of a number of tests since the\ntestsuite was released (as developers of XML parsers have reported issues\nwith the testsuite). They provide a public CVS repository that include the\nmetadata for the tests (list of tests, their status, expected output,...),\nbut unfortunately not the tests themselves. As a result, getting the latest\nversion requires several steps. First get the .tar.gz as described above,\nand extract it in schema/test. From the same directory, run:\n\n   cvs -d :pserver:anonymous@dev.w3.org:/sources/public login\n   cvs -d :pserver:anonymous@dev.w3.org:/sources/public -z5 co XML/xml-schema-test-suite/2004-01-14/xmlschema2006-11-06\n\nYou can update that directory at any time with:\n   cd XML; cvs update\n\nThe XML/Ada testsuite will automatically take advantage of that directory\nif found. You need however to manually run\n   cd schema/test\n   ./schematest --cvs\nto get the output under those conditions, since \"make run_test\" is setup\nfor the .tar.gz output.\n\n\nCONTENTS OF THE LIBRARY\n-----------------------\n\nThe sources in this library are split into several subdirectories, each\nwith its own README, sources, documentation and unit tests.\n\nThe list of subdirectories (aka modules) is:\n\n- unicode:\n  provides a full support for Unicode and Utf8/Utf16/Utf32 encodings. It also\n  support other encodings like Latin1, Latin2, ...\n\n- input_sources\n  provides types to read characters from several types of media.\n\n- sax\n  Provides a common, standard interface for any XML parser, through\n  callback subprograms. You can extend any of the tagged types defined in these\n  packages and thus parse XML files without having to store an XML tree in\n  memory.\n  This package is compatible with SAX 2.0, but doesn't implement the functions\n  specific to SAX 1.0\n\n- dom\n  The Document Object Model is a set of standard subprograms to manipulate\n  XML tree in memory.\n  Only the Core module is currently implemented.\n\n- docs\n  This contains the full documentation for this XML library\n\nBUG REPORTS\n-----------\n\nPlease send questions and bug reports to support@gnat.com following\nthe same procedures used to submit reports with the GNAT toolset itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdaCore%2Fxmlada","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAdaCore%2Fxmlada","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdaCore%2Fxmlada/lists"}