Generate html with python 3. DOM API, Javascript API and more...

These details have not been verified by PyPI

Project links

Project description

𖤐 domonic 𖤐

A DOM for making HTML with python 3! (and more)

Install

python3 -m pip install domonic
# python3 -m pip install domonic --upgrade

Creating HTML with Python 3

from domonic.html import *
print(html(body(h1('Hello, World!'))))
# <html><body><h1>Hello, World!</h1></body></html>

or to pretty format and insert the doctype, use an f-string:

mydom = html(body(h1('Hello, World!'), a("somelink", _href="somepage.html")))
print(f"{mydom}")

<!DOCTYPE html>
<html>
	<body>
		<h1>Hello, World!</h1>
		<a href="somepage.html">somelink</a>
	</body>
</html>

parsing html

Basic useage...

from domonic import domonic
mydom = domonic.parseString('<somehtml...')

To quickly parse a webapge try the window module...

from domonic.window import window
window.location = "http://www.google.com"
print(window.document.title)

Also try the xpath or css selectors on command line...

domonic -x https://google.com '//a' | uniq | sort

html : Generate html with python 3 😎
dom : DOM API in python 3 😲
javascript : js API in python 3 😳 + (dQuery, d3)
JSON : utils for loading / decorating / transforming
SVG || mathml || aframe || x3d tags - generators for popular tags
terminal || cmd : call terminal commands with python3 😱

See the docs/code for more features...

or examples in the repo...

Namespace

Use the tags packaage if you want a namespace. i.e.

import domonic.tags
print(domonic.tags.h1)
# or
import domonic.tags as tags
str(tags.div)
# or 
import domonic.tags as html
print(html.span)

or just import what you need...

from domonic import div, span, input as myinput, html as root

html attributes

prepend attributes with an underscore ( avoids clashing with python keywords )

test = label(_class='classname', _for="someinput")
print(test)

<label class="classname" for="someinput"></label>

rendering DOM objects

domonic is a pure python dom whos tree is composed of objects. i.e

div()
# <domonic.html.div object at 0x106b0e6b0>

cast str() on any element to render it without formatting.

el = str(div())
print(el)
# <div></div>

There's also a render method that takes 2 parameters, some domonic and an optional output file.

page = div(span('Hello World'))
render(f"{page}", 'index.html')  # notice use of f-string to pretty print the html

There's a few new rendering options. See DOMConfig.

from domonic.dom import DOMConfig
print(DOMConfig.GLOBAL_AUTOESCAPE)  # Default False
print(DOMConfig.RENDER_OPTIONAL_CLOSING_TAGS)  # Default True
print(DOMConfig.RENDER_OPTIONAL_CLOSING_SLASH)  # Defaults True
print(DOMConfig.SPACE_BEFORE_OPTIONAL_CLOSING_SLASH)  # Default False

DOM

DOM manipulation with python.

createElement

to create your own elements use the DOM API

from domonic.dom import *

site = html()
el = document.createElement('myelement')
site.appendChild(el)
print(site)
# <html><myelement></myelement></html>

There's an evolving DOM API. To learn more about the webAPI click here.

And check the code/docs to see what's currently been implemented.

mysite.querySelectorAll('button') 
mysite.querySelectorAll("a[rel=nofollow]")
mysite.querySelectorAll("a[href='#services']")
mysite.querySelectorAll("a[href$='technology']")
mysite.querySelectorAll('.fa-twitter')

somelinks = mysite.querySelectorAll("a[href*='twitter']")
for l in somelinks:
    print(l.href)

To use the DOM either reference your root 'html' node or import the dom modules global 'document'

# access the document via the html tag
mydom = html()
# mydom.getElementbyID...

# or by importing the document global
from domonic.dom import document
# document.createElement...
print(document)

javascript

There is a javascript package that mimics the js API:

from domonic.javascript import Math
print(Math.random())

from domonic.javascript import Array
myArr=Array(1,2,3)
print(myArr.splice(1))
# [2, 3]

