semvec/pypi-packages huggingface dataset:
tranco 0.8.1
Tranco: A Research-Oriented Top Sites Ranking Hardened Against Manipulation

# Tranco

This package allows easy access to the Tranco list, published at [https://tranco-list.eu](https://tranco-list.eu/).

## Usage

Create a `Tranco` object, indicating where you want to cache downloaded lists (caching is required):
```python
from tranco import Tranco
t = Tranco(cache=True, cache_dir='.tranco')
```

You can then retrieve lists from this object using the `list` method:

```python
latest_list = t.list()
date_list = t.list(date='2019-02-25')
```

The `list` method accepts the following parameters:
- `date`: the date of the list you want to retrieve (in the format `YYYY-MM-DD`). If not given, the latest daily list is returned
- `list_id`: the ID of the list you want to retrieve. If neither list ID nor date are given, the latest daily list is returned. If both are given, you will get an exception
- `subdomains`: whether to include subdomains; only relevant when requesting a daily list. Default: False
- `full`: whether to retrieve the full list (else only the top million). Default: False

This method returns a `TrancoList`, which allows you to retrieve a certain prefix of the list (`top`), 
the list ID (`list_id`), the list page (`list_page`) or the rank of a domain (`rank`):
```python
latest_list.top(10000)
latest_list.list_id
latest_list.list_page
latest_list.rank("google.com")
latest_list.rank("not.in.ranking") # returns -1
```

You can also generate custom lists. 
First, create a `Tranco` object with valid credentials 
(available from your [account page](https://tranco-list.eu/account)):
```python
from tranco import Tranco
t = Tranco(account_email="abc@xyz.eu", api_key="123ABC")
```

Then, pass the configuration (according to [this schema](https://tranco-list.eu/api_documentation#datatypes-configuration))
of your custom list to `configure`:
```python
c = t.configure(
    {
        'providers': ['alexa', 'umbrella', 'majestic'],
        'startDate': '2021-01-01',
        'endDate': '2021-01-30',
        'combinationMethod': 'dowdall',
        'listPrefix': 'full',
        'filterPLD': 'on',
    }
)
```
This method returns a tuple: whether the list is already available or is still being generated, 
and the ID that has been/will be assigned to the list.

You can retrieve metadata for a list through `list_metadata`:
```python
m = t.list_metadata(list_id="6P7X")
```
If a list is still being generated, you can use this method to track the progress; 
once a list has been generated, this metadata will indicate how the list was configured.
beatlesalbuns 0.0.5
Shows a list of The Beatles albuns, stats and the band members
Requires Python: >=3.11

# Beatlesalbuns
==========
This package is a demo for my Python students and so I decided to give a tribute to The Beatles band, providing a list of their published Albums.
Enjoy this packge and listen to their masterpieces!

NOTE:
----------
To use this beatlesalbuns module it is a requirement import pandas module. Intall pandas modules:

console> pip install pandas


Change log
------------
0.0.5 (02/04/2024) - Small correction in method show_albuns() in order return the datafrane objet and as well printing the list of albuns
0.0.4 (26/02/2024) - It was added new methods to class BAlbuns: stats() and band_members()
0.0.3 (16/05/2023) - It was simplified the import of this module. Previous versions were needed to import beatlesalbuns.beatlesalbuns, this version you just need this instruction: import beatlesalbuns
0.0.2 (8/05/2023) - Added print "I love The Beatles"