Skip to main content

Advent of Code helper CLI and library

Project description

Advent-of-code-py

Advent of Code helper CLI and library for python projects.

Status & Info:

Code style License Project Version
Code style License: MIT PyPI

Usage

Installation

To install advent-of-code-py run following command which installs advent-of-code-py CLI and advent_of_code_py library.

pip install advent-of-code-py

OR

poetry add advent-of-code-py

Usage

Initially for advent-of-code-py to work it need session value or session ID which you can obtain by viewing cookie while visiting advent of code server. After collecting session cookie value you need to add those values in config using advent-of-code-py CLI

advent-of-code-py config add <session-name> <session-value>

Now you can import library by using

import advent_of_code_py

After importing a library you can use either two decorator present which are solve and submit decorator for a function of puzzle

For example:-

@advent_of_code_py.submit(2018,3,1,session_list="<session-name>")
def puzzle_2018_3_1(input=None):
    # do some calculation with data and return final output
    return final_output

Now after decorating function now you can call function like regular function call

puzzle_2018_3_1()

After calling function final_output value will be submitted by library to Advent of Code server for 2018 year day 3 problem, then returns whether the submitted answer was correct or not. If session value is not provided then the solution will be submitted to all session value present in config file.

You can also use advent-of-code-py builtin Initializer and runner to create appropriate CLI for problem so problem can be run from CLI instead of modifying python file every time to run appropriate function To set advent-of-code-py puzzle as CLI

@advent_of_code_py.advent_runner()
def main_cli():
    initializer = advent_of_code_py.Initializer()
    initializer.add(<function_alias>=<function>)
    # for example to run above function you can write
    initializer.add(p_3_1=puzzle_2018_3_1)
    # add other functions ...
    return initializer

Now you can set main_cli as entry points, and it will create CLI with the appropriate name and function which was added. So for example to run function puzzle_2018_3_1() you have to run command as entry-point-name run p_3_1 which will run the appropriate function as well as submit as desired if the function was decorated by submit decorator or else prints its output if the function was decorated by solve decorator.

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

advent_of_code_py-0.4.0.tar.gz (9.8 kB view details)

Uploaded Source

Built Distribution

advent_of_code_py-0.4.0-py3-none-any.whl (11.8 kB view details)

Uploaded Python 3

File details

Details for the file advent_of_code_py-0.4.0.tar.gz.

File metadata

  • Download URL: advent_of_code_py-0.4.0.tar.gz
  • Upload date:
  • Size: 9.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.11.2 Linux/5.15.0-1034-azure

File hashes

Hashes for advent_of_code_py-0.4.0.tar.gz
Algorithm Hash digest
SHA256 5f65e178e40aabc69748534e1f0785af21d1b2b8db095102798c967fe1182edc
MD5 848e28618af9e64487e2466ad0df5cef
BLAKE2b-256 5cfb9c713087935b5ba3f48661fc8ad0121e131faf84b9db0c2cc38d71da9bae

See more details on using hashes here.

File details

Details for the file advent_of_code_py-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: advent_of_code_py-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 11.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.11.2 Linux/5.15.0-1034-azure

File hashes

Hashes for advent_of_code_py-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f7153e406de5c68ee360b80aaa95b8229744c2a5b28759958384ee0abd7e4b32
MD5 7251db546eb8f086f65e2c9c89366166
BLAKE2b-256 185d994d7221a9b93689a2090a68adba8798f8f22da03520a2bc0a1b1a8d561e

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