<commit_before>package stsc.common.trading;

import java.util.Date;

import stsc.common.Side;
import stsc.common.storage.StockStorage;

public interface Broker {

	public abstract void setToday(Date today);

	public abstract StockStorage getStockStorage();

	// algorithms interface
	/**
	 * @return bought amount of actions
	 */
	public abstract int buy(String stockName, Side side, int sharesAmount);

	/**<commit_msg>added javadocs for Broker interface<commit_after>package stsc.common.trading;

import java.util.Date;

import stsc.common.Side;
import stsc.common.storage.StockStorage;

/**
 * {@link Broker} is an interface that simulate broker behavior. (Simulate
 * broker behavior for Market with simple interface:
 * {@link #buy(String, Side, int)}, {@link #sell(String, Side, int)}.
 * 
 */
public interface Broker {

	public abstract void setToday(Date today);

	public abstract StockStorage getStockStorage();

	// algorithms interface
	/**
	 * @return bought amount of actions
	 */
	public abstract int buy(String stockName, Side side, int sharesAmount);

	/**
{'fraction_non_alphanumeric': 0.10541044776119403, 'fraction_numerical': 0.0, 'mean_word_length': 4.647368421052631, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3622448', 'n_tokens_mistral': 321, 'n_tokens_neox': 296, 'n_words': 101}