from domonic.javascript import URL
url = URL('https://somesite.com/blog/article-one#some-hash')
print(url.protocol)  # https
print(url.host)  # somesite.com
print(url.pathname)  # /blog/article-one
print(url.hash)  # #some-hash

# Use Global class to import all the js methods from the global namespace i.e
# from domonic.javascript import Global
# Global.decodeURIComponent(...
# Global.encodeComponent(...
# Global.setInterval(...

# from domonic.javascript import Date, String, Number
# etc..

Use setInterval and clearInterval with params

from domonic.javascript import setInterval, clearInterval

x=0

def hi(inc):
    global x
    x = x+inc
    print(x)

test = setInterval(hi, 1000, 2)
import time
time.sleep(5)
clearInterval(test)
print(f"Final value of x:{x}")

Or for a single delayed function call use setTimeout, clearTimeout

from domonic.javascript import setTimeout, clearTimeout
timeoutID = setTimeout(hi, 1000)

You can call () on a stringvar to transform it into a Node

from domonic.javascript import String

test = String("Hi there!")
test('div', _style="font-color:red;")
str(test('div', _style="font-color:red;"))
# <div style="font-color:red;">Hi there!</div>

a-tags inherit URL:

from domonic.html import *

atag = a(_href="https://somesite.com:8000/blog/article-one#some-hash")
print('href:', atag.href)
# href: https://somesite.com:8000/blog/article-one#some-hash
print('protocol:', atag.protocol)
# protocol: https:
print('port:', atag.port)
# port: 8000

atag.protocol = "http"
atag.port = 8983
print(atag)
# <a href="http://somesite.com:8983/blog/article-one#some-hash">

For writing and using regular javascript, load from a src...

script(_src="/docs/5.0/dist/js/bootstrap.bundle.min.js", _integrity="sha384-1234", _crossorigin="anonymous"),
# <script src="/docs/5.0/dist/js/bootstrap.bundle.min.js" integrity="sha384-1234" crossorigin="anonymous"></script>

or do inline js by opening triple quotes...

script("""
let itbe = ""
"""),

Styling

Styling is supported. Styles get passed to the style tag on render...

mytag = div("hi", _id="test")
mytag.style.backgroundColor = "black"
mytag.style.fontSize = "12px"
print(mytag)
# <div id="test" style="background-color:black;font-size:12px;">hi</div>

To use css use a link tag as you usually would...

link(_href="styles.css", _rel="stylesheet"),

or use triple quotes to open style tag...

style("""
.placeholder-img {
    -webkit-user-select: none;
    -moz-user-select: none;
    -ms-user-select: none;
    user-select: none;
}
"""),

decorators

use decorators to wrap elements around function results

from domonic.decorators import el

@el(html, True)
@el(body)
@el(div)
def test():
    return 'hi!'

print(test())
# <html><body><div>hi!</div></body></html>

# returns pyml objects so call str to render
assert str(test()) == '<html><body><div>hi!</div></body></html>'

It returns the tag object by default. You can pass True as a second param to the decorator to return a rendered string instead. Also accepts strings as first param i.e. custom tags.

data-tags

python doesn't allow hyphens in parameter names. so use variable keyword argument syntax for custom data-tags

div("test", **{"_data-test":"test"} )
# <div data-test="test">test</div>

or for example a colon...

t = div( **{"_:test":"something"} )
str(t)
# <div :test="something"></div>

JSON (utils)

decorate any function that returns python objects to return json instead

from domonic.decorators import as_json
import domonic.JSON as JSON

@as_json
def somefunc():
    myObj = {"hi":[1,2,3]}
    return myObj

print( somefunc() )
# {"hi":[1,2,3]}
print( JSON.is_json(somefunc()) )
# True

convert json arrays into html tables...

import domonic.JSON as JSON

# i.e. containting flat json array of dicts... [{"id":"01","name": "some item"},{"id":"02","name": "some other item"}]

json_data = JSON.parse_file('somefile.json')
mytable = JSON.tablify(json_data)
print(mytable)

