Menu
Introduction
Getting Started
Developer guide
Release
Architecture
CLI
Technical documentations
Version
Publication date

Mar 9, 2022

Confidentiality
Public
Reactions
1
Share

FloatRField

Resource field for storing floating-point values.

FloatRField stores floating-point numeric values with automatic validation and configurable storage. By default, floats are stored in the DATABASE for efficient querying and indexing.

This is useful for: - Measurements and scientific values - Scores, percentages, and ratios - Statistical results - Any decimal numeric metadata

Storage behavior: - Stored in DATABASE by default (searchable and queryable) - Included in dict views by default - Automatically validated as float on load/save

Example: ```python class MyResource(Resource): # Simple measurement temperature = FloatRField()

    # With default value
    threshold = FloatRField(default_value=0.95)

    # Stored in KV_STORE instead
    large_value = FloatRField(storage=RFieldStorage.KV_STORE)

    # Not included in dict view
    internal_score = FloatRField(include_in_dict_view=False)
```
Attributes
include_in_dict_view: boolstorage: RFieldStoragevalidator: Validator
Functions
__init__

Initialize a FloatRField for storing floating-point values.

default_value : float | None
Default float value. Can be: - float: A specific floating-point value - Type or Callable: Called to generate default (e.g., float for 0.0) - None: Field has no default value Defaults to None
include_in_dict_view : bool - True
If True, included in dict/JSON representations. Defaults to True for primitive fields
storage : RFieldStorage - RFieldStorage.DATABASE
Storage backend (DATABASE for searchable, KV_STORE for simple storage, NONE for transient). Defaults to DATABASE for floats
deserialize

Deserialize and validate a value from storage.

Validates the stored value using the field's validator before returning it.

r_field_value : Any
The raw value from storage
Return type : Any
get_default_value

Get the default value for this field.

If the default value is a Type or Callable, it will be called to generate a new default value. Otherwise, the default value is returned directly.

This ensures that mutable defaults (like lists or dicts) are not shared between Resource instances.

Return type : Any
serialize

Serialize and validate a value for storage.

Validates the value using the field's validator before storing it.

r_field_value : Any
The runtime value to serialize
Return type : Any
Shine Logo
Technical bricks to reuse or customize

Have you developed a brick?

Share it to accelerate projects for the entire community.