suzanne.soy/SearchBar
1
0
Fork 0
Code Issues 20 Pull Requests 2 Actions Packages Projects Releases Wiki Activity
A FreeCAD Mod which adds a search bar to the user inferface. The results include tools, document objects and (still to do) preferences.
41 Commits 1 Branch 0 Tags 1.4 MiB
Python 100%
b698b01bf6
Go to file
luz paz b698b01bf6 README: add link to "What's this" tool page JIC
2022-03-01 12:32:48 -05:00
.gitignore Ignore __pycache__ 2021-10-02 15:24:29 +01:00
BuiltInSearchResults.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
GetItemGroups.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
IndentedItemDelegate.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
Init.py Turned this into a standalone FreeCAD Mod 2021-10-02 20:36:53 +01:00
InitGui.py Updated README with warning, place search bar in a standalone toolbar instead of the File toolbar. 2022-01-27 01:38:10 +00:00
LICENSE Added licence badge to the README and the full text of the CC0 license 2021-10-16 21:27:48 +01:00
README.md README: add link to "What's this" tool page JIC 2022-03-01 12:32:48 -05:00
RefreshTools.py Renamed repository 2021-10-16 21:32:58 +01:00
ResultsDocument.py Buttons for enabling the 3D preview (unstable) 2022-02-28 23:07:18 +00:00
ResultsPreferences.py Prevent segault when doing right-click actions on the extra info panel 2021-10-16 20:15:33 +01:00
ResultsRefreshTools.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
ResultsToolbar.py Prevent segault when doing right-click actions on the extra info panel 2021-10-16 20:15:33 +01:00
SafeViewer.py Buttons for enabling the 3D preview (unstable) 2022-02-28 23:07:18 +00:00
screenshot.png Added README 2021-10-16 20:47:12 +01:00
SearchBox.py Fix trivial typos 2022-01-25 13:24:43 -05:00
SearchBoxLight.py Fix trivial typos 2022-01-25 13:24:43 -05:00
SearchResults.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
Serialize.py Cleanup: removed debug messages 2021-10-06 04:24:23 +01:00
Tango-Tools-spanner-hammer.svg WIP, having some bugs with the 3D view still 2021-09-30 23:39:02 +01:00
Tango-Tools-spanner-hammer.svg.url WIP, having some bugs with the 3D view still 2021-09-30 23:39:02 +01:00

README.md

FreeCAD SearchBar

This FreeCAD mod adds a search bar for tools, document objects and preferences.

⚠️ Several issues related to the C++ memory management interacting badly with Python's have caused lots of segfaults during development. ⚠️

⚠️️ Most of these should now be solved, but save your work often and proceed with caution while testing this extension. ⚠️

Extensibility

It can be extended by other mods, by adding a new result provider.

Usage

The search bar appears next to the What's this? tool drawing in FreeCAD's default File toolbar.

Screenshot of the search bar, with results in its drop-down menu and extra info about the result in a separate pane

Installation

Automatic Install

Install SearchBar addon via the FreeCAD Addon Manager from the Tools ➡️ Addon Manager dropdown menu.

Manual Install

Expand for instructions on manual installation of SearchBar

Clone the GIT repository or extract the .zip downloaded from GitHub to the following location:

  • Linux: ~/.FreeCAD/Mod/SearchBar
  • macOS: /Users/user_name/Library/Preferences/FreeCAD/Mod/SearchBar
  • Windows: C:\Users\user_name\AppData\Roaming\FreeCAD\Mod\SearchBar

Uninstallation

  • Remove the folder which was cloned during installation:
    • Linux: ~/.FreeCAD/Mod/SearchBar
    • macOS: /Users/user_name/Library/Preferences/FreeCAD/Mod/SearchBar
    • Windows: C:\Users\user_name\AppData\Roaming\FreeCAD\Mod\SearchBar
  • Optional: Remove the cache (~30MB) \~/.FreeCAD/Cache_SearchBarMod or equivalent on other platforms

Development

  • InitGui.py adds an instance of SearchBoxLight to the GUI.
  • SearchBoxLight is a hollowed-out implementation of a search box, it loads everything lazily.

Feedback

To report bugs or feature enhancements, please open a ticket in the issue queue. Best place to discuss feedback or issues in on the dedicated FreeCAD forum discussion for SearchBar.

License License: CC0 v1.0.

See LICENSE. This repository is in the public domain.