{"id":34941846,"url":"https://github.com/opene57/opene57","last_synced_at":"2025-12-26T19:18:32.887Z","repository":{"id":43397306,"uuid":"268082554","full_name":"openE57/openE57","owner":"openE57","description":"Fork of original project libE57 (https://www.libe57.org)","archived":false,"fork":false,"pushed_at":"2025-06-22T12:19:15.000Z","size":9602,"stargazers_count":20,"open_issues_count":8,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-22T13:23:56.833Z","etag":null,"topics":["cpp","e57"],"latest_commit_sha":null,"homepage":"","language":"C++","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/openE57.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"madduci"}},"created_at":"2020-05-30T13:13:43.000Z","updated_at":"2025-06-22T12:18:21.000Z","dependencies_parsed_at":"2024-10-19T17:24:13.206Z","dependency_job_id":"f40d4621-6c74-454e-9eef-e4f7ca51c08f","html_url":"https://github.com/openE57/openE57","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/openE57/openE57","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openE57%2FopenE57","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openE57%2FopenE57/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openE57%2FopenE57/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openE57%2FopenE57/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openE57","download_url":"https://codeload.github.com/openE57/openE57/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openE57%2FopenE57/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28058825,"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","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cpp","e57"],"created_at":"2025-12-26T19:18:31.772Z","updated_at":"2025-12-26T19:18:32.876Z","avatar_url":"https://github.com/openE57.png","language":"C++","funding_links":["https://github.com/sponsors/madduci"],"categories":[],"sub_categories":[],"readme":"# openE57\n\n[![openE57-windows](https://github.com/openE57/openE57/actions/workflows/build-win.yml/badge.svg?branch=master)](https://github.com/openE57/openE57/actions/workflows/build-win.yml)\n[![openE57-unix](https://github.com/openE57/openE57/actions/workflows/build-unix.yml/badge.svg?branch=master)](https://github.com/openE57/openE57/actions/workflows/build-unix.yml)\n\nopenE57 is a forked version of the original LibE57 (http://www.libe57.org) project, with the intent to refine and optimize the source code in a modern C++ idiomatic way and remove unnecessary dependencies (e.g. Boost) in favour of the C++ Standard Library.\n\nThe library is compiled as C++17, since some of following language intrinsics and libraries are used:\n\n* constexpr values\n* enum classes\n* random (replaces boost::uuid)\n* filesystem (replaces boost::filesystem)\n* thread (replaces boost::thread)\n* memory (replaces boost::shared_ptr and std::auto_ptr)\n\nAt the current state, Boost is still required when building the tools as in the original source code, but it will be completely removed with the release 2.0.0.\n\n## Requirements\n\nYou need the following tools to build this library:\n\n* A C++17 compiler (MSVC 2017+, gcc 8+, clang 8+)\n* A recent version of CMake (3.15+)\n* A recent version of conan (2.0+)\n\n## Build Instructions\n\nThere are two ways to build and use openE57: building it as a conan package or as a standard CMake project.\nThe dependencies are now managed with conan and integrated in CMake, without the need of compiling the required libraries by yourself.\n\n### Building as a local conan package\n\nThe following instructions will guide you to build openE57 as a local conan package (actually it is being submitted as official conan recipe in the Conan Center), so it can be used it further in other projects.\n\nAvailable conan options are the following ones:\n\n* with_tools - disabled by default\n* shared - disabled by default (not supported at the moment - no symbol is exported yet)\n* fPIC - enabled by default, activates the `-fPIC` flag on gcc/clang compilers on Linux/Mac\n\nPlatform independent:\n\n```shell\ngit clone https://github.com/openE57/openE57.git\ncd open57\nconan create . --build=missing\n```\n\n### Building as local project (e.g. for development)\n\nThe following instructions will guide you to build openE57 as a standard CMake Project, downloading the external dependencies with conan, but managing all the settings with CMake.\n\nAvailable CMake Options are:\n\n* BUILD_DOCS - builds the Doxygen documentation (requires Doxygen and Graphviz)\n* BUILD_EXAMPLES - builds the API examples\n* BUILD_TOOLS - builds the binary tools to validate and dump E57 files\n* BUILD_TESTS - builds tests\n* BUILD_SHARED_LIBS - actually unsupported (missing exported symbols)\n* XERCES_C_DEFAULT_FETCH_TAG - tag that is used for fetching and building xerces-c library from sources (if it's not found on your system)\n* BUILD_WITH_MT - instructs CMake to set the correct [`CMAKE_MSVC_RUNTIME_LIBRARY`](https://cmake.org/cmake/help/latest/variable/CMAKE_MSVC_RUNTIME_LIBRARY.html?highlight=cmake_msvc_runtime_library) flag for Visual Studio\n\nBuilding with Position indipendent code on Unix can be activated with the option [`CMAKE_POSITION_INDEPENDENT_CODE`](https://cmake.org/cmake/help/latest/variable/CMAKE_POSITION_INDEPENDENT_CODE.html?highlight=cmake_position_independent_code).\n\n\n#### On Linux:\n\n```shell\ngit clone https://github.com/openE57/openE57.git\ncd open57\nmkdir build \u0026\u0026 cd build\nconan install --output-folder . --build=missing -s compiler.cppstd=17 -o with_tests=True -o with_tools=True .. \ncmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON -DBUILD_TOOLS=ON\ncmake --build . --config Release --target install\n```\n\n#### On Windows:\n\n```cmd\ngit clone https://github.com/openE57/openE57.git\ncd open57\nmd build \u0026\u0026 cd build\nconan install --output-folder . --build=missing -s compiler.cppstd=17 -o with_tests=True -o with_tools=True .. \ncmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_WITH_MT=ON -DBUILD_TESTS=ON -DBUILD_TOOLS=ON\ncmake --build . --config Release --target install\n```\n\n#### Autoformatting\n\nThe Project offers the possibility to run the auto-formatter (clang-format) on the sources. As prerequisite, you need to install `clang-format` on your machine and then run the following cmake target:\n\n```sh\ncmake --build . --target clangformat\n```\n\n#### Building the documentation\n\nIt's also possible to build the documentation for the API (still largely outdated), using Doxygen and Graphviz. You'll have to install the required packages for your distribution in order to generate proper documentation files. \n\nTo enerate the documentation, configure the project like:\n\n```sh\ncmake .. -DBUILD_DOCS=ON\ncmake --build . --target doxygen\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopene57%2Fopene57","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopene57%2Fopene57","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopene57%2Fopene57/lists"}