convert json arrays into csv files...

import domonic.JSON as JSON

json_data = JSON.parse_file('somefile.json')
JSON.csvify(json_data, 'data.csv')

convert csv files to json...

import domonic.JSON as JSON

json_data =JSON.csv2json("data.csv")
print(json_data)

more to come...

SVG

All tags extend 'Element'. So will have DOM and magic methods available to them. See the docs.

circ = svg(
    circle(_cx="50", _cy="50", _r="40", _stroke="green", **{"_stroke-width": "4"}, _fill="yellow"),
    _width="100", _height="100",
)
mysvg = svg()
mysvg.appendChild(circ / 10)
print(mysvg)

Tweening

Tween values with the tween library:

from domonic.lerpy.easing import *
from domonic.lerpy.tween import *

someObj = {'x':0,'y':0,'z':0}
twn = Tween( someObj, { 'x':10, 'y':5, 'z':3 }, 6, Linear.easeIn )
twn.start()

aframe / x3d

3d tags can be used if you import the js

from domonic.html import *
from domonic.xml.aframe import *
from domonic.CDN import *

_scene = scene(
      box(_position="-1 0.5 -3", _rotation="0 45 0", _color="#4CC3D9"),
      sphere(_position="0 1.25 -5", _radius="1.25", _color="#EF2D5E"),
      cylinder(_position="1 0.75 -3", _radius="0.5", _height="1.5", _color="#FFC65D"),
      plane(_position="0 0 -4", _rotation="-90 0 0", _width="4", _height="4", _color="#7BC8A4"),
      sky(_color="#ECECEC")
    )

_webpage = html(head(),body(
    script(_src=CDN_JS.AFRAME_1_2), # < NOTICE you need to import aframe to use it
    str(_scene)
    )
)

render( _webpage, 'hello.html' )

dQuery (NEW)

dQuery uses the º symbol (alt+0).

from domonic.html import *
from domonic.dQuery import º

d = html(head(body(li(_class='things'), div(_id="test"))))

print( º('#test') )
# <div id="test">
print( º('.things') )
# <li class="things">
mydiv = º('<div class="test2"></div>')
# <domonic.dQuery.o object at 0x107d5c9a0>

b = º('#test').append(mydiv)
print(b)
# <div id="test"><div class="test2"></div></div>

Only recently started so check to see what's implemented.

terminal

There is a command line package that can call bash/unix/posix and other apps on the command line:

This package only works on nix systems as it effectively just passes stuff off to subprocess.

from domonic.terminal import *

print(ls())
print(ls("-al"))
print(ls("../"))
print(pwd())
print(mkdir('somedir'))
print(touch('somefile'))
print(git('status'))

for file in ls( "-al" ):
    print("Line : ", file)

for f in ls():
    try:
        print(f)
        print(cat(f))
    except Exception as e:
        pass

for i, l in enumerate(cat('LICENSE.txt')):
    print(i,l)

print(man("ls"))
print(echo('test'))
print(df())
print(du())

for thing in du():
    print(thing)

print(find('.'))
# print(ping('eventual.technology'))# < TODO - need to strean output
print(cowsay('moo'))
# print(wget('eventual.technology'))
print(date())
print(cal())

or just run arbitrary commands...

from domonic.terminal import command
command.run("echo hi")

Take a look at the code in 'terminal.py' to see all the commands as there's loads. (Disclaimer: not all tested.)

Windows users can use now use cmd.

from domonic.cmd import *
print(dir())
print(dir("..\\"))

DOCS

https://domonic.readthedocs.io/

CLI

Use the command line interface to help you out.

To view the online the docs:

domonic -h

To see the version:

domonic -v

To quickly create a domonic project for prototyping:

domonic -p myproject

To evaluate some domonic pyml:

domonic -e 'html(head(),body(div()))'

To use xpath on a website from the command line:

domonic -x https://google.com '//a'

To use css selectors on a website from the command line:

domonic -q https://google.com 'a'

EXAMPLE PROJECTS

Blueberry : A browser based file OS. Working example of how components can work.

ezcron : A cron viewer

bombdisposer : A basic game

htmlx : A low dependency lightweight (DOM only) version of domonic

Checkout the docs for more examples i.e. generating sitemaps or using domonic with server frameworks like flask, django, sanic, fastapi and others.

There's also several useage examples in the repo so pull and have a look.

Join-In

Feel free to contribute if you find it useful. (I'd be grateful for help on all fronts)

Email me, message me directly if you like or create a discussion on here. Or join the discord.

If there are any methods you want that are missing or not complete yet or you think you can help make it better just update the code and send a pull request. I'll merge and releaese asap.

In the repo there's a requirements-dev.txt which is mostly the libs used in the examples.

requirements.txt are the libs used for packaging just the lib.

running examples

. venv/bin/activate
pip install -r requirements-dev.txt
cd examples
python lifecalendar.py

run tests

There are tests used during dev. They are useful as code examples and to see what still needs doing.

See Makefile to run all tests:

make test  # default tests ubuntu. so will fail on window when terminal test runs. comment out locally if that's the case

or to test a single function:

python -m unittest tests.test_javascript.TestCase.test_javascript_array
python -m unittest tests.test_dQuery.TestCase.test_addClass
python -m unittest tests.test_geom.TestCase.test_vec2
python3 -m unittest tests.test_cmd.TestCase.test_cmd_dir  # only windows

or to test a whole module

python -m unittest tests.test_html
python -m unittest tests.test_CDN

to see coverage

coverage run -m unittest discover tests/
coverage report

or...

pip install pytest
pytest tests

Disclaimer

There's several more widely supported libraries doing HTML generation, DOM reading/manipulation, terminal wrappers etc. Maybe use one of those for production due to strictness and support.

This is more of a fast prototyping library.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.9.12

Nov 6, 2023

0.9.11

Jun 28, 2022

0.9.10

Apr 10, 2022

0.9.9

Apr 5, 2022

0.9.8

Mar 24, 2022

0.9.7

Feb 26, 2022

0.9.6

Feb 25, 2022

0.9.5

Feb 23, 2022

0.9.4

Feb 17, 2022

0.9.3

Feb 15, 2022

0.9.1

Feb 11, 2022

0.9.0

Jan 24, 2022

0.8.5

Jan 22, 2022

0.8.4

Jan 16, 2022

0.8.3

Dec 14, 2021

0.8.2

Dec 4, 2021

0.8.1

Dec 4, 2021

0.8.0

Dec 3, 2021

0.7.3

Nov 30, 2021

0.7.2

Nov 23, 2021

0.7.1

Nov 20, 2021

0.7.0

Nov 17, 2021

0.6.9

Nov 6, 2021

0.6.8

Nov 5, 2021

0.6.7

Oct 31, 2021

0.6.6

Oct 28, 2021

0.6.5

Oct 27, 2021

0.6.4

Oct 25, 2021

0.6.3

Oct 20, 2021

0.6.2

Oct 12, 2021

0.6.1

Oct 9, 2021

0.6.0

Sep 26, 2021

0.5.1

Sep 11, 2021

0.5.0

Sep 6, 2021

0.4.8

Aug 26, 2021

0.4.7

Aug 21, 2021

0.4.6

Aug 15, 2021

0.4.5

Aug 13, 2021

0.4.4

Aug 8, 2021

0.4.3

Aug 8, 2021

0.4.2

Aug 5, 2021

0.4.1

Aug 5, 2021

0.4.0

Jul 29, 2021

0.3.19

Jul 21, 2021

0.3.18

Jul 10, 2021

0.3.17

Jul 6, 2021

0.3.16

Jul 4, 2021

0.3.15

Jul 4, 2021

0.3.14

Jul 3, 2021

0.3.13

Jul 1, 2021

0.3.12

Jun 27, 2021

0.3.11

Jun 26, 2021

0.3.10

Jun 24, 2021

0.3.9

Jun 10, 2021

0.3.8

Jun 2, 2021

0.3.7

Jun 1, 2021

0.3.6

May 30, 2021

0.3.5

May 30, 2021

0.3.4

May 29, 2021

0.3.3

May 28, 2021

0.3.2

May 4, 2021

0.3.1

May 3, 2021

0.3.0

May 3, 2021

0.2.18

May 2, 2021

0.2.17

May 1, 2021

0.2.16

Apr 27, 2021

0.2.15

Apr 26, 2021

0.2.14

Apr 26, 2021

0.2.13

Apr 17, 2021

0.2.12

Apr 16, 2021

0.2.11

Sep 27, 2020

0.2.10

Sep 20, 2020

0.2.9

Sep 14, 2020

0.2.8

Sep 13, 2020

0.2.7

Sep 6, 2020

0.2.6

Sep 5, 2020

0.2.5

Sep 4, 2020

0.2.4

Sep 4, 2020

0.2.3

Sep 4, 2020

0.2.2

Sep 3, 2020

0.2.1

Sep 2, 2020

0.2.0

Sep 2, 2020

0.1.12

Sep 2, 2020

0.1.11

Aug 31, 2020

0.1.10

Aug 31, 2020

0.1.9

Aug 30, 2020

0.1.8

Aug 30, 2020

0.1.7

Aug 29, 2020

0.1.6

Aug 24, 2020

0.1.5

Aug 20, 2020

0.1.4

Aug 20, 2020

0.1.3

Aug 19, 2020

0.1.2

Aug 13, 2020

0.1.1

Jul 6, 2020

0.1.0

Jul 6, 2020

0.0.9

Jul 2, 2020

0.0.8

Jul 1, 2020

0.0.7

Jul 1, 2020

0.0.6

Jun 29, 2020

0.0.5

Jun 27, 2020

0.0.4

Jun 17, 2020

0.0.3

Jun 17, 2020

0.0.2

Jun 15, 2020

0.0.1

Jun 15, 2020

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

domonic-0.9.12.tar.gz (358.8 kB view details)

Uploaded Nov 6, 2023 Source

Built Distribution

domonic-0.9.12-py3-none-any.whl (314.8 kB view details)

Uploaded Nov 6, 2023 Python 3

File details

Details for the file domonic-0.9.12.tar.gz.

File metadata

Download URL: domonic-0.9.12.tar.gz
Upload date: Nov 6, 2023
Size: 358.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.9.6

File hashes

Hashes for domonic-0.9.12.tar.gz
Algorithm	Hash digest
SHA256	`2245d149ea9c563ef3471f89b5850a548b77c9eea77c2aa9eee15afac373c09b`
MD5	`324828e1f48377544542a85476d56dfa`
BLAKE2b-256	`22f439dae82aa5023539c90f877bfb05f2d537feb07f7eca2707a4e2227432da`

See more details on using hashes here.

File details

Details for the file domonic-0.9.12-py3-none-any.whl.

File metadata

Download URL: domonic-0.9.12-py3-none-any.whl
Upload date: Nov 6, 2023
Size: 314.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.9.6

File hashes

Hashes for domonic-0.9.12-py3-none-any.whl
Algorithm	Hash digest
SHA256	`df6eafa6c37b382b5d2d3c38c05aff5f87d4b8fdae6f19d779278406578e98d6`
MD5	`605b59e06f0db06b2aa4be1d5e3b91b7`
BLAKE2b-256	`c357c96d8aba44d4ec889c4960acd61c61aaafe85d204e3ed337888c3b60d12c`

See more details on using hashes here.

domonic 0.9.12

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

𖤐 domonic 𖤐

A DOM for making HTML with python 3! (and more)

Install

Creating HTML with Python 3

parsing html

More

Namespace

html attributes

rendering DOM objects

DOM

createElement

javascript

Styling

decorators

data-tags

JSON (utils)

SVG

Tweening

aframe / x3d

dQuery (NEW)

terminal

DOCS

CLI

EXAMPLE PROJECTS

Join-In

running examples

run tests

Disclaimer

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes