{"id":20618550,"url":"https://github.com/englishexe/psdb","last_synced_at":"2026-04-17T18:32:22.716Z","repository":{"id":192119751,"uuid":"686101926","full_name":"Englishexe/psdb","owner":"Englishexe","description":"Python Simple Database is a Python module that allows data to be stored safely without complication, it requires no knowledge except basic Python skills.","archived":false,"fork":false,"pushed_at":"2023-10-11T19:02:10.000Z","size":91,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T19:44:28.632Z","etag":null,"topics":["database","database-management","python","simple"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Englishexe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-09-01T18:44:34.000Z","updated_at":"2024-07-23T10:09:49.000Z","dependencies_parsed_at":"2023-10-12T01:33:22.566Z","dependency_job_id":null,"html_url":"https://github.com/Englishexe/psdb","commit_stats":null,"previous_names":["englishexe/psdb"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Englishexe/psdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Englishexe%2Fpsdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Englishexe%2Fpsdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Englishexe%2Fpsdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Englishexe%2Fpsdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Englishexe","download_url":"https://codeload.github.com/Englishexe/psdb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Englishexe%2Fpsdb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31940826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","database-management","python","simple"],"created_at":"2024-11-16T12:08:52.798Z","updated_at":"2026-04-17T18:32:22.693Z","avatar_url":"https://github.com/Englishexe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Englishexe/psdb-program-resources/main/images/psdb.png\" /\u003e\n\u003c/p\u003e\n\n# FIND ALL DOCUMENTATION ON THE [WIKI](https://github.com/Englishexe/psdb/wiki/_Home)\nThis documentation is out of date and has non-existing functions\n# Python Simple Database \u003csmall\u003e\u003csmall\u003e\u003csmall\u003e(PSDB)\u003c/small\u003e\u003c/small\u003e\u003c/small\u003e Documentation\n### **Contents:**\n- [PSDB Info](#psdb-info)\n- [Documentation](#documentation)\n    - [1. The Basics](#1-the-basics)\n        - [Preformance](#preformance)\n        - [Modules](#modules)\n        - [Database Layout](#database-layout)\n    - [2. Using PSDB](#2-using-psdb)\n    - [3. Customising PSDB](#3-customising-psdb)\n    - [4. Creating Deleting and Changing Databases](#4-creating-deleting-and-changing-databases)\n    - [Debugging \u0026 Error Codes](#0-debugging--error-codes)\n        - [Error Table](#error-table)\n        - [Dump Table](#dump-table)\n- [Contact me](#contact-me)\n- [Change log](#change-log)\n- [More](#more)\n    - [Future Updates](#future-updates)\n    - [Link Placeholder](#sorry)\n    - [About me](#about-me)\n    - [CLT](#clt)\n- [Legal](#legal)\n    - [PSDB Legal](#psdb-legal)\n    - [License / Copyright](#license)\n\n⚠️ WARNING ⚠️\\\nThis is moving the the [PSDB Wiki](https://github.com/Englishexe/psdb/wiki)\n\n## PSDB Info\nPython Simple Database is a Python module that allows data to be stored safely without complication, it requires no knowledge except basic Python skills. PSDB does all the heavy lifting for the programmer while keeping it human-readable. PSDB allows for customisation such as 'detailed scan' and 'output', these allow developers to choose what they see or what the end-user sees. PSDB is good for beginners or small projects as it has a very simple syntax and output. For more information refer to the [documentation](#documentation) or [Contact Me](#contact-me)\n## Documentation\n[1](#1-the-basics) **|** [2](#2-using-psdb) **|** [3](#3-customising-psdb) **|** [4](#4-creating-deleting-and-changing-databases) **|** [placeholder](#0-debugging--error-codes)\n### 1. The Basics\nIn this chapter you can find the basic information about PSDB, even if you are an experienced Python developer reading this can help a lot.\n#### \u003cu\u003ePreformance:\u003c/u\u003e\nInfo: 10,000 databases running v0.1.4-alpha.6\\\nStartup: 1s\\\nCreate: 30s\n#### \u003cu\u003eModules:\u003c/u\u003e\nModules with a suffix of * are pre-installed\n- os*\n- time*\n- requests\\\nTo install a module run:\n`pip install requests` or use your corrisponding package manager\n#### \u003cu\u003eDatabase layout:\u003c/u\u003e\n```\ndatabase description,type(s),creator,v,cv,\n{object_name\nvarible_name varible_value\n}\n```\n'database description' can be blank or '-' in PSDB it will be replaced with 'No description'\\\n'type(s)' can be blank but **not** '-' (will be fixed - [status](#future-updates))\\\n'creator' can be blank but **not** '-' (will be fixed - [status](#future-updates))\\\n'v' can **not** be blank or '-' as it is required for checking compatability\\\n'cv' can **not** be blank or '-' as it is required for checking compatibility\\\n'object_name' can **not** be blank or '-' as it must be deleted\\\n'variable_name' can **not** be blank or '-' as it must be deleted\\\n'variable_value' can **not** be blank or '-' as it must be deleted\n\n### 2. Using PSDB\nInitializing PSDB is most likely the simplest thing you will do when using PSDB, to properly initialise you need 3 lines of code it is best to do this before your main script starts as it may take a few seconds to initialise.\n```py\nimport pythondatabase\npythondatabase.settings(True, True)\npythondatabase.start()\n```\n`import pythondatabase` simply loads PSDB into your namespace\\\n`.settings(True, True)` configures the settings, these can be changed throughout PSDB on the go. [More](#3-customising-psdb)\\\n`.start()` starts PSDB correctly by scanning all databases, checking versions etc\n\n### 3. Customising PSDB\nWhen creating PSDB I decided to keep the settings minimal, meaning there are 3 settings you can control these are output, hide networking and debug. To change the first two settings use `pythonsimpledatabase.settings()` and pass in two arguments. Argument 0 is `HideNetworking` if `True` no networking alerts will appear looking nicer on small windows and keeping the terminal clear, if `False` (providing output is `True`) networking alerts will appear. Argument 1 is `output` this is a major setting as it controls all outputs to the terminal (depending on the type of output), if `True` an output will be printed to the terminal containing simple but important information, if `False` no output is printed excluding errors.\n```py\nimport pythonsimpledatabase\npythonsimpledatabase.settings(True, True)\n```\nFor more advanced users you can use `pythonsimpledatabase.debug()` to have extra information. This is useful for debugging yourself and checking what is happening in PSDB. `Warning: your terminal does become a lot more cluttered and PSDB slows.`\n```py\nimport pythonsimpledatabase\npythonsimpledatabase.setdebug(True)\n```\n| Position(0-1) | Setting | Description |\n| ------------- | ------------- | ------------- |\n| 0 | HideNetworking  | If `True` no networking URLs will appear |\n| 1 | Output  | Disable and enable output |\n\n| Position(0) | Setting | Description |\n| ------------- | ------------- | ------------- |\n| 0 | debug  | Disables and enables debugging |\n### 4. Creating, Deleting and Changing Databases:\n| Function | Description | Arguments |\n| ------------- | ------------- | ------------- |\n|.create()|Creates a database file|`name`, `creator`|\n|.createdb()| Deprecated - ^ | `name`, `type(s)`, `creator` |\n|.delete()|Deletes a database file|`name`, `force`|\n|.add()|Adds an object in the specified database|`name`, `objectname`|\n|.change()|Changes an object value in the specified database|`name`, `objectname`, `newobjectname`\n|.addvalue()|Adds a value in the specified database|`name`, `valuename`, `value`\n|.remove()|Removes an object from the specified database|`name`, `objectname`|\n|.\n\u003cu\u003eFunctions used:\u003c/u\u003e\n```py\nimport pythonsimpledatabase\n# *Initalisation here*\npythonsimpledatabase.create()\npythonsimpledatabase.delete()\npythonsimpledatabase.add()\npythonsimpledatabase.change()\npythonsimpledatabase.remove()\n```\n### 0. Debugging \u0026 Error Codes\n[Issues page](https://github.com/Englishexe/psdb/issues)\n#### \u003cu\u003eError Table:\u003c/u\u003e\nWhenever experiencing an error make an issue report to improve PSDB, and make sure to include the dump!\n| Error # | severity (L/H) | Reason | Fix |\n| ------------- | ------------- | ------------- | ------------- |\n| 0 |  | Unknown error |  |\n| 1 | HIGH | Failed to import modules | Read [The Basics](#1-the-basics) |\n| 2 | LOW | Network did not return `200` | Reinstall PSDB |\n| 3 | HIGH | Database directory not found | Make an [issue](https://github.com/Englishexe/psdb/issues) report |\n| 4 | LOW | PSDB is not started properly | [How to use PSDB](#2-using-psdb) |\n| 5 | LOW | Networking failed | Check internet connection or make a report |\n\n**Dump:**\\\nWhen an error happens a long line of text is outputted below, this allows us to debug your error a lot faster as it contains vital information usually hidden from the user. This contains information from the version number to the CWD. When submitting an error please paste this text in (~ to ~) to speed up the debug process.\n#### Dump table\nTable in order of output, other symbols are used to show the difference between sections\n| Display | Name | Description |\n| ------------- | ------------- | ------------- |\n|0.1.4-alpha| v | Version number |\n|`Long Link`| rawurl | The base URL for PSDB resources |\n|True| HideNetworking | Setting (`True`/`False`) |\n|True| output | Setting (`True`/`False`) |\n|1| len(databases) | Number count of databases in memory |\n|[`db1name`]| databases | A list of databases in memory |\n|True| started | Setting (`True`/`False`) |\n|True| debug | Setting (`True`/`False`) |\n|C:\\PSDB| maindir | Contains the home directory of PSDB |\n|C:\\PSDB\\databases| os.getcwd() | The CWD |\n|#1| num | Error code number |\n|12|tm_hour|Time|\n|0|tm_min|Time|\n|0|tm_sec|Time|\n|1|tm_mday|Date|\n|9|tm_mon|Date|\n|2023|tm_year|Date|\n|\u003cs\u003euser\u003c/s\u003e|\u003cs\u003eos.getlogin()\u003c/s\u003e|\u003cs\u003ecurrent signed-in user for directory checking\u003c/s\u003e|\n|200|.status_code|The response code of [google](https://www.google.com)|\n\n\n\n## Contact me\nEmail: \u003cenglishexe8910@gmail.com\u003e\\\nDiscord: [@englishexe](https://www.discord.com) (Not in use)\n## Change log:\nPSDB follows lightly with semantic versioning, read more [HERE](https://semver.org/) \n| Version       | Description   |\n| ------------- | ------------- |\n| V0.1-alpha    | Basic scripting of PSDB  |\n| V0.1.2-alpha  | SEMVER introduced, Version checking |\n| V0.1.3-alpha  | PSDBargs, bug fixes  |\n| V0.1.4-alpha  | New documentation, Major work |\n| V0.1.5-alpha (Not released)| [More](#future-updates) |\n#### \u003cu\u003eV0.1-alpha\u003c/u\u003e\n```diff\n+ Initialisation\n+ Networking \n+ Basic scripting\n```\n#### \u003cu\u003eV0.1.2-alpha\u003c/u\u003e\n```diff\n! Following SEMVER\n-   Removed 'rawurl'\n+   Added copyright to 3-5\n+   Added module sys\n-   Removed copyright box\n! Moved copyright\n+   Main.py runs when pythondatabase.py is run incorrectly\n! Fixed version checking\n+   Prefixes added\n! Removed random comments\n-   Removed PSDB.settings\n```\n#### \u003cu\u003eV0.1.3-alpha\u003c/u\u003e\n```diff\n-   Removed random comments\n! Improved documentation\n+   Added PSDBargs function\n! Cleaned header of pythondatabase.py\n-   Removed .gitignore\n```\n#### \u003cu\u003eV0.1.4-alpha\u003c/u\u003e\n```diff\n! Fixed formatting error in docs (old)\n-   Removed automatic main.py execution\n-   Removed dir (not used)\n+   Added \"wrong execution\" detection\n+   Added psdbnet function (Deals with network requests)\n-   Omitted prefixes (Still see some? Report it in issues)\n! Terminal simplified\n! Transitioned to using psdbnet\n-   Omitted networking setting, maybe a future update\n! bypassconfirmation --\u003e NoInput (Removes input dialogs)\n+   dbcreate function\n+   The great declutter, unlike my room I have removed everything useless\n-   Remove most prints (Uses psdbp)\n+   Added HideNetworking\n! debugging --\u003e debug\n-   Removed exampledatabase.psdb, useless + more clutter\n-   Removed psdbargs\n-   Removed sys\n+   Added heavy optimization resulting in faster speeds\n+   Added Dump, outputs advanced information on an error\n+   Error Codes (Scroll up)\n-   Deprecated createdb() - create()\n```\n\n## More\nExtra information about PSDB\n### Future Updates\n```\ndbdelete function\ndbinfo function\nformatting PSDBExecution\n```\n### About Me\nI am [Englishexe](https://github.com/Englishexe), a driven and proficient programmer and an accomplished drone pilot. My journey in the world of programming commenced in 2021, and since then, I have passionately immersed myself in the intricate world of code. With a solid foundation in programming languages such as Python and C++, complemented by additional expertise in Batch and HTML5, I have evolved into a versatile and creative coder.\n\nCurrently pursuing my academic endeavours at a STEM-focused college, I am constantly honing my skills and expanding my horizons in the ever-evolving landscape of technology. My educational background in STEM not only reinforces my programming capabilities but also fuels my curiosity for innovation.\n\nIn my programming journey, I began by exploring languages like Batch, using them as a stepping stone to grasp the fundamentals of scripting and automation. As my passion grew, I delved deeper into Python and HTML, realising their immense potential for diverse applications. These languages allowed me to craft efficient solutions, from Raspberry Pi applications that seamlessly integrate hardware and software to the development of Folder Encryption that enhance data security.\n\nBy 2023, I had further broadened my skill set to include C++, a language renowned for its power and versatility in software development. This expansion has enabled me to tackle more complex projects and contribute to a wider array of technological domains.\n\nBeyond coding, I possess a unique proficiency as a drone pilot, combining my technical prowess with a deep appreciation for aerial photography and videography. This skill adds a distinctive dimension to my abilities, allowing me to merge technology and artistry seamlessly.\n\nMy programming journey is characterised by a relentless pursuit of excellence, a commitment to continuous learning, and an insatiable curiosity about the limitless possibilities that technology offers. I look forward to leveraging my skills and experiences to contribute to innovative projects, collaborate with like-minded professionals, and make a meaningful impact in the ever-evolving world of technology and programming.\n\nThank you for taking the time to learn about me. If you have any questions contact me.\n\n###  CLT\nChange Log Template\n#### \u003cu\u003eV0.0.0-alphabeta\u003c/u\u003e\n```diff\n+ Added feature\n- Removed Feature\n! Change feature\n? Temporary fix (Most likely changed in the next version) \n```\n### Sorry!\nThis link isn't working right now, if this is a bug report it in [issues](https://github.com/Englishexe/psdb/issues).\\\nBack to [Contents](#contents)\n## Legal\n#### As of 12/9/23 this is the official legal disclaimer for PSDB and other PSDB resources, versions and repositories.\nData Loss Risk:\\\nPython Simple Database (PSDB) is a database handler designed for simplicity and ease of use. Users should be aware that there is a risk of data loss when using PSDB. While every effort has been made to ensure data integrity, PSDB cannot guarantee the complete prevention of data loss or corruption. Users are advised to regularly back up their data to minimize this risk.\n\nNo Warranty:\\\nPSDB is provided \"as is\" and without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The developers and contributors of PSDB make no warranties regarding the functionality, accuracy, or performance of this software.\n\nUse at Your Own Risk:\\\nThe use of PSDB is entirely at the user's own risk. Users are responsible for verifying the suitability of PSDB for their intended purposes and ensuring that their data is adequately protected.\n\nNo Liability:\\\nIn no event shall the developers, contributors, or maintainers of PSDB be liable for any damages, including, but not limited to, direct, indirect, special, incidental, or consequential damages, arising out of the use or inability to use PSDB, even if they have been advised of the possibility of such damages. Users acknowledge and agree that they assume all responsibility and risk for the use of PSDB.\n\nNetworking:\\\nPSDB may include networking features that allow it to interact with systems, databases and domains. Users are responsible for ensuring the security and integrity of data transmitted over networks and for complying with all applicable laws and regulations related to data privacy and security.\n\nInfected Versions:\\\nUsers are urged to download PSDB only from official and trusted sources. The developers of PSDB cannot be held responsible for any issues or damage caused by using infected or tampered versions of the software obtained from unauthorized sources. (Trustable sources: GitHub main repository)\n\nBy using PSDB, you acknowledge that you have read, understood, and agreed to this disclaimer. If you do not agree with any part of this disclaimer, do not use PSDB.\n\nPlease note PSDB is **unstable** and should not be used for any important data until specified in the documentation.\n\n\u003cu\u003e14/9/23\u003c/u\u003e\\\n\u003cu\u003eEnglishexe\u003c/u\u003e\n\nPython Simple DataBase - PSDB\\\nCopyright (C) 2023 Englishexe\\\nGPL-3.0 License\n\n# License\nRead the GPL-3.0 License [HERE](https://raw.githubusercontent.com/Englishexe/psdb/main/LICENSE)\n\\\n\\\n\\\n\\\n[Back To Contents](#contents)\\\nAbout this file:\\\nThis file has been fact-checked as much as possible and no errors were found, if there is still an error, misspelt word or strange bug please tell us in issues.\\\n\\\nWritten by Englishexe\\\nProgrammed by Englishexe\\\nLogo by Commander\\\nREADME Version: 1\n\u003c!--- Documentation written over 22 days ---!\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenglishexe%2Fpsdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fenglishexe%2Fpsdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenglishexe%2Fpsdb/lists"}