Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Document breaking changes

...

Improvements

  • Wildcard & phrase queries are now highlighted in PDFs
  • Combination of highlighting queries and explaining smart filters is now possible
  • Dragging and dropping of widgets in the dashboard edit mode has improved
  • Items are now stored/queried by referencing their subscription_id instead of their source_id. This will allow Squirro to process items from a source differently per project/object and also allows users to change the source (e.g. include more search terms in a search).  This has the following two breaking side-effects:
    • Queries referencing sources now need to pass in their subscription IDs
    • Items no longer include the source_ids field
  • See the section Source identifier handling for how this will affect existing code.
    Migration scripts will migrate the data seamlessly.

Bug Fixes

  • time_increment query parameter is working again
  • Ensure all recipients of an alert receive the digest email
  • Ensure the timezones are correct when sending digest emails
  • Ensure facet titles are sorted correctly
  • Fix caching of keywords without values

Deprecated functions/features

  • The get_items method of the SquirroClient should no longer be used. Please use the query function
  • Query expansion on a project level using query_string has been removed
  • The get_project_source method of the SquirroClient got removed
  • The modify_project_source method of the SquirroClient got removed
  • The delete_project_source method of the SquirroClient got removed
  • The get_project_sources method of the SquirroClient got

    Breaking Changes

    The following changes may break existing integrations.

    Source identifier handling

    Items are now stored/queried by referencing their subscription_id instead of their source_id. This will allow Squirro to process items from a source differently per project/object and also allows users to change the source (e.g. include more search terms in a search). This has the following two breaking side-effects:

    • Queries referencing sources now need to pass in their subscription IDs
    • Items no longer include the source_ids field

    Pipelet config

    Pipelets constructors take an argument called config that passes in the user's configuration. Up til now, the handling of the config from the local pipelet consume command and when running in production on the server was different. This has been streamlined to work the same in both cases.

    As a result, change any code snippets as follows (changed code is on line 3):

    Old codeNew code
    Code Block
    languagepy
    linenumberstrue
    class TestPipelet(PipeletV1):
        def __init__(self, config):
            self.api_key = config['config']['api_key']
    
        def consume(self, item):
            # Do something with self.api_key
            …
    Code Block
    languagepy
    linenumberstrue
    class TestPipelet(PipeletV1):
        def __init__(self, config):
            self.api_key = config['api_key']
    
        def consume(self, item):
            # Do something with self.api_key
            …

    Squirro client changes

    The following methods of SquirroClient have been removed.

    • get_project_source
    • modify_project_source
    • delete_project_source
    • get_project_sources

    Other changes

    • Query expansion on a project level using query_string has been removed
    • Pipelet uploading/editing is disabled by default. Talk to the operator in charge if you need Pipelet access

    Deprecated functions/features

    • The get_items method of the SquirroClient should no longer be used. Please use the query function. The get_items method will be removed in a future version.