rawast 0.1.0__tar.gz

rawast-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# macOS
+.DS_Store
+
+# CMake build artifacts
+build/
+build-*/
+cmake-build-*/
+CMakeCache.txt
+CMakeFiles/
+CMakeUserPresets.json
+*.cmake.lock
+
+# Compiled objects and binaries
+*.o
+*.obj
+*.a
+*.lib
+*.so
+*.so.*
+*.dylib
+*.dll
+*.exe
+
+# Editors / IDEs
+.vscode/
+.idea/
+.kdev4/
+*.kdev4
+*.swp
+*.swo
+*.bak
+*~
+
+# Python bindings, packaging artefacts, test caches
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.venv/
+venv/
+dist/
+build-py/
+.pytest_cache/
+_skbuild/
+.eggs/

rawast-0.1.0/CMakeLists.txt

@@ -0,0 +1,122 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(rawast
+    # CMake's project(VERSION ...) only accepts numeric components
+    # (up to 4 dot-separated integers), so it can't carry PEP 440
+    # pre-release suffixes. The actual user-visible version lives in
+    # pyproject.toml (Python wheel) and include/rawast/version.hpp
+    # (C++ string `rawast::VERSION`); both may carry an `aN` / `bN`
+    # / `rcN` tier the CMake VERSION here cannot.
+    VERSION 0.1.0
+    DESCRIPTION "Data-driven predictive PEG parser engine and .jast container format"
+    LANGUAGES CXX
+)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+    set(CMAKE_BUILD_TYPE Release CACHE STRING "Default build type" FORCE)
+    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
+        Debug Release RelWithDebInfo MinSizeRel)
+endif()
+
+option(RAWAST_BUILD_TESTS "Build tests" ON)
+option(RAWAST_WARNINGS_AS_ERRORS "Treat compiler warnings as errors" OFF)
+
+# Some upstream dependencies (doctest, tl::expected) still declare very old
+# cmake_minimum_required values that modern CMake refuses outright. Tell CMake
+# to apply at least the 3.5 policy set when configuring those sub-projects.
+set(CMAKE_POLICY_VERSION_MINIMUM 3.5)
+
+include(FetchContent)
+
+# tl::expected — header-only error type.
+FetchContent_Declare(tl-expected
+    GIT_REPOSITORY https://github.com/TartanLlama/expected.git
+    GIT_TAG v1.1.0
+    GIT_SHALLOW ON
+)
+set(EXPECTED_BUILD_TESTS OFF CACHE BOOL "" FORCE)
+FetchContent_MakeAvailable(tl-expected)
+
+# Library target.
+add_library(rawast STATIC
+    src/version.cpp
+    src/value.cpp
+    src/node.cpp
+    src/stream.cpp
+    src/parsers.cpp
+    src/pool.cpp
+    src/frame.cpp
+    src/grammar.cpp
+    src/save_stack.cpp
+    src/loader.cpp
+    src/linter.cpp
+    src/profile.cpp
+    src/parsers_gdsii.cpp
+    src/parsers_lefdef.cpp
+    src/parsers_tcl.cpp
+    src/parsers_registry.cpp
+)
+add_library(rawast::rawast ALIAS rawast)
+
+target_include_directories(rawast
+    PUBLIC
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+        $<INSTALL_INTERFACE:include>
+)
+
+target_link_libraries(rawast PUBLIC tl::expected)
+
+target_compile_features(rawast PUBLIC cxx_std_17)
+
+if(RAWAST_WARNINGS_AS_ERRORS)
+    if(MSVC)
+        target_compile_options(rawast PRIVATE /W4 /WX)
+    else()
+        target_compile_options(rawast PRIVATE -Wall -Wextra -Wpedantic -Werror)
+    endif()
+else()
+    if(MSVC)
+        target_compile_options(rawast PRIVATE /W4)
+    else()
+        target_compile_options(rawast PRIVATE -Wall -Wextra -Wpedantic)
+    endif()
+endif()
+
+if(RAWAST_BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+endif()
+
+# -----------------------------------------------------------------------
+# Python binding (built only when invoked via scikit-build-core).
+# -----------------------------------------------------------------------
+if(SKBUILD)
+    set_property(TARGET rawast PROPERTY POSITION_INDEPENDENT_CODE ON)
+
+    find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+
+    FetchContent_Declare(nanobind
+        GIT_REPOSITORY https://github.com/wjakob/nanobind.git
+        GIT_TAG v2.4.0
+        GIT_SHALLOW ON
+    )
+    FetchContent_MakeAvailable(nanobind)
+
+    nanobind_add_module(_native NB_STATIC python/src/native.cc)
+    target_link_libraries(_native PRIVATE rawast::rawast)
+    target_compile_features(_native PRIVATE cxx_std_17)
+
+    install(TARGETS _native LIBRARY DESTINATION rawast)
+
+    # Bundle the canonical grammars/ directory into the wheel under
+    # rawast/grammars/ so Grammar(name) and grammar_path(name) resolve
+    # at runtime in installed wheels (editable installs use the
+    # python/rawast/grammars symlink to the same files in the repo).
+    install(DIRECTORY ${CMAKE_SOURCE_DIR}/grammars/
+            DESTINATION rawast/grammars
+            FILES_MATCHING PATTERN "*.json" PATTERN "*.rawast")
+endif()

rawast-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# Code of Conduct
+
+This project follows the [Contributor Covenant, version 2.1][cc]. The
+short version: be respectful, assume good faith, focus on the work,
+welcome contributors regardless of background or experience level.
+
+For the full text, including enforcement guidelines, see:
+
+  https://www.contributor-covenant.org/version/2/1/code_of_conduct/
+
+## Reporting
+
+If you experience or witness behaviour that violates this code,
+please email the project maintainer at the contact address listed on
+the [org page](https://github.com/edacommons). Reports are handled
+confidentially.
+
+[cc]: https://www.contributor-covenant.org/

rawast-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to rawast
+
+Thanks for the interest. rawast is small enough that any thoughtful
+issue or pull request is welcome.
+
+## Getting set up
+
+```sh
+git clone https://github.com/edacommons/rawast.git
+cd rawast
+
+# C++ build + tests
+cmake -B build && cmake --build build
+ctest --test-dir build --output-on-failure
+
+# Python build + tests
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[test]"
+pytest python/tests/
+```
+
+The C++ tests use [doctest](https://github.com/doctest/doctest) and
+the Python tests use [pytest](https://pytest.org). Both run on every
+push via the CI workflow in `.github/workflows/ci.yml`.
+
+## What's helpful
+
+- **Bug reports.** Open an issue with a minimal reproduction —
+  ideally a small grammar fragment and the input that misbehaves.
+- **New grammars.** Each grammar (`grammars/*.rawast`) is mostly
+  self-contained data; a new format becomes a new file plus
+  whatever terminal parsers it needs. See `grammars/json.json` and
+  `grammars/gdsii.rawast` for examples of text and binary patterns
+  respectively, and `docs/rawast-format.md` for the language spec.
+- **Pull requests.** For non-trivial changes, opening an issue first
+  to talk through the approach saves time. Small fixes are fine to
+  submit directly.
+
+## Style
+
+- C++20, `clang-format`-friendly two-space indent, no tabs.
+- Public APIs in `include/rawast/`, implementations in `src/`.
+- Test additions go in `tests/` (doctest) or `python/tests/` (pytest).
+- Commit messages: imperative subject (`feat:`, `fix:`, `docs:`,
+  `refactor:`, `test:`), wrapped at ~72 columns, with body
+  explaining *why* the change exists rather than restating the diff.
+
+## License
+
+By contributing you agree your changes are released under the
+project's MIT license (see [LICENSE](LICENSE)).

rawast-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Serge Rabyking
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.