Skip to main content

No project description provided

Project description

beautifulspoon

The project is a command line tool build upon beautifulsoup, or say this is a oneliner's tool for dealing with html files. With beautifulspoon, you can easily modify html files in the shell or within the scripts.

Install

pip install beautifulspoon

Usage

Let's prepare a test.html as below:

<html>
 <head>
  <title>
   Hello World
  </title>
 </head>
 <body>
  <div class="container" id="root">
   <a href="https://www.google.com">
    Google
   </a>
  </div>
 </body>
</html>

We can explore the functions of beautifulspoon as follow.

  • Get the first HTML element matched selectors in --select.
bspoon test.html --select '#root a'
  • Get all the HTML element matched selectors in --select.
bspoon test.html --select '#root a' --all
  • --set_name, change the name of the selected tag.
$ bspoon debug/test.html --select a --set_name button|bspoon --select button
<button href="https://www.google.com">
 Google
</button>
  • --set_attr, set attributes for the seleted tag.
$ bspoon test.html --select a --set_attr class link|bspoon --select a
<a class="link" href="https://www.google.com">
 Google
</a>
  • --append, append a node(HTML) inside the selected node.
$ bspoon test.html --select a --append '<b>Home</b>'|bspoon --select a
<a href="https://www.google.com">
 Google
 <b>
  Home
 </b>
</a>
  • --extend, extend the string(text) of the selected node. Adding --smooth may help smooth the extended content.
$ bspoon test.html --select a --extend ' It' --smooth|bspoon --select a
<a href="https://www.google.com">
 Google
    It
</a>

$ bspoon test.html --select a --extend ' It' --smooth|bspoon --select a
<a href="https://www.google.com">
 Google It
</a>
  • --insert, insert a node(HTML) at the POS position inside the selected node. Arguments --insert_before and --insert_after are the same with --insert, with insert position specified at the first and the last slots.
$ bspoon test.html --select div --insert 0 '<br/>'| bspoon --select div
<div class="container" id="root">
 <br/>
 <a href="https://www.google.com">
  Google
 </a>
</div>
  • --insert_before(--ib), insert a node(HTML) before the selected node.
$ bspoon test.html --select a --insert_before '<br/>'|bspoon --select div
<div class="container" id="root">
 <br/>
 <a href="https://www.google.com">
  Google
 </a>
</div>
  • --insert_after(--ia), insert a node(HTML) next to the position of the selected node.
$ bspoon test.html --select a --ia '<br/>'|bspoon --select div
<div class="container" id="root">
 <a href="https://www.google.com">
  Google
 </a>
 <br/>
</div>
  • --clear, clear the inner content of the seleted node.
$ bspoon test.html --select div --clear| bspoon --select div
<div class="container" id="root">
</div>
  • --decompose, remove the node along with its inner content of the seleted node.
$ bspoon test.html --select div --decompose|bspoon --select body
<body>
</body>
  • --replace_with, replace the seleted node with HTML.
$ bspoon test.html --select a --replace_with '<br/>'| bspoon --select div
<div class="container" id="root">
 <br/>
</div>
  • --comment, Comment the selected node.
$ bspoon test.html --select a --comment|bspoon --select div
<div class="container" id="root">
 <!-- <a href="https://www.google.com">Google</a> -->
</div>
  • --wrap, wrap the seleted node with tag provided(HTML).
$ bspoon test.html --select a --wrap '<p></p>'
| bspoon --select p
<p>
 <a href="https://www.google.com">
  Google
 </a>
</p>
  • --unwrap, unwrap the selected node.
$ bspoon test.html --select a --unwrap|bspoon --select div
<div class="container" id="root">
 Google
</div>

Project details


Download files

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

Source Distribution

beautifulspoon-0.0.4.tar.gz (3.6 kB view details)

Uploaded Source

Built Distribution

beautifulspoon-0.0.4-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file beautifulspoon-0.0.4.tar.gz.

File metadata

  • Download URL: beautifulspoon-0.0.4.tar.gz
  • Upload date:
  • Size: 3.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.5 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for beautifulspoon-0.0.4.tar.gz
Algorithm Hash digest
SHA256 36b5f6b1242e4ff8423bc60725415bb927a570e4a2a519804140bd2ec9dcc53a
MD5 590926e0b8255cc35159d6ff97e5e497
BLAKE2b-256 dc6903bfc49cdcf6589230bd29042677fff01b1270f5549f79af48dcddb563e0

See more details on using hashes here.

File details

Details for the file beautifulspoon-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: beautifulspoon-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.5 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for beautifulspoon-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1add578b61f4544293408a1cd61a37ceb2b0074242bbb264e108026cef23b396
MD5 93aaba7c319ffe967bf29c9b6073bc15
BLAKE2b-256 05b0a2a4b0119b0e7a265025732e7516a30c0487006bd96355ddf9ca8536b153

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page