BOM
BOM is a simple Django app to manage a bill of materials. It supports multiple part numbering schemes, tracking component sourcing information, estimates costs, and contains smart integrations with Mouser to pull in the latest component pricing and Google Drive for part file management. BOM is written in Python 3 and Django.
BOM can be added to an existing (or new) Django project, or stand alone on its own, which can be more convenient if you're interested in tweaking the tool.
If you already have a django project, you can skip to Add Django Bom To Your App, otherwise Start From Scratch: Add to new Django project to add it to a new django project, or Start From Scratch: Use as standalone Django project.
Table of contents
- Start From Scratch: Add to new Django project
- Add Django Bom To Your App
- Start From Scratch: Use as standalone Django project
- Customize Base Template
- Integrations
- Contributing
- Installation pitfalls
Start From Scratch: Add to a new Django project
- Create and activate a virtual environment (Python 3.10+):
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
- Install Django and set up your project:
pip install django
django-admin startproject mysite
cd mysite
python manage.py migrate
python manage.py createsuperuser # make a user for your development environment
- Continue on to Add Django Bom To Your App.
Add Django Bom To Your App
django-bom is a reusable django application. If you don't already have a django project, you can follow some quick steps below to get up and running, or read about creating your first django app here.
pip install django-bom
- Add "bom" to your INSTALLED_APPS setting like this::
INSTALLED_APPS = [
...
'bom',
'social_django', # to enable google drive sync in bom
'djmoney', # for currency
'djmoney.contrib.exchange', # for currency
'materializecssform',
]
- Update your URLconf in your project urls.py like this::
path('bom/', include('bom.urls')),
And don't forget to import include:
from django.conf.urls import include
- Update your settings.py to add the bom context processor
'bom.context_processors.bom_config',to your TEMPLATES variable, and create a new empty dictionary BOM_CONFIG.
TEMPLATES = [
{
...
'OPTIONS': {
'context_processors': [
...
'bom.context_processors.bom_config',
],
},
},
]
and
BOM_CONFIG = {'standalone_mode': False}
-
Run
python manage.py migrateto create the bom models. -
Start the development server
python manage.py runserverand visit http://127.0.0.1:8000/admin/ to manage the bom (you'll need the Admin app enabled). -
Visit http://127.0.0.1:8000/bom/ to begin.
Start From Scratch: Use as a standalone Django project
- Clone the repo and create a virtual environment:
git clone https://github.com/mpkasp/django-bom.git
cd django-bom
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
- Install dependencies and start the server:
pip install -e .
cp bom/local_settings.py.example bom/local_settings.py
python manage.py migrate
python manage.py runserver
Customize Base Template
The base template can be customized to your pleasing. Just add the following configuration to your settings.py:
BOM_CONFIG = {
'base_template': 'base.html',
}
where base.html is your base template.
Integrations
Mouser Integration
For part matching, make sure to add your Mouser api key. You can get your key here.
Google Drive Integration
Make sure to add the following to your settings.py:
AUTHENTICATION_BACKENDS = (
'social_core.backends.google.GoogleOpenId',
'social_core.backends.google.GoogleOAuth2',
'social_core.backends.google.GoogleOAuth',
'django.contrib.auth.backends.ModelBackend',
)
SOCIAL_AUTH_GOOGLE_OAUTH2_SCOPE = ['email', 'profile', 'https://www.googleapis.com/auth/drive', 'https://www.googleapis.com/auth/plus.login']
SOCIAL_AUTH_GOOGLE_OAUTH2_AUTH_EXTRA_ARGUMENTS = {
'access_type': 'offline',
'approval_prompt': 'auto'
}
And if you're using https on production add:
SOCIAL_AUTH_REDIRECT_IS_HTTPS = not DEBUG
FIXER
Fixer.io is used to handle exchange rate calculations. This is helpful if you may be purchasing parts from another currency (especially via Mouser) and you still need to estimate your part costs.
To set this up you just need to add your API key to local_settings.py as shown in the example.
To update rates, migrate and run python manage.py update_rates. Some day we will need to add a (celerybeat?) task to update rates on a schedule. Explained more here.
Contributing
Contributions welcome! Before contributing your work please read the contributing readme.
Also reach out to mike@indabom.com to discuss features, and join our slack channel.
Installation Pitfalls
Windows
Sqlite
You may get an error during your pip install -r requirements.txt related to sqlite. This may be fixed by installing Visual C++ for python...
Cryptography
Sometimes you'll have issues installing cryptography, if this is the case you may just need to set up some environment variables. This stackoverflow may help.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_bom-1.302.tar.gz.
File metadata
- Download URL: django_bom-1.302.tar.gz
- Upload date:
- Size: 647.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d71abf3f99c0b33c59fce9208dfee3454dc781b63eead53aeec285fbfa22dec5
|
|
| MD5 |
ca14c8bc81784cedfa085f5453751dd7
|
|
| BLAKE2b-256 |
fda0a2a58d1df90d56d2f30b54de2a6848e6f82c9c1015144a6d52b8c5ea64fa
|
Provenance
The following attestation bundles were made for django_bom-1.302.tar.gz:
Publisher:
publish.yml on mpkasp/django-bom
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_bom-1.302.tar.gz -
Subject digest:
d71abf3f99c0b33c59fce9208dfee3454dc781b63eead53aeec285fbfa22dec5 - Sigstore transparency entry: 2169304050
- Sigstore integration time:
-
Permalink:
mpkasp/django-bom@a25414f4236587b79e3dbbf8c69da1d4a574b5c4 -
Branch / Tag:
refs/tags/v1.302 - Owner: https://github.com/mpkasp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a25414f4236587b79e3dbbf8c69da1d4a574b5c4 -
Trigger Event:
release
-
Statement type:
File details
Details for the file django_bom-1.302-py3-none-any.whl.
File metadata
- Download URL: django_bom-1.302-py3-none-any.whl
- Upload date:
- Size: 733.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e9b431579a2b3049ba739297305409e9dfa8e89d44ed3ac20066479b908a91c
|
|
| MD5 |
c41a0b7953d7f2f34e9f0522f3bb30f4
|
|
| BLAKE2b-256 |
7c1ee5f4c9fdc24c1258552182a7d0ad57ac6578638bf10f37424df3ee3ffb93
|
Provenance
The following attestation bundles were made for django_bom-1.302-py3-none-any.whl:
Publisher:
publish.yml on mpkasp/django-bom
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_bom-1.302-py3-none-any.whl -
Subject digest:
8e9b431579a2b3049ba739297305409e9dfa8e89d44ed3ac20066479b908a91c - Sigstore transparency entry: 2169304065
- Sigstore integration time:
-
Permalink:
mpkasp/django-bom@a25414f4236587b79e3dbbf8c69da1d4a574b5c4 -
Branch / Tag:
refs/tags/v1.302 - Owner: https://github.com/mpkasp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a25414f4236587b79e3dbbf8c69da1d4a574b5c4 -
Trigger Event:
release
-
Statement type:
