{"id":30733522,"url":"https://github.com/utelle/wxsqlite3","last_synced_at":"2025-09-03T18:18:20.438Z","repository":{"id":35455024,"uuid":"39722231","full_name":"utelle/wxsqlite3","owner":"utelle","description":"wxSQLite3 - SQLite3 database wrapper for wxWidgets (including SQLite3 encryption extension)","archived":false,"fork":false,"pushed_at":"2025-07-18T07:40:33.000Z","size":77685,"stargazers_count":620,"open_issues_count":3,"forks_count":183,"subscribers_count":54,"default_branch":"main","last_synced_at":"2025-07-18T11:28:49.915Z","etag":null,"topics":["database-adapter","database-encryption","encrypted-database","encryption-extension","encryption-support","sqlite","sqlite-amalgamation","sqlite-database","sqlite3","sqlite3-database","sqlite3-encryption","wxsqlite3","wxwidgets","wxwidgets-library"],"latest_commit_sha":null,"homepage":"http://utelle.github.io/wxsqlite3","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/utelle.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"COPYING.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://www.paypal.com/donate/?hosted_button_id=5FYDM3AKBFPUQ"]}},"created_at":"2015-07-26T10:44:28.000Z","updated_at":"2025-07-18T07:40:37.000Z","dependencies_parsed_at":"2023-11-23T23:22:55.660Z","dependency_job_id":"41d4196e-2b97-4c2f-b500-1146eeb9bdd6","html_url":"https://github.com/utelle/wxsqlite3","commit_stats":null,"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"purl":"pkg:github/utelle/wxsqlite3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utelle%2Fwxsqlite3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utelle%2Fwxsqlite3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utelle%2Fwxsqlite3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utelle%2Fwxsqlite3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/utelle","download_url":"https://codeload.github.com/utelle/wxsqlite3/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utelle%2Fwxsqlite3/sbom","scorecard":{"id":912987,"data":{"date":"2025-08-11","repo":{"name":"github.com/utelle/wxsqlite3","commit":"4bb4a3c86c2086957275cb60c52e826bf4a2e8e2"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.2,"checks":[{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":8,"reason":"7 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 8","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci4wxsqlite3.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENCE.txt:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci4wxsqlite3.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/utelle/wxsqlite3/ci4wxsqlite3.yml/main?enable=pin","Info:   0 out of   1 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}}]},"last_synced_at":"2025-08-24T19:56:21.225Z","repository_id":35455024,"created_at":"2025-08-24T19:56:21.225Z","updated_at":"2025-08-24T19:56:21.225Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273487911,"owners_count":25114644,"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-09-03T02:00:09.631Z","response_time":76,"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":["database-adapter","database-encryption","encrypted-database","encryption-extension","encryption-support","sqlite","sqlite-amalgamation","sqlite-database","sqlite3","sqlite3-database","sqlite3-encryption","wxsqlite3","wxwidgets","wxwidgets-library"],"created_at":"2025-09-03T18:18:18.817Z","updated_at":"2025-09-03T18:18:20.426Z","avatar_url":"https://github.com/utelle.png","language":"C","readme":"# wxSQLite3 - a lightweight wrapper for SQLite\n\n**wxSQLite3** is a C++ wrapper around the public domain SQLite 3.x database\nand is specifically designed for use in programs based on the wxWidgets\nlibrary.\n\n**wxSQLite3** does not try to hide the underlying database, in contrary\nalmost all special features of the current SQLite3 version are\nsupported, like for example the creation of user defined scalar or\naggregate functions.\n\nSince SQLite stores strings in UTF-8 encoding, the wxSQLite3 methods\nprovide automatic conversion between wxStrings and UTF-8 strings. This\nworks best for the Unicode builds of wxWidgets. In ANSI builds the\ncurrent locale conversion object (wxConvCurrent) is used for conversion\nto/from UTF-8. Special care has to be taken if external administration\ntools are used to modify the database contents, since not all of these\ntools operate in Unicode or UTF-8 mode.\n\nSince version 1.7.0 **wxSQLite3** includes a key-based SQLite3 encryption\nextension using AES encryption. The decision whether to use 128 bit or\n256 bit AES encryption had to be made at compile time. Starting with version\n4.0.0 the encryption extension allows to select the cipher scheme at runtime.\n\nCurrently the following encryption schemes are supported:\n\n- AES 128 Bit CBC - No HMAC ([wxSQLite3](https://github.com/utelle/wxsqlite3))\n- AES 256 Bit CBC - No HMAC ([wxSQLite3](https://github.com/utelle/wxsqlite3))\n- ChaCha20 - Poly1305 HMAC ([sqleet](https://github.com/resilar/sqleet)) (**default**)\n- AES 256 Bit CBC - SHA1/SHA256/SHA512 HMAC ([SQLCipher](https://www.zetetic.net/sqlcipher/) versions 1 - 4) \n- RC4 - No HMAC ([System.Data.SQLite](https://system.data.sqlite.org/))\n- Ascon 128 - Ascon Tag ([Ascon](https://ascon.iaik.tugraz.at/)) (since version 4.9.8)\n- AEGIS - AEGIS Tag ([AEGIS](https://cfrg.github.io/draft-irtf-cfrg-aegis-aead/draft-irtf-cfrg-aegis-aead.html)) (since version 4.10.0)\n\n## Important Notes\n\nWith the release of SQLite version 3.32.0 on May 22, 2020 critical changes to the public SQLite code finally took officially effect, although they weren't officially announced. They were introduced on Feb 7, 2020: [\"Simplify the code by removing the unsupported and undocumented SQLITE_HAS_CODEC compile-time option\"](https://www.sqlite.org/src/timeline?c=5a877221ce90e752). As a consequence, updating the _wxSQLite3 encryption extension_ to support SQLite version 3.32.0 and later was no longer possible.\n\nSince August 2020 a new implementation of an encryption extension, capable of supporting SQLite version 3.32.0 and later, is available as a separate project, [SQLite3 Multiple Ciphers](https://github.com/utelle/SQLite3MultipleCiphers). Starting with the release of **wxSQLite3 4.6.0** this new implementation is used.\n\nCurrently the _CMake_ support is experimental and limited to Windows platforms (and may or may not work). \n\n## Table of Contents\n\n- [Version history](#history)\n- [Installation](#install)\n- [Optional features](#optional)\n- [Key based database encryption support](#encryption)\n- [Static SQLite library](#sqlite-static)\n- [License](#license)\n- [Acknowledgements](#acknowledge)\n\n## \u003ca name=\"history\"\u003e\u003c/a\u003eVersion history\n\n* 4.10.12 - *August 2025*\n\n  - Upgrade to SQLite3 Multiple Ciphers version 2.2.4 (SQLite version 3.50.4)\n\nFor further version information please consult the [CHANGELOG](CHANGELOG.md).\n\n## \u003ca name=\"install\" /\u003eInstallation\n\nThe build files for Windows platforms are now generated with\n[Premake 5](https://premake.github.io/) (version Premake 5.0 beta 5).\n\nReady to use project files are provided for Visual C++ 2010, 2012, 2013,\n2015, 2017, 2019, and 2022. Additionally, GNU Makefiles are provided supporting for\nexample MinGW-w64.\n\nFor Visual Studio 2010+ solutions it is possible to customize the build\nby creating a `wx_local.props` file in the build directory which is used,\nif it exists, by the projects. The settings in that file override the\ndefault values for the properties. The typical way to make the file is\nto copy `wx_setup.props` to `wx_local.props` and then edit locally.\n\nFor GNU Makefiles the file `config.gcc` serves the same purpose as the\nfile wx_setup.props for Visual C++ projects.\n\nThe customization files `wx_setup.props` resp. `config.gcc` allow to\ncustomize certain settings like for example the version number and the\nroot directory of the wxWidgets library.\n\n### wxMSW\n\nWhen building on Win32 or Win64, you can use the makefiles or one of the\nMicrosoft Visual Studio solution files in the `build` folder.\n\nThe Visual Studio solution files reference the property file `wx_setup.props`\nin the build subdirectory. This file is configured in a way to allow running\nAppVeyor CI without any modifications. Especially, specific library directories\nare used for different compiler versions (as it is used by the pre-built\nwxWidgets libraries) by adding the toolkit version (i.e., 141 for VS 2015,\n142 for VS 2019) to the library path name.\n\nTo get library path names without toolkit version (as you usually get when\ncompiling wxWidgets yourself) please adjust the 2 parameters `wxCompilerPrefix`\nand `wxMsvcVersionAuto` in file `wx_setup.props` as follows:\n\n```\n\u003cwxCompilerPrefix\u003evc\u003c/wxCompilerPrefix\u003e\n\u003cwxMsvcVersionAuto\u003e\u003c/wxMsvcVersionAuto\u003e\n```\n\nAdditionally, the property file assumes that the environment variable `WXWIN`\nis defined and points to the root directory of the wxWidgets installation.\nMake sure that `WXWIN` is set up properly, or replace it by a environment\nvariable of your choice or by an absolute path specification.\n\nFor Visual C++ the debugging properties are set up in such a way that\ndebugging the sample applications should work right out of the box. For\nrelease builds you may need to copy the wxSQLite3 DLL or add the\n`lib` folder path to the Windows search path (PATH environment variable).\n\nThe SQLite3 library is now compiled as an integrated part of wxSQLite3.\nThe advantage is that SQLite3 and wxSQLite3 are always compiled with\nmatching configuration options. Additionally, the SQLite3 encryption\nextension is automatically enabled, too.\n\nA precompiled SQLite shell program supporting encrypted\ndatabases is provided as a separate download. Use\n```\nPRAGMA KEY=\"encryption key\";\n```\nto create or open an encrypted database. Use\n```\nATTACH DATABASE x AS y KEY z;\n```\nto attach an encrypted database.\n\n### wxGTK\n\nWhen building on an autoconf-based system (like Linux/GNU-based\nsystems), the first setup is to recreate the configure script doing:\n\n```\n  autoreconf\n```\n\nThereafter you should create a build directory\n\n```\n  mkdir build-gtk [or any other suitable name]\n  cd build-gtk\n  ../configure [here you should use the same flags you used to configure wxWidgets]\n  make\n```\n \nType `../configure --help` for more info.\n\nThe autoconf-based system also supports a `make install` target which\nbuilds the library and then copies the headers of the component to\n`/usr/local/include` and the lib to `/usr/local/lib`.\n\n## \u003ca name=\"optional\" /\u003eOptional features\n\nSQLite has many optional features and offers a number of optional extensions.\nThe below table lists the features that are enabled for **wxSQLite3** as\ndefault. For details, please see [SQLite Compile Time Options](https://www.sqlite.org/compile.html).\n\nIn case of memory constraints it is of course possible to disable unneeded features.\nHowever, this will usually require to modify the build files.\n\n| Symbol | Description|\n| :--- | :--- |\n| SQLITE_DQS | Setting for the double-quoted string literal misfeature (default: disabled) |\n| SQLITE_ENABLE_CARRAY | C array extension |\n| SQLITE_ENABLE_COLUMN_METADATA | Access to meta-data about tables and queries |\n| SQLITE_ENABLE_CSV | CSV extension |\n| SQLITE_ENABLE_DEBUG | Enable additional debug features (default: off) |\n| SQLITE_ENABLE_DESERIALIZE | Option to enable the serialization interface |\n| SQLITE_ENABLE_EXPLAIN_COMMENTS | Enable additional comments in EXPLAIN output |\n| SQLITE_ENABLE_FTS3 | Version 3 of the full-text search engine |\n| SQLITE_ENABLE_FTS3_PARENTHESIS | Additional operators for query pattern parser |\n| SQLITE_ENABLE_FTS4 | Version 4 of the full-text search engine |\n| SQLITE_ENABLE_FTS5 | Version 5 of the full-text search engine |\n| SQLITE_ENABLE_GEOPOLY | Geopoly extension |\n| SQLITE_ENABLE_JSON1 | JSON SQL functions |\n| SQLITE_ENABLE_REGEXP | Regular expression extension |\n| SQLITE_ENABLE_RTREE | R*Tree index extension |\n| SQLITE_ENABLE_EXTFUNC | Extension with mathematical and string functions |\n| SQLITE_ENABLE_FILEIO | Extension with file I/O SQL functions |\n| SQLITE_ENABLE_SERIES | Series extension |\n| SQLITE_ENABLE_SHA3 | SHA3 extension |\n| SQLITE_ENABLE_UUID | Extension for handling handling RFC-4122 UUIDs |\n| SQLITE_MAX_ATTACHED=10 | Maximum Number Of Attached Databases (max. 125) |\n| SQLITE_SECURE_DELETE | Overwrite deleted content with zeros |\n| SQLITE_SOUNDEX | Enable soundex SQL function |\n| SQLITE_THREADSAFE | Setting the multithreading mode (default: serialized)  |\n| SQLITE_USE_URI | Enable URI file names |\n| SQLITE_USER_AUTHENTICATION | User authentication extension |\n\n## \u003ca name=\"encryption\" /\u003eKey based database encryption support\n\nThe public release of SQLite contains hooks for key based database\nencryption, but the code for implementing this feature is not freely\navailable. D. Richard Hipp offers a commercial solution\n(see [http://www.hwaci.com/sw/sqlite/prosupport.html#crypto](http://www.hwaci.com/sw/sqlite/prosupport.html#crypto)).\n\nThere exist other closed-source commercial solutions, among them:\n\n- [http://www.sqlcrypt.com](http://www.sqlcrypt.com)\n- [http://www.sqlite-crypt.com](http://www.sqlite-crypt.com)\n\nBoth use a slightly different encryption API, which is currently _NOT_\nsupported by wxSQLite3.\n\nFor Windows based systems there exists an open source solution:\n[System.Data.SQLite](http://System.Data.SQLite.org). For SQLite version 3.32.0 or higher encryption support has been dropped.\nHowever, the new encryption extension _SQLite3 Multiple Ciphers_ allows to use this encryption scheme on all supported platforms.\n\n**wxSQLite3** uses now the new encryption extension [SQLite3 Multiple Ciphers](https://github.com/utelle/SQLite3MultipleCiphers).\nPrecompiled binaries of the SQLite3 DLL and the SQLite3 shell  for Windows are now provided by this new separate project.\n\n## \u003ca name=\"sqlite-static\"\u003e\u003c/a\u003eUsing statically linked SQLite library on Windows\n\nStarting with wxSQLite3 version 3.5.0 the SQLite3 library is compiled as an\nintegrated part of wxSQLite3. A separate SQLite3 DLL is not required any longer.\n\n## \u003ca name=\"license\" /\u003eLicense\n\n**wxSQLite3** is free software: you can redistribute it and/or modify it\nunder the terms of the GNU Lesser General Public License version 3\nor later as published by the Free Software Foundation,\nwith the wxWindows 3.1 exception.\n\n## \u003ca name=\"acknowledge\" /\u003eAcknowledgements\n\nThe following people have contributed to **wxSQLite3**:\n\n- Vadim Zeitlin (revision of the build system)\n- Francesco Montorsi (enhancement of the build system)\n- Neville Dastur (enhancement of the method TableExists)\n- Tobias Langner (RAII class for managing transactions)\n","funding_links":["https://www.paypal.com/donate/?hosted_button_id=5FYDM3AKBFPUQ"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futelle%2Fwxsqlite3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Futelle%2Fwxsqlite3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futelle%2Fwxsqlite3/lists"}