utility-code / pyGroff Licence: other
laTEX is awesome but we are lazy -> groff with markdown syntax and inline code execution
Programming Languages python 139335 projects - #7 most used programming language
Projects that are alternatives of or similar to pyGroff gut 🍱 yet another collection of go utilities & tools
Stars : ✭ 24 (-4%)
Mutual labels: wrapper , utility
pwnscripts Very simple script(s) to hasten binary exploit creation
Stars : ✭ 66 (+164%)
Mutual labels: wrapper
SoapHttpClient HttpClient wrapper for sending SOAP messages.
Stars : ✭ 80 (+220%)
Mutual labels: wrapper
Lavalink.py A wrapper for Lavalink in Python, which aims to be powerful and intuitive.
Stars : ✭ 162 (+548%)
Mutual labels: wrapper
steampak Nicely packed tools to work with Steam APIs
Stars : ✭ 21 (-16%)
Mutual labels: wrapper
Resource Monitor Resource_Monitor is a GNOME Shell extension that Monitor the use of system resources like cpu, ram, disk, network and display them in GNOME Shell top bar.
Stars : ✭ 62 (+148%)
Mutual labels: utility
redtimer RedTimer - Redmine Time Tracker
Stars : ✭ 59 (+136%)
Mutual labels: utility
xbytes Parse bytes to human readable sizes (4747) → ('4.75 KB') and vice versa.
Stars : ✭ 17 (-32%)
Mutual labels: utility
caller-lookup Reverse Caller Id using TrueCaller
Stars : ✭ 55 (+120%)
Mutual labels: wrapper
sc2gears The COMPLETE (!) source code of the Sc2gears universe (Sc2gears app + Sc2gears Database + web-based parsing engine - bundled in an Eclipse project).
Stars : ✭ 30 (+20%)
Mutual labels: utility
koishi Python wrapper for the unofficial scraped API of the satori testing system.
Stars : ✭ 13 (-48%)
Mutual labels: wrapper
hibpwned Python API wrapper for haveibeenpwned.com (API v3)
Stars : ✭ 21 (-16%)
Mutual labels: wrapper
MentalGL Single header OpenGL utility library in the public domain
Stars : ✭ 20 (-20%)
Mutual labels: utility
smcutil SMC utility for modifying and examining Apple's SMC payloads.
Stars : ✭ 30 (+20%)
Mutual labels: utility
YetAnotherKeyDisplayer The application for displaying pressed keys of the keyboard
Stars : ✭ 88 (+252%)
Mutual labels: utility
Shadbot A configurable multipurpose bot bringing you music, multiplayer games, moderation commands and more!
Stars : ✭ 48 (+92%)
Mutual labels: utility
pv Unix Pipe Viewer (pv) utility in Node.js
Stars : ✭ 20 (-20%)
Mutual labels: utility
groupby Group lines by a regex
Stars : ✭ 14 (-44%)
Mutual labels: utility
Pagination-Utils A collection of methods to make message pagination with JDA easier.
Stars : ✭ 20 (-20%)
Mutual labels: utility
pyGroff
A wrapper for groff using python to have a nicer syntax for groff documents
DOCUMENTATION
Very similar to markdown. So if you know what that is. You will love this :)
We hate word -.-
Editing pdfs is a pain and please we are lazy
We love markdown. But we need pdfs and docx. So why not
LaTEX is amazing but it is tooo much work for small things.
Vim is love. What can we do without keyboard shortcuts ):
What can you do
Write in a text file
Get a cover page as well :)
Get a Table of contents. (Due to limitations : its only on the last page for now.)
Add code. And get execution results directly! Default is python. You can use any other language in your system
Easy tables (Aint nobody got time for complicated ones)
You can get a word document too (you do need libreoffice for it)
Get auto generated, beautifully formatted pdfs and docs instantly
Not cry because you moved an image and now your document is in hieroglyphics
(You can also write in groff syntax in the file. It will work as well. Just in case you need something extra)
Requirements
You need python of course.
For python dependencies, using pip install -r requirements.txt (Only PIL)
Almost every unix system has groff preinstalled.
If you want to convert to word, you need libreoffice.
If you want to get a table of contents you will need pdftk
- yay pdftk #arch
- sudo pacman -S pdftk #arch
- sudo apt install pdftk
Syntax
p runner.py -f "demo.txt" -o "syntax.pdf" (most basic)
p runner.py -f "demo.txt" -o "syntax.pdf" -c True -n "Subhaditya Mukherjee" -t "pyGroff" (with cover page)
Please please look at arguments
By default, it is assumed that you have images. If you wish to disable it (for more speed), just use -i False
Check syntax.pdf and demo.txt for an example
Refer to syntax.pdf for new, easier syntax :)
This was also generated by the program hehe
Examples of langauge strings
python -c (default)
argument -l
R -e
FAQ
I dont like the cover page
- If you know a bit of groff (check the links below), you can use "-d False" and then edit whatever you want using groff itself.
- Then run "groff -ms {infile} -Tpdf > {outfile}" replacing the infile and outfile respectively.
Contribution guidelines
Can I contribute?
- YES
What to do?
- Check todo.md
Restrictions?
- File an issue first, if it looks useful. Go for it
Spelling mistakes?
- I mean sure why not xD
References
Note that the project description data, including the texts, logos, images, and/or trademarks,
for each open source project belongs to its rightful owner.
If you wish to add or remove any projects, please contact us at
[email protected] .