StandAlone Async cross-platform Prettifier Beautifier for the Web.
Project description
# css-html-prettify
Async single-file cross-platform no-dependencies Prettifier Beautifier for the Web. [![GPL License](http://img.shields.io/badge/license-GPL-blue.svg?style=plastic)](http://opensource.org/licenses/GPL-3.0) [![LGPL License](http://img.shields.io/badge/license-LGPL-blue.svg?style=plastic)](http://opensource.org/licenses/LGPL-3.0) [![Python Version](https://img.shields.io/badge/Python-3-brightgreen.svg?style=plastic)](http://python.org)
![screenshot](https://source.unsplash.com/q78PYnUehV8/800x402 "Illustrative Photo by https://unsplash.com/@s_erwin")
https://pypi.python.org/pypi/css-html-prettify
```bash
css-html-prettify.py --help
usage: css-html-prettify.py [-h] [--version] [--prefix PREFIX] [--timestamp]
[--quiet] [--checkupdates] [--after AFTER]
[--before BEFORE] [--watch] [--group] [--justify]
fullpath
CSS-HTML-Prettify. StandAlone Async single-file cross-platform no-dependencies
Unicode-ready Python3-ready Prettifier Beautifier for the Web.
positional arguments:
fullpath Full path to local file or folder.
optional arguments:
-h, --help show this help message and exit
--version show programs version number and exit
--prefix PREFIX Prefix string to prepend on output filenames.
--timestamp Add a Time Stamp on all CSS/SCSS output files.
--quiet Quiet, Silent, force disable all Logging.
--checkupdates Check for Updates from Internet while running.
--after AFTER Command to execute after run (Experimental).
--before BEFORE Command to execute before run (Experimental).
--watch Re-Compress if file changes (Experimental).
--group Group Alphabetically CSS Poperties by name.
--justify Right Justify CSS Properties (Experimental).
--extraline Add 1 New Line for each New Line (Experimental)
CSS-HTML-Prettify: Takes file or folder full path string and process all
CSS/SCSS/HTML found. If argument is not file/folder will fail. Check Updates
works on Python3. StdIn to StdOut is deprecated since may fail with unicode
characters. CSS Properties are AlphaSorted,to help spot cloned ones,Selectors
not. Watch works for whole folders, with minimum of ~60 Secs between runs.
```
- Takes a full path to anything, a file or a folder, then parse, Prettify and Beautify for Human Development.
- If full path is a folder with multiple files it will use Async Multiprocessing.
- Pretty-Printed colored Logging to Standard Output and Log File on OS Temporary Folder.
- Set its own Process name and show up on Process lists.
- Full Unicode/UTF-8 support, SASS SCSS Support.
- Smooth CPU usage.
- Can Watch for changes on files.
- Can execute arbitrary commands after and before running.
- `*.css` files are saved as `*.css`, `*.html` are saved as `*.html`, unless provided a prefix.
# Use
```shell
css-html-prettify.py file.html
css-html-prettify.py file.htm
css-html-prettify.py file.css
css-html-prettify.py file.scss
css-html-prettify.py /project/static/
```
# Install
```
pip install css-html-prettify
```
Uninstall `pip uninstall css-html-prettify`
# Why?
- This project is the small brother of [another project that does the inverse, a Minifier Compressor for the Web.](https://github.com/juancarlospaco/css-html-js-minify#css-html-js-minify)
# Requisites
- [Python 3.6+](https://www.python.org "Python Homepage")
**Optional:**
- BeautifulSoup 4+ (Recommeded, for HTML5 Prettify, without BeautifulSoup it works, but only strict XHTML can be processed)
# Example
<details>
**Input CSS:**
```css
/* dont remove this comment */
.class, #NotHex, input[type="text"], a:hover {
border:none;
margin:0 0 0 0;
border-color: fuchsia;
color: mediumspringgreen;
background-position:0 0;
transform-origin:0 0;
margin: 0px !important;
color: #000000;
background-color: #FFFFFF;
}
.foo {content: "If you leave too much new lines it will add a horizontal line"}
```
**Output CSS:**
```css
@charset utf-8;
/* dont remove this comment */
.class, #NotHex, input[type="text"], a:hover {
background-color: #FFFFFF;
background-position: 0 0;
border: none;
border-color: fuchsia;
color: mediumspringgreen;
color: #000000;
margin: 0 0 0 0;
margin: 0 !important;
transform-origin: 0 0;
}
/* ------------------------------------------------------------------------ */
.foo {content: "If you leave too much new lines it will add a horizontal line"}
```
</details>
# Coding Style Guide
- Lint, [PEP-8](https://www.python.org/dev/peps/pep-0008), [PEP-257](https://www.python.org/dev/peps/pep-0257), [iSort](https://github.com/timothycrosley/isort) must Pass Ok. `pip install prospector pre-commit isort`
- If theres any kind of Tests, they must Pass Ok, if theres no Tests, its ok, if Tests provided, is even better.
# Contributors
- **Please Star this Repo on Github !**, it helps to show up faster on searchs.
- [Help](https://help.github.com/articles/using-pull-requests) and more [Help](https://help.github.com/articles/fork-a-repo) and Interactive Quick [Git Tutorial](https://try.github.io).
# Licence
- GNU GPL Latest Version *AND* GNU LGPL Latest Version *AND* any Licence [YOU Request via Bug Report](https://github.com/juancarlospaco/css-html-prettify/issues/new).
Async single-file cross-platform no-dependencies Prettifier Beautifier for the Web. [![GPL License](http://img.shields.io/badge/license-GPL-blue.svg?style=plastic)](http://opensource.org/licenses/GPL-3.0) [![LGPL License](http://img.shields.io/badge/license-LGPL-blue.svg?style=plastic)](http://opensource.org/licenses/LGPL-3.0) [![Python Version](https://img.shields.io/badge/Python-3-brightgreen.svg?style=plastic)](http://python.org)
![screenshot](https://source.unsplash.com/q78PYnUehV8/800x402 "Illustrative Photo by https://unsplash.com/@s_erwin")
https://pypi.python.org/pypi/css-html-prettify
```bash
css-html-prettify.py --help
usage: css-html-prettify.py [-h] [--version] [--prefix PREFIX] [--timestamp]
[--quiet] [--checkupdates] [--after AFTER]
[--before BEFORE] [--watch] [--group] [--justify]
fullpath
CSS-HTML-Prettify. StandAlone Async single-file cross-platform no-dependencies
Unicode-ready Python3-ready Prettifier Beautifier for the Web.
positional arguments:
fullpath Full path to local file or folder.
optional arguments:
-h, --help show this help message and exit
--version show programs version number and exit
--prefix PREFIX Prefix string to prepend on output filenames.
--timestamp Add a Time Stamp on all CSS/SCSS output files.
--quiet Quiet, Silent, force disable all Logging.
--checkupdates Check for Updates from Internet while running.
--after AFTER Command to execute after run (Experimental).
--before BEFORE Command to execute before run (Experimental).
--watch Re-Compress if file changes (Experimental).
--group Group Alphabetically CSS Poperties by name.
--justify Right Justify CSS Properties (Experimental).
--extraline Add 1 New Line for each New Line (Experimental)
CSS-HTML-Prettify: Takes file or folder full path string and process all
CSS/SCSS/HTML found. If argument is not file/folder will fail. Check Updates
works on Python3. StdIn to StdOut is deprecated since may fail with unicode
characters. CSS Properties are AlphaSorted,to help spot cloned ones,Selectors
not. Watch works for whole folders, with minimum of ~60 Secs between runs.
```
- Takes a full path to anything, a file or a folder, then parse, Prettify and Beautify for Human Development.
- If full path is a folder with multiple files it will use Async Multiprocessing.
- Pretty-Printed colored Logging to Standard Output and Log File on OS Temporary Folder.
- Set its own Process name and show up on Process lists.
- Full Unicode/UTF-8 support, SASS SCSS Support.
- Smooth CPU usage.
- Can Watch for changes on files.
- Can execute arbitrary commands after and before running.
- `*.css` files are saved as `*.css`, `*.html` are saved as `*.html`, unless provided a prefix.
# Use
```shell
css-html-prettify.py file.html
css-html-prettify.py file.htm
css-html-prettify.py file.css
css-html-prettify.py file.scss
css-html-prettify.py /project/static/
```
# Install
```
pip install css-html-prettify
```
Uninstall `pip uninstall css-html-prettify`
# Why?
- This project is the small brother of [another project that does the inverse, a Minifier Compressor for the Web.](https://github.com/juancarlospaco/css-html-js-minify#css-html-js-minify)
# Requisites
- [Python 3.6+](https://www.python.org "Python Homepage")
**Optional:**
- BeautifulSoup 4+ (Recommeded, for HTML5 Prettify, without BeautifulSoup it works, but only strict XHTML can be processed)
# Example
<details>
**Input CSS:**
```css
/* dont remove this comment */
.class, #NotHex, input[type="text"], a:hover {
border:none;
margin:0 0 0 0;
border-color: fuchsia;
color: mediumspringgreen;
background-position:0 0;
transform-origin:0 0;
margin: 0px !important;
color: #000000;
background-color: #FFFFFF;
}
.foo {content: "If you leave too much new lines it will add a horizontal line"}
```
**Output CSS:**
```css
@charset utf-8;
/* dont remove this comment */
.class, #NotHex, input[type="text"], a:hover {
background-color: #FFFFFF;
background-position: 0 0;
border: none;
border-color: fuchsia;
color: mediumspringgreen;
color: #000000;
margin: 0 0 0 0;
margin: 0 !important;
transform-origin: 0 0;
}
/* ------------------------------------------------------------------------ */
.foo {content: "If you leave too much new lines it will add a horizontal line"}
```
</details>
# Coding Style Guide
- Lint, [PEP-8](https://www.python.org/dev/peps/pep-0008), [PEP-257](https://www.python.org/dev/peps/pep-0257), [iSort](https://github.com/timothycrosley/isort) must Pass Ok. `pip install prospector pre-commit isort`
- If theres any kind of Tests, they must Pass Ok, if theres no Tests, its ok, if Tests provided, is even better.
# Contributors
- **Please Star this Repo on Github !**, it helps to show up faster on searchs.
- [Help](https://help.github.com/articles/using-pull-requests) and more [Help](https://help.github.com/articles/fork-a-repo) and Interactive Quick [Git Tutorial](https://try.github.io).
# Licence
- GNU GPL Latest Version *AND* GNU LGPL Latest Version *AND* any Licence [YOU Request via Bug Report](https://github.com/juancarlospaco/css-html-prettify/issues/new).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
css-html-prettify-2.5.5.zip
(18.0 kB
view details)
Built Distributions
File details
Details for the file css-html-prettify-2.5.5.zip
.
File metadata
- Download URL: css-html-prettify-2.5.5.zip
- Upload date:
- Size: 18.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4fbdd6d42256fc9573fea57874852b8df58bef469b0a3e2f154000b85bcbbc44 |
|
MD5 | 60c75b52d27fa66261d85f3e01f2ebaa |
|
BLAKE2b-256 | 4904bb7856e351315046516399c37974e9dafbb3f1ca1593f35ccbfe25aa4ad1 |
File details
Details for the file css_html_prettify-2.5.5-py3.6.egg
.
File metadata
- Download URL: css_html_prettify-2.5.5-py3.6.egg
- Upload date:
- Size: 10.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d1df7cf0830298a5dd532dfefa240291021d66097b4f8446cbbf3b3050f04b61 |
|
MD5 | fa16a905e48a6e43fcd7f193a7cfb6a8 |
|
BLAKE2b-256 | 23655d29956c12db631e1b3711c368fd492c10cc47afe7e64d1aeb06d9c22df8 |
File details
Details for the file css_html_prettify-2.5.5-py2.py3-none-any.whl
.
File metadata
- Download URL: css_html_prettify-2.5.5-py2.py3-none-any.whl
- Upload date:
- Size: 10.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 992040e47cd81511c8ca8f632febda380b7d93908418703a29d310c0b56077a6 |
|
MD5 | c8baee8868bcb229a62f5085a187d53d |
|
BLAKE2b-256 | bc604160db2abca67e80cc61c3c59dc2d477c59701a0412f3c1742094f7e2d8d |