Skip to content

A simple tagging library for documenting python scripts

License

Notifications You must be signed in to change notification settings

korcankaraokcu/UnoTagger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UnoTagger

A simple tagging library for documenting python scripts

How to install

UnoTagger only requires unotools, assuming that you already have libreoffice installed:
sudo pip3 install unotools
If you don't have libreoffice or unolibs by default, execute this to install all the required tools from scratch:
sudo aptitude install -y libreoffice libreoffice-script-provider-python uno-libs3 python3-uno python3

How to use

Startup libreoffice:
soffice --accept='socket,host=localhost,port=8100;urp;StarOffice.Service'
Use UnoTagger's create_tag_documents() function in your project.
Run this command for demonstration:
python3 test.py

Pros

  • Module based, you don't have to pass source file paths as the parameter
  • Can create documents based on multiple modules
  • Ability to search through function names
  • Can document variables (check unotagger.get_comments_of_variables() function for more information)

Cons

  • Can only tag functions and variables in a module. Doesn't support classes or inline functions since it iterates on dir(module) only once. Iteration on demand can be achieved by modifying the functions in unotagger.py slightly. You can also choose to create a generator out of them.

About

A simple tagging library for documenting python scripts

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages