location: Split the "How To Use?" page into several pages

[ipfire.org.git] / src / templates / location / how-to-use / python.html

{% extends "../../base.html" %}

{% block title %}{{ _("How To Use?") }} - {{ _("Python") }}{% end block %}

{% block container %}
	<section class="hero is-light">
		<div class="hero-body">
			<div class="container">
				<nav class="breadcrumb" aria-label="breadcrumbs">
					<ul>
						<li>
							<a href="/">
								{{ _("Home") }}
							</a>
						</li>
						<li>
							<a href="/location">
								{{ _("Location") }}
							</a>
						</li>
						<li>
							<a href="/location/how-to-use">
								{{ _("How To Use?") }}
							</a>
						</li>
						<li class="is-active">
							<a href="#" aria-current="page">{{ _("Python") }}</a>
						</li>
					</ul>
				</nav>

				<h1 class="title">{{ _("Python") }}</h1>
			</div>
		</div>
	</section>

	<section class="section">
		<div class="container">
			<div class="columns">
				<div class="column">
					<div class="content">
						<p>
							<code>libloc</code> comes with native Python bindings which
							are used by its main command-line tool
							<a class="text-white" href="https://man-pages.ipfire.org/libloc/location.html">
								<code>location</code>
							</a>.
							They are the most advanced bindings as they support reading
							from the database as well as writing to it.
						</p>
					</div>
				</div>

				<div class="column is-narrow">
					<figure class="image is-128x128">
						<img src="{{ static_url("img/python-logo.svg") }}"
							alt="{{ _("Python") }}">
					</figure>
				</div>
			</div>

			<div class="block">
				<h6 class="title is-6">{{ _("Load the database") }}</h6>

				<pre><code>Python 3.7.3 (default, Apr  3 2019, 05:39:12)
[GCC 8.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
&gt;&gt;&gt; import location
&gt;&gt;&gt; d = location.Database("/usr/share/location/database.db")</code></pre>
			</div>

			<div class="block">
				<h6 class="title is-6">{{ _("Search for an Autonomous System by Name") }}</h6>

				<pre><code>&gt;&gt;&gt; for i in d.search_as("Lightning Wire Labs"):
... &nbsp;&nbsp;print(i)
...
AS204867 (Lightning Wire Labs GmbH)</code></pre>
			</div>

			<div class="block">
				<h6 class="title is-6">{{ _("Lookup an IP Address") }}</h6>

				<pre><code>&gt;&gt;&gt; n = d.lookup("81.3.27.38")
&gt;&gt;&gt; n
&lt;location.Network 81.3.27.0/24&gt;
&gt;&gt;&gt; n.asn
24679
&gt;&gt;&gt; n.country_code
'DE'</code></pre>
			</div>
		</div>
	</section>
{% end block %}