Metadata-Version: 2.1
Name: PhotoDB
Version: 0.1.0
Summary: App for cataloguing vintage cameras, lenses, films, negatives & prints
Home-page: https://github.com/djjudas21/photodb
Author: Jonathan Gazeley
Author-email: photodb@jonathangazeley.com
License: MIT
Description: # PhotoDB
        
        PhotoDB is a web app for film photography that can be used to track cameras, lenses, accessories, films, negatives and prints, to fully
        catalogue a collection of photographic equipment as well as the pictures that are made with them. Read the [Concepts](docs/CONCEPTS.md)
        section for full details on the capabilities of PhotoDB.
        
        It replaces an earlier command-line project, also called [PhotoDB](https://github.com/djjudas21/photodb-perl), which has now been deprecated.
        
        ## Installing PhotoDB
        
        ### From source
        
        This method of installation is required if you want to work on the source code. To install PhotoDB from source, clone this repo and run
        these steps to create a virtualenv with all the dependencies:
        
        ```sh
        git clone https://github.com/djjudas21/photodb.git
        cd photodb
        virtualenv venv
        source venv/bin/activate
        pip install .
        ```
        
        PhotoDB will run out of the box with no additional configuration, by creating an SQLite database in its own directory.
        
        If you wish to use an external database then copy `photodb/local_settings/local_settings.py.template` to
        `photodb/local_settings/local_settings.py` and customise the database settings for your environment.
        
        After the database is configured, apply the migrations and create your user account:
        
        ```sh
        python manage.py migrate
        python manage.py createsuperuser
        ```
        
        To run PhotoDB, run:
        
        ```sh
        python manage.py runserver
        ```
        
        and navigate to [http://localhost:8000](http://localhost:8000). Log in with the superuser account you created above.
        
        ### With Docker
        
        To create a named container running PhotoDB, use the following command. You can change the `-p` settings
        if you wish to serve PhotoDB on a different port.
        
        A persistent volume will be created to store the SQLite database file.
        
        To provide additional config, e.g. [connection info for external databases](https://docs.djangoproject.com/en/2.2/ref/settings/#databases),
        create a config file `~/photodb/local_settings.py` with your settings in. This will be mounted into the container.
        
        ```sh
        docker create --name photodb --mount source=photodb-sqlite,target=/var/www/photodb/db -v "$HOME/photodb":/var/www/photodb/photodb/local_settings -p 8000:8000 djjudas21/photodb
        ```
        
        Start PhotoDB by running:
        
        ```sh
        docker start photodb
        ```
        
        and navigate to [http://localhost:8000](http://localhost:8000). Login with default username `admin` and password `admin`.
        
        ## See also
        
        * [Concepts](docs/CONCEPTS.md)
        * [Screenshots](docs/SCREENSHOTS.md)
        * [Contributing](docs/CONTRIBUTING.md)
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Other Environment
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
Description-Content-Type: text/markdown
