Masonite Debugbar

Masonite Debugbar is a really helpful way to see the stats of your application while you are developing. You can use this information to help debug errors you are getting or even optimize your models and queries for speed and memory issues.
Masonite Debugbar also supports AJAX calls which you will be able to see directly in a dropdown on your toolbar.
Install
Setting up Masonite Debugbar is simple.
First, install the package:
1
$ pip install masonite-debugbar
Copied!
Put the provider at the end of your provider list:
1
from debugbar.providers import DebugProvider
2
PROVIDERS = [
3
    #.. 
4
    DebugProvider
5
]
Copied!
Then publish the package:
1
$ python craft package:publish debugbar
Copied!
Now when you go to a page in your application, you will see a debug bar at the bottom of the page.
Config
The configuration file is created on collectors
1
OPTIONS = {
2
    "models": True,
3
    "queries": True,
4
    "request": True,
5
    "measures": True,
6
    "messages": True,
7
    "environment": True,
8
}
Copied!
Not all collectors may be equally important to you so you can set anyone of these to either True or False in order to enable or disable them in the debugbar.
Collectors
Masonite Debugbar collects data to show in your debugbar as a tab. Each collector is 1 tab in the debugbar.
Below is a detailed explanation of each collector
Model Collector
The model collector shows how many models are hydrated on that request. Whenever you make a query call, a model instance has to be created to store that rows data. This could be a costly operation depending on how many rows are in the table you are calling.
Queries Collector
The queries collector shows all the queries made during that request as well as the time it took to perform that query. Use this to see where bottle necks are in your application. Slow queries lead to slow load times for your users.
Request Collector
The request collector shows you information related to the request such as inputs, parameters and headers.
Message Collector
The message collector contains messages you can add in your application. Instead of adding a bunch of print statements you can add a message:
1
from debugbar.facades import Debugbar
2
​
3
Debugbar.get_collector('messages').add_message("a debug message")
Copied!
You could also add tags which will create a colored tag in the content tab:
1
Debugbar.get_collector('messages').add_message("a debug message", tags={"color": "green", "message": "tag name"})
Copied!
Environment Collector
This collector adds all of your environment variables to your debugbar as well as the Python and Masonite versions.
Measures Collector
The measures collector you can use to measure 2 points in your application. By default there is the time it takes for your application to complete the whole request. You can start and stop any measures you want:
1
from debugbar.facades import Debugbar
2
​
3
Debugbar.start_measure("loop check")
4
# .. Long running code
5
Debugbar.stop_measure("loop check")
Copied!
You will now see the time it takes to run this code in the measures tab
Adding Your Own Collectors
If you find a need to create your own collector, maybe to log information related to exceptions or something similar, you can create your own collector simply:
Creating the Collector
Collectors are simple instances like this:
1
class YourCollector:
2
    def __init__(self, name="Your Collector", description="Description"):
3
        self.messages = []
4
        self.name = name
5
        self.description = description
6
​
7
    def restart(self):
8
        self.messages = []
9
        return self
Copied!
The restart method is required to restart your collector have each request so the information doesn't get persisted bewteen requests. If this is not required for your collector then you can simply return self.
Collector Methods
The next part you'll need is a way to add data to your collector. This can be done in any method you want your developers to use. These are your external API's and how you want developers interacting with your collector. You can name these methods whatever you want and can be as complex as you need them to be.
1
class YourCollector:
2
    def __init__(self, name="Your Collector", description="Description"):
3
        self.messages = []
4
        self.name = name
5
        self.description = description
6
​
7
    def restart(self):
8
        self.messages = []
9
        return self
10
​
11
    def add(self, key, value):
12
        self.messages.append({key: value})
Copied!
This method could be as simple or as complex as you need. Some of Masonite Debugbar's collectors use special classes to keep all the information.
Collector Rendering
Next you need a collect and an html method to finalize the collector. First the collect method should just return a dictionary like this:
1
from jinja2 import Template
2
​
3
​
4
class YourCollector:
5
    def __init__(self, name="Your Collector", description="Description"):
6
        self.messages = []
7
        self.name = name
8
        self.description = description
9
​
10
    def restart(self):
11
        self.messages = []
12
        return self
13
​
14
    def add(self, key, value):
15
        self.messages.append({key: value})
16
    
17
    def collect(self):
18
        collection = []
19
        for message in self.messages:
20
            for key, value in message.items():
21
                collection.append(
22
                    {
23
                        "key": key,
24
                        "value": value
25
                    }
26
                )
27
        # # render data to html
28
        template = Template(self.html())
29
        return {
30
            "description": self.description,
31
            "count": len(collection),
32
            "data": collection,
33
            "html": template.render({"data": collection}),
34
        }
35
    
36
    def html(self):
37
        return """
38
        <div>
39
            <div class="flex justify-between p-4">
40
                <p>{{ object.key }}: {{ object.value }}</p>
41
            </div>
42
        </div>
43
        """
Copied!
data here in the html method loop is the collection we built. You can use this to style your tab and content.
In the collect method return dictionary, the description is used to show a quick description at the top of the tabs content. The count here is the number badge shown in the actual tab itself.
Registering the collector
Lastly we just need to register the collector to the debugbar for it to show up. You can do this in your own provider. If you are building this in your own application you can make your own provider. If you are building a collector as part of a package you can have your developers install it in their projects.
1
class YourProvider(Provider):
2
    def __init__(self, application):
3
        self.application = application
4
​
5
    def register(self):
6
        debugger = self.application.make('debugger')
7
        debugger.add_collector(YourCollector())
8
​
9
    def boot(self):
10
        pass
Copied!
And then finally register the provider with your provider config and your collector will now show up in the debug toolbar with the rest of the collectors.