Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imigueldiaz/cameras_db
A Python package offering an SQLite3 database with detailed specifications for around 3,500 DSLR and mirrorless cameras. Comes with a Camera class and a CamerasController for effortless search capabilities. Easily extendable through CSV data imports.
https://github.com/imigueldiaz/cameras_db
camera-specification data-management dslr-camera mirrorless pip-package python search-api sqlite-database sqlite3
Last synced: 23 days ago
JSON representation
A Python package offering an SQLite3 database with detailed specifications for around 3,500 DSLR and mirrorless cameras. Comes with a Camera class and a CamerasController for effortless search capabilities. Easily extendable through CSV data imports.
- Host: GitHub
- URL: https://github.com/imigueldiaz/cameras_db
- Owner: imigueldiaz
- License: gpl-3.0
- Created: 2023-09-04T07:15:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-20T16:51:57.000Z (8 months ago)
- Last Synced: 2024-04-20T18:13:14.283Z (8 months ago)
- Topics: camera-specification, data-management, dslr-camera, mirrorless, pip-package, python, search-api, sqlite-database, sqlite3
- Language: Python
- Homepage:
- Size: 518 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cameras-db
## About
`cameras-db` is a Python package that offers a powerful SQLite3 database stocked with technical specifications for roughly 3,500 DSLR and mirrorless cameras. Out of the box, you get a `Camera` class and a `CamerasController` for effortless, search-only database interaction. Extend your data collection effortlessly with CSV imports.
## Topics
`python` `pip-package` `sqlite3` `dslr` `mirrorless-cameras` `camera-specifications` `search-api` `csv-import` `data-management`
---
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Extending the Database](#extending-the-database)
- [Contributing](#contributing)
- [License](#license)
---
## Installation
To install `cameras-db`, run the following command:
```bash
pip install cameras-db
```
## Usage
Initializing the `CamerasController` and searching is straightforward:
```python
from cameras_db.controllers import CamerasController
# Initialize the controller
controller = CamerasController()
# Search by brand and model
camera = controller.get_by_fields_like_and({"brand": "Canon", "model": "EOS 5D"})
```
The controller search API is a bit rough still, but I plan to improve it to be more human-like.
---
## Extending the Database
Have a CSV file with fresh camera models and specs? Extend the database pasting it at the `setup` folder and executing from the command line:
```shell
python ./setup_db.py
```
A `README.md` file is provided within the folder with more precise instructions.
---
## Contributing
All contributions are welcome. To get started, fork this repository and submit your pull request.
---
## License
This project is licensed under the GNU General Public License v3.0. For full license information, please see the `LICENSE` file.