Compare commits
6 Commits
Author | SHA1 | Date | |
---|---|---|---|
5407681c34 | |||
cfd977135d | |||
7a5e0bfdaf | |||
48dcda8020 | |||
3ed2170a32 | |||
d6ef55020c |
25
CITATION.cff
Normal file
25
CITATION.cff
Normal file
@ -0,0 +1,25 @@
|
||||
cff-version: 1.2.0
|
||||
message: "If you use this software, please cite it as below."
|
||||
title: waybackpy
|
||||
abstract: "Python package that interfaces with the Internet Archive's Wayback Machine APIs. Archive pages and retrieve archived pages easily."
|
||||
version: '3.0.6'
|
||||
doi: 10.5281/ZENODO.3977276
|
||||
date-released: 2022-03-15
|
||||
type: software
|
||||
authors:
|
||||
- given-names: Akash
|
||||
family-names: Mahanty
|
||||
email: akamhy@yahoo.com
|
||||
orcid: https://orcid.org/0000-0003-2482-8227
|
||||
keywords:
|
||||
- Archive Website
|
||||
- Wayback Machine
|
||||
- Internet Archive
|
||||
- Wayback Machine CLI
|
||||
- Wayback Machine Python
|
||||
- Internet Archiving
|
||||
- Availability API
|
||||
- CDX API
|
||||
- savepagenow
|
||||
license: MIT
|
||||
repository-code: "https://github.com/akamhy/waybackpy"
|
26
README.md
26
README.md
@ -22,15 +22,15 @@
|
||||
|
||||
# <img src="https://github.githubassets.com/images/icons/emoji/unicode/2b50.png" width="30"></img> Introduction
|
||||
|
||||
Waybackpy is a [Python package](https://www.udacity.com/blog/2021/01/what-is-a-python-package.html) and a [CLI](https://www.w3schools.com/whatis/whatis_cli.asp) tool that interfaces with the [Wayback Machine](https://en.wikipedia.org/wiki/Wayback_Machine) API.
|
||||
Waybackpy is a Python package and a CLI tool that interfaces with the Wayback Machine APIs.
|
||||
|
||||
Wayback Machine has 3 client side [API](https://www.redhat.com/en/topics/api/what-are-application-programming-interfaces)s.
|
||||
Wayback Machine has 3 client side APIs.
|
||||
|
||||
- [Save API](https://github.com/akamhy/waybackpy/wiki/Wayback-Machine-APIs#save-api)
|
||||
- [Availability API](https://github.com/akamhy/waybackpy/wiki/Wayback-Machine-APIs#availability-api)
|
||||
- [CDX API](https://github.com/akamhy/waybackpy/wiki/Wayback-Machine-APIs#cdx-api)
|
||||
- SavePageNow or Save API
|
||||
- CDX Server API
|
||||
- Availability API
|
||||
|
||||
These three APIs can be accessed via the waybackpy either by importing it in a script or from the CLI.
|
||||
These three APIs can be accessed via the waybackpy either by importing it from a python file/module or from the command-line interface.
|
||||
|
||||
## <img src="https://github.githubassets.com/images/icons/emoji/unicode/1f3d7.png" width="20"></img> Installation
|
||||
|
||||
@ -58,11 +58,11 @@ pip install git+https://github.com/akamhy/waybackpy.git
|
||||
|
||||
## <img src="https://github.githubassets.com/images/icons/emoji/unicode/1f433.png" width="20"></img> Docker Image
|
||||
|
||||
Docker Hub : <https://hub.docker.com/r/secsi/waybackpy>
|
||||
Docker Hub: [hub.docker.com/r/secsi/waybackpy](https://hub.docker.com/r/secsi/waybackpy)
|
||||
|
||||
[Docker image](https://searchitoperations.techtarget.com/definition/Docker-image) is automatically updated on every release by [Regulary and Automatically Updated Docker Images](https://github.com/cybersecsi/RAUDI) (RAUDI).
|
||||
Docker image is automatically updated on every release by [Regulary and Automatically Updated Docker Images](https://github.com/cybersecsi/RAUDI) (RAUDI).
|
||||
|
||||
RAUDI is a tool by SecSI (<https://secsi.io>), an Italian cybersecurity startup.
|
||||
RAUDI is a tool by [SecSI](https://secsi.io), an Italian cybersecurity startup.
|
||||
|
||||
## <img src="https://github.githubassets.com/images/icons/emoji/unicode/1f680.png" width="20"></img> Usage
|
||||
|
||||
@ -165,7 +165,8 @@ https://web.archive.org/web/20171206002737/http://pypi.org:80/
|
||||
|
||||
#### Availability API
|
||||
|
||||
It is recommended to not use the availability API due to performance issues. All the methods of availability API interface class, `WaybackMachineAvailabilityAPI`, are also implemented in the CDX server API interface class, `WaybackMachineCDXServerAPI`.
|
||||
It is recommended to not use the availability API due to performance issues. All the methods of availability API interface class, `WaybackMachineAvailabilityAPI`, are also implemented in the CDX server API interface class, `WaybackMachineCDXServerAPI`. Also note
|
||||
that the `newest()` method of `WaybackMachineAvailabilityAPI` can be more recent than `WaybackMachineCDXServerAPI`'s same method.
|
||||
|
||||
```python
|
||||
>>> from waybackpy import WaybackMachineAvailabilityAPI
|
||||
@ -201,10 +202,5 @@ Demo video on [asciinema.org](https://asciinema.org/a/469890), you can copy the
|
||||
|
||||
> CLI documentation is at <https://github.com/akamhy/waybackpy/wiki/CLI-docs>.
|
||||
|
||||
## <img src="https://github.githubassets.com/images/icons/emoji/unicode/1f6e1.png" width="20"></img> License
|
||||
|
||||
[](https://github.com/akamhy/waybackpy/blob/master/LICENSE)
|
||||
|
||||
Copyright (c) 2020-2022 Akash Mahanty Et al.
|
||||
|
||||
Released under the MIT License. See [license](https://github.com/akamhy/waybackpy/blob/master/LICENSE) for details.
|
||||
|
@ -32,6 +32,7 @@ classifiers =
|
||||
License :: OSI Approved :: MIT License
|
||||
Programming Language :: Python
|
||||
Programming Language :: Python :: 3
|
||||
Programming Language :: Python :: 3.6
|
||||
Programming Language :: Python :: 3.7
|
||||
Programming Language :: Python :: 3.8
|
||||
Programming Language :: Python :: 3.9
|
||||
@ -40,12 +41,16 @@ classifiers =
|
||||
|
||||
[options]
|
||||
packages = find:
|
||||
python_requires = >= 3.7
|
||||
include-package-data = True
|
||||
python_requires = >= 3.6
|
||||
install_requires =
|
||||
click
|
||||
requests
|
||||
urllib3
|
||||
|
||||
[options.package_data]
|
||||
waybackpy = py.typed
|
||||
|
||||
[options.extras_require]
|
||||
dev =
|
||||
black
|
||||
|
@ -1,6 +1,6 @@
|
||||
"""Module initializer and provider of static information."""
|
||||
|
||||
__version__ = "3.0.4"
|
||||
__version__ = "3.0.6"
|
||||
|
||||
from .availability_api import WaybackMachineAvailabilityAPI
|
||||
from .cdx_api import WaybackMachineCDXServerAPI
|
||||
|
0
waybackpy/py.typed
Normal file
0
waybackpy/py.typed
Normal file
Reference in New Issue
Block a user