{"id":22379111,"url":"https://github.com/davyjonescodes/jsondb-python","last_synced_at":"2025-03-26T19:13:25.547Z","repository":{"id":228000920,"uuid":"772900398","full_name":"DavyJonesCodes/JsonDB-Python","owner":"DavyJonesCodes","description":"JsonDB is a minimal, Python-powered JSON database for easy data management. Ideal for small projects and prototyping, it supports simple CRUD operations, nested data structures, and basic searches. Streamline your data tasks with JsonDB's intuitive file-based system.","archived":false,"fork":false,"pushed_at":"2024-08-06T21:45:07.000Z","size":54,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-01T00:34:07.442Z","etag":null,"topics":["crud","data-management","data-storage","database","educational-tool","file-based-database","json","jsondb","lightweight-database","no-sql","pypi","python","simple-database"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DavyJonesCodes.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":"2024-03-16T07:20:54.000Z","updated_at":"2024-12-29T19:05:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"3510beb0-c770-4df9-8734-4c166a2a8481","html_url":"https://github.com/DavyJonesCodes/JsonDB-Python","commit_stats":null,"previous_names":["davyjonescodes/json-db-project"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavyJonesCodes%2FJsonDB-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavyJonesCodes%2FJsonDB-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavyJonesCodes%2FJsonDB-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavyJonesCodes%2FJsonDB-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DavyJonesCodes","download_url":"https://codeload.github.com/DavyJonesCodes/JsonDB-Python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245718777,"owners_count":20661161,"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":["crud","data-management","data-storage","database","educational-tool","file-based-database","json","jsondb","lightweight-database","no-sql","pypi","python","simple-database"],"created_at":"2024-12-04T23:09:00.280Z","updated_at":"2025-03-26T19:13:25.525Z","avatar_url":"https://github.com/DavyJonesCodes.png","language":"Python","readme":"# JsonDB Project\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/logo.png\" alt=\"Logo\" height=\"128px\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-%2314354C.svg?\u0026style=for-the-badge\u0026logo=python\u0026logoColor=white\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/json-%23000000.svg?\u0026style=for-the-badge\u0026logo=json\u0026logoColor=white\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/DavyJonesCodes/JsonDB-Python?style=for-the-badge\"/\u003e\n\u003c/p\u003e\n\nThe JsonDB Project provides a lightweight, file-based database system, designed to make data storage and retrieval simple and intuitive. Built in Python, it leverages the versatility of JSON for data manipulation, making it an ideal solution for small projects, prototypes, or for educational purposes where a full-scale database system isn't required.\n\n## 🚀 Features\n\n- **Simple CRUD Operations**: Easily create, read, update, and delete records with straightforward Python methods.\n- **Lightweight and Portable**: No need for complex database setups. Your data is stored in a single JSON file.\n- **Flexible Data Models**: Store anything from simple key-value pairs to complex nested structures.\n- **Search Functionality**: Includes basic search capabilities to filter through data based on keys or patterns.\n- **Minimal Setup**: With just a few lines of code, integrate JsonDB into any Python project.\n\n## 🏁 Getting Started\n\n### Prerequisites\n\n- Python 3.6 or newer\n\n### Installation\n\nYou can download the `jsonDB.py` file directly for your platform using the following commands:\n\n#### Windows\n\n**Option 1: Using PowerShell (no extra installations needed)**:\nOpen PowerShell and run:\n\n```powershell\nInvoke-WebRequest -Uri https://raw.githubusercontent.com/DavyJonesCodes/json-db-python/master/jsonDB.py -OutFile jsonDB.py\n```\n\n**Option 2: Using `wget`**:\nIf you have `wget` installed, you can use the following command in Command Prompt or PowerShell:\n\n```cmd\nwget -O jsonDB.py https://raw.githubusercontent.com/DavyJonesCodes/json-db-python/master/jsonDB.py\n```\n\n#### Linux and macOS\n\nOpen your terminal and run:\n\n```bash\nwget -O jsonDB.py https://raw.githubusercontent.com/DavyJonesCodes/json-db-python/master/jsonDB.py\n```\n\n### Usage\n\nHere's how to get started with JsonDB in your project:\n\n```python\nfrom jsonDB import JsonDB\n\n# Initialize the database\ndb = JsonDB('data.json')\n\n# Adding data\ndb['user1'] = {'name': 'John Doe', 'age': 30}\ndb['user2'] = {'name': 'Jane Doe', 'age': 25}\n\n# Retrieving data\nprint(db['user1'])  # Output: {'name': 'John Doe', 'age': 30}\n\n# Updating data\ndb['user1']['age'] = 31\n\n# Deleting data\ndel db['user2']\n\n# Searching for keys (example with regex)\nprint(db.keys('user.*'))  # Output: ['user1']\n```\n\n## 📁 Project Structure\n\n- `jsonDb.py`: The core database module, implementing CRUD operations and data storage in JSON format.\n- `main.py`: An example script demonstrating how to use the JsonDB for basic data management tasks.\n- `data.json`: A sample JSON file used by `main.py` to illustrate data storage and retrieval.\n\n## 🤝 Contributing\n\nContributions to the JsonDB Project are welcome! Whether it's reporting a bug, discussing potential improvements, or contributing code, we value your input.\n\nPlease feel free to submit issues and pull requests.\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavyjonescodes%2Fjsondb-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavyjonescodes%2Fjsondb-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavyjonescodes%2Fjsondb-python/lists